Run the site

Getting a site
running.

Locations, chargers, identities, tariffs, access and credentials. The whole setup surface, and the two or three places where a small mistake is expensive.

Locations

A location is a physical site: an address, coordinates, a type and an electricity rate. Everything reports against it, so it is worth getting right before you add hardware.

The address is geocoded and normalised. Do not free-type the province or the country, because consistent geography is what makes the map, the reporting and, in Canada, the carbon registration work.

Create or edit a location
Do it yourself
  1. Stations, Sites, then Add Site.
  2. Name, site type and street address. Save.
  3. Open the location and set the electricity rate on its Electricity Reimbursement card.
Or just ask EVII™
Add a location for the Hilton on Plymouth Road, it is a hotel.
What is my electricity rate set to at Balboa?
The Add Site dialog, opened from Stations, Sites by a test Operator, in manual address entry. Location Name is Sample Plaza (sample data) and Type is Multi-Family. The address is 500 Sample Avenue, Testville, CA 90000, country US, with optional Latitude and Longitude fields left empty, showing the form’s grey example values, and a note that blank coordinates are geocoded on the server. Cancel and Create Location buttons are at the bottom. Nothing was submitted.
Add Site: the location name, the type and the address. The electricity rate is set afterwards, on the location’s Electricity Reimbursement card. The live console starts with an address search; this capture shows manual entry. Sample screen with test data.
Set the electricity rate honestly

Every margin figure you see is calculated against it. Leave it at zero and the platform will cheerfully report gross revenue as if power were free, which is a number that looks right and is not. When a figure looks right, ask what produced it.

Where the site is reimbursed for its electricity, the same rate is what we reimburse at, applied to each session at the rate in effect when it starts. A change applies only to sessions that start after you save it, so keep it current. The rules are in our Site Host Terms.

The Electricity Reimbursement card in the Edit form of Sample Towers (sample data), opened by a test Operator. It reads: what this building actually pays per kWh, subtracted from each session’s gross before the platform and owner split. Three mode buttons read Use a saved tariff, Custom TOU schedule and Flat rate, with Flat rate selected. The Flat rate field holds 21 with the unit cents per kWh, and a hint says the single rate applies to every session and is also the floor for the other modes.
The Electricity Reimbursement card in a location’s Edit form, set to a flat rate of 21 cents per kWh. Sample screen with test data.

Getting it online

A charger is not much use until it can reach us. This is the decision to make before the unit goes on the wall, not after, because one of the three answers needs a cable pulled and the other two do not.

You need one of the three, not all three. If the unit is on ethernet or cellular, the wifi step in the unit’s own setup can be skipped entirely.

What a dropped connection actually costs you

A session already running keeps delivering power. A car plugged in at the moment the link goes does not stop charging. What stops is everything that needs us: a driver starting a new session from the app, a remote reset, live status, and the meter readings that land in your reports. A card or fob may still start a session offline if the unit holds its own list of allowed cards, and that session reaches your reports when the charger reconnects. If the charger is back within about an hour of its last reading, its own stop record carries the full meter reading and the session bills normally. If it stays dark longer than that, we close the session on the last reading we received and bill only that. That is the real cost of an unreliable connection, and it is why we would rather see a cable or a SIM than somebody else’s wifi.

Decide how a new site gets online
Do it yourself
  1. Is there a network drop within reach of where the charger goes? If yes, pull ethernet while the walls are open.
  2. No drop, or the run is expensive? Use cellular, check the signal at the exact spot the unit goes, and do not let the installer leave until the unit shows on the console. A SIM that was never activated is the usual reason it does not.
  3. Wifi only if neither is available, and write the network and password down where the next person will find them.
Or just ask EVII™
Is SPARK2 online, and when did it last talk to you?
Which of my chargers are offline right now?

Whichever you pick, confirm the unit actually appears on the console before the installer drives away. A charger that never connected is almost always a SIM that was never activated or an identity that was typed instead of copied, and both are far easier to sort out while the installer is still on site than after they have left.

The Connectivity section on the Overview tab of the charger page for TEST-TWR-02, as a test Operator sees it (read only). Connection is EV Initiative cellular, from the deployment. SIM provider is 1nce, SIM ICCID is the sample value TEST-ICCID-000000001 and SIM IMSI is TEST-IMSI-0001, set by BootNotification. The 1nce status pill reads online, last event 6 minutes ago. A note explains that only chargers with provider 1nce take part in the 1nce webhook and reconciliation flows.
The Connectivity section on a charger’s Overview tab: the connection type, SIM provider, ICCID and IMSI, and the SIM’s live status. Sample screen with test data.

Once a charger has connected, we watch for silence: whether its messages are still arriving, not whether a stored flag says it is online. See preventative maintenance for what that means, and the notices for what arrives in your inbox.

Chargers and identity

A charger is one unit. Its identity is what it announces to the network, and that identity is the single most important field in the whole system.

Add a charger
Do it yourself
  1. Open the location, add a charger.
  2. Paste the identity, copied from the unit’s configuration screen.
  3. Set connector types and power rating.
  4. After saving, set who can charge in the charger’s Edit form. See Who may charge.
Or just ask EVII™
Add a second charger at the Hilton, same settings as the first.
The Register Charger dialog, opened with Add Charger from Stations, Chargers by a test Operator. Location is Sample Towers (sample data), Identity is TEST-TWR-03 with the hint OCPP chargepoint ID, max 20 characters, no spaces, OCPP Version is 1.6, Vendor is Sample Charger Co. and Model is SC-7. One connector row reads number 1, type J1772, 7.2 kW, with an Add connector button below. Cancel and Register Charger buttons are at the bottom. Nothing was submitted.
Register Charger, from Add charger on the location’s page or Add Charger on Stations, Chargers: the identity pasted from the unit, the OCPP version, vendor and model, and each connector’s type and power. Opened from Stations, Chargers, as here, it also asks for the location. Sample screen with test data.
Work out why a new charger never appeared
Do it yourself
  1. Check the identity you entered against the unit’s own configuration, character for character.
  2. Check the unit has power and a working internet connection.
  3. Check the websocket address programmed into the unit points at our network.
Or just ask EVII™
Has the charger at Plymouth ever connected?
Show me every message from SPARK1 today.

An identity mismatch produces silence, not an error. If it has never connected and the address is right, the identity is the answer roughly every time.

Stations, Chargers list for a test Operator: 8 chargers registered, with an Add Charger button, a search box and a Status filter button. The table lists the sample chargers TEST-TWR-01, TEST-TWR-02, TEST-LFT-01, TEST-LFT-02, TEST-INN-01, TEST-INN-02, TEST-DEPOT-01 and TEST-DEPOT-02, all Sample Charger Co. SC-7 on OCPP 1.6, with a colored dot for each connector, an Online or Offline badge, the 30-day start timeouts and the last heartbeat time. TEST-LFT-02 is Offline, its timeouts column reads Offline, no contact 2d, and its last heartbeat is two days earlier.
Stations, Chargers: compare the identity in the first column with the unit’s own configuration, character for character. Sample screen with test data.

A charger that has connected once and then gone quiet is a different problem, and it is in the fault playbook.

What drivers pay

A tariff lives under Manage, Tariffs, and each charger picks one. Three types, each billed per kWh or per hour.

Any of them can carry an idle fee for a car left plugged in after charging. There is no session fee for you to set: EV Initiative’s connection fee is set per charger by EV Initiative and shown to the driver before they start.

Change a price
Do it yourself
  1. Edit the tariff under Manage, Tariffs, or create a new one with Add Tariff.
  2. To move a charger to a different tariff, open the charger, use Edit, and pick it under Tariff.
  3. Save. It is live immediately.
Or just ask EVII™
Put the visitor chargers up to 48 cents from Monday.
Make charging free at the Hilton on weekends.

A price change takes effect on sessions that start after it. It never reprices a session already running.

The New Tariff dialog over Tariff Plans, opened with Add Tariff by a test Tenant Admin; the list behind it shows Resident (sample data), marked Default, and Off-peak nights (sample data). In the dialog, Name is Visitor (sample data); Type is Flat, single per-kWh rate, the select that also offers Time of Use and Tiered; Unit is cents per kWh, billed by kWh delivered, with cents per hour as the other choice; Energy rate is 42 cents per kWh and Tax rate is 0.0875, which is 8.75 percent. The optional Idle fee field is empty, so Idle grace (15 minutes, 5 to 30 allowed) is greyed out. A box Set as default tariff for this tenant is unticked, above Cancel and Create Tariff buttons. Nothing was saved.
New Tariff, from Add Tariff under Manage, Tariffs: the name, the type (Flat, Time of Use or Tiered), the unit, the rate in cents and the tax rate, with an optional idle fee. Sample screen with test data.
The top of the Edit charger form on the charger page for TEST-TWR-01, opened with Edit by a test Tenant Admin. Vendor is Sample Charger Co., Model is SC-7, OCPP version is OCPP 1.6 and Location is Sample Towers (sample data), Testville, CA. The Tariff select is set to Visitor 42¢ per kWh (sample data), next to the Active switch, which reads Charger is live and accepting sessions.
On the charger’s page, Edit opens the charger form, where the Tariff select sets what drivers pay at this charger. Sample screen with test data.

Who may charge

Set per charger, in its Edit form and on its Overview tab, and changeable any time. Drivers on your own account charge at your rate, and residents join your account with the building join code. These settings decide who else can.

The Guest access part of the Edit charger form for TEST-TWR-01, opened by a test Tenant Admin. It explains that outside drivers can charge here when guest access is on and pay the tenant rate plus the guest markup. Open to guests is ticked, with the guest pricing markup set to 20 percent. Public network listing is ticked: the charger is listed on the driver map, and stays reachable by direct link or QR either way. The Guest pass list holds one sample driver, guest.driver@example.test, with a counter of 1 of 100 users and a search box for adding more. Guest time windows has none, meaning no restriction.
Access settings in the charger’s Edit form: Open to guests with its markup, Public network listing, the Guest pass list and guest time windows. Sample screen with test data.
The Fleet Assignment section on the Overview tab of the charger page for TEST-TWR-01, seen by a test Tenant Admin. Assigned fleet is set to no fleet, a public charger, and the Effective access badge reads PUBLIC, with a note that it is a preview until saved. A Save fleet assignment button sits below, dimmed because nothing has changed.
Fleet Assignment, on the charger’s Overview tab: with no fleet the Effective access badge reads Public, and assigning a fleet makes the charger fleet only. Sample screen with test data.
Keep a charger to residents
Do it yourself
  1. Open the charger, use Edit, and turn Open to guests off.
  2. Turn Public network listing off too if it should not be on the map.
  3. Give residents the building join code. Once they join they are drivers on your account, so they charge at your rate and outside drivers cannot start a session.
Or just ask EVII™
Make the garage chargers residents only.
Who charged at Balboa last week?
The join code does the work

Every building has a join code. Post it where residents already look: the notice board, the resident app, the new-tenant pack, the lift. A resident enters it once and they are linked to your building. You do not have to add people one at a time.

The Building Join Code card under Location Settings for Sample Towers (sample data), seen by a test Operator. It explains that this per-location code is for residents of the building and that anyone with the link can register or switch their account into the location. Active code is the sample code SMPL01, with its generated date and a Copy join URL button. The join link reads https://app.example.test/join?code=SMPL01, and the footer says 14 users joined via this code.
The Building Join Code card, under the location’s Location Settings: the active code, Copy join URL and the join link. Sample screen with test data.

RFID cards and fobs

For people who will not use a phone, and for fleet drivers.

Issue or kill a credential
Do it yourself
  1. Manage, RFID, Card Management.
  2. Add a card and assign it to a driver, or release or disable one.
Or just ask EVII™
Kill the fob for Dana, she lost it.
Issue a keyfob to the new driver at the depot.

A lost fob is killed in seconds. It does not have to be a security problem for a week.

RFID Cards (Manage, RFID, Card Management) for a test Tenant Admin: Register physical cards to drivers so Authorize returns Accepted end to end, with an Add card button, a search box and an All cards filter. Cards are grouped by the driver's email. resident.one@example.test has 2 cards, TEST-RFID-0002 (Spare card) and TEST-RFID-0001 (Blue card), both Active. resident.two@example.test has 1 card, TEST-RFID-0003 (Lost card), marked Disabled and greyed. Each row shows its created date and edit, release and disable or reactivate icons.
RFID Cards, under Manage, RFID, Card Management: cards grouped by driver email, with Add card, and edit, release and disable on each card. Sample screen with test data.