demus/openhab-addons
1
0
Fork 0
mirror of https://github.com/openhab/openhab-addons.git synced 2025-01-10 15:11:59 +01:00
Code Issues Packages Projects Releases Wiki Activity

[volvooncall] Clean up readme. (#10976)

Browse Source 
Signed-off-by: James Hewitt <james.hewitt@uk.ibm.com>
This commit is contained in:
James Hewitt 2021-07-12 08:22:00 +01:00 committed by GitHub
parent 64a418829f
commit 26cf35116e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 50 additions and 50 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

100
bundles/org.openhab.binding.volvooncall/README.md
View File

@ -41,59 +41,59 @@ The 'VolvoOnCall API' bridge uses the owner's email address and password in orde
All numeric channels use the [UoM feature](https://openhab.org/blog/2018/02/22/units-of-measurement.html).
This means you can easily change the desired unit e.g. miles/h instead of km/h just in your item definition.
#####Thing properties
Some of the channels are only available for specific cars and models.
Some of the channels are only available for specific cars and models. These properties are added to the Thing
automatically by the binding when an API call is made.
Following channels are currently available:
| Channel Type ID | Item Type | Description | Remark |
|-----------------------------------------------|----------------------|--------------------------------------------------|--------------------------------------------------|
| doors#frontLeft | Contact | Door front left | |
| doors#frontRight | Contact | Door front right | |
| doors#rearLeft | Contact | Door rear left | |
| doors#rearRight | Contact | Door rear right | |
| doors#hood | Contact | Hood | |
| doors#tailgate | Contact | Tailgate | |
| doors#carLocked | Switch | Is the car locked | Can also be used to lock / unlock the car (see thing properties above) |
| windows#frontLeftWnd | Contact | Window front left | |
| windows#frontRightWnd | Contact | Window front right | |
| windows#rearLeftWnd | Contact | Window rear left | |
| windows#rearRightWnd | Contact | Window rear right | |
| odometer#odometer | Number:Length | Odometer value | |
| odometer#tripmeter1 | Number:Length | Trip meter 1 value | |
| odometer#tripmeter2 | Number:Length | Trip meter 2 value | |
| tank#fuelAmount | Number:Volume | Amount of fuel left in the tank | |
| tank#fuelLevel | Number:Dimensionless | Percentage of fuel left in the tank | |
| tank#fuelAlert | Switch | Alert if the amount of fuel is running low | ON when distancy to empty < 100 |
| tank#distanceToEmpty | Number:Length | Distance till tank is empty | |
| position#location | Location | Location of the car | |
| position#locationTimestamp | DateTime | Timestamp of the latest confirmed location | |
| tyrePressure#frontLeftTyre | Number | Tyrepressure front left tyre | Normal / LowSoft |
| tyrePressure#frontRightTyre | Number | Tyrepressure front right tyre | Normal / LowSoft |
| tyrePressure#rearLeftTyre | Number | Tyrepressure rear left tyre | Normal / LowSoft |
| tyrePressure#rearRightTyre | Number | Tyrepressure rear right tyre | Normal / LowSoft |
| other#averageSpeed | Number:Speed | Average speed | |
| other#engineRunning | Switch | Is the car engine running | |
| other#remoteHeater | Switch | Start the car remote heater | Only if property 'remoteHeater' is true (see thing properties above) |
| other#preclimatization | Switch | Start the car preclimatization | Only if property 'preclimatization' is true (see thing properties above) |
| other#brakeFluidLevel | Number | Brake fluid level | Normal / Low / VeryLow |
| other#washerFluidLevel | Number | Washer fluid level | Normal / Low / VeryLow |
| other#serviceWarning | String | Warning if service is needed | |
| other#bulbFailure | Switch | ON if at least one bulb is reported as failed | |
| battery#batteryLevel | Number:Dimensionless | Battery level | Only for Plugin hybrid / Twin Engine models |
| battery#batteryDistanceToEmpty | Number:Length | Distance until battery is empty | Only for Plugin hybrid / Twin Engine models |
| battery#chargeStatus | String | Charging status | Only for Plugin hybrid / Twin Engine models |
| battery#timeToHVBatteryFullyCharged | Number:Time | Time in minutes until the battery is fully charged| Only for Plugin hybrid / Twin Engine models |
| battery#chargingEnd | DateTime | Calculated time when the battery is fully charged| Only for Plugin hybrid / Twin Engine models |
| lasttrip#tripConsumption | Number:Volume | Last trip fuel consumption | |
| lasttrip#tripDistance | Number:Length | Last trip distance | |
| lasttrip#tripStartTime | DateTime | Last trip start time | |
| lasttrip#tripEndTime | DateTime | Last trip end time | |
| lasttrip#tripDuration | Number:Time | Last trip duration | |
| lasttrip#tripStartOdometer | Number:Length | Last trip start odometer | |
| lasttrip#tripStopOdometer | Number:Length | Last trip stop odometer | |
| lasttrip#startPosition | Location | Last trip start location | |
| lasttrip#endPosition | Location | Last trip end location | |
| Channel Type ID | Item Type | Description | Remark |
|-----------------------------------------------|----------------------|----------------------------------------------------|------------------------------------------------|
| doors#frontLeft | Contact | Door front left | |
| doors#frontRight | Contact | Door front right | |
| doors#rearLeft | Contact | Door rear left | |
| doors#rearRight | Contact | Door rear right | |
| doors#hood | Contact | Hood | |
| doors#tailgate | Contact | Tailgate | |
| doors#carLocked | Switch | Is the car locked | Can also be used to lock / unlock the car. Only if property 'lock' is true. |
| windows#frontLeftWnd | Contact | Window front left | |
| windows#frontRightWnd | Contact | Window front right | |
| windows#rearLeftWnd | Contact | Window rear left | |
| windows#rearRightWnd | Contact | Window rear right | |
| odometer#odometer | Number:Length | Odometer value | |
| odometer#tripmeter1 | Number:Length | Trip meter 1 value | |
| odometer#tripmeter2 | Number:Length | Trip meter 2 value | |
| tank#fuelAmount | Number:Volume | Amount of fuel left in the tank | |
| tank#fuelLevel | Number:Dimensionless | Percentage of fuel left in the tank | |
| tank#fuelAlert | Switch | Alert if the amount of fuel is running low | ON when distancy to empty < 100 |
| tank#distanceToEmpty | Number:Length | Distance till tank is empty | |
| position#location | Location | Location of the car | |
| position#locationTimestamp | DateTime | Timestamp of the latest confirmed location | |
| tyrePressure#frontLeftTyre | Number | Tyrepressure front left tyre | Normal / LowSoft |
| tyrePressure#frontRightTyre | Number | Tyrepressure front right tyre | Normal / LowSoft |
| tyrePressure#rearLeftTyre | Number | Tyrepressure rear left tyre | Normal / LowSoft |
| tyrePressure#rearRightTyre | Number | Tyrepressure rear right tyre | Normal / LowSoft |
| other#averageSpeed | Number:Speed | Average speed | |
| other#engineRunning | Switch | Is the car engine running | |
| other#remoteHeater | Switch | Start the car remote heater | Only if property 'remoteHeater' is true |
| other#preclimatization | Switch | Start the car preclimatization | Only if property 'preclimatization' is true |
| other#brakeFluidLevel | Number | Brake fluid level | Normal / Low / VeryLow |
| other#washerFluidLevel | Number | Washer fluid level | Normal / Low / VeryLow |
| other#serviceWarning | String | Warning if service is needed | |
| other#bulbFailure | Switch | ON if at least one bulb is reported as failed | |
| battery#batteryLevel | Number:Dimensionless | Battery level | Only for Plugin hybrid / Twin Engine models |
| battery#batteryDistanceToEmpty | Number:Length | Distance until battery is empty | Only for Plugin hybrid / Twin Engine models |
| battery#chargeStatus | String | Charging status | Only for Plugin hybrid / Twin Engine models |
| battery#timeToHVBatteryFullyCharged | Number:Time | Time in minutes until the battery is fully charged | Only for Plugin hybrid / Twin Engine models |
| battery#chargingEnd | DateTime | Calculated time when the battery is fully charged | Only for Plugin hybrid / Twin Engine models |
| lasttrip#tripConsumption | Number:Volume | Last trip fuel consumption | |
| lasttrip#tripDistance | Number:Length | Last trip distance | |
| lasttrip#tripStartTime | DateTime | Last trip start time | |
| lasttrip#tripEndTime | DateTime | Last trip end time | |
| lasttrip#tripDuration | Number:Time | Last trip duration | |
| lasttrip#tripStartOdometer | Number:Length | Last trip start odometer | |
| lasttrip#tripStopOdometer | Number:Length | Last trip stop odometer | |
| lasttrip#startPosition | Location | Last trip start location | |
| lasttrip#endPosition | Location | Last trip end location | |
## Events