misc notes

Arduino Yun cheat sheet: Difference between revisions

Page Discussion

Arduino Yun cheat sheet (view source)

Revision as of 17:07, 12 March 2019

55,369 bytes added ,  12 March 2019
→‎YUN と SPI と RX LED
 
(850 intermediate revisions by the same user not shown)
Line 1: Line 1:
Arduino Yún / Arduino Yun
Arduino Yún / Arduino Yun
= はじめに =
= はじめに =
arduino Uno である程度なれたし、プロトタイプつくったので、そろそろ TCP/IP 喋る段階になって、Arduino Yun に挑戦してみた。
Arduino Uno である程度なれたし、プロトタイプつくったので、そろそろ TCP/IP 喋る段階になって、技適もとれた Arduino Yun に挑戦してみた。
:インターネットに接続して AWS 上にある time series database に計測データをストア。(いわゆる IoT ですかね 火暴)
:インターネットに接続して AWS 上にある time series database に計測データをストア。(いわゆる IoT ですかね 火暴)
:[https://aws.amazon.com/jp/iot/ AWS IoT] なるものも触ってみたかったし。
:[https://aws.amazon.com/jp/iot/ AWS IoT] なるものも触ってみたかったし。
Uno で足慣らししたし、結構簡単に Yun に移行できるかと思っていたら、なかなか結構大変(現在も学習中)なのでいろいろメモメモ。
ダガシカシ、簡単に Yun に移行できるかと思っていたら、なかなか結構大変(現在も学習中)なのでいろいろメモ。


== どっち? ==
== SRL と LLC ==
SRL:
[http://www.arduino.org/ http://www.arduino.org/]
[http://labs.arduino.org/Arduino%20Yun Arduino | Labs | Arduino Yún]
[https://github.com/arduino-org https://github.com/arduino-org]
[http://download.arduino.org/products/YUN/YUN-V04(20150114).pdf Schematic]


  SRL [http://www.arduino.org/ http://www.arduino.org/]
LLC:
  SRL [http://labs.arduino.org/Arduino%20Yun Arduino | Labs | Arduino Yún]
  [https://www.arduino.cc/ https://www.arduino.cc/]
  [https://www.arduino.cc/en/Guide/ArduinoYun Arduino - ArduinoYun]
[https://github.com/arduino https://github.com/arduino]
[https://www.arduino.cc/en/uploads/Main/arduino-Yun-schematic.pdf Schematics]


LCC [https://www.arduino.cc/ https://www.arduino.cc/]
私がスイッチサイエンス社から購入した Yun は製造は SRL。Atheros AR9331 に組み込まれていたのが Linino ではなく OpenWrt-Yun なので LLC 。
LCC [https://www.arduino.cc/en/Guide/ArduinoYun Arduino - ArduinoYun]


私がスイッチサイエンス社から購入した Yun は製造は SRL 、Atheros AR9331 に組み込まれていたのが OpenWrt-Yun なので LCC 。
実際 github 上の動きをみても LLC のほうが好ましい。  
:ということは、ソフトウェアは LCC を見た方が良いという思し召しか。
:IDE も LLC 版は Java8 に上がっている。
実際 github 上の動きをみても LCC のほうが好ましい。  
::ウェブサイトも LLC は https だし。
:IDE も LCC 版は Java8 に上がってるしね。
ソフトウェアは LLC を信頼したほうが良いと思われる。(最近 SRL の github が活発になってきた。stay, tuned)
::ウェブサイトも LCC は https だし。


SRL [https://github.com/arduino-org https://github.com/arduino-org]
回路図も微妙に違うような...


LCC [https://github.com/arduino https://github.com/arduino]
'''朗報! Two Arduinos Become One [http://www.arduino.org/blog/two-arduinos-become-one http://www.arduino.org/blog/two-arduinos-become-one]'''


:ソフトは LLC を見た方がよさそう。（しかし分裂なんとかしてよ...)
'''おや！ LLC 版の Yún が変わった [https://www.arduino.cc/en/Main/ArduinoBoardYun Arduino Yún LininoOS]'''
:2016年12月2日にウェブサイトが更新された模様。SRL と LLC 和解の成果か。
::2014年10月以降に出荷された Yún は LininoOS だったと。(歴史改ざんしてる気がするｗｗｗ)
::おそらく(大人の事情で) LLC で Yún の出荷がとまった(Web から消えた)のが 2014年10月ごろか...
::その後 LLC では Yún Shield なる製品が出荷されて LininoOS ではなく OpenWrt-Yun が載ってたはず。
::この Yún Shield も(大人の事情で)出荷がとまった(Web から消えた)が、現在は出荷されている。技適とれてないので日本では触れない。
:::なので'''本サイトの以下↓の情報は古い'''です。(LEDE + Arduino-OS + Ciao のファーム作るか...)
::::[[#Arduino_Y.C3.BAn_LininoOS_.E5.B7.AE.E5.88.86|差分を追っかけてみる]]
 
== 諸注意 ==
Arduino Yun は Atmel ATmega32U4 と Atheros AR9331 の二つのマイコンがあり、それぞれソフトウェアが稼働する。さらに開発環境のコンピュータもあるので、以下の記事中のコード等がどの環境の話かを区別できるように ('''"Leonardo"''') ('''"OpenWrt"''') ('''"開発環境"''') を入れるようにした。明らかに区別できるものは注記はいれていない。
:ATmega32U4 マイコン部をどう言うのがわかりやすいかを考えて、結局 '''Leonardo''' と呼ぶことにした。
 
検証機 ハードウェアは SRL 製。
 
ソフトウェアの情報は LLC に合わせている。
 
Arduino Yun の面白さ(逆に難しさ)はマイコン屋の知識と、UNIX屋・ネットワーク屋の知識と、Web屋の知識がすべて必要なところ。それぞれの専門家からみたら他方はブラックボックスに見えて理解の妨げになっているようだ。Arduino Yun の使い方・付き合い方は多方面から見てあげることが大切だ。


= 導入 =
= 導入 =
== 電源 ==
== 電源 ==
Uno では(ACアダプターからの)DC入力ジャック(5.5mm/2.1mm Center Plus | 7～12V) があったが Yun には無い。
Uno では(ACアダプターからの)DC入力ジャック(5.5mm/2.1mm Center Plus | 7～12V) があったが Yun には無い。
:micro-USB から 5V 供給するのが推奨。Ethernet RJ45ジャックが PoE 対応なのでこれでも可。VIN pin に定電圧レギュレータの5Vをいれるのも可。
 
#micro-USB から 5V 供給するのが推奨。
#(びみょうに斜めに付く) PoE モジュールをつければ Ethernet RJ45ジャックから給電も可。
#VIN pin に定電圧レギュレータの5Vをいれるのも可。


== USB Serial ==
== USB Serial ==
Yun は Arduino Leonardo（ATmega32u4）ベースに作られている。Uno のように USB 通信用のペリフェラル(ATmega16U2がUSBを受け持つ)をもっていない。そこで大きな使い勝手の差がある。
Yun は Arduino Leonardo（ATmega32U4）ベースに作られている。Uno のように USB 通信用のペリフェラル(ATmega16U2がUSBを受け持つ)をもっていない。そのかわりに ATmega32U4 は USB 制御器を内蔵している(Uno の ATmega328P にはその回路はない)。そこで大きな使い勝手の差がある。
 
micro-USB ケーブルには充電専用というのが紛れ込んでいるので要注意。


紐をほどくために Arduino Leonardo ガイドの日本語訳
紐ほどくために Arduino Leonardo ガイドの日本語訳
  [http://trac.switch-science.com/wiki/Guide/ArduinoLeonardo Guide/ArduinoLeonardo – スイッチサイエンス]
  [http://trac.switch-science.com/wiki/Guide/ArduinoLeonardo Guide/ArduinoLeonardo – スイッチサイエンス]


ハードウェア構成が違うので Leonardo とも微妙な差異があるが、ほぼ同様とはいえる。
== OpenWrt WiFi 設定 ==
工場出荷状態なら、WiFi AP モードで Yun (OpenWrt) が起動するので、開発環境からそのアクセスポイントに接続してごにょごにょ。SSID が WiFiの MACアドレスになっているので、もしフィルタリングをしてる場合はこれを使う。
:ご参考 : [http://takagi-hiromitsu.jp/diary/20071103.html 高木浩光＠自宅の日記 - 無線LANのMACアドレス制限の無意味さがあまり理解されていない]
初心者向け記事:
[http://mag.switch-science.com/2015/03/06/try-arduino-yun-1/ Arduino Yúnを使ってみよう (1) Yúnを設定する | スイッチサイエンス マガジン]
[http://mag.switch-science.com/2015/03/10/try-arduino-yun-2/ Arduino Yúnを使ってみよう (2) YúnをPCから操作する | スイッチサイエンス マガジン]
[http://mag.switch-science.com/2015/10/10/aws-iot-yun/ AWS IoTがリリースされました（Yúnを繋ぎました） | スイッチサイエンス マガジン]
[http://mag.switch-science.com/2015/10/13/aws-iot-yun-detail/ AWS IoTをArduino Yúnで使う（少し詳しく書いてみた） | スイッチサイエンス マガジン]
[http://mag.switch-science.com/2015/11/02/aws-s3-lambda-iot-yun/ LambdaからIoT経由でArduino Yúnへ（前編） | スイッチサイエンス マガジン]
[http://mag.switch-science.com/2015/11/02/s3-lambda-iot-yun-continued/ LambdaからIoT経由でArduino Yúnへ（後編） | スイッチサイエンス マガジン]
[http://www.eleki-jack.com/FC/2015/04/arduino-yun1.html Arduino YUNを使ってみる（1） - フィジカル・コンピューティング]
[http://www.eleki-jack.com/FC/2015/08/arduino-yun2.html Arduino YUNを使ってみる（2） - フィジカル・コンピューティング]
[http://www.eleki-jack.com/FC/2015/09/arduino-yun3.html Arduino YUNを使ってみる（3） - フィジカル・コンピューティング]
[http://www.eleki-jack.com/FC/2015/10/arduino-yun4.html Arduino YUNを使ってみる（4） - フィジカル・コンピューティング]
[http://www.eleki-jack.com/FC/2015/11/arduino-yun5.html Arduino YUNを使ってみる（5） - フィジカル・コンピューティング]
'''メモ''': 初期パスワードは '''arduino''' (ちなみに Linino の場合は '''doghunter''')
'''注意''': 開発環境が Windows の場合は [https://support.apple.com/kb/DL999?viewlocale=ja_JP&locale=ja_JP Apple から Bonjour のドライバー]をとってきてインストールしておく。
'''注意''': WiFi ルーターが「アイソレーション」「ネットワーク分離機能」「プライバシーセパレータ」等の名前の端末間通信を拒否する設定になっていると同一ネットワークに有る機器は Yun (OpenWrt) に接続できない。WiFi ルーターの該当を機能を解除する事。
'''重要''': '''TIMEZONE は正しく設定する事(Asia/Tokyo)。'''でないと技適的にまずいはず...
=== ネットワーク設定に失敗したら ===
AR9331 OpenWrt のシリアルコンソールを使って設定を修正する。
[https://www.arduino.cc/en/Tutorial/YunSerialTerminal YunSerialTerminal]
micro-USB を接続し Arduino IDE で
ファイル -> スケッチの例 -> Bridge -> YunSerialTerminal
このスケッチをコンパイルして Leonardo にアップロードする。これは、OpenWrt のコンソールを Serial1 経由で micro-USB シリアル (Serial) へつなげるプログラムである。
Arduino IDE の シリアルモニターでは使い勝手がわるいので、picocom 等で シリアルポートにつなげる。
:この状態は UNIX 端末の通常のシリアルコンソールをつかっていることになる。つまりネットワーク設定こけたらシリアル端末つなげてホゲるというルーティーンw
('''開発環境側で''')
<syntaxhighlight lang="bash" enclose="div">
picocom -b 115200 /dev/ttyS4
# for Emacsian
picocom -b 115200 -e t /dev/ttyS4
</syntaxhighlight>
:(それぞれの開発環境でのお好きなシリアルターミナルソフトでそれぞれのシリアルポート名で。ボーレートは 115200 bps)
シリアルコンソールで OpenWrt に(ログインフェーズは無しで)接続して、
('''OpenWrt側で''')
<syntaxhighlight lang="text" enclose="div">
/etc/config/arduino
/etc/config/wireless
</syntaxhighlight>
を確認して修正する。平文で WiFi のパスワードが書かれているのでこのファイルの扱いは要注意。
:もちろん [[#UCI|uci]] でも WiFi パスワードは平文。
[http://xx-prime.hatenablog.com/entry/2015/04/06/222321 Arduino Yún(OpenWRTYun)の設定情報書き出しには注意 - XX-Prime's blog]
=== 細かな設定は　LuCI で ===
WiFi の設定を解除して有線に変えるとか、PPPoE とかの詳細設定は LuCI とよばれる GUI で行う。
Arduino Webpanel にログインして、上部にある "CONFIGURE" ボタンを押して次のページに遷移し、そのページの上部にある、
advanced configuration panel (luci)
のリンクをクリックする。OpenWrt の LuCI で設定する。
Yun は WiFi ルータでよくつかわれている AR9331 を使用しており、かつ OpenWrt なので、WiFi ルータとしても十分つかえる。
== OpenWrt-Yun のアップデート ==
Arduino LLC 純正システムイメージ: [https://www.arduino.cc/en/Main/Software Other Software, ARDUINO YÚN LINUX OS OPENWRT-YÚN]
<syntaxhighlight lang="text" enclose="div">
Remember that updating the OpenWrt-Yun image will cause the loss of all files and configurations you previously saved on the flash memory of the Yún.
</syntaxhighlight>
'''注意''' : '''すべての設定やデータが消えます。'''(luci の backup / restore を使う方法もあり)
'''注意''' : '''アップデート後、もういちどWiFiの設定を最初からやり直す事。'''
'''注意''' : '''μSD カードや USB 装置は抜いておく事。'''
'''注意''' : '''/tmp (tmpfs) に大きなファイルを置くので、空きメモリーが少ない場合は不要なプロセスを落とす事。'''
導入後最初にやったほうがよさそう。(私が購入した Yun はそのままでは opkg の整合性が合わなかった)
[http://crossbar.io/iotcookbook/Arduino-Yun-Basic-Setup/ http://crossbar.io/iotcookbook/Arduino-Yun-Basic-Setup/]
[http://crossbar.io/iotcookbook/Arduino-Yun-Expanding-Disk-Space/ http://crossbar.io/iotcookbook/Arduino-Yun-Expanding-Disk-Space/]
[http://crossbar.io/iotcookbook/Arduino-Yun-System-Update/ http://crossbar.io/iotcookbook/Arduino-Yun-System-Update/]
[http://crossbar.io/iotcookbook/Arduino-Yun-Prepare-Image/ http://crossbar.io/iotcookbook/Arduino-Yun-Prepare-Image/]
[https://github.com/crossbario/crossbarexamples/blob/master/iotcookbook/device/yun/quickinstall/step1.sh step1.sh]
:crossbar.io ここがマニアックでいいかんじ。
安全のために YunSerialTerminal を使ったシリアルコンソールで作業する。(もちろん OpenWrt 側で wget するので Internet にはつながってことは前提)
('''OpenWrt側で''')
<syntaxhighlight lang="bash" enclose="div">
opkg update
opkg install unzip
### ファイルのバージョンは確認のこと
### https://www.arduino.cc/en/Main/Software
cd /tmp
wget http://downloads.arduino.cc/openwrtyun/1/YunSysupgradeImage_v1.5.3.zip
unzip YunSysupgradeImage_v1.5.3.zip
sysupgrade -v -n openwrt-ar71xx-generic-yun-16M-squashfs-sysupgrade.bin
</syntaxhighlight>
いろいろ echo されるが無視して(キーを叩かず)待ち続けること。ひたすら待つと自動的にリブートする。
:boot 時のコンソール出力(さまざまなログ)が落ち着いたところ(WiFi のログ wlan0: associated がでたところぐらい)でリターンキーを押すとプロンプトが出る。
'''心配''' : OpenWrt-yun も opkg のパッケージもアップデートが遅い。[http://www.egrep.jp/wiki/index.php/Arduino_Yun_cheat_sheet#Security すでにいろいろヤバい]
== ディスクの容量を増やす ==
必要なソフトウェアを導入したらすぐにディスクフルになるので、micro SD をつかってディスク容量を増やす。(この要因があるので Arduino Yun Mini は残念...)
[http://crossbar.io/iotcookbook/Arduino-Yun-Expanding-Disk-Space/ http://crossbar.io/iotcookbook/Arduino-Yun-Expanding-Disk-Space/]
:を参考に
::Overlayfs がポイント
:::[https://wiki.openwrt.org/doc/howto/extroot Rootfs on External Storage (extroot)]
Yun は 32GB までは対応している。できたら class 10 の micro SD カードを準備して挿入する。
:Alcor Micro AU6350-MGL USB2.0 Hub-Reader Controller が AR9331 につながっており、これがμSDのインタフェースになっている。
('''OpenWrt側で''')
<syntaxhighlight lang="bash" enclose="div">
opkg update
opkg upgrade temboo
opkg install e2fsprogs mkdosfs fdisk rsync
umount /dev/sda1
### パーティション情報を壊す
dd if=/dev/zero of=/dev/sda bs=4096 count=1000
### FAT32 に 15G、ext4 に残り
(echo o; echo n; echo p; echo 1; echo; echo +15G; echo n; echo p; echo 2; echo; echo; echo t; echo 1; echo c; echo w) | fdisk /dev/sda
mkfs.vfat /dev/sda1
# mkfs.fat /dev/sda1
mkfs.ext4 /dev/sda2
mkdir -p /mnt/sda2
mount /dev/sda2 /mnt/sda2
rsync -a --exclude=/mnt/ --exclude=/www/sd /overlay/ /mnt/sda2/
umount /dev/sda2
rm -rf /mnt/sda2
### uci というのは OpenWrt の汎用設定インターフェースシステム
### https://wiki.openwrt.org/doc/uci
uci add fstab mount
uci set fstab.@mount[0].target=/overlay
uci set fstab.@mount[0].device=/dev/sda2
uci set fstab.@mount[0].fstype=ext4
uci set fstab.@mount[0].enabled=1
uci set fstab.@mount[0].enabled_fsck=0
uci set fstab.@mount[0].options=rw,sync,noatime,nodiratime
uci commit
reboot
</syntaxhighlight>
ブートしたら、
('''OpenWrt側で''')
<syntaxhighlight lang="bash" enclose="div">
df -h
</syntaxhighlight>
で増えた事を確認する。
<syntaxhighlight lang="bash" enclose="div">
root@Arduino:~# df -h
Filesystem                Size      Used Available Use% Mounted on
rootfs                  14.7G    380.6M    13.6G  3% /
/dev/root                7.5M      7.5M        0 100% /rom
tmpfs                    29.8M    392.0K    29.5M  1% /tmp
tmpfs                  512.0K        0    512.0K  0% /dev
/dev/sda2                14.7G    380.6M    13.6G  3% /overlay
overlayfs:/overlay      14.7G    380.6M    13.6G  3% /
/dev/sda1                15.0G    18.6M    15.0G  0% /mnt/sda1
</syntaxhighlight>
'''ディスク容量は必ず増やしてから OpenWrt の作業をすること。'''32GB が高価であれば 8GB class 10 でもよい。'''かならず増やすこと。'''
上記の micro-SD を取り出すには、
<syntaxhighlight lang="bash" enclose="div">
poweroff
</syntaxhighlight>
shutdown したら micro-SD を取り出す。
"YUN RST" ボタンをおして再起動する。起動したら、
<syntaxhighlight lang="bash" enclose="div">
uci delete fstab.@mount[0]
uci commit
</syntaxhighlight>
/etc/fstab の記述を消す必要あり。
== RESET ==
[https://www.arduino.cc/en/Guide/ArduinoYun#toc6 Resetting the processors (AR9331, WiFi, and 32U4)]
#OpenWrt が稼働する AR9331 をリスタートするには、いっぱい LED がある側の、アナログピンの横の "YÚN RST" を押す。
#AVR マイコン ATmega32U4 (Leonardo) をリスタートするには、イーサネットポートの横にある、"32U4 RST" を押す。
#:1回だけなら通常のリセットになる。2回速く押す事で bootloader mode に入り LED 13 が赤く点灯し 8 秒待機した後、起動する。
#:[https://learn.sparkfun.com/tutorials/pro-micro--fio-v3-hookup-guide/troubleshooting-and-faq#ts-reset Reset to Bootloader]
#WiFi ボードをリセットするには、USB-A ポートの横にある "WLAN RST" を押す。
#WiFi 設定を初期化するには、"WLAN RST" を 5 秒以上かつ 30 秒以下押し続ける。AR9331 がリスタートして 初期のWiFi設定モードになる。
#OpenWrt-Yun を工場出荷の状態(正確には最後に導入した OpenWrt-Yun)に戻すには、"WLAN RST"を 30 秒以上押し続ける。この場合すべての設定が初期化される。
#:micro SD を使って Overlayfs で拡張している場合は micro SD を安全に抜いておく。
#::/etc/config/fstab の 該当の config 'mount' セクションを削除して micro-SD のファイルシステムを umount し micro-SD カードを抜く。
#OpenWrt-Yun の root ログインパスワードを忘れた場合は、YunSerialTerminal をロードしてシリアルコンソールから変更する。
== LED ==
'''ボードの刻印と意味が違うところがあるので要注意'''
#'''USB''' の刻印がある白色 LED は OpenWrt ブート完了時( rc.local 実行時) に点灯する。つまり AR9331 OpenWrt が正常に稼働したというサイン。
#:AR9331 GPIO1 OpenWrt /sys/class/leds/ds:green:usb [https://github.com/arduino/openwrt-packages-yun/blob/master/arduino/yun-scripts/files/usr/bin/boot-complete-notify#L3 boot-complete-notify]
#'''WLAN''' の刻印がある青色 LED は WiFi ボードに何等かの操作(動作確認・初期化・リセット)をしている際にブリンクする。通常は消灯。
#:AR9331 GPIO0 OpenWrt /sys/class/leds/ds:green:wlan [https://github.com/arduino/openwrt-packages-yun/blob/master/arduino/yun-scripts/files/usr/bin/blink-start blink-start] [https://github.com/arduino/openwrt-packages-yun/blob/master/arduino/yun-scripts/files/usr/bin/blink-stop blink-stop]
#'''ON''' の刻印がある緑色 LED は刻印通り通電しているサイン。
#:接地
#'''WAN''' (私は未検証) 電源投入後しばらくオレンジ色に点灯し消灯。
#:AR9331 GPIO17 OpenWrt
#'''L13''' の刻印のある赤色 LED はおなじみの '''L''' つまり  13 ピン。
#:ATmega32U4 PC7 (ICP3/CLKO/OC4A)
#'''TX''' の刻印のあるオレンジ色 LED は micro-USB のシリアル通信 TX。
#:ATmega32U4 PD5 (~XCK/CTS) [https://github.com/arduino/Arduino/blob/master/hardware/arduino/avr/bootloaders/caterina/Caterina.h#L79 Caterina bootloader]
#'''RX''' の刻印のあるオレンジ色 LED は micro-USB のシリアル通信 RX、回路は ハードウェア SPI の SS と接続されている。
#:ATmega32U4 PB0 (~SS/PCINT0) [https://github.com/arduino/Arduino/blob/master/hardware/arduino/avr/bootloaders/caterina/Caterina.h#L81 Caterina bootloader]
= Yun 特有な開発 =
== avrdude ==
USBシリアル経由でプログラムをアップロードするのにいろいろはまった。
Leonardo 側が割り込み禁止になっていれば USB シリアルは使えない。
また SLEEP のモードによっても USB シリアルは使えない。
:データシートによると SLEEP_MODE_IDLE と SLEEP_MODE_ADC であれば USB 割り込みから復帰可能であり、割り込み可能の場合は IDE で USBシリアルがつかえる。
::ATmega32U4 は USB の回路を内蔵していて Yun の micro-USB 端子に D+ D- VBUS (USB)GND が繋がっている。
スピードは極端におそいが、TCP/IP ネットワーク経由(AR9331 OpenWrt を AVR ライタとして使う)にしておくのが無難だとわかった。([http://www.egrep.jp/wiki/index.php/Arduino_Yun_cheat_sheet#YUN_.E3.81.A8_SPI_.E3.81.A8_ICSP_.E3.81.A8_avrdude SPI デバイスを使用する場合は問題あり])
== Arduino-Makefile ==
avrdude のところでおかしくなる。
例の 1200bps でリセットするところでこける。
:私の開発環境が Windows の Cygwin なので、新しく接続された USB デバイスを Cygwin 側からは認識しないという事情によるものだった。
:あとは 上記と同様な理由で、割り込み禁止にしているか、SLEEP_MODE_PWR_DOWN 等では USB シリアルは使えない。TCP/IP ネットワーク経由(AR9331 OpenWrt を AVR ライタとして使う)で使う方法/パッチ探すことにする...
memo:
('''開発環境側で''')
<syntaxhighlight lang="bash" enclose="div">
scp sketch.hex root@arduino.local:/tmp/
ssh root@arduino.local 'kill-bridge'
### ssh root@arduino.local '/usr/bin/merge-sketch-with-bootloader.lua /tmp/sketch.hex'
ssh root@arduino.local '/usr/bin/run-avrdude /tmp/sketch.hex'
</syntaxhighlight>
:下手にやると文鎮になりそうなので要注意。もっと遊んでからこの実験をすることにしたので放置。
== 割り込み禁止 もしくは SLEEP_MODE_PWR_DOWN という状況で micro USB 経由で avrdude ==
IDE でコンパイルが終了するところで "32U4 RST" をダブルクリック(bootloader mode に)すると、タイミングが合えばプログラムを転送できる。
:([http://www.egrep.jp/wiki/index.php/Arduino_Yun_cheat_sheet#YUN_.E3.81.A8_SPI_.E3.81.A8_ICSP_.E3.81.A8_avrdude SPI デバイスを接続している場合]は、これのほうが便利かも)
== 2つのマイコン・3つの状態 ==
[http://playground.arduino.cc/Hardware/Yun#rebootStability How to improve reboot/reset stability]
Arduino Yun は AVR ATmega32U4 と MIPS 24K 系の Atheros AR9331 の2つのマイコンを搭載している。
:Uno も2つのマイコンを搭載しているが ATmega16U2 は USB通信をつかさどっている。(ATmega16U2 専用の ICSP 端子があるのでプログラミンは可能)
Yun の AR9331 は U-boot と呼ばれる汎用ブートローダを持ち、LLC 版では GNU/Linux の組み込み系ディストリビューションである OpenWrt-yun が起動する。Yun でのプログラムは Arduino 環境で開発するプログラム(スケッチ)、つまり Arduino Leonardo のプログラムと OpenWrt プログラムとの連携がポイントになる。連携は Bridge ライブラリを利用する。
2つのマイコンは以下の3つの状態を取りうる。
#Leonardo と OpenWrt が同時に起動する(電源投入時)場合。Leonardo が瞬時に立ち上がり、OpenWrt は init rc 等上がりきるまで20数秒かかる。
#Leonardo がリセットされた時(スケッチがアップロードされた・ボードの Leonardo リセットボタンを押した・OpenWrt から reset-mcu を実行した)、この場合は OpenWrt が稼働し続けている。
#OpenWrt がリブートされた時(reboot コマンドを実行した・OpenWrt リセットボタンを押した・OpenWrt をアップグレードした)、この場合は Leonardo は稼働し続けている。
Leonardo と OpenWrt の連携をする場合はこの3つの状態を意識してプログラムをしなければならない。
=== OpenWrt の boot 完了を待つ処理 ===
Bridge は OpenWrt の起動直後(Serial1活性確認つまり OpenWrt のシリアルコンソール活性後・ブートシーケンスの最初の頃)、Leonardo 側からシリアルコンソールで OpenWrt にログインして run-bridge スクリプトを起動する。つまり、
<syntaxhighlight lang="cpp" enclose="div">
  Bridge.begin();
</syntaxhighlight>
は OpenWrt の起動確認後、run-bridge スクリプトを起動し処理を抜ける。つまり、OpenWrt のシリアルコンソールが使えるまで待つ。
:もちろん OpenWrt がすでに稼働済みであるばあいは即座に run-bridge を起動して抜ける。
Bridge.cpp:
<syntaxhighlight lang="cpp" enclose="div">
  // Wait for U-boot to finish startup
  do {
    dropAll();
    delay(1000);
  } while (stream.available() > 0);
</syntaxhighlight>
<syntaxhighlight lang="cpp" enclose="div">
void BridgeClass::dropAll() {
  while (stream.available() > 0) {
    stream.read();
  }
}
</syntaxhighlight>
<syntaxhighlight lang="cpp" enclose="div">
    // Bridge startup:
    // - If the bridge is not running starts it safely
    stream.print(CTRL_C);
    delay(250);
    stream.print(F("\n"));
    delay(250);
    stream.print(F("\n"));
    delay(500);
    // Wait for OpenWRT message
    // "Press enter to activate console"
    stream.print(F("run-bridge\n"));
    delay(500);
    dropAll();
</syntaxhighlight>
/usr/bin/run-bridge:
<syntaxhighlight lang="bash" enclose="div">
python -u bridge.py
</syntaxhighlight>
このスクリプトの処理を設定後、次の処理にわたす。
Bridge について詳しい記事:
[http://jtakao.web.fc2.com/elec/yun/yun_bridge.html Arduino YunのBridgeメモ]
OpenWrt 側ソース:
[https://github.com/arduino/YunBridge https://github.com/arduino/YunBridge]
Bridge は破棄することができなさそう。もし Leonardo が稼働中に、OpenWrt が再起動したばあい、bridge.py は起動しておらず、その条件下で再度 Leonardo で Bridge.begin() を呼んでも、private のフラグがセットされていて、bridge.py を呼び出すことはない。
Bridge.cpp:
<syntaxhighlight lang="cpp" enclose="div">
void BridgeClass::begin() {
  if (started)
    return;
  started = true;
</syntaxhighlight>
:Bridge が動いていないことを検知したら、美しくはないが Leonardo を自らリセットするのがいまのところよさそう。
<syntaxhighlight lang="cpp" enclose="div">
  asm volatile ("jmp 0");
</syntaxhighlight>
=== OpenWrt の init script 完了を待つ処理 ===
USB LED (明るい白色)が点灯する時点で OpenWrt が起動済み(rc.local 実行時)ということを利用して、
:/etc/rc.local の boot-complete-notify 実行直前は brightness は 0 である。boot-complete-notify 実行後に 255 である。
:白色 LED を消灯するために trigger に none を入力後も brightness は 255 である。
::'''どうもバグと認識されたようで最新の OpenWrt では none を設定すると brightness は 0 になる。'''
('''Leonardo側で''')
<syntaxhighlight lang="cpp" enclose="div">
/* Check OpenWrt USB White LED ON (after rc.local boot-complete-notify) */
boolean CheckOpenWrtUsbnLed(void) {
  Process yun_proc;
  String yun_str;
  char c;
  boolean ret = false;
  /* USB LED ON ? */
  yun_proc.begin("/bin/cat");
  yun_proc.addParameter("/sys/class/leds/ds:green:usb/brightness");
  yun_proc.run();
  while(yun_proc.available() > 0) {
    c = yun_proc.read();
    if(c != '\n') {
      yun_str+= c;
    }
  }
  if (yun_str == "255") {
    ret = true;
  }
  return ret;
}
</syntaxhighlight>
この関数で /sys/class/leds/ds:green:usb/brightness の値を状態を監視。0 から 255 になったことを確認したら OpenWrt のブートの一連の処理完了とみなせる。
=== NTP 時刻同期完了確認 ===
OpenWrt 起動直後は、ネットワークの設定処理が終わっていないことや、NTP で時刻同期がまだできていない状態で、Leonardo 側の処理が動く場合がある。
:ちなみに OpenWrt 側のマイコンには RTC がなく、ブート直後は、時刻が大幅に違っている。（/etc ディレクトリにあるファイルの最新日付を boot 時に設定している）
上記の関数で OpenWrt のブートシーケンス完了確認後、NTP (BusyBox sysntpd) の同期を待つ(25秒ほどで同期する)処理を配置しておく。もちろん、OpenWrt 稼働済みの状態で Leonardo が起動する場合は待つ必要は無い。
= Leonardo =
== I/O ==
== I/O ==
D0, D1 は AR9331 との Serial1 用に接続されている。Yun で外部割り込みで使えるのは D2/INT1 と D3/INI0 とのこと。D7/INT4 は AR9331 の ハンドシェイク用(予定)なので使わない。
D0/INT2, D1/INT3 は AR9331 との Serial1 用に接続されている。Yun で外部割り込みで使えるのは D2/INT1 と D3/INI0 とのこと。D7/INT4 は AR9331 の ハンドシェイク用(予定)なので使わない。


I2C(TWI)の SDA/SCL が Uno は A4/A5。Yun は D2/D3 。
I2C(TWI)の SDA/SCL が Uno は A4/A5。Yun は D2/D3 。
:はい！終わった！INT1/INT0 の外部割り込みが使えない...
:Uno で使っていた INT1/INT0 の外部割り込みが使えない...
::I2C使わないように、回路変えるか...
::I2C使わないように、SPI に回路変えるか...
:外部割り込みを他のpinで可能にする方法があるらしい。
:::SPI で気象データセンサーなら
:::: [https://www.adafruit.com/products/2652 Adafruit BME280 I2C or SPI Temperature Humidity Pressure Sensor ID: 2652]
:::::5V対応
:::: [https://www.sparkfun.com/products/13676 SparkFun Atmospheric Sensor Breakout - BME280 - SEN-13676]
:::::3.3Vのみ。5Vマシンならロジックレベルシフタが必要。
:::SPI でRTC なら
:::: [https://www.sparkfun.com/products/10160 SparkFun DeadOn RTC Breakout - DS3234 - BOB-10160]
:::ハードウェアSPI も UNO と異なる。UNO はICSP 端子と PIN 10, 11, 12 だが YUN は ICSP 端子のみだ。
::::Yun で ハードウェア SPI のために ICSP 端子に接続する場合は問題がある。network 経由の avrdude で[http://www.egrep.jp/wiki/index.php/Arduino_Yun_cheat_sheet#SPI_.E3.81.A8_ICSP_.E3.81.A8_avrdude エラー]がでる。
:Pin による割り込みを他の Pin で可能にする方法がある。
  [http://forum.arduino.cc/index.php?topic=182173.0 Leonardo - using I2C and external interrupts]
  [http://forum.arduino.cc/index.php?topic=182173.0 Leonardo - using I2C and external interrupts]
  [https://github.com/GreyGnome/PinChangeInt Pin Change Interrupt library for the Arduino]
  [https://github.com/GreyGnome/PinChangeInt Pin Change Interrupt library for the Arduino]
:これをテストしてみる。
 
::Uno ではうごいた。D2/D3 を避けるようにした。Yun はこれから検証する。
=== Pin Change Interrupt ===
PinChangeInt の更新版である EnableInterrupt があった。
[https://github.com/GreyGnome/EnableInterrupt https://github.com/GreyGnome/EnableInterrupt]
これによると Yun と同じ Leonardo の割り込みの拡張・変更は、
:外部割り込み        : D0, D1, D2, D3, D7
:Pin Change 割り込み : D8, D9, D10, D11, SCK, MOSI, MISO
ポートB の変更になる。
 
実際に Yun で試したみたところ、割り込みは検知できた。
:enableInterrupt() で RISING を設定したが、たしかに 割り込みハンドラは RISING(LOW->HIGH) でのみ起動はした。
:しかし AVR の SLEEP が RISING(LOW->HIGH) だけでなく FALLING(HIGH->LOW)でも解除された。
:おそらく AVR ポートB の仕様によるものというか、Pin '''Change''' Interrupt という文字通りの挙動で、enableInterrupt ライブラリが割り込みハンドルを横取りしてソフト的に RISING, FALLING, CHANGE の制御をおこなっているのであろう。
 
EnableInterrupt に記述されている Leonardo の割り込みの種類
<syntaxhighlight lang="text" enclose="div">
Pin    Interrupt Port
 
3      INT0      PD0      // External Interrupt (I2C SCL)
2      INT1      PD1      // External Interrupt (I2C SDA)
0      INT2      PD2      // External Interrupt (Serial1 RX)
1      INT3      PD3      // External Interrupt (Serial1 TX)
7      INT6      PE6      // External Interrupt (AR9331 handshake)
8      PCINT4    PB4      // Pin Change Interrupt
9      PCINT5    PB5      // Pin Change Interrupt
10      PCINT6    PB6      // Pin Change Interrupt
11      PCINT7    PB7      // Pin Change Interrupt
SCK/15  PCINT1    PB1      // Pin Change Interrupt
MOSI/16 PCINT2    PB2      // Pin Change Interrupt
MISO/14 PCINT3    PB3      // Pin Change Interrupt
</syntaxhighlight>
 
[http://www.atmel.com/images/atmel-7766-8-bit-avr-atmega16u4-32u4_datasheet.pdf ATmega32U4 DATA SHEET]
[http://www.avr.jp/user/DS/PDF/mega16U4.pdf ATmega32U4 データシート 日本語訳]
 
[http://flogics.com/wp/diy/zigbee-temp/arduino-%E3%81%AE%E3%82%B9%E3%83%AA%E3%83%BC%E3%83%97%E3%81%A8%E3%80%81pin-change-%E5%89%B2%E8%BE%BC/ Arduino のスリープと、Pin Change 割込 | FIRMLOGICS]
([http://d.hatena.ne.jp/ayokoyama/20140803/p3 Arduino のスリープと、Pin Change 割込 - 私の二次記憶]) : はてな版


=== PINOUT DIAGRAM ===
=== PINOUT DIAGRAM ===
Line 53: Line 501:
  [http://www.pighixxx.com/test/pinoutspg/boards/page/2/ THE UNOFFICIAL ARDUINO PINOUT DIAGRAM 本家]
  [http://www.pighixxx.com/test/pinoutspg/boards/page/2/ THE UNOFFICIAL ARDUINO PINOUT DIAGRAM 本家]


== WiFi 設定 ==
== SLEEP ==
工場出荷状態なら、WiFi AP モードで Yun が起動するので、それに接続してごにょごにょ。SSID が WiFiの MACアドレスになっているので、もしフィルタリングをしてる場合はこれを使う。
Leonardo では sleep_bod_disable が未定義になる。
:ご参考 : [http://takagi-hiromitsu.jp/diary/20071103.html 高木浩光＠自宅の日記 - 無線LANのMACアドレス制限の無意味さがあまり理解されていない]
 
USB(micro-USB)つかうなら sleep mode は SLEEP_MODE_IDLE か SLEEP_MODE_ADC で。(USB制御回路の割り込みでスリープから復帰する)
 
== Timer 2 ==
Timer 2 がない。Uno にはない Timer 3, Timer 4がある
 
== Console ==
<syntaxhighlight lang="bash" enclose="div">
ssh root@arduino.local 'telnet localhost 6571'
</syntaxhighlight>
:たぶん Uno で Serial ってかいてるところをすべて Console ってかいてやれば最初のハードルは越えられそう...
 
=== OpenWrt 側からの Console 接続待ち ===
<syntaxhighlight lang="cpp" enclose="div">
  while(!Console);
</syntaxhighlight>
:OpenWrt 側から ポート 6571 に接続するまで待つための Leonardo 側プログラム処理。
'''注意: loop で待っているので OpenWrt 側の bridge.py が OpenWrt 側の CPU を食う。早い目に OpenWrt 側で yun console に繋げて、この loop を抜けるようにしてあげる事。'''
 
== Process ==
なんと Leonardo 側から OpenWrt のコマンドを実行できる。
[https://www.arduino.cc/en/Tutorial/Process Arduino - Process]
:邪悪だ...;)
 
[http://xx-prime.hatenablog.com/entry/2015/04/26/224618 Arduino yunで放射線センサのデータをxivelyとM2Xにアップロードする - XX-Prime's blog]
[http://qiita.com/kassy_kz/items/ebeda9bcda444cf401a0 IFTTTを用いてArduinoからツイートする]
[https://github.com/itman83/ArduinoYun https://github.com/itman83/ArduinoYun]
 
== YUN と SPI と ICSP と avrdude ==
Yun で ハードウェアSPI の構成をとる場合、ICSP 端子を使うのだが、ICSP 端子からデバイスに接続している場合、ネットワーク経由での avrdude でエラーがでる。
 
<syntaxhighlight lang="text" enclose="div">
/usr/bin/run-avrdude /tmp/sketch.hex
avrdude: AVR device not responding
avrdude: initialization failed, rc=-1
        Double check connections and try again, or use -F to override
        this check.
 
/usr/bin/run-avrdude: line 5: can't open /tmp/efuse: no such file
 
avrdude: AVR device not responding
avrdude: initialization failed, rc=-1
        Double check connections and try again, or use -F to override
        this check.
 
 
avrdude done.  Thank you.
</syntaxhighlight>
 
ICSP 端子からデバイスの接続を抜くと avrdude は成功する。プログラムを送信後、再度デバイスを ICSP 端子に接続して reset-mcu するとよい。
:私はマイコンのプログラムは通常 HALT/SLEEP で、処理は割り込み駆動で書くべきだとおもっているので YUN の場合 USB での avrdude は使わない・使えない。("32U4 RST" ダブルクリックの bootloader mode 作戦で使える)
 
[https://www.arduino.cc/en/Main/ArduinoBoardYun https://www.arduino.cc/en/Main/ArduinoBoardYun]
の Documentation -> Input and Output -> SPI によると、
<syntaxhighlight lang="text" enclose="div">
SPI: on the ICSP header. These pins support SPI communication using the SPI library. Note that the SPI pins are not connected to any of the digital I/O pins as they are on the Uno, They are only available on the ICSP connector. This means that if you have a shield that uses SPI, but does NOT have a 6-pin ICSP connector that connects to the Yún's 6-pin ICSP header, the shield will not work. The SPI pins are also connected to the AR9331 gpio pins, where it has been implemented in software the SPI interface. This means that the ATMega32u4 and the AR9331 can also communicate using the SPI protocol.
</syntaxhighlight>
AR9331 の GPIO と共有しているらしい。それを利用してまさしく ICSP でプログラムを書き込んでいる。ネットワーク経由でプログラムを書き込む(AR9331 OpenWrt を AVR ライタとして使う)場合は、ICSP 端子には何もつながないようにすること。
 
== YUN と SPI と RX LED ==
SPI 構成時になぜか RX LED がオレンジ色で点灯しっぱなし。
:回路図みると RX LED は ~SS につながってるっぽい。ハードウェア SPI 使う場合は点灯しっぱなしなのか?
:調べると Caterina bootloader が micro-USB 通信時で TX LED, RX LED の制御をおこなっている。もし SPI 構成時に micro-USB データ転送がおこなわれたら RX LED は消灯する。SPI 構成時に micro-USB のデータ転送がなかった場合 RX LED は点灯のままになる。
 
[http://forum.arduino.cc/index.php?topic=213389.0 Arduino Yun SPI on ICSP connector (try to connect to a isd 1760 shield)]
[http://forum.arduino.cc/index.php?topic=223320.0 SPI on Yun]
 
SPI Library によると、
<syntaxhighlight lang="cpp" enclose="div">
void SPIClass::begin()
{
  uint8_t sreg = SREG;
  noInterrupts(); // Protect from a scheduler and prevent transactionBegin
  if (!initialized) {
    // Set SS to high so a connected chip will be "deselected" by default
    uint8_t port = digitalPinToPort(SS);
    uint8_t bit = digitalPinToBitMask(SS);
    volatile uint8_t *reg = portModeRegister(port);
 
    // if the SS pin is not already configured as an output
    // then set it high (to enable the internal pull-up resistor)
    if(!(*reg & bit)){
      digitalWrite(SS, HIGH);
    }
 
    // When the SS pin is set as OUTPUT, it can be used as
    // a general purpose output port (it doesn't influence
    // SPI operations).
    pinMode(SS, OUTPUT);
 
    // Warning: if the SS pin ever becomes a LOW INPUT then SPI
    // automatically switches to Slave, so the data direction of
    // the SS pin MUST be kept as OUTPUT.
    SPCR |= _BV(MSTR);
    SPCR |= _BV(SPE);
</syntaxhighlight>
なので SPI 初期化のあとは、SS (PB0/~SS/PCINT0)は普通のデジタル出力ピンとしてつかえる。
 
('''Leonardo側で''')
<syntaxhighlight lang="cpp" enclose="div">
SPI.begin();
digitalWrite(SS, HIGH);
</syntaxhighlight>
で RX LED が付きっぱなしの条件でも RX LED は消灯することができる。
 
ちなみに、複数の SPI デバイスを使う場合は、SPI Library で初期化する前に、すべての SPI デバイスの CS を必ず HIGH にしておくこと。
<syntaxhighlight lang="cpp" enclose="div">
/* Prepare for using multiple SPI devices */
pinMode(SPI1_CS, OUTPUT);
digitalWrite(SPI1_CS, HIGH);
pinMode(SPI2_CS, OUTPUT);
digitalWrite(SPI2_CS, HIGH);
 
/* Init SPI lib */
SPI.begin();
</syntaxhighlight>
 
== DS3234 の SQW と Alarm ==
Alarm ので割り込みのあとは Alarm flag clear しないと次の割り込みが来ない。
 
RTClib 改 DS3224 版を fork して clearAlarmFlag という関数つくった。
[https://github.com/nxhack/rtclib https://github.com/nxhack/rtclib]
:SQW の停止もすこし変更した。
 
= OpenWrt =
[https://github.com/arduino/openwrt-yun https://github.com/arduino/openwrt-yun]
[https://github.com/arduino/openwrt-packages-yun https://github.com/arduino/openwrt-packages-yun]
[https://github.com/arduino/YunBridge https://github.com/arduino/YunBridge]
 
[http://codesnippets.altervista.org/documentation/yun/ Documenting the Yun - Code Snippets]
 
[https://bitbucket.org/unitn/yuntricks/wiki/Home unitn / YunTricks / wiki / Home — Bitbucket]
[http://tavendo.com/blog/post/arduino-yun-with-autobahn/ Getting started with Arduino Yun and Autobahn]
 
 
ふつうの PC UNIX とはいろいろ異なる。特に軽量化重視でいろんな設計がされている。
 
== init rc ==
/etc/rc.d/:
<syntaxhighlight lang="text" enclose="div">
K50dropbear
K90network
K95luci_fixtime
K98boot
K99umount
K99usd
S05defconfig
S05luci_fixtime
S09handle_wifi_reset
S10boot
S11sysctl
S11ubus
S18rename-wifi-if-access-point
S19firewall
S20fstab
S20network
S39usb
S48rngd
S49delete_uhttpd_cert
S49generate_new_gpg_key
S50cron
S50dropbear
S50uhttpd
S59luci_dhcp_migrate
S60dbus
S60dnsmasq
S61avahi-daemon
S93triggerhappy
S95done
S96led
S97watchdog
S98sysntpd
S99rngd-turn-off
S99usd
</syntaxhighlight>
 
== ボードのLED ==
 
/sys/class/leds:
<syntaxhighlight lang="text" enclose="div">
ath9k-phy0
ds:green:usb
ds:green:wlan
</syntaxhighlight>
 
<syntaxhighlight lang="text" enclose="div">
brightness
device
max_brightness
subsystem
trigger
uevent
</syntaxhighlight>
 
点灯と消灯:
 
('''OpenWrt側で''')
<syntaxhighlight lang="bash" enclose="div">
echo "default-on" > /sys/class/leds/ds\:green\:wlan/trigger
echo "none" > /sys/class/leds/ds\:green\:wlan/trigger
 
echo "default-on" > /sys/class/leds/ds\:green\:usb/trigger
echo "none" > /sys/class/leds/ds\:green\:usb/trigger
</syntaxhighlight>
 
('''OpenWrt側で''')
<syntaxhighlight lang="bash" enclose="div">
echo "255" > /sys/class/leds/ds\:green\:wlan/brightness
echo "0" > /sys/class/leds/ds\:green\:wlan/brightness
 
echo "255" > /sys/class/leds/ds\:green\:usb/brightness
echo "0" > /sys/class/leds/ds\:green\:usb/brightness
</syntaxhighlight>
:brightness は文字通り明るさ。0 は消灯。1から255は点灯。実際 明るさをコントロールする回路(PWMとか)が組み込まれていない場合は 1 でも 255 でも点灯は点灯。
:trigger が default-on で brightness が 0 の場合の意味は、電気はつけたが明るさを絞りきっているという意味で事実消灯。
 
まぶしい白色LED(usb)を消灯するスケッチ
 
('''Leonardo側で''')
<syntaxhighlight lang="cpp" enclose="div">
/* Turn off OpenWrt usb led (White LED) */
void TurnOffUsbLed(void) {
  Process yun_proc;
 
  yun_proc.runShellCommand("echo none > /sys/class/leds/ds:green:usb/trigger");
}
</syntaxhighlight>
 
カーネルモジュール
 
標準インストール済み:
ledtrig_timer
ledtrig_default_on
 
opkg で提供されているのも:
<syntaxhighlight lang="text" enclose="div">
kmod-ledtrig-default-on - 3.3.8-1 - Kernel module that allows LEDs to be initialised in the ON state.
kmod-ledtrig-gpio - 3.3.8-1 - Kernel module that allows LEDs to be controlled by gpio events.
kmod-ledtrig-heartbeat - 3.3.8-1 - LED Heartbeat Trigger
kmod-ledtrig-morse - 3.3.8-1 - Kernel module to show morse coded messages on LEDs.
kmod-ledtrig-netdev - 3.3.8-1 - Kernel module to drive LEDs based on network activity.
kmod-ledtrig-netfilter - 3.3.8-1 - Kernel module to flash LED when a particular packets passing through your machine.  For example to create an LED trigger for incoming SSH traffic: iptables -A INPUT -p tcp --dport 22 -j LED --led-trigger-id ssh --led-delay 1000 Then attach the new trigger to an LED on your system: echo netfilter-ssh > /sys/class/leds/<ledname>/trigger
kmod-ledtrig-timer - 3.3.8-1 - Kernel module that allows LEDs to be controlled by a programmable timer via sysfs.
kmod-ledtrig-usbdev - 3.3.8-1 - Kernel module to drive LEDs based on USB device presence/activity.
</syntaxhighlight>
 
[https://www.kernel.org/doc/Documentation/leds/leds-class.txt LED handling under Linux]
 
=== 起動後の LED の点減 ===
USB LED (まぶしい白色) は /etc/rc.local の boot-complete-notify で常時点灯に設定される。
[https://github.com/arduino/openwrt-packages-yun/blob/0fb82cf85e489ffad89a78a58beac9d256c1bbbf/arduino/yun-scripts/files/usr/bin/boot-complete-notify boot-complete-notify]
 
WLAN LED (暗い青色) は WiFi モジュールの動作確認・初期化・リセット等の操作時にブリンクするようになっている。処理が終わったら消灯される。
[https://github.com/arduino/openwrt-packages-yun/blob/master/arduino/yun-scripts/files/usr/bin/wifi-live-or-reset wifi-live-or-reset]
[https://github.com/arduino/openwrt-packages-yun/blob/0fb82cf85e489ffad89a78a58beac9d256c1bbbf/arduino/yun-scripts/files/usr/bin/wifi-reset-button-released wifi-reset-button-released]
[https://github.com/arduino/openwrt-packages-yun/blob/master/arduino/yun-scripts/files/usr/bin/blink-start blink-start]
[https://github.com/arduino/openwrt-packages-yun/blob/master/arduino/yun-scripts/files/usr/bin/blink-stop blink-stop]
 
== U-boot ==
[http://www.denx.de/wiki/U-Boot http://www.denx.de/wiki/U-Boot]
汎用ブートローダ。GPL。
 
== BusyBox ==
[http://busybox.net/downloads/BusyBox.html http://busybox.net/downloads/BusyBox.html]
GNU Coreutils 等を1つのプログラムファイルに固めたもの。コードの重複等のさまざまな無駄をはぶいてファイルサイズを少なくし、メモリー使用も少なく、起動を速くしたもの。組み込み系には嬉しい。
 
== Dropbear SSH ==
[https://matt.ucc.asn.au/dropbear/dropbear.html https://matt.ucc.asn.au/dropbear/dropbear.html]
SSH の軽量実装。OpenSSL を使っていない。zlib を省くことも可能。主な SSH の機能は装備されている。
 
openssh の ssh-keygen  で作ったキーを使おうとしたら
 
<syntaxhighlight lang="bash" enclose="div">
dbclient: Exited: String too long
</syntaxhighlight>
 
dropbear 用に変換する必要がある
 
<syntaxhighlight lang="bash" enclose="div">
opkg install dropbearconvert
dropbearconvert openssh dropbear id_dsa id_dsa.db
</syntaxhighlight>
 
OpenWrt 版には SSHKeepAlive 対応のパッチがあたっているらしい
[https://wiki.openwrt.org/doc/uci/dropbear Dropbear Configuration]
が、OpenWrt-yun のはまだかも...要確認
 
== UCI ==
[https://wiki.openwrt.org/doc/uci https://wiki.openwrt.org/doc/uci]
UCI を調査...
 
<syntaxhighlight lang="bash" enclose="div">
uci show
</syntaxhighlight>
 
== OpenWrt 側から Leonardo のリセット ==
<syntaxhighlight lang="bash" enclose="div">
reset-mcu
</syntaxhighlight>
 
== yun scripts ==
[https://github.com/arduino/openwrt-packages-yun/tree/0fb82cf85e489ffad89a78a58beac9d256c1bbbf/arduino/yun-scripts/files/usr/bin openwrt-packages-yun/arduino/yun-scripts/files/usr/bin/]
:おもしろいのがいっぱい。
 
reset-to-factory-anyway
:豪快
 
upgrade-all
:これいいね
 
== opkg ==
最初にこれだけは
<syntaxhighlight lang="bash" enclose="div">
opkg update
opkg list-upgradable
### なになあればそれを upgrade
### opkg upgrade temboo
opkg install ca-certificates
opkg install unzip
opkg install screen
opkg install logrotate
opkg install diffutils
</syntaxhighlight>
 
<syntaxhighlight lang="bash" enclose="div">
opkg install dosfsck
# opkg install dosfstools
umount /dev/sdb1
dosfsck -t -a -w /dev/sdb1
# fsck.fat -t -a -w /dev/sda1
/sbin/block mount
</syntaxhighlight>
 
<syntaxhighlight lang="bash" enclose="div">
mkdir -p -m 0755 /usr/local/var/lib/logrotate
crontab -e
### logrotal の記述かく
### 25 6 * * * /usr/sbin/logrotate -s /usr/local/var/lib/logrotate/status /etc/logrotate.conf > /dev/null 2>&1
### もしくは crontab ファイル
/etc/init.d/cron restart
</syntaxhighlight>
 
[http://groenholdt.net/Computers/OpenWRT/openwrt-logrotate.html Homepage V. 5.1 - Rotating lighhtpd logs on OpenWRT]
 
注意：FAT32 で作ったファイルを ext4 に持って行くと x 属性がついてしまっている。logrotate.d 配下に置くファイルはこれが問題になった。
 
ps aux や w のたびに悲しい思いするのを避けるために
<syntaxhighlight lang="bash" enclose="div">
opkg update
opkg install procps --force-overwrite
</syntaxhighlight>
 
<syntaxhighlight lang="bash" enclose="div">
root@Arduino:~# opkg install procps
Installing procps (3.2.8-1) to root...
Downloading http://downloads.arduino.cc/openwrtyun/1/packages/procps_3.2.8-1_ar71xx.ipk.
Collected errors:
* check_data_file_clashes: Package procps wants to install file /usr/bin/free
        But that file is already provided by package  * busybox
* check_data_file_clashes: Package procps wants to install file /usr/bin/pgrep
        But that file is already provided by package  * busybox
* check_data_file_clashes: Package procps wants to install file /usr/bin/top
        But that file is already provided by package  * busybox
* opkg_install_cmd: Cannot install package procps.
</syntaxhighlight>
競合するらしいが、手癖のリズムを優先したいのでリスクを負って '''--force-overwrite''' した。
<syntaxhighlight lang="bash" enclose="div">
cd /bin
ln -s busybox free
ln -s busybox pgrep
ln -s busybox top
</syntaxhighlight>
念のため競合したプログラムを復活しておく。
 
/root/.profile:
<syntaxhighlight lang="bash" enclose="div">
alias ps=/usr/bin/ps
alias top='TERM=xterm; export TERM;/usr/bin/top'
</syntaxhighlight>
PATHを変えるのは影響がでかそうなので alias しておく。
 
emacs もどき...
<syntaxhighlight lang="bash" enclose="div">
opkg install coreutils-ls
opkg install mg
</syntaxhighlight>
 
/root/.profile:
<syntaxhighlight lang="bash" enclose="div">
alias ls='/usr/bin/ls -F --color=auto'
alias ll='ls -alF --color=auto'
alias emacs="TERM=xterm; export TERM;PATH='/usr/bin:/usr/sbin:/bin:/sbin'; /usr/bin/mg"
</syntaxhighlight>
: (setq-default truncate-lines nil) の挙動がないので、長い行を改行しないことを意識すること。
 
== syslog ==
syslogd が -C16 というオプション付きで起動されている。
/sbin/syslogd -C16
これは ログメッセージを RAM 上のリングバッファにストアするオプション。
<syntaxhighlight lang="bash" enclose="div">
logread
</syntaxhighlight>
これで表示。もちろんリングバッファということで古いものは消えていく。
<syntaxhighlight lang="bash" enclose="div">
logread -f
</syntaxhighlight>
で tail 表示
 
== python beaver ==
ELK stack / Elastic Stack (Logstash + Elasticsearch + Kibana) に計測データを送るために、軽量 shipper beaver を導入。もちろん経路の安全性や接続先の厳密化のために '''SSH Tunneling''' を使用する。
:本当は filebeat が良いのだが、Golang が MIPS に対応してない。
導入する前に micro-SD でディスク容量を増やしておく事。
<syntaxhighlight lang="bash" enclose="div">
opkg update
opkg install distribute
opkg install python-openssl
opkg install python-bzip2
easy_install pip
opkg install python-sqlite3
pip install beaver==36.2.0
</syntaxhighlight>
 
SSH Tunneling の設定するため OpenWrt-Yun の 軽量 ssh である Dropbear SSH のための key 変換ツール。これで Dropbear 用に変換する。
<syntaxhighlight lang="bash" enclose="div">
opkg install dropbearconvert
</syntaxhighlight>
 
<syntaxhighlight lang="bash" enclose="div">
/usr/bin/beaver -D -c /mnt/sda1/beaver/beaver.conf -P /mnt/sda1/beaver/beaver.pid
</syntaxhighlight>
とりあえず動いたっぽい。
 
<syntaxhighlight lang="bash" enclose="div">
opkg install python-expat
pip install supervisor
</syntaxhighlight>
 
[https://github.com/Supervisor/initscripts Supervisor/initscripts]
 
[https://gist.github.com/nxhack/71e7988e60106de14564 python supervisor startup script for OpenWrt-yun]
:OpenWrt 用作った。
 
いろいろ設定して意外とさっくり supervisord 配下で beaver が動いた。
:ついでに、外部からの接続用 ssh tunnel も稼働中...
 
init script で ssh を起動する場合、 HOME が設定されていないので、ssh 関連のファイルの操作ができない。
<syntaxhighlight lang="bash" enclose="div">
HOME=/root
export HOME
</syntaxhighlight>
:init script に HOME を設定しておく事。
 
なんかいろいろやろうとすると supervisor も daemontools とおなじカホリを感じたな...
 
== AR9331 メモリー ==
AR9331 の主メモリーは 64MB ということで、busybox や dropbear などを使って工夫している。
python supervisor と beaver を稼働させるともちろんメモリーは圧迫されるので無駄をなくす事が重要。
本当は OpenSSH client インストールして ssh tunnel のいろんなオプションつけたいのだけど我慢。ntpd も同様。
:(最終的には、ExitOnForwardFailure=yes が必要だったので OpenSSH-client は入れた。)
 
<syntaxhighlight lang="bash" enclose="div">
root@Arduino:~# free
            total      used      free    shared    buffers    cached
Mem:        61116      56088      5028          0      5572      15992
-/+ buffers/cache:      34524      26592
Swap:            0          0          0
</syntaxhighlight>
python supervisor と beaver を稼働させた状態。
 
ちなみに、AR9331 は MIPS 24Kc で FPU は無し。
 
== メンテ用トンネル ==
おなじみのサーバサイドの sshd_config をホゲる
<syntaxhighlight lang="text" enclose="div">
TCPKeepAlive no
ClientAliveInterval 15
ClientAliveCountMax 3
</syntaxhighlight>
 
ssh tunnel サービス は python supervisord 配下で稼働させた。
:shell script を supervisord で管理する場合、最終的なプログラム(この場合は ssh)は exec 付きで起動すること。でないと supervisord が ssh のプロセス追えない。
 
dropbear の client dbclient のオプションを調査したが、 -o は無視するようだ。
 
やっぱり -o ExitOnForwardFailure=yes をつかわないとマズイ状態になる。なので
<syntaxhighlight lang="bash" enclose="div">
opkg install openssh-client --force-overwrite
</syntaxhighlight>
OpenSSH いれてテストしてみる。
 
== init script ==
[https://wiki.openwrt.org/doc/techref/initscripts Init Scripts]
 
#!/bin/sh /etc/rc.common
 
/etc/init.d/hoge enable
 
要調査...
 
== ssh-agent ==
OpenWrt側に入ってテストすることがおおいので('''開発環境側で''')
 
<syntaxhighlight lang="bash" enclose="div">
eval `ssh-agent -s`
ssh-add ./.ssh/id_rsa
</syntaxhighlight>
:とかやっとく
 
OpenWrt 側は Dropbear SSH なので、
 
<syntaxhighlight lang="bash" enclose="div">
~/.ssh/authorized_keys
</syntaxhighlight>
 
ではなく
 
<syntaxhighlight lang="bash" enclose="div">
/etc/dropbear/authorized_keys
</syntaxhighlight>
 
自分の公開キーを書いておく。


  [http://blog.iot.nifty.com/index.php/2015/10/21/arduino-yun/ Arduino YÚNのネットワーク機能を試してみる | ニフティIoTデザインセンターブログ]
= Yun を 無線(Wi-Fi) 有線(Ethernet) コンバータとして使う =
  [https://lede-project.org/docs/user-guide/relay_configuration Wifi Extender or Repeater or Bridge Configuration]
[https://wiki.openwrt.org/doc/recipes/relayclient Routed Client with relayd (Pseudobridge)]
[http://ultimania.org/trac/yuna/wiki/linux/OpenWrt2 http://ultimania.org/trac/yuna/wiki/linux/OpenWrt2]


[http://mag.switch-science.com/2015/03/06/try-arduino-yun-1/ Arduino Yúnを使ってみよう (1) Yúnを設定する | スイッチサイエンス マガジン]
<syntaxhighlight lang="bash" enclose="div">
opkg update
opkg install relayd
opkg install luci-proto-relay
/etc/init.d/relayd enable
/etc/init.d/relayd start
</syntaxhighlight>


注意：Windows の場合は [https://support.apple.com/kb/DL999?viewlocale=ja_JP&locale=ja_JP Apple から Bonjour のドライバー]をとってきてインストールしておく。
Luci 使えば簡単だった。


= Yun 特有な開発 =
↓は LEDE 公式資料なので IF 名が Yun と違うので注意。(Yun は wan が eth1、lan が wifi)
== avrdude ==
[https://lede-project.org/_media/docs/guide-user/wifirepeater_interfaces_lan.png https://lede-project.org/_media/docs/user-guide/wifirepeater_interfaces_lan.png]
USBシリアル経由でプログラムをアップロードするのにいろいろはまった。まだ調査中。
[https://lede-project.org/_media/docs/guide-user/wifirepeater_newinterface.png https://lede-project.org/_media/docs/user-guide/wifirepeater_newinterface.png]
:ケーブルに注意。micro-USBは充電用というのが紛れ込んでる可能性が高い。ハマる。
[https://lede-project.org/_media/docs/guide-user/wifirepeater_relaybridge1.png https://lede-project.org/_media/docs/user-guide/wifirepeater_relaybridge1.png]
[https://lede-project.org/_media/docs/guide-user/wifirepeater_relaybridge2.png https://lede-project.org/_media/docs/user-guide/wifirepeater_relaybridge2.png]
[https://lede-project.org/_media/docs/guide-user/wifirepeater_firewall.png https://lede-project.org/_media/docs/user-guide/wifirepeater_firewall.png]


== arduino-Makefile ==
avrdude のところでおかしくなる。調査する。


例の 1200bps でリセットするところでおかしい...
↓を再度確認のこと。(Yun は wan が eth1)
eth1 に ダミーの IP を振る。
<syntaxhighlight lang="text" enclose="div">
config interface 'wan'
        option ifname 'eth1'
        option proto 'static'
        option ipaddr '192.168.2.1'
        option netmask '255.255.255.0'
       
config interface 'repeater_bridge'
        option proto 'relay'
        list network 'lan'
        list network 'wan'
</syntaxhighlight>


== Console ==
最後に relayd を restart
<syntaxhighlight lang="bash" enclose="div">
<syntaxhighlight lang="bash" enclose="div">
ssh root@arduino.local 'telnet localhost 6571'
/etc/init.d/relayd restart
</syntaxhighlight>
 
relayd の '-I' オプションは ARP cache を頻繁に行うようで気持ち悪い '-i' に変えてみた。が、動かなかった。'-I' に戻した。
 
最終的に ARP storm 問題が気になったので、いろいろ試したが解決せず、relayd を使わずに、静的な bridge 構成にした。
 
bridge しているインターフェースには proxy_arp を有効にすること。
 
= Security =
[http://hackaday.com/2016/11/11/arduworm-a-malware-for-your-arduino-yun/ ArduWorm: A Malware for Your Arduino Yun]
:あーーー出てしまった...
::ATmega32u4に侵入して、bridge でお好きに的...
 
Arduino Yun の OpenWrt と AVR の脆弱性(要 Flash Plugin):
[https://prezi.com/ufthiwidvb_0/tfm-arduino-yun-security-iot/ TFM - Arduino Yun - Security IoT]
 
<syntaxhighlight lang="text" enclose="div">
Linux environment
・ROOT as default user:
　　No local access control.
・Vulnerable components (Kali -> Nmap,Nessus):
　　Dropbeard ssh 2011.54 -> DoS, remote execution...
　　BusyBox v1.19.4 -> execute arbitrary commands...
　　Kernel v3.3.8 -> DoS, gain privileges...
・Critical paths:
　　/var/hosts -> pharming attack
　　/etc/opkg -> fake repository (SSLsniff)
　　/usr/bin/kill-bridge -> DoS, own malicious bridge
　　/rom/ -> persistence
・No integrity file checks on boot.
・No redirection to 443 (https).
・Remote insecure configuration:
　　Deauthentication attack to create new free
　　hotspot, capturing WPA/WPA2 handshakes...
 
Arduino environment:
・Device sensors no authenticated.
・No memory controls (Heap Overflow & Stack Overflow)
</syntaxhighlight>
</syntaxhighlight>
:たぶん Uno で Serial ってかいてるところをすべて Console ってかいてやれば最初のハードルは越えられそう...
Arduino の性質上しかたのないものもあるが、ネットワークからの侵入や使用不能攻撃はさけたい。
 
Compromised firmware:
[http://fabytes.com/fab/?p=486 Are your devices secure? Firmware hacking | Fabytes.com]
 
Update ヲタクとして作業中: [http://www.egrep.jp/wiki/index.php/OpenWrt_for_Arduino_Yun_cheat_sheet OpenWrt for Arduino Yun Security Upgrade]
 
= Arduino Yún LininoOS 差分 =
 
*Arduino LLC 版 Arduino IDE で「ライブラリを管理...」から MCU 側の Ciao Library がインストールできるようになっていた。
 
*Bridge Library か Ciao Library かは選択可能のように記述されている。(どちらか推奨があるわけではないみたい)
 
*luci-app-arduino-webpanel (Linino 版) と Arduino-OS (arduinoos) かはこれも様子見っぽい。Arduino-OS は野心的なので安定するまでは様子見したほうがよさげ。
 
*LininoIO はまだ水面下っぽい。(MCUIO driver 系) コンセプトは素晴らしいが、vanilla kernel に取り込まれる勢いで OpenWrt / LEDE に入らないと将来はあやしい。
**こんなのあるんだ。これを拡張するのかな [https://www.kernel.org/doc/html/latest/driver-api/iio/index.html Industrial I/O (IIO)]
 
*公式版 LininoOS (LininoIO 版) は Barrier Breaker(14.07) ベース。 (/etc/linino_version には attitude_adjustment とあるが)（あかん..)


= OpenWRT =
*Chaos Calmer(15.05) ベースの LininoOS もあることはある。
[https://www.arduino.cc/en/Tutorial/YunSysupgrade Arduino - YunSysupgrade]


= link =
= link =
Documenting the Yún:
[http://codesnippets.altervista.org/documentation/yun/index.html http://codesnippets.altervista.org/documentation/yun/index.html]
ibuyopenwrt:
[http://www.ibuyopenwrt.com/index.php http://www.ibuyopenwrt.com/index.php]
Filebeat を動かすための mips Golang 情報:
  [http://akagi201.org/blog/golang-on-openwrt/ Golang on OpenWrt · Akagi201]
  [http://akagi201.org/blog/golang-on-openwrt/ Golang on OpenWrt · Akagi201]
Yun 濃い議論:
[http://hackaday.com/2015/02/24/is-the-arduino-yun-open-hardware/ Is The Arduino Yun Open Hardware? | Hackaday]
linux USB RTC:
[https://code.google.com/p/mist-board/wiki/UsbRtc USB Real Time Clock (USBRTC)]
= ToDo メモ =
[http://akizukidenshi.com/catalog/g/gK-09833/ 秋月 ００６Ｐ安定化電源モジュールキット]
:電流足りないね。
Retrieved from "https://www.egrep.jp/wiki/index.php/Special:MobileDiff/3400...6267"