はじめに
Nerves プロジェクトでハードウェアデバイスを扱う場合、Linux カーネルとの連携が欠かせません。特に、デバイスドライバのロードやシステムのイベント管理は、エンジニアにとって重要な課題です。
そんな課題をシンプルに解決してくれるのが NervesUEvent パッケージです。
この記事では、公式 README の内容を元に、NervesUEvent の特徴や使い方を紹介します。
特に、modprobe
コマンドを使ったデバイスドライバの自動ロードや、デバイスの状態監視方法について解説します。
NervesUEvent とは?
NervesUEventは、Linux のudevd
の簡易版ともいえる存在です。
udevd
のようにカーネルからの UEvent を受け取りますが、必要な場合にのみmodprobe
を実行し、システム内のハードウェアを追跡する点で異なります。
Nerves プロジェクトの多くでは、udevd
ではなくNervesUEventで十分なケースがほとんどです。
ほぼすべての Nerves システムでは、カーネルモジュールが正しくロードされないと重要な機能が動作しません。例えば、WiFi デバイスドライバはほとんどがカーネルモジュールです。もしNervesUEventやudevd
などの自動ロード機能を使わない場合は、アプリケーション内で手動でmodprobe
を呼び出す必要があります。
設定方法
NervesUEventはシステム起動時に自動的に動作を開始します。設定はconfig.exs
を通じて行います。以下のオプションを利用可能です:
オプション | 説明 |
---|---|
:autoload_modules |
必要に応じてmodprobe を実行(デフォルトはtrue ) |
以下に設定例を示します:
config :nerves_uevent, autoload_modules: false
使い方
NervesUEventは現在、非常に低レベルで Linux システムの構造を反映しています。以下に基本的な使い方を説明します。
デバイス情報の取得
例えば、MMC デバイスが Linux 上で/sys/devices/platform/soc/2100000.bus/2194000.mmc
に登録されている場合、この情報を取得するには以下のように記述します:
iex> NervesUEvent.get(["devices", "platform", "soc", "2100000.bus", "2190000.mmc"])
%{
"driver" => "sdhci-esdhc-imx",
"modalias" => "of:NmmcT(null)Cfsl,imx6ull-usdhcCfsl,imx6sx-usdhc",
"of_alias_0" => "mmc1",
"of_compatible_0" => "fsl,imx6ull-usdhc",
"of_compatible_1" => "fsl,imx6sx-usdhc",
"of_compatible_n" => "2",
"of_fullname" => "/soc/bus@2100000/mmc@2190000",
"of_name" => "mmc",
"subsystem" => "platform"
}
このように、デバイスツリーから得られる情報を反映しています。特に"modalias"
キーに注目してください。このキーを基にNervesUEventは対応するカーネルドライバをロードします。
イベントの監視
デバイスの変更イベントを監視する場合、監視を利用します。例えば、MicroSD カードが挿入されたときのイベントを監視するには以下のように記述します:
iex> NervesUEvent.subscribe(["devices", "platform", "soc", "2100000.bus", "2190000.mmc"])
監視対象が分からない場合、全体を監視して確認することも可能です:
iex> NervesUEvent.subscribe([])
カードを物理的に挿入すると、NervesUEventはプロセスのメールボックスにイベントを送信します。以下はその一例です:
iex> flush
%PropertyTable.Event{
table: NervesUEvent,
timestamp: 2558213871126,
property: ["devices", "platform", "soc", "2100000.bus", "2190000.mmc", "mmc_host", "mmc0", "mmc0:1234"],
value: %{
"mmc_name" => "SA04G",
"mmc_type" => "SD",
"modalias" => "mmc:block",
"subsystem" => "mmc"
},
previous_timestamp: nil,
previous_value: nil
}
PropertyTable.Event
構造体には、以下のフィールドが含まれます。
フィールド | 説明 |
---|---|
:table |
イベントを発生させたテーブル |
:timestamp |
システムのモノトニック時刻でのタイムスタンプ |
:property |
デバイスパスの詳細 |
:value |
デバイスに関連する情報 |
おわりに
NervesUEvent は、Nerves プロジェクトにおけるデバイス管理を簡素化する強力なツールです。イベントの監視やカーネルモジュールの自動ロードを活用することで、IoT デバイスの制御を効率化できます。
NervesUEvent を活用して、Nerves プロジェクトでのハードウェア統合をさらにシンプルにしてみませんか?詳細は以下のリンクをご覧ください。
この記事を読んで氣づいた点や感想があれば、ぜひコメントで教えてください!