Сборка образов прошивки/en

A special set of scripts has been prepared to build the controller firmware images. The image build process consists of two steps:

1. Preparing the root filesystem (rootfs)
2. Build an image to upload to the controller

The scripts are located in the wirenboard repository. Then the paths will be indicated from the repository folder

Build an image to upload to the controller

Preparing rootfs

The script for preparing the root FS is located in the rootfs folder.

How to use create_rootfs.sh script:

 $ ./create_rootfs.sh <path_to_new_rootfs> <board_ver> [<list of additional repos>]

Here:

• path_to_new_rootfs - the name of the directory in which to create the root filesystem. The directory will be created automatically;
• board_ver - controller revision version. Valid values:
  • 5 - for Wiren Board 5
  • 55 - for Wiren Board 5.5
  • 4 - for Wiren Board 4
  • 32 - for WB Smart Home (3.2)
  • 28
  • NETMON
  • MKA3
  • CQC10
  • MKA31
  • AC-E1
• list of additional repos -addresses of additional repositories with test packages (see below). This parameter is optional.

Example. Build basic (without additional repositories) root FS in the directory rootfs/rootfs for Wiren Board 5.5:

 $ cd rootfs
 $ ./create_rootfs.sh ./rootfs/ 55

Additional repositories

Additional repositories are necessary if you want to add your own versions of packages to the root FS being built.

Only the address of the repository are sent to the script. For example:

 $ ./create_rootfs.sh ./rootfs/ 55 http://server1.net/ http://server2.net:8086/

The format of the repositories corresponds to the one created by the wbrepo utility. Specifically, the additional repository has the following requirements:

• The repository server root must contain the public GPG key in the /repo file.gpg.key. For example, if the repository is located at http://localhost:8086/, then the key should be available via link http://localhost:8086/repo.gpg.key
• name - testing
• component used - main

E.g., if the repository address is passed http://localhost:8086/, then in sources.list it will be presented as

 deb http://localhost:8086/ testing main

Сборка образа для загрузки на контроллер

TODO: раздел требует дополнения

Скрипты для сборки образов находятся в директории images. Перед сборкой образа необходима готовая корневая ФС.

Дополнительно на хост-машине потребуются утилиты (названия приведены для Debian/Ubuntu):

• kpartx
• device-tree-compiler
• u-boot-tools

Пример: собираем образ прошивки для Wiren Board 5, корневая ФС находится по пути rootfs/rootfs/:

 $ cd image
 $ ./create_images_wb5.sh ../rootfs/rootfs/ <tag>

Здесь tag - суффикс, который будет добавлен к имени файла образа.

Готовый образ будет лежать по пути image/image/wb5/<current_datetime>/<current_datetime>_emmc_<tag>.img.

См. также

• Обновление прошивки
• Wiren Board 5: Восстановление прошивки