# Firmware Download Portal

Current firmware images for Salia charging stations are not published as open
downloads. They are requested through the firmware download portal at
**[firmware-download.echarge.de](https://firmware-download.echarge.de)**, which
checks the serial number of the station against eCharge's records and then
sends a personal download link by email. There is no account and no login: the
form on the page is the whole authentication.

The page also lists the release notes of the current firmware, so the changes
in a version can be read before requesting it.

## Requesting a download link

The form asks for:

| Field | Required | Notes |
| --- | --- | --- |
| First name, last name | yes | Letters and apostrophes only |
| E-mail | yes | The download link is sent here |
| Serial number | yes | 9 to 11 characters, letters and digits only |
| Company name | no | |

After submitting, the portal confirms that the link has been sent. **The link
is valid for 60 minutes.** After that the firmware has to be requested again
with the same form.

If the serial number is not recognised, the portal answers that the device
could not be verified. That is a data question rather than a form error —
contact support@echarge.de with the serial number instead of retrying.

If the email does not arrive, wait up to ten minutes, then check the spam
folder and the address that was entered before requesting the link a second
time.

## Finding the serial number

The serial number is printed on the type plate of the wallbox, usually on the
side of the housing, and also on the packaging and the invoice. On the type
plate it is the value **below the second barcode**, labelled `Ser.#`, and it is
9 to 11 characters long.

The number printed at the top of the type plate as `Prod.#` (for example
`3M38013`) is the production number. It is not the serial number and will not
be recognised by the portal.

## Before installing

The firmware is installed through the station's own web portal — the
configuration page the station serves on its IP address in the local network.
Two ways to find that address:

* In the eCharge app, open the wallbox, go to its details and tap **Show more
  details**. The IP address of the left and right charge point is listed
  there.
* In the router's web interface, open the list of network devices (often
  called "Home network" or "Connected devices") and look for a device with
  `Salia` in its name.

Check before starting:

* The station is powered on and has a stable network connection.
* No vehicle is charging, and the vehicle is unplugged.
* The current firmware version is known — the app and the station's web
  portal both show it.
* The user or admin credentials for the station's web portal are at hand.
* Date and time zone on the station are correct (**Global options → Timezone**
  and **Network options → NTP**). Wrong time values can make the update fail.

## Installing the image

1. Open the link from the email. The download starts automatically.
2. In the station's web portal, open the **Firmware** tab and select **Upload
   firmware**. Pick the downloaded image file.
3. Start the installation. It takes several minutes — roughly 5 to 15 in
   total.
4. Do not disconnect the station from power while the update runs. An
   interruption can damage the device.
5. The station reboots on its own when the installation has finished. It is
   briefly offline during this, and charging is not possible.
6. After the reboot, reload the web portal with Ctrl+F5 (Windows) or
   ⌘ + Shift + R (macOS) so the new pages are loaded rather than the cached
   old ones.

Configuration is normally preserved across an update, but note down the
credentials and the important settings before starting anyway.

## Passwords after the update

After the update, the station asks for new passwords for three separate
accounts: `user`, `service` and `root`. Each one needs its own password, and
each password must have:

* at least 12 characters
* at least one uppercase letter
* at least one lowercase letter
* at least one digit
* **no special characters** — a password containing them is rejected

If the page renders oddly after the passwords have been set, it is the browser
cache: reload with Ctrl+F5 (Windows) or ⌘ + Shift + R (macOS), and clear the
cache if that does not help.

## Firmware older than 1.50

A station running a firmware version below 1.50 cannot go straight to the
current release. Install version 1.50 first, from the Hardy Barth firmware
page at [salia.hardybarth.de/firmware](https://salia.hardybarth.de/firmware/),
using the same upload procedure as above. Once that update has succeeded,
request the current firmware from the portal and install it the same way.

## Updating from the eCharge app

The eCharge app — **Hardy Barth eMobility**, for Android and iOS — can carry
out the whole update itself, without the download portal, as long as the phone
and the station are on the same network. It finds stations on the local
network, reads the firmware version of each charge point, and compares it
against the latest published version.

When a station is behind, the app offers the update and runs it in this order:
it downloads the image to the phone, verifies the downloaded file against the
published checksum, uploads it to every charge point of the station at once,
installs it and reboots the boards, then waits for each board to come back.
The upload and reboot part can take up to about three minutes. The app must
stay open and the station must stay powered for the whole time.

Two related functions in the app:

* **Firmware list** downloads firmware images to the phone ahead of time. That
  is the path for stations that have no internet connection of their own: the
  phone fetches the image where there is a connection and installs it on site.
* When the app finds a station on an older firmware, it shows a note and
  offers to open the update instructions. That button opens this download
  portal in the browser.

The app is the shorter route where it works. The portal is what is left when
it does not: no app, no shared network, a PC-only workflow, or a station that
is reached through its web portal only.

## When the update fails

Wait two to three minutes and let the station finish booting before judging
the result — the reboot at the end of an update takes a while. Then reconnect
with the app, check the station's network connection, and restart the device.
If the second attempt also fails, contact support@echarge.de with the serial
number and the firmware version the station currently reports.

After a successful update, three things are worth checking: that a charging
session starts normally, that the app connects to the station again, and that
configured schedules are still active.
