> ## Documentation Index
> Fetch the complete documentation index at: https://developer.plugchoice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallbox

> Add a Wallbox picked from the ones nearby: the phone sets it up over Bluetooth, with the passcode from the Wallbox app.

Link sets up a Wallbox with the Bluetooth passcode the Wallbox app shows for it. The phone reaches the charger over Bluetooth, imports its charging history, shows how it connects to the internet (and connects it to Wi-Fi when needed), and points it at Plugchoice. Your user stays near the charger while it's set up.

| | |
| - | - |
| Models | Pulsar Plus, Pulsar Plus Socket, Pulsar Max, Pulsar Pro, Commander 2, Copper SB, Quasar and Quasar 2. Not the original Pulsar or the Supernova |
| Onboarding method | `local_ble` (or `manual_ocpp`, by hand) |
| What the phone needs | `ble` |
| Network setup | Yes, by reconnecting it (`reconnect` has `network: true` and `needs` `ble`) |
| In a browser | No: the charger pairs with a passcode, which a browser can't ask for. Link offers your app or setting it up by hand |

## Adding a charger

**1. The passcode**

Link shows where the charger's Bluetooth passcode is: in the Wallbox app, the charger's settings, **Charger info**. Your user notes it, with the serial number shown there.

![Find the charger's Bluetooth passcode: open the Wallbox app, its settings, then Charger info](https://developer.plugchoice.com/images/sdk/wallbox-passcode-light.webp)

**2. Pick the charger**

Link lists the Wallbox chargers nearby, by the name they advertise: `WB` and the serial number, such as `WB377275`. Your user picks theirs.

![Which charger is yours: the Wallbox chargers nearby, with their signal](https://developer.plugchoice.com/images/sdk/wallbox-nearby-light.webp)

**3. Pairing**

The phone asks for the Bluetooth passcode in its own pairing dialog. Link never sees the passcode. Plugchoice then registers the charger under its Chargepoint ID.

**4. The setup**

Link imports the charger's charging history and shows how it connects. 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.

![Choose a Wi-Fi network: the networks the charger found, with their signal](https://developer.plugchoice.com/images/sdk/wallbox-networks-light.webp)

**5. Online**

Link waits until the charger connects to Plugchoice.

What to know:

* **Its Chargepoint ID stays.** Link leaves the charger's Chargepoint ID as it is. A charger without one gets its serial number.
* **The current operator comes along.** When the charger used another OCPP backoffice, it stays the charger's operator, with Plugchoice connected alongside. That backoffice's OCPP password isn't passed on.
* **Its charging history comes along.** Link imports the charger's finished sessions, with the energy of each. A Wallbox doesn't record which card started a session, so no RFID cards are imported.
* **Its software.** A charger whose software can't take a backoffice address over Bluetooth asks your user to update it in the Wallbox app first.
* **The Wallbox app.** Once the charger is on OCPP, the Wallbox app's cloud features may stop working for it. The Wallbox app still reaches it over Bluetooth.

## Reconnecting it, or changing its network

The `reconnect` action gets a Wallbox that's already on Plugchoice reaching Plugchoice again, or moves it to another Wi-Fi network. Your user picks the charger from the ones nearby, and Link checks that it connects with the Chargepoint ID it has on Plugchoice. Link points the charger at Plugchoice again when it doesn't point there. Your user sees its connections, where they can give it another Wi-Fi, and Link waits until it's back online. It imports nothing again.

## What your app needs

* **iOS**: `NSBluetoothAlwaysUsageDescription`. See [iOS](https://developer.plugchoice.com/sdk/ios.md).
* **Android**: `BLUETOOTH_SCAN` and `BLUETOOTH_CONNECT`. See [Android](https://developer.plugchoice.com/sdk/android.md).
* **React Native**: the config plugin sets them up. See [React Native](https://developer.plugchoice.com/sdk/react-native.md).

In a browser, Link offers your app (the Plugchoice app, on Plugchoice's own page) or setting the charger up [by hand](https://developer.plugchoice.com/sdk/chargers/other.md). A browser can reach the charger over Bluetooth but can't pair with it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.