Skip to content

Instantly share code, notes, and snippets.

@mnishiguchi
Last active March 14, 2024 04:00
Show Gist options
  • Save mnishiguchi/b2b6472dad381065da298f2c9db62988 to your computer and use it in GitHub Desktop.
Save mnishiguchi/b2b6472dad381065da298f2c9db62988 to your computer and use it in GitHub Desktop.
Elixir Nerves Quickstart (日本語)

Nerves Quickstart

初めて Nerves 試す方にはNerves Livebookをお勧めします。

Nerves Livebookという予めビルドされたファームウェアが公開されているので、それをダウンロードしてmicroSD カードに焼くだけで簡単に氣樂にNervesを樂しめます。Livebook のノートブック上でElixirコードを実際に実行しながら進められるので、ウェブブラウザで快適に 楽しくNerves を学べます。

Elixirコードを実行しますが、Elixir言語に関する知識は特に不要です。なぜなら、Nerves Livebook上でElixir言語を学ぶこともできるからです。

買い物リスト

Nerves Livebookを動かすのに最低限必要なものは以下の通りです。

作業の流れを掴む

有志の方々が Nerves Livebook のセットアップ方法ついてのビデオやコラムを制作してくださっています。まずはこれらを見て流れを掴むと良いかもしれません。

nerves-livebook-demo-by-torifukukaiou

nerves-quickstart-by-underjord

fwup をインストール

fwup は、ファームウェアイメージをmicroSD カードに焼いたりするのに使うコマンドラインユーティリティです。

ホストコンピュータ の OS によりインストール方法が異なるので、ドキュメントをご参照ください。

fwup-pup.png

Nerves Livebook ファームウェアイメージをダウンロード

まずはNerves Livebook Releasesページで、お手持ちのターゲットデバイスに対応するファームウェアイメージ(.fwファイル)をダウンロードします。例として、ターゲットデバイスRaspberry Pi 4の場合にはnerves_livebook_rpi4.fwをダウンロードします。

ファームウェアイメージを microSD カードに焼く

ターゲットデバイス向けのファームウェアはmicroSD カードから起動します。今からそのmicroSD カードを準備します。

先ほどダウンロードしたファームウェアイメージが存在するディレクトリに移動し、fwup を使用してファームウェアをmicroSD カードに焼きます。

cd path/to/my-firmware

fwup nerves_livebook_rpi4.fw

fwupを実行するとmicroSD カードがフォーマットされ、microSD カード上のすべてのデータが失われますのでご注意ください。

Use 15.84 GB memory card found at /dev/rdisk2? [y/N] y
Depending on your OS, you'll likely be asked to authenticate this action. Go ahead and do so.

|====================================| 100% (31.81 / 31.81) MB
Success!
Elapsed time: 3.595 s

ターゲットデバイスへ接続

ターゲットデバイスへの接続方法は複数考えられます。

Workflows for Nerves

お使いのターゲットデバイスによりサポートされている接続方法が異なります。

Nerves System Gadget Mode Ethernet UART
Raspberry Pi Zero W rpi0 x
Raspberry Pi 3 Model B rpi3 x
Raspberry Pi 4 Model B rpi4

USB ガジェットモードに対応しているデバイスをご使用の場合は、USB ケーブルを電源供給とネットワークの両方に利用できます。その場合、USB On-The-Go (OTG)ポートに接続するよう注意してください。

ファームウェアを起動

microSD カードをターゲットデバイスに挿入します。そしてデバイスの電源を入れます。

公式サポートされているほとんどのデバイスには LED が付いています。 Nerves Livebook では、ネットワークが切断されると点滅し、ネットワーク インターフェイス経由で接続できる場合は点灯に変わります。

ウェブブラウザで Nerves Livebook を開く

デバイスの準備ができたら、ウェブブラウザで http://nerves.local にアクセスします。 パスワードはnervesです。

livebook.jpg

Nerves Livebook を樂しむ

Nerves Livebookを使用すると、何も構築せずに実際のハードウェアで Nerves プロジェクトを試すことができます。 Livebook のノートブック上で Elixir コードを実際に実行しながら進められるので、ブラウザー上で快適に 楽しくNervesElixir言語を学べます。

Nerves JP コミュニティ

Nerves なんなの?とか、動いた!とか、なんでもおっけーです!

https://nerves-jp.connpass.com

@mnishiguchi
Copy link
Author

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment