Wiren Board Firmware Update/en

Материал из Wiren Board
Версия от 14:54, 24 мая 2019; RomanKulibaba (обсуждение | вклад) (Новая страница: «== The Wiren Board 6 factory reset ==»)


Partial firmware update using APT

In this method, the firmware is updated in parts using the Debian operating system package manager.

The advantage of this method is that the update is fast, you can update only the necessary components, and this method has the least impact on user files and settings.

The disadvantage of the method is the need to take a responsible approach to the process and not to do rash actions: careless use of the tool can lead to incomplete installation or even removal of important components of the Wiren Board controller software


Updating the package list

Before you start, you need to get an up-to-date list of packages from the Debian and Wiren Board repositories.

To update all the package lists:

apt-get update


To update only the packages from the Wiren Board repository:

apt-get update -o Dir::Etc::sourcelist="sources.list.d/contactless.list" -o Dir::Etc::sourceparts="-" -o APT::Get::List-Cleanup="0"



Full firmware update

Firmware update via web interface

Please note that this method is not recommended on Wiren Board 5 when upgrading to the revision with word "stetch" in the name from the version without "stetch" in the file name. This applies in particular to the factory WB5 firmware older than mid-2018 release.

  1. Firmware update is performed by overwriting the controller drive section with the operating system and all installed programs. This does not affect files that are in folders (they are on another partition). Read more to see the files that were lost when you upgrade the system, in the section updateLoss of files during a software update
    These folders store all changes that can be made through the web interface, including settings from the Configs page, all connected devices and widgets - all this data will be saved.
    If you stored data on the controller in other folders, or installed your own software, they will be lost. You can download the desired files to your computer before updating by following the instructions .'View the controller files from your computer'.
  2. Download the latest firmware from the page https://github.com/contactless/wirenboard/releases.
    Firmware file with extension .fit on Github
    .
  3. Go to the web interface to the Settings section. Find section Firmware update, press Select file, choose the previous downloaded file.
    Press Select file to download
  4. The file with the new firmware will be downloaded to the controller, after that the update process will begin. Do not close the update page or perform any actions on the controller, including the web interface. The upgrade process will take up to 10 minutes.
    During the update, system messages appear on the page
  5. After installing the new firmware, the controller will reboot. After that, the update page will display a message about the successful completion of the update - Firmware update complete.
    Successful update notification


Firmware update via USB drive

You can update the firmware of the Wiren Board 6 controllers using USB drive (flash drive).

The upgrade algorithm is similar to the one used when upgrading via the Web interface. The firmware image with the extension is used for the upgrade .fit

During the upgrade, you can connect to the controller's debug console, which displays information about the upgrade process.

  1. The USB drive must be formatted to FAT32. If you are using an external hard drive, you should also make sure that the USB port of the controller can provide sufficient current to start the drive.
  2. Download the latest firmware for Your controller from [1].
  3. Save the downloaded file to the USB drive in the root directory. Rename this file to wb6_update.fit.
  4. Power off the controller.
  5. Practice pressing the FW button when the controller is turned off - during the update you will need to do it quickly and accurately. To do this, it is convenient to use a small screwdriver supplied with the controller.
  6. Connect the USB drive to the first USB port of the controller (the one closest to the Ethernet connectors) and turn on the controller.
  7. If the USB drive is correctly recognized and the wb6_update file is found in the root.fit, the controller led will start flashing orange frequently. At this point, you need to press the FW button on the controller Board and hold it for about a second.
  8. The controller led should start blinking red, then green more often than in normal operation.
  9. Wait for the update process to finish, it will take about 5 minutes. During the upgrade, the controller will reboot once. The upgrade is complete when the controller led starts flashing green as in normal operation. You can remove the USB drive.


The Wiren Board 6 factory reset

ВНИМАНИЕ: при сбросе все пользовательские данные (конфигурация, правила, файлы в домашней директории) будут уничтожены!

ВНИМАНИЕ: сбросить к заводским настройкам можно ТОЛЬКО через USB-накопитель с ОСОБЫМ именем файла прошивки.

Для сброса к заводским настройкам применяется такой же алгоритм, как при обычном обновлении c USB-накопителя, НО со следующими уточнениями:

  1. Файл на USB-накопителе нужно назвать wb6_update_FACTORYRESET.fit (имя файла должно быть именно таким!);
  2. После нажатия на кнопку FW через некоторое время контроллер начнёт издавать писк, а светодиод начнёт часто мигать красным. В этот момент требуется зажать кнопку FW более чем на 4 секунды. Писк станет прерывистым. Пока писк и мигание продолжаются, кнопку нужно держать нажатой. Когда писк и мигание прекратятся, кнопку можно отпустить. Это нажатие требуется для подтверждения сброса настроек.


Перезапись прошивки Wiren Board 5

Для Wiren Board 5 см. Wiren Board 5: Восстановление прошивки.

Для других версий контроллера см. Создание microSD-карты с образом.


Информация для разработчиков

Информация о внутреннем устройстве системы обновлений находится на отдельной странице.