Adding a charger
1
Pick the charger
Link lists the Ratio chargers nearby, by the name they advertise:
RATIO_ and the serial number, such as RATIO_P00000000035706. Your user picks theirs by the serial number on its sticker. Nothing is typed. In Chrome or Edge, the browser’s own Bluetooth list does this.2
Pairing
The phone asks for the Bluetooth passcode from the sticker in its own pairing dialog. Link never sees the passcode. Plugchoice then registers the charger under that name, its Chargepoint ID.
3
The setup
Link sets the charger’s timezone to the phone’s and reads which backoffice it uses. Then it shows how the charger connects: Wi-Fi, and Ethernet where the charger reports it. Your user can set up Wi-Fi by picking a network from the charger’s own scan (or typing one) and entering its password. They continue once one connection is up, and Link points the charger at Plugchoice.
4
Online
Link waits until the charger connects to Plugchoice.
- Older firmware. A charger whose firmware has no backoffice address is set to Plugchoice through the Volt Time entry in Ratio’s own list. One without that entry is asked to update with Ratio’s app first.
- The current operator comes along. When the charger used another OCPP backoffice, it stays the charger’s operator, with Plugchoice connected alongside. When it used none, your user is asked whether it keeps one.
Reconnecting it, or changing its network
Thereconnect action gets a Ratio that’s already on Plugchoice reaching Plugchoice again, or moves it to another Wi-Fi network. Link finds that charger by its name, and your user sees its connections, where they can give it another Wi-Fi. Link checks that the charger points at Plugchoice, and points it there again when it doesn’t. It imports nothing again.
What your app needs
- iOS:
NSBluetoothAlwaysUsageDescription. See iOS. - Android:
BLUETOOTH_SCANandBLUETOOTH_CONNECT. See Android. - React Native: the config plugin sets them up. See React Native.