Skip to content

Commit 44691b3

Browse files
authored
Update event type list
Add comms_lost for removed -> unknown, comms_restored for unknown -> removed, and missing for removed -> unknown. Also added language about how to get in/out of Unknown in a more global way.
1 parent c944ba7 commit 44691b3

1 file changed

Lines changed: 5 additions & 2 deletions

File tree

general-information.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -260,6 +260,8 @@ The state-transition table below describes how the `vehicle_state` changes in re
260260

261261
Note that to handle out-of-order events, the validity of the prior-state shall not be enforced at the time of ingest via Provider or Agency. Events received out-of-order may result in transient incorrect vehicle states.
262262

263+
Vehicles can enter the `unknown` state to and from any other state with the following event types: `unknown` can go to any state with event type `comms_restored`, and any state can go to `unknown` with event type `comms_lost` or `missing`.
264+
263265
| Valid prior `vehicle_state` values | `vehicle_state` | `event_type` | Description |
264266
| --- | --- | --- | --- |
265267
| `non_operational` | `available` | `battery_charged` | The vehicle became available because its battery is now charged. |
@@ -293,8 +295,9 @@ Note that to handle out-of-order events, the validity of the prior-state shall n
293295
| `available`, `non_operational`, `elsewhere` | `removed` | `compliance_pick_up` | The provider picked up the vehicle because it was placed in a non-compliant location |
294296
| `available`, `non_operational`, `elsewhere`, `unknown` | `removed` | `decommissioned` | The provider has removed the vehicle from its fleet |
295297
| `unknown`, `non_operational`, `available`, `elsewhere` | `removed` | `unspecified` | The vehicle was removed, but the provider cannot definitively (yet) specify the reason |
296-
| `available`, `reserved`, `on_trip`, `non_operational`, `elsewhere` | `unknown` | `missing` | The vehicle is not at its last reported GPS location, or that location is wildly in error |
297-
| `available`, `reserved`, `on_trip`, `non_operational`, `elsewhere` | `unknown` | `comms_lost` | The vehicle is unable to transmit its GPS location or other status information |
298+
| `unknown` | `removed` | `comms_restored` | The vehicle transmitted status information after a period of being in an unknown state |
299+
| `available`, `reserved`, `on_trip`, `non_operational`, `elsewhere`, `removed` | `unknown` | `missing` | The vehicle is not at its last reported GPS location, or that location is wildly in error |
300+
| `available`, `reserved`, `on_trip`, `non_operational`, `elsewhere`, `removed` | `unknown` | `comms_lost` | The vehicle is unable to transmit its GPS location or other status information |
298301
| `available`, `non_operational` | `unknown` | `unspecified` | The provider cannot definitively (yet) specify the reason for the unknown state |
299302

300303
### State Machine Diagram

0 commit comments

Comments
 (0)