Adding a charger
1
Serial number and pincode
Your user picks Volt Time and the model, then types the serial number and the pincode printed on the card. Link adds the charger to Plugchoice. The pincode proves your user has the charger in hand.
2
Its internet
A charger that’s already online goes straight on. An offline One or Source 2s gets its network over Bluetooth, as below. A Two Pro goes over Bluetooth even when it’s online, so Link can check its OCPP address and its connection. Other Volt Time models connect by their own network; Link waits for them to come online.
3
Electrical setup
Once the charger is online, Link asks about its electrical setup, such as the rating of its overcurrent protection and its current limit, and applies it.
Wi-Fi over Bluetooth
Your user stays near the charger. The phone finds it over Bluetooth by its Chargepoint ID, which is the charger’s Bluetooth name. Each setup also checks that the charger points at Plugchoice, and corrects it when it doesn’t.One
The One can’t tell the phone about its network, so Link asks for the Wi-Fi first: the network name and the password. A user whose charger is connected by cable or SIM can skip this. Link then sends the details to the charger, which restarts and joins the Wi-Fi. Link waits until the charger is online. When that takes long, it suggests checking the network name and password, and lets your user enter them again.Source 2s
The Source 2s reports its connections, so Link doesn’t ask for anything first. The setup shows how the charger reaches the internet, on a screen of its own: Ethernet, Wi-Fi, or mobile when it has a SIM. Your user can open Wi-Fi to pick a network from the charger’s own scan, or type a hidden one, and enter its password. They continue once one connection is up, and the setup goes on. If the charger refuses the connection, Link says it’s locked to another app. Your user removes it there and tries again.Two Pro
The Two Pro asks for its Bluetooth PIN before it can be set up. This is not the pincode it was added with. Your user types it as it came with the charger, capitals and small letters as given. Link then finds the charger, signs in with the PIN, checks that it points at Plugchoice and corrects it when it doesn’t. It shows how the charger reaches the internet: Wi-Fi, Ethernet or mobile, where the charger has them. The Two Pro doesn’t list the networks it can see, so your user types the Wi-Fi network name and password, or sets the SIM’s APN. Link restarts the charger only when something changed, and never while it’s charging. Then it waits until the charger is online. A wrong PIN takes your user back to the PIN.Changing the network later
Open Link with thereconnect action and the charger’s id to change its Wi-Fi. Link shows the network steps (the Wi-Fi details for a One, the connections for a Source 2s or Two Pro), checks the charger’s OCPP connection, waits until the charger is online, and closes. It doesn’t ask the setup questions again once the setup is done.
Read the charger’s capabilities.reconnect first: for these models network is true and it needs ble. Show a Network settings button only when the device has ble too. See Devices and capabilities.
Bluetooth in your app and in browsers
- iOS: your app needs
NSBluetoothAlwaysUsageDescriptionin its Info.plist. Without it, the SDK doesn’t use Bluetooth and the device has noble. See iOS. - Android: keep the Bluetooth permissions the library adds to your manifest. See Android.
- React Native: the config plugin adds the iOS string for you. See React Native.
- Browsers: Chrome and Edge show their own list of nearby devices; your user picks the one named after the charger’s Chargepoint ID. Safari, every browser on iPhone, and Firefox have no Bluetooth. There, Link waits for the charger to come online by cable or SIM.
Source and Source 2
Link sets up a Volt Time Source or Source 2 through the charger’s own web app, signed in as its Installer account (local_lan, needs lan and wifi, so your app).
1
Signing in
For a Source 2, your user types the serial number (7 digits, such as
0004920) and the pincode from the card that came with it; Link signs in with the pincode. A first Source has no pincode: your user types its serial number and the Installer password from the sticker inside it. Either can switch to the factory’s Assembler account.2
Finding the charger
Link looks for the charger on the phone’s Wi-Fi network. When there are several, your user picks theirs by name. When it isn’t there, your user switches the charger off and on and waits until its light is no longer white. The phone then joins the charger’s setup network,
VoltTime and the serial number. Link fills in a Source 2’s password, the pincode twice, and asks for it only when that doesn’t work. A Source’s is on its sticker, and your user types it.3
The setup
Link reads the charger’s Chargepoint ID and adds it to Plugchoice, points it at Plugchoice, keeping its other settings, and brings its RFID cards along, and its charging history in SDK 0.6.0 and later. Then it shows how the charger connects: Ethernet, Wi-Fi or its SIM. Your user can give it a Wi-Fi from the charger’s own scan, or see its SIM’s ICCID and set its APN.
4
Online
Link waits until the charger connects to Plugchoice. When it doesn’t, Link logs why it may not, from the charger’s own logs and network status.
_http._tcp in NSBonjourServices, NSLocalNetworkUsageDescription, and the Hotspot Configuration and Access Wi-Fi Information entitlements, because Link finds them on the network by name or joins their setup network.
ENO one for business
Link sets up an ENO one for business over its own Wi-Fi hotspot, in your app (local_hotspot, needs wifi and socket). Your user restarts it at its breaker first, because it only opens its hotspot when it starts, and waits until its light is back to its usual colour. Then they scan the ENO install code on the label in its installation guide, or type the hotspot’s name and passkey. Link points the charger at Plugchoice, keeping its Chargepoint ID, and shows its connections so your user can connect it to Wi-Fi. A charger that already connects to Plugchoice is left as it is. In a browser, your user sets it up by hand, or in the Plugchoice app when the charger goes to their own account.
On iOS your app needs the Hotspot Configuration and Access Wi-Fi Information entitlements and NSLocalNetworkUsageDescription. Android needs nothing beyond the SDK’s setup.