Adding a charger
1
A restart
A Peblar opens its own Wi-Fi hotspot for setup when it starts, so your user restarts it first with its breaker.
2
The card
The card has an Installation Wizard QR code and a device password. Your user scans the Installation Wizard code (not the Web App code) and types the password. They can also type the hotspot’s details instead.
3
The setup
The phone joins the charger’s hotspot; your user taps Join when the phone asks. Link signs in to the charger, reads its settings, cards and charging history, and points it at Plugchoice, which restarts the charger. Before the hotspot closes, Link shows how the charger will reach the internet (Ethernet, Wi-Fi or mobile), and your user can connect it to a Wi-Fi network there. Then the phone returns to its own network.
4
Online
Link waits until the charger connects to Plugchoice.
- Cards, history and the current operator come along. Plugchoice imports the charger’s cards and charging history. When the charger used another OCPP backoffice, it stays the charger’s operator, with Plugchoice connected alongside. Your user sees all of it before it’s saved.
- The right card. Link checks that the charger it reaches matches the card.
- No internet during the setup. The phone is on the charger’s hotspot for part of it, which has no internet. The SDK keeps the hosted flow working, and keeps the screen awake, because the hotspot drops when the phone locks.
Reconnecting it, or changing its network
Thereconnect action gets a Peblar that’s already on Plugchoice reaching Plugchoice again, or moves it to another network, such as a new Wi-Fi router or Ethernet. Your user restarts the charger and scans its card. Link checks that the charger points at Plugchoice and points it there again when it doesn’t (that restarts the charger), shows its connections (Ethernet, Wi-Fi or mobile) so your user can connect it, and waits until it’s back online. It doesn’t read the charger’s cards or charging history again.
What your app needs
- iOS: the Hotspot Configuration and Access Wi-Fi Information entitlements,
NSLocalNetworkUsageDescription, andNSAllowsLocalNetworkingunderNSAppTransportSecurity(the charger answers over plain HTTP). On iOS 18 and later, AccessorySetupKit asks once per charger instead of on every join. See iOS. - Android: the charger serves its setup over plain HTTP on its hotspot (
http://172.16.0.1). Android blocks plain HTTP in release builds unless your network security configuration allows it. See Android. - React Native: the config plugin sets up iOS; Android’s network security configuration is yours to set. See React Native.