Skip to main content

Lithium Integration (Smart Parking)

The Lithium integration turns parking lots into smart environments: it monitors vehicle entries and exits in real time and automatically updates the number of available spots. The occupancy calculated by ACCELERO is published to the Lithium devices (for example, spot panels), offering a modern experience connected to access control.

Availability

This integration is provided as a plugin (lithium) and must be installed and enabled by the IONGRADE technical team. Contact support to check compatibility with your ACCELERO version.

Compatibility

Current plugin version: 0.0.1 — compatible with ACCELERO 2.16.5, 2.16.6, 2.16.7, or 2.16.8.


What the integration does

With the plugin active, ACCELERO starts publishing the occupancy of the monitored parking areas to the Lithium devices. Communication happens over MQTT: ACCELERO calculates the occupancy from its own vehicle access events and sends the status to the devices, which can also request the current occupancy on demand.

FeatureWhat happens in ACCELERO
Occupancy monitoringOn each vehicle movement in a monitored parking area, the occupancy is recalculated and published to the Lithium devices
On-demand publishingWhen a device requests the current occupancy, ACCELERO responds with the status of used and total spots of each configured area
Device registryA dedicated screen to manage the Lithium devices (description, serial, status)
Device keep-alivePeriodic messages sent by the devices update the metadata of each piece of equipment (last contact/state)
Main benefit

The spot count is maintained automatically by ACCELERO's access control — with no manual operation and no additional counting sensors.


Configuration

Navigation path: Settings > Integrations - Lithium

The screen has one tab: General.

TODO: Add Screenshot

The Settings > Integrations - Lithium configuration screen, General tab, showing the Integration data section with the Parking areas field.

General tab — Integration data

FieldDescription
Parking areasMulti-selection of ACCELERO areas. Only the selected areas have their occupancy monitored and published to the Lithium devices
Unselected areas are not monitored

Movements in areas that are not in Parking areas do not generate occupancy publishing. Select all areas whose spots should be displayed by the devices.

Screen buttons

ButtonFunction
SavePersists the configuration
BackReturns without saving

Lithium Devices

Navigation path: Settings > Lithium

Lists the registered Lithium devices and allows creating, editing, and deleting them.

TODO: Add Screenshot

Device list in Settings > Lithium, showing the Description, Serial, Metadata, Status, and Actions columns, plus the New device button.

List columns

ColumnContent
DescriptionDevice name
SerialDevice serial number
MetadataTechnical device data, updated automatically (e.g., keep-alive)
StatusIndicates whether the device is active
ActionsEdit the device

Device registration / editing

Registration can be done by inline addition in the list itself (the New device button) or by the edit screen.

TODO: Add Screenshot

Lithium device registration/edit form with the Description, Serial, and the Status selector.

FieldDescription
DescriptionDevice name (3 to 50 characters, required)
SerialDevice serial number (3 to 50 characters, required). Used to identify the equipment in the MQTT messages
StatusActivates or deactivates the device
The Serial must be unique and correct

The Serial is the key that links the messages sent by the device to its registration in ACCELERO. If the serial does not match any registered device, the received messages are ignored.

Bulk deletion

The list allows selecting several devices and deleting them at once via the Delete action in the More actions menu.


How occupancy is published

The integration works over the MQTT channel. ACCELERO calculates the occupancy of each monitored parking area and publishes a status in the format:

DataContent
areaArea identifier
usedNumber of vehicles currently in the area (current occupancy)
totalTotal vehicle capacity of the area

Publishing happens at two moments:

  • Update on movement — when a vehicle enters or leaves a monitored area (or a monitored origin area), ACCELERO recalculates and publishes the occupancy automatically.
  • Response to a request — when a Lithium device requests the current occupancy, ACCELERO publishes the status of all configured areas.
Only vehicles count

Occupancy considers the movement of vehicles. The total capacity of each area comes from the configuration of the area itself in ACCELERO.

TODO: Add Diagram

Diagram of the MQTT flow between the Lithium devices and ACCELERO: vehicle movement → occupancy recalculation → status publishing; and occupancy request → status response.


Use cases

Enable smart parking

  1. Request that IONGRADE install the lithium plugin.
  2. In Settings > Integrations - Lithium, select the Parking areas that should be monitored.
  3. In Settings > Lithium, register the devices with the correct Description and Serial and keep them active.
  4. Make sure the selected areas have the vehicle capacity configured.
  5. Move a test vehicle and confirm that the published occupancy reflects the entry/exit.

Replace or restore a device

  1. Register the new device in Settings > Lithium with the equipment's Serial.
  2. Deactivate (Status) or delete the old device.
  3. Confirm that the keep-alive messages of the new equipment are updating the Metadata column.

Best practices

  • Areas dedicated to parking: select only areas that represent real parking lots to avoid irrelevant occupancy publishing.
  • Correct capacity: keep the total vehicle capacity of the areas updated — it is the basis of the available-spots calculation.
  • Reliable serial: register the serial exactly as recorded on the equipment; discrepancies make ACCELERO ignore the device's messages.
  • Status as a maintenance control: deactivate devices under maintenance instead of deleting them, preserving the metadata history.

Troubleshooting

The devices do not update the spots

Possible causes:

  • The area is not checked in Parking areas.
  • The area's vehicle capacity is not configured.
  • The device is inactive (Status off).

Solution:

  1. In Settings > Integrations - Lithium, confirm that the area is selected.
  2. Check the area's vehicle capacity.
  3. In Settings > Lithium, confirm that the device is active.

The device's messages are ignored

Possible causes:

  • The Serial provided in the registration does not match the equipment's serial.
  • The device is not registered.

Solution:

  1. Check the serial recorded on the equipment and compare it with the registration in Settings > Lithium.
  2. Register the device if it does not yet exist.
Advanced diagnosis

The MQTT communication (occupancy publishing, keep-alive, and requests) depends on the ACCELERO messaging infrastructure. In case of a persistent failure, contact IONGRADE support to validate the environment.


Integration with other modules

Areas

Occupancy is calculated per Area: only areas checked in Parking areas are monitored, and the area's vehicle capacity defines the total number of spots.

Vehicles and parking spots

The occupancy count reflects the movement of Vehicles. Also see Parking Spots to understand spot control in ACCELERO.

Controllers and channels

The movement that triggers the occupancy recalculation comes from the access events recorded by the Controllers in the configured areas.


Next Steps

  • Areas — Configure the parking areas and their capacities
  • Vehicles — Understand the vehicle registry used in the count
  • Parking Spots — Learn how ACCELERO controls vehicle spots
  • Controllers — See how access movements are recorded
  • Plugins — Learn more about the ACCELERO plugin system