工場でのビルドとテスト

ここでは、Modalix ベースのボードを工場で製造およびテストするための推奨プロセスを説明します。お使いのボード、テスト治具、組み立てラインに合わせて調整してください。

物理的な組み立て
電気的な検証
ボード ID と MAC アドレスを書き込む
テストステーションをセットアップする
テストイメージを起動する
診断を実行する
量産用イメージを書き込む
アプリケーションテスト、ラベル貼付、梱包

シリアルコンソール

Modalix ボードには 2 つのシリアルコンソールがあります。どちらも 115200 ボー、ハードウェアフロー制御無効で動作します。

コンソール	用途
tRoot UART（セキュアブート）	ボード ID と MAC アドレスの書き込み、tRoot アップデートのメッセージ
U-Boot/Linux UART	U-Boot コマンド、Linux へのログイン、およびこのページのすべてのテスト

それぞれのコネクターはボードによって異なります。リファレンスキャリアボードについては、キャリアボードの立ち上げに記載されている UART の役割を参照してください。ホストから各コンソールに接続します。例：

sima-user@sima-user-machine:~$ minicom -b 115200 -D /dev/ttyUSB0

デバイス名（/dev/ttyUSB0、/dev/ttyUSB1）は、ホスト上でケーブルがどのように認識されるかによって異なります。

物理的な組み立て

この工程は、お使いのボードと生産フローによって異なります。ヒートシンクの取り付け、ボードの筐体やテスト治具への設置などが含まれます。

電気的な検証

すべての主要電源レールのアクセスポイントを一覧にし、各レールのインピーダンスを測定してオープンやショートがないことを確認します。
測定可能な電圧を一覧にし、すべてのボード、または各ロットのサンプルボードについて記録します。
測定可能なクロックを確認し、各シリアル番号に対して記録します。

ボード ID と MAC アドレスを書き込む

ボード ID（デバイス ID とも呼ばれます）と MAC アドレスは、特別な tRoot ファームウェアによって MLSoC のワンタイムプログラマブル（OTP）メモリに書き込まれます。

OTP の値は変更できません

OTP メモリには一度しか書き込めません。確定する前に各値を確認してください。

ホストを tRoot UART に接続します。
SPI フラッシュプログラマーを接続してから、電源を接続します。
tRoot SPI フラッシュに書き込むの手順に従って、 OTP 書き込み用の tRoot ファームウェアを SPI フラッシュに読み込みます。
電源を外し、SPI フラッシュプログラマーを取り外してから、電源を再接続します。
tRoot コンソールでボード ID を 16 進数で入力して確定し、続けて MAC アドレスを入力します。
```
enter hwid in hex format(ex:0x00010012)
hwid entered is 0x123
Press (Y/N)
burning hwid
Configured HWID :: 0x123
Activated ID Selector :: 1
Enter mac addr in format (A0:B1:C2:D3:E4:F5)
```
MAC アドレスを入力すると、ボードはすぐにブートシーケンスを完了します。
ボードの電源を入れ直し、起動すること、およびボード ID が書き込み済みであると表示されることを確認します。
tRoot SPI フラッシュに書き込むの手順に従って、量産用の tRoot ファームウェアを SPI フラッシュに読み込みます。

tRoot SPI フラッシュに書き込む

tRoot ファームウェアは単一のバイナリ troot_blob.be です。書き込むのは、上記で使用した OTP 書き込み用ファームウェアか、量産用ファームウェアのいずれかです。SiMa.ai では、Total Phase Aardvark I2C/SPI ホストアダプターと Total Phase Flash Center ソフトウェアの使用をお勧めします。

ホストに Flash Center をインストールします。
プログラマーをボードの SPI フラッシュヘッダーに接続します。このコネクターはボードによって異なり、通常は 2 列のヘッダーです。
Flash Center を起動します。この手順を自動化したい場合は、コマンドラインツールも用意されています。
アダプターを追加します。
ターゲットデバイスを選択します。SPI Flash を選択し、次にボードに実装されている部品（例：Winbond W25Q16（2 MB））を選択します。
troot_blob.be を読み込みます。
フラッシュに書き込みます。

テストステーションをセットアップする

テスト対象のボードにキャリアボードやインターフェースボードが必要な場合は、それを接続します。
ホストを tRoot UART と U-Boot/Linux UART の両方に接続します。
ボードにイーサネットポートがある場合は、それぞれをホストに接続します。
ボードに MIPI カメラ入力がある場合は、テスト用カメラを接続します。
ボードが PCIe カードの場合は、ホストの x8 幅以上の PCIe Gen5 スロットに取り付けます。

テストイメージを起動する

イメージを eMMC に書き込むの説明に従って、最新リリースのテストファームウェアを SD カードまたはネットワークから起動します。 SD カードをお勧めします。イーサネットポートが空くため、ネットワークのストレステストに使用できます。

診断を実行する

手順は次のとおりです。アイドル時の温度を記録し、ストレステストを実行し、最終的な温度を確認してから、各 I/O インターフェースを確認します。

すべてのテストは U-Boot/Linux コンソールで実行します。ボードの電源を入れ、Linux のプロンプトが表示されるまで待ってから、ユーザー sima、パスワード edgeai でログインし、root になります。

sima@modalix:~$ sudo su

ボードにイーサネットがある場合は、ボードのポートごとに 1 つずつホストにアドレスを割り当てます。たとえば、ホストのインターフェースが eno1 の場合は次のようにします。

sima-user@sima-user-machine:~$ sudo ifconfig eno1:1 192.168.1.10 up
sima-user@sima-user-machine:~$ sudo ifconfig eno1:2 192.168.2.10 up
sima-user@sima-user-machine:~$ sudo ifconfig eno1:3 192.168.3.10 up
sima-user@sima-user-machine:~$ sudo ifconfig eno1:4 192.168.4.10 up

PCIe カードの場合は、ホストの電源を入れる前に、カードから外部電源をすべて取り外してください。カードにはスロットから給電されます。

1. アイドル時の温度

simaai_modalix_thermal_sensor という名前の hwmon デバイスを探します。

root@modalix:~# grep -l simaai_modalix_thermal_sensor /sys/class/hwmon/hwmon*/name

その temp1_input を 10 回読み取り、平均します。値の単位は 1/1000 ℃ です。 X は見つかった番号に置き換えてください。

root@modalix:~# for i in $(seq 10); do cat /sys/class/hwmon/hwmonX/temp1_input; done | awk '{s+=$1} END {print s/NR/1000 " C"}'

2. イーサネット

ホストで iperf3 サーバーを起動します。

sima-user@sima-user-machine:~$ iperf3 -s

ボード上で、イーサネットポートごとにクライアントを実行します。

root@modalix:~# iperf3 -c 192.168.1.10 -t 60 --logfile /tmp/iperf1   # end0
root@modalix:~# iperf3 -c 192.168.2.10 -t 60 --logfile /tmp/iperf2   # end1
root@modalix:~# iperf3 -c 192.168.3.10 -t 60 --logfile /tmp/iperf3   # end2
root@modalix:~# iperf3 -c 192.168.4.10 -t 60 --logfile /tmp/iperf4   # end3

3. メモリ

root@modalix:~# stress-ng --class memory --all -1 --log-file /tmp/memorytest --log-brief --verify --abort -x atomic,heapsort,judy,mergesort,radixsort,tree,wcs,zlib -t 370s

4. CPU キャッシュ

root@modalix:~# stress-ng --class cpu-cache --seq 2 -t 8s --log-brief --log-file /tmp/cpucache

5. CPU

root@modalix:~# stress-ng --cpu 0 --verify -t 1m --log-brief --log-file /tmp/cpu0

--cpu 0 はすべての CPU で実行されます。結果には 16 個の CPU が表示される必要があります。

6. 最終的な温度

アイドル時の温度と同じ方法で温度を再度読み取り、ボードの熱的な限界値と照らし合わせて確認します。

7. PCIe ループバック

ホストに sima_pcie_hostpkg.sh をインストールしてから、対応するバイナリでボードを起動します。
ボードが起動したら、ボードのコンソールで次を実行します。
```
root@modalix:~# sima_pep_test
```

ホストで 1 MB のテストファイルを作成し、ループバックテストを開始します。

sima-user@sima-user-machine:~$ dd if=/dev/urandom of=~/data1MB.bin bs=1M count=1
sima-user@sima-user-machine:~$ sima_mla_test -Q 1 -q 0 -e 32 -i 8 -d ~/data1MB.bin

ホストには、送信フレーム数と受信フレーム数を含む成功メッセージが表示されます。

8. MIPI カメラ

テスト対象のポート用のカメラオーバーレイを読み込みます。再起動して自動ブートを中断し、 dtbos を設定します。オーバーレイ名の形式は modalix-som-<carrier>-<camera>-<port>.dtbo です。Modalix DevKit の最初のカメラポートに Arducam IMX477 を接続する場合は次のとおりです。
```
sima$ env set dtbos modalix-som-waveshare-ARDU-IMX477-1CAM.dtbo
sima$ saveenv
```
オーバーレイは、カメラ、ポート、ボードごとに異なります。 MIPI カメラインターフェースを参照してください。
テスト対象の各ポートに IMX477 カメラを接続し、電源を入れ直してログインし、 sudo su を実行します。
RAW フレームをキャプチャーしてから、ISP 出力を開始します。video0raw と video0out は、テスト対象のポートに合わせて変更してください。
```
root@modalix:~# gst-launch-1.0 v4l2src device=/dev/video0raw ! 'video/x-bayer,format=rggb12le,width=2048,height=1080,framerate=30/1' ! queue ! multifilesink location=/tmp/mipi_in_%d.raw12 &
root@modalix:~# gst-launch-1.0 v4l2src device=/dev/video0out ! 'video/x-raw,format=RGB,width=2048,height=1080,framerate=30/1' ! fakesink
```
最初のパイプラインは /tmp に毎秒 30 個のファイルを書き込みますが、その容量は限られています。約 10 秒で停止してください。Ctrl+C を押して 2 番目のパイプラインを停止し、次に fg を実行してから Ctrl+C を押して最初のパイプラインを停止します。

9. SD カード

ボードを SD カードから起動した場合は、このテストをスキップしてください。それ以外の場合は、SD カードを挿入してストレージテストスクリプトを実行します。SD カードには 1 を選択し、次に簡易スループットテストには 2、カード全体の読み書きには 3 を選択します。

root@modalix:~# /usr/bin/simaai_pt/emmc_sd_test.sh
Enter 0 - /dev/mmcblk0 (eMMC) or 1 /dev/mmcblk1 (SD card)
Choice: 1
1) Test 1: Memory Operations
2) Test 2: Throughput Measurement
3) Test 3: Whole memory read and write
4) Test 4: sd_card insertion and connection back
Enter your choice (1 or 2 or 3 or 4): 2
Throughput: 11.3099 MB/s

10. eMMC

警告

このテストは eMMC を上書きします。ボードがネットワークまたは SD カードから起動している場合にのみ実行し、その後で量産用イメージを書き込んでください。

同じスクリプトを実行し、eMMC には 0 を選択してから、2 または 3 を選択します。

11. ディスプレイと USB

ボードにディスプレイ出力がある場合は、eLxr イメージをネットワークまたは SD カードから起動します。 USB キーボードとマウスを接続し、デスクトップが 1920×1080 で表示されることを確認します。コンソールと同じ認証情報を使用して、キーボードとマウスでログインします。

12. NVMe

NVMe ドライブを取り付けた状態で、ドライブが検出されることを確認し、ダイレクト読み取り速度を測定します。

root@modalix:~# nvme list
root@modalix:~# hdparm -tT --direct /dev/nvme0n1

ドライブのフォーマットとマウントについては、 NVMe ストレージの設定を参照してください。

13. tRoot のセルフアップデート

このテストでは、swupdate を使用して tRoot アップデートパッケージをインストールします。

量産用の troot-upgrade-simaai-ev.swu をボードの /tmp にコピーします。
tRoot コンソールと U-Boot/Linux コンソールの両方を接続したままにします。

U-Boot/Linux コンソールで、root として次を実行します。

root@modalix:~# swupdate -v -H simaai-image-troot:1.0 -i /tmp/troot-upgrade-simaai-ev.swu

tRoot コンソールの出力が 5 分以内に停止することを確認します。

量産用イメージを書き込む

イメージを eMMC に書き込むの説明に従って、最新リリースの量産用イメージを eMMC に書き込み、ボードが eMMC から起動することを確認します。

アプリケーションテスト、ラベル貼付、梱包

これらの手順は製品によって異なります。

シリアルコンソール​

物理的な組み立て​

電気的な検証​

ボード ID と MAC アドレスを書き込む​

tRoot SPI フラッシュに書き込む​

テストステーションをセットアップする​

テストイメージを起動する​

診断を実行する​

1. アイドル時の温度​

2. イーサネット​

3. メモリ​

4. CPU キャッシュ​

5. CPU​

6. 最終的な温度​

7. PCIe ループバック​

8. MIPI カメラ​

9. SD カード​

10. eMMC​

11. ディスプレイと USB​

12. NVMe​

13. tRoot のセルフアップデート​

量産用イメージを書き込む​

アプリケーションテスト、ラベル貼付、梱包​