Skip to content

Latest commit

 

History

History
331 lines (194 loc) · 10.5 KB

build.md

File metadata and controls

331 lines (194 loc) · 10.5 KB
Raw

SD-Cardイメージの作成方法

必要な環境

  • Windows / macOS / Linux
  • GitHubにアクセスできる環境
  • Dockerが実行可能な環境

※ 以下の手順はmacOS Sonomaで動作確認済みです。

ビルド手順

適当なディレクトリで以下のコマンドを実行します。 macOSの場合はDockerの起動にLimaを使用します。 事前にLima、Docker CLI、docker-composeをインストールしておいてください。

git clone https://github.com/mnakada/atomcam_tools
cd atomcam_tools
make lima  # macOSのみ
make

環境によりますが、約1時間でatomcam_tools/atomcam_tools.zipが生成されます。

以下のファイルが含まれます:

  • authorized_keys
  • hostname
  • factory_t31_ZMC6tiIDQN
  • rootfs_hack.squashfs

リモートログインを行う場合は、SSHの公開鍵をauthorized_keysに追加してください:

cat ~/.ssh/id_rsa.pub >> ./target/authorized_keys

デバイス名を変更したい場合、hostnameを編集してください（デフォルト: atomcam）:

echo "新しいホスト名" > ./target/hostname

上記4つのファイルをSDカードにコピーし、AtomCamに挿入して起動します。

注意: 初回起動時は、スワップファイルの作成とSSHホストキーの生成のため、約40秒ほど時間がかかります。

ビルド環境はイメージ作成後、Docker上にコンテナが起動した状態になります。

コンテナに入るには以下のコマンドを使用します：

make login

Dockerコンテナを手動で起動:

make lima               # macOSの場合
docker-compose up -d    # Linuxの場合

AtomCam内部の環境

このイメージでAtomCamを起動すると、glibcで生成されたMIPSEL版のLinux環境が起動します。

この環境内で/atomディレクトリ以下に本来のAtomCamシステムを起動し、chroot監獄に閉じ込めています。

システム構成は以下の通りです:

  • SoC: Ingenic T31 SoC
  • CPU: MIPS32R5 I$32K/D$32K/L2$128K
  • Kernel: Linux 3.10.14 MIPSEL

起動シーケンス

AtomCamの起動シーケンスは以下の通りです:

1. U-Boot

  • カーネルに内蔵されたinitramfsの/initディレクトリに配置されます

2. Initramfs

  • 内容はinitramfs_skeleton/ディレクトリに格納されています
  • カーネル起動時のコマンドラインで/initを実行するよう設定されています

3. ツール更新

必要に応じて、ツールの更新処理が実行されます

4. ルートファイルシステムの切り替え

  • SD-Card上のrootfs_hack.squashfsをルートにswitch_rootします
  • remountの処理を行います
  • /sbin/init（busybox）を起動します

これにより、AtomCamのカスタムファームウェアが正常に起動します。

rootfs_hack.squashfs

rootfs_hack.squashfsは、configs/atomcam_defconfigの設定でビルドされたイメージにoverlay_rootfsを重ねたものです。

起動プロセス

  1. /sbin/initがinittabに従って/etc/init.d/rcSを起動
  2. rcSが/etc/init.d/S*を順番に実行
  3. /etc/init.dの実行
  • シリアル接続時: gettyでログインプロンプトが表示
  • AtomCam: 背面LEDが青点滅から青点灯に変わるとSSHログイン可能

/etc/init.d/S16fwupdate

AtomCamのファームウェアアップデートのシーケンスが実行中の場合、その処理を代行します。

/etc/init.d/S20mountfs

overlayfsが使用できないため、bind mountでシステムのファイル/フォルダーの配置を入れ替えています。

/etc/init.d/S61atomcam

/atom/以下に本来のATOMCamのシステムと幾つかのmount-pointを共通でアクセスできるようにmountします。

その後、chrootで/atom の/tmp/system/bin/atom_init.shを呼び出します。

ここまではglibcの世界で動作しています。

/atom/tmp/system/bin/atom_init.sh

本来のAtomCamの初期化シーケンスを実行します。ここからuClibcの環境に入ります。 iCamera_app実行時にlibcallback.soを介在させ、各種パッチを適用して処理を追加しています。さらにWebHook用にログを名前付きFIFOファイル（/var/run/atomapp）に出力させています。

これを実行するとウォッチドッグが起動するため、assistとiCamera_appは停止できなくなります。

認識機能などの機能はiCamera_app内にあるわけではなく、クラウドから読み込まれて実行されているようです。

各種スクリプト

/atom/bin/mv, /atom/bin/rm

AtomCamのiCloud_appが動体検知をクラウドに送信後に削除する際のrmコマンド、1分ごとのSD-Cardへの記録ファイルを/tmpから移動するmvコマンドを置き換えて、NASへの記録やWebHookのイベントを送信するためのスクリプトです。

/scripts/cmd

iCamera_app内部パラメータや動作を変更するためのコマンドを実行するラッパーコマンドです。

/scripts/cruise.sh

AtomSwingでのクルーズ動作を実行するためのスクリプトです。

/scripts/hack_ini_reconfig.sh

バージョンアップでhack_iniの互換性がない場合に引き継ぎ処理をするためのスクリプトです。

/scripts/health_check.sh

定期的にネットワークの健全性のチェックを行うスクリプトです。

/scripts/lighttpd.sh

WebUIのlighttpdの起動処理と認証の切り替え等の処理を行うスクリプトです。

/scripts/memory_check.sh

定期的にメモリーの状態をログに記録するスクリプトです。

/scripts/motor_init

AtomSwingでモーターの初期位置動作をするスクリプトです。

/scripts/network_init.sh

ネットワークの接続をするための初期化スクリプトです。

/scripts/reboot.sh

WebUIの定期リブート設定をcrontabで指定時間に実行するためのスクリプトです。

同期してリブートを実行します。

/scripts/remove_old.sh

指定時間経過した録画データを削除するためのスクリプトです。

/scripts/rtspserver.sh

init.d/S58rtspserverとWebUIのRTSPのオン/オフから呼ばれます。

v4l2rtspserverをオン/オフします。

/scripts/samba.sh

設定に従ってSambaの起動／終了をするスクリプトです。

/scripts/set_crontab.sh

reboot.shやtimelapse.shを起動する時刻をcrontabに設定するためのスクリプトです。

/scripts/set_icamera_config.sh

iCamera_app起動直後に設定しておくべき設定値を処理するためのスクリプトです。

/scripts/timelapse.sh

タイムラプスの開始処理、終了時のファイル処理のスクリプトです。

/scripts/webcmd.sh

/var/www/cgi-bin/exec.cgiから名前付きFIFO経由でコマンドを実行します。

CGIの実行はwww-dataアカウントでの実行なのでシステム制御系のコマンドは直接実行できないため、コマンドを受けて実行して問題ないものだけ実行する構造にしています。

/scripts/webhook.sh

iCamera_appのログを受けてWebHookのイベントを拾っています。

iCamera_appの実行環境では制限があるため、名前付きFIFO経由でログを受けて必要に応じてcurlでポストしています。

/var/www/cgi-bin/cmd.cgi

WebUIからのコマンドを名前付きパイプ経由でwebcmd.shに渡しています。

/var/www/cgi-bin/get_jpeg.cgi

WebUIで表示するJPEG画像を取得しています。

/var/www/cgi-bin/hack_ini.cgi

WebUIで使用している設定値の取得、設定をします。

/var/www/cgi-bin/hello.cgi

モバイルアプリからのアクセス時の要求に応答するためのCGIです。

/var/www/cgi-bin/video_isp.cgi

カメラ設定の詳細設定項目を操作するCGIです。

/var/www/cgi-bin/watermark.cgi

システム設定のロゴを設定するためのCGIです。

WebUI

web/ディレクトリ以下にWebUIのソースコードがあります。 WebUIはVue.jsとElementUIで記述しています。 ターゲット環境はMIPSELなのでNode.jsの最新のバージョンは未対応です。

そのため、フロントエンド側のみビルドして、バックエンド側はlighttpdとCGIで対応し、フロントエンドからaxios経由でアクセスする構造にしています。

WebUIの画面はweb/source/vue/Setting.vueに記述しています。

Docker環境

Docker環境では /src が atomcam_tools/ にマップされています。

以下、基本的にDocker内のコマンドは下記のディレクトリから実行します:

root@ac0375635c01:/atomtools# cd /atomtools/build/buildroot-2016.02

rootfsはglibc環境でDocker内のgccを使用します。 ビルド時にgccも生成されます。

gccのプレフィックスは以下の通りです: /atomtools/build/buildroot-2016.02/output/host/usr/bin/mipsel-ingenic-linux-gnu-

ATOMCam本来のシステムのカメラアプリiCamera_appはuClibc環境でビルドされています。 そのため、iCamera_appのハック用のlibcallback.soのビルドにはuClibc環境が必要です。 別途cross tools-ng-1.26.0を導入しています。

uClibc用gccのプレフィックスは以下の通りです: /atomtools/build/cross/mips-uclibc/bin/mipsel-ingenic-linux-uclibc-

各種変更時のビルド方法

initramfs, kernelのconfigを変更した場合

make linux-rebuild
make

これでビルドされ、atomcam_tools/targetにコピーされます。

rootfs内のファイルやbusyboxのmenuconfigを修正した場合

make

これでビルドされ、atomcam_tools/targetにコピーされます。

rootfsに含まれるパッケージを変更した場合

make menuconfig
make

これでビルドされ、atomcam_tools/targetにコピーされます。

個別のパッケージをリビルドする場合

make <package>-rebuild
make

busyboxのコマンド等の設定を変更する場合

make busybox-menuconfig
make

これでrootfsがビルドされます。

kernelの設定を変更する場合

make linux-menuconfig
make linux-rebuild
make

これでビルドされ、atomcam_tools/targetにコピーされます。