開発の基本的な流れ

デフォルトでは、Podmanのデータはtmpfsに保存されます。そのため、再起動すると消えてしまいます。 eMMCにデータを保存するには、以下のコマンドを実行してください。

[armadillo ~]# podman_switch_storage --disk
Creating configuration for persistent container storage
Create subvolume '/mnt/containers_storage'
[ 2145.288677] EXT4-fs (mmcblk2p1): re-mounted. Opts: (null)
[ 2145.294132] ext4 filesystem being remounted at /dev/shm/overlay_etc_lower supports timestamps until 2038 (0x7fffffff)
[ 2145.335848] EXT4-fs (mmcblk2p1): re-mounted. Opts: (null)
[ 2145.341398] ext4 filesystem being remounted at /dev/shm/overlay_etc_lower supports timestamps until 2038 (0x7fffffff)
[ 2145.386884] EXT4-fs (mmcblk2p1): re-mounted. Opts: (null)
[ 2145.392350] ext4 filesystem being remounted at /dev/shm/overlay_etc_lower supports timestamps until 2038 (0x7fffffff)
[armadillo ~]# podman_switch_storage --status
Currently in disk mode, run with --tmpfs to switch

ベースとなるOSを取得します。alpineやdebian等、任意の環境でアプリケーションを作成することができます。

ベースとなる OS はイメージの公開・共有サービスである Docker Hub から取得することができます。目的に合わせて選択してください。

マルチメディアや機械学習を行うアプリケーションを作成する場合は、アットマークテクノが配布しているdebianコンテナがおすすめです。

開発中のアプリケーションがデバイスを利用する場合は、コンテナにデバイスを渡す必要があります。

podman run コマンドに --device オプションでデバイスファイルを指定します。

	--privileged オプションを指定するとすべてのセキュリティーメカニズムが無効になる為、全てのデバイスが利用できるようになります。このオプションを利用することは、セキュリティー上問題がある為、デバッグ用途でのみご利用ください。

アプリケーションからデータを保存する場合は、eMMCに保存する必要があります。コンテナ自体のデータは基本的にRAMに保存されているか書き込み不可であるため、再起動すると消えてしまいます。

保存するデータの性質によって、保存先を選択してください。

	不具合が発生したなどの理由でコンテナを前のバージョンに戻(ロールバック)した場合、/var/app/rollblack/volumes/のデータの前のバージョンに戻ります。その為、アプリケーションのバージョンに依存するようなデータは、/var/app/rollblack/volumes/に保存しておくと管理が容易になります。

「アプリケーションをコンテナで実行する」を参考にして、オリジナルのアプリケーションを開発します。

コンテナが完成したら、 podman commit コマンドを実行してPodman内のストレージに保存します。詳しい手順は「コンテナの変更を保存する」を参考にしてください。

podman_start用の設定ファイル(/etc/atmark/containers/*.conf)を作成します。その後、 podman_start -a コマンドを実行するか、armadilloを再起動してコンテナが自動起動することを確認してください。

まず、コンテナをコンテナレジストリに送るか、 podman save コマンドを実行してアーカイブを作成します。次にswupdate-mkimageに組み込むと送信できるようになります。

[armadillo ~]$ git clone https://github.com/atmark-techno/swupdate-mkimage
[armadillo ~]$ cd swupdate-mkimage
[armadillo ~]$ cat examples/pull_container_nginx.desc
swdesc_pull_container "docker.io/nginx:alpine" --version container_nginx 1
swdesc_tar nginx_start.tar --version extra_os.nginx 1
[armadillo ~]$ ./mkimage.sh -o pull_container_nginx.swu examples/pull_container_nginx.desc

詳しい手順は「Armadilloのソフトウェアをアップデートする」を参考にしてください。

最終確認として、クリーンインストールを行います。「Armadilloのソフトウェアの初期化」を参照し、Armadillo Base OSを初期化してからアプリケーションをアップデートしてください。

アップデートを行う方法は以下の二通りです：

自動的にイメージを作る方法は「コンテナの自動作成やアップデート」を参考にしてください。

ライブラリのビルドツールを実行する準備として、gitのユーザ名とメールアドレスの設定を行い、必要なソフトウェアをインストールします。

[ATDE ~]$ git config --global user.name "Your name"
[ATDE ~]$ git config --global user.email your@mail.tld
[ATDE ~]$ sudo apt install libdrm2:arm64 libwayland-client0:arm64 libwayland-server0:arm64 \
libwayland-cursor0:arm64 libwayland-egl1:arm64 libxdamage1:arm64 \
libxext6:arm64 libxfixes3:arm64 libx11-6:arm64 linux-imx-headers \
libdrm-dev:arm64 libstdc++6:arm64 cmake

次に、ATDE 上で動作するビルドツールである、 Armadillo-IoT ゲートウェイ G4 開発用ツール から 「VPU/NPUライブラリビルドツール」ファイル (at-imxlibpackage-[VERSION].tar.gz) をダウンロードしてください。

その後、ビルドツールを展開して実行します。

実行中にライセンスへの同意を求められます。内容を確認の上、同意する場合は y を入力して処理を進めてください。

[ATDE ~]$ tar xzf at-imxlibpackag-[VERSION].tar.gz
[ATDE ~]$ cd at-imxlibpackage-[VERSION]
[ATDE ~/at-imxlibpackage-[VERSION]]$ ./make-imxlibpkg

実行が完了すると、ATDE にクロスコンパイル用のライブラリがインストールされます。

以下に示す製品では、出荷状態でライブラリイメージが Armadillo に書き込まれています。

ライブラリをアップデートする手順を説明します。

Armadillo Base OS 上のコンテナ内から利用できるイメージを作成します。

[ATDE ~]$ cd at-imxlibpackage-[VERSION]
[ATDE ~/at-imxlibpackage-[VERSION]]$ ./make-imxlibimage

VPU を使用しない場合は、--without-vpu オプションを付けてください。

[ATDE ~]$ cd at-imxlibpackage-[VERSION]
[ATDE ~/at-imxlibpackage-[VERSION]]$ ./make-imxlibimage --without-vpu

実行が完了すると imx_lib.img というファイルが生成されます。

Armadillo Base OS 上で、「Armadillo へ書き込むためのライブラリイメージを作成する」で作成した imx_lib.img を eMMC の /dev/mmcblk2p4 パーティションに書き込みます。

次のコマンドは、 imx_lib.img が /tmp にある場合の実行例です。

[armadillo ~]$ umount /opt/firmware
[armadillo ~]$ dd if=/tmp/imx_lib.img of=/dev/mmcblk2p4 bs=1M conv=fsync
23+1 records in
23+1 records out
24965120 bytes (25 MB, 24 MiB) copied, 0.357741 s, 69.8 MB/s

書き込みが完了した後、/opt/firmware にマウントします。

[armadillo ~]$ mount /opt/firmware

コンテナ内からライブラリを使用するためには、コンテナ作成時にライブラリの場所を明示する必要があります。

--volume オプションにファームウェアが書き込まれているディレクトリ(/opt/firmware)を、--env オプションにライブラリのパスを指定します。次の例では、コンテナイメージに Debian(bullseye) を利用しています。

[armadillo ~]$ podman run -it --name=container_name \
--volume=/opt/firmware:/opt/firmware \ 
--env=LD_LIBRARY_PATH=/opt/firmware/usr/lib/aarch64-linux-gnu \ 
docker.io/debian:bullseye /bin/bash

次に、コンテナにログインし、/opt/firmware/usr/lib/aarch64-linux-gnu/imx-mm へのシンボリックリンクを /usr/lib/aarch64-linux-gnu/ に作成します。

[armadillo ~]$ podman exec -it container_name /bin/bash
[conteiner ~]# ln -s /opt/firmware/usr/lib/aarch64-linux-gnu/imx-mm /usr/lib/aarch64-linux-gnu

以上で、コンテナからライブラリを使用できるようになります。