Armadillo 開発者サイト

i.MX25 プロセッサは UART1 から UART5 までの 5 つの UART モジュールを内蔵しています。Armadillo-400 シリーズでは標準状態で UART2 をシリアルインターフェース1 (CON3)、UART3 をシリアルインターフェース2 (CON9)、UART5 をシリアルインターフェース3 (CON9)に使用しています。また、カーネルコンフィギュレーションを変更することにより、CON11 に UART3 及び UART4 の機能を割り当てることができます。UART9 もしくは UART11 に機能を割り当てた場合、CTS/RTSによるハードウェアフローコントロールを有効にするか無効にするかを選択することができます。

UART ドライバーは以下の機能を有します。

各シリアルインターフェースとデバイスファイルの対応を、表8.1「シリアルインターフェースとデバイスファイルの対応」に示します。

UART 機能に関連するカーネルコンフィギュレーションを表8.2「UART コンフィギュレーション」に示します。

Armadillo-400 シリーズの Ethernet ドライバーは以下の機能を有します。

i.MX25 プロセッサは、SD/MMC/SDIO ホストコントローラ(eSDHC)を二個内蔵しています。Armadillo-400 シリーズでは、標準状態で eSDHC1 を microSD スロット(CON1)に使用しています。また、カーネルコンフィギュレーションを変更することにより、CON9 に eSDHC2の機能を割り当てることができます。

Armadillo-400 シリーズの SD/MMC/SDIO ホストドライバーは以下の機能を有します。

microSD カードスロットにカードが挿入されると、/dev/mmcblkN (Nは0または1)として認識されます。

SD/MMC/SDIO ホスト機能に関連するカーネルコンフィギュレーションを表8.3「SD/MMC/SDIO ホストコントローラ コンフィギュレーション」に示します。

Armadillo-400 シリーズの USB 2.0 ホストドライバーは以下の機能を有します。

USB デバイスが検出されると、/dev/sd* にマップされます。

Armadillo-440 のビデオ出力機能は、フレームバッファデバイスとして実装されています。

フレームバッファデバイスドライバーは以下の機能を有します。

Armadillo-440 液晶モデルの標準では、以下の設定になっています。

フレームバッファとデバイスファイルの対応を、表8.4「フレームバッファとデバイスファイルの対応」に示します。

Armadillo-440 の LED バックライト機能は、バックライトクラスとして実装されています。

/sys/class/backlight/pwm-backlight ディレクトリ以下のファイルによって、バックライトの制御を行うことができます。

輝度の調整は、brightness ファイルによって行うことができます。 brightness ファイルに 0(消灯)〜255(最高輝度)までの数値を書き込むことにより、輝度を変更することができます。

また、brightness ファイルを読むことにより現在の輝度を知ることができます。

バックライトの点灯/消灯は、bl_power ファイルによって行うことができます。bl_power に 0 を書き込むと消灯になり、1 を書き込むと点灯になります。

Armadillo-440 のタッチスクリーン機能は、インプットデバイスとして実装されており、ユーザーランドとのインターフェースとしてイベントインターフェースを提供しています。

表8.5「タッチスクリーンイベント」に示すイベントが発生します。

Armadillo-440 液晶モデルの標準状態では、タッチスクリーンのイベントデバイスは /dev/input/event1 にマップされます。

	イベントデバイスの番号は、検出された順番に割り振られます。そのため、USB キーボードなど他のインプットデバイスが起動時に検出されると、タッチスクリーンのイベントデバイス番号は変わる可能性があります。

Armadillo-400 シリーズのオーディオ機能は、ALSA デバイスとして実装されています。 ALSA デバイスドライバーは以下の機能を有します。

オーディオデバイスの制御は、ALSA ライブラリ (libasound2) を通じて行うことができます。

	Armadillo-400 シリーズのオーディオドライバーでは、録音と再生を同時に行うことはできません。

i.MX25では、オーディオマルチプレクスにより、オーディオ機能をどのピンで使用するかを選択することができます。Armadillo-400シリーズではカーネルコンフィギュレーションでオーディオマルチプレクスの設定をおこなうことができます。標準では、オーディオマルチプレクスは AUD6 を使用するようになっており、オーディオ機能は CON11 に接続されます。コンフィギュレーションにより AUD5 を使用することで CON9 に接続することができます。

オーディオ 機能に関連するカーネルコンフィギュレーションを表8.6「オーディオ コンフィギュレーション」に示します。

Armadillo-400 シリーズの GPIO は、generic GPIO として実装されています。

ユーザーランドから GPIO を操作するためのインターフェースとしては、GPIO sysfs と Armadillo-200 シリーズ互換 GPIO ドライバーの2つがあります。標準状態では GPIO sysfs ドライバーが有効になっています。

カーネルコンフィギュレーションで機能が割り当てられなかったピンは、全て GPIO として設定されます。

8.9.2. Armadillo-200 シリーズ互換 GPIO ドライバー

Armadillo-200 シリーズ互換 GPIO ドライバーでは、対応するデバイスファイルに対して ioctl を発行することにより、GPIO の操作および状態の取得を行うことができます。

	Armadillo-200 シリーズ互換 GPIO ドライバーは標準状態では無効になっています。有効にするには Linux カーネルコンフィギュレーションで、CONFIG_GPIO_SYSFS を無効に、CONFIG_ARMADILLO2X0_GPIO を有効にして、カーネルをビルドする必要があります。

Armadillo-200 シリーズ互換 GPIO ドライバーでの GPIO 名と GPIOピンの対応を表8.9「Armadillo-200 シリーズ互換 GPIO ドライバー GPIO 一覧」に示します。

表8.9 Armadillo-200 シリーズ互換 GPIO ドライバー GPIO 一覧

GPIO 名	GPIO ピン	初期入出力方向	初期出力レベル
GPIO0	CON9 21ピン	入力	-
GPIO1	CON9 22ピン	入力	-
GPIO2	CON9 23ピン	入力	-
GPIO3	CON9 24ピン	入力	-
GPIO4	CON9 25ピン	入力	-
GPIO5	CON9 26ピン	入力	-
GPIO6	CON9 27ピン	出力	LOW
GPIO7	CON9 28ピン	出力	LOW
GPIO8	CON9 11ピン	入力	-
GPIO9	CON9 12ピン	入力	-
GPIO10	CON9 13ピン	入力	-
GPIO11	CON9 14ピン	入力	-
GPIO12	CON9 15ピン	入力	-
GPIO13	CON9 16ピン	入力	-
GPIO14	CON9 17ピン	入力	-
GPIO15	CON9 18ピン	入力	-

	Armadillo-200 シリーズ互換 GPIO ドライバーでの GPIO 名と対応する GPIO ピンの位置は、Armadillo-200 シリーズと同じになっています。そのため、Armadillo-200 シリーズ互換 GPIO ドライバーではArmadillo-400 シリーズで使用可能な GPIO のうち、一部だけしか操作することができません。

デバイスファイルのパラメータは、以下の通りです。

表8.10 Armadillo-200 シリーズ互換 GPIO ドライバーデバイスファイル

タイプ	メジャー番号	マイナー番号	デバイスファイル
キャラクタデバイス	10	185	/dev/gpio

ioctl の第1引数には、デバイスファイルのファイルディスクリプタを指定します。第2引数には、GPIOを操作するためのコマンドを指定します。

表8.11 Armadillo-200 シリーズ互換 GPIO ドライバー ioctl コマンド

コマンド	説明	第3引数のType
PARAM_SET	第3引数で指定する内容でGPIOの状態を設定します	struct gpio_param
PARAM_GET	第3引数で指定する内容でGPIOの状態を取得します	struct gpio_param
INTERRUPT_WAIT	第3引数で指定する内容でGPIOの割込みが発生するまでWAITします	struct wait_param

第3引数には、(カーネルソース)/include/linux/armadillo2x0_gpio.h に定義されている構造体「struct gpio_param」と「struct wait_param」を使用します。「struct gpio_param」は単方向リストになっているので、複数の GPIO を一度に制御する場合は next メンバを使用してください。また、リストの最後の next メンバには"0(NULL)"を指定してください。GPIO デバイスドライバーの詳細な使用方法については、GPIO 操作アプリケーション(atmark-dist/vendors/AtmarkTechno/Armadillo-440/gpioctrl)のソースコードを参考にしてください。

Armadillo-400 シリーズの LED ドライバーは、LED クラスドライバーと Armadillo-200 シリーズ互換 LED ドライバーの2つがあります。標準状態では、LED クラスドライバーが有効になっています。

8.10.2. Armadillo-200 シリーズ互換 LED ドライバー

Armadillo-200 シリーズ互換 LED ドライバーでは、対応するデバイスファイルに対して ioctl を発行することにより、LED の操作を行うことができます。

	Armadillo-200 シリーズ互換 LED ドライバーは標準状態では無効になっています。有効にするには Linux カーネルコンフィギュレーションで、CONFIG_LEDS_GPIO を無効に、CONFIG_ARMADILLO2X0_LED を有効にして、カーネルをビルドする必要があります。

LED に対応するデバイスファイルのパラメータは、以下の通りです。

表8.13 LEDノード

タイプ	メジャー番号	マイナー番号	デバイスファイル
キャラクタデバイス	10	215	/dev/led

ioctl の第1引数には、デバイスファイルのファイルディスクリプタを指定します。第2引数には、LED を操作するためのコマンドを指定します。

表8.14 LED操作コマンド

コマンド	説明	第3引数のType
LED_RED_ON	LED3(赤)を点灯します	なし
LED_RED_OFF	LED3(赤)を消灯します	なし
LED_RED_STATUS	LED3(赤)の点灯状態を取得します	状態を保存するバッファ(最小1バイト)
LED_RED_BLINKON	LED3(赤)の点滅を開始します	なし
LED_RED_BLINKOFF	LED3(赤)の点滅を停止します	なし
LED_RED_BLINKSTATUS	LED3(赤)の点滅状態を取得します	状態を保存するバッファ(最小1バイト)
LED_GREEN_ON	LED(緑)を点灯します	なし
LED_GREEN_OFF	LED4(緑)を消灯します	なし
LED_GREEN_STATUS	LED4(緑)の点灯状態を取得します	状態を保存するバッファ(最小1バイト)
LED_GREEN_BLINKON	LED4(緑)の点滅を開始します	なし
LED_GREEN_BLINKOFF	LED4(緑)の点滅を停止します	なし
LED_GREEN_BLINKSTATUS	LED4(緑)の点滅状態を取得します	状態を保存するバッファ(最小1バイト)

LEDデバイスドライバーの詳細な使用方法については、サンプルのLED制御アプリケーション(atmark-dist/vendors/AtmarkTechno/Armadillo-440/ledctrl)のソースコードを参考にしてください。

Armadillo-400 シリーズでは、ボタン入力はインプットデバイスとして実装されており、ユーザーランドとのインターフェースとしてイベントインターフェースを提供しています。

Armadillo-440 液晶モデルでは、Armadillo-440 本体にオンボードタクトスイッチ× 1と、LCD 拡張ボードにボタン× 3が実装されています。

それぞれのボタンに対するイベントを、表8.15「Armadillo-440液晶モデルボタンイベント」に示します。

Armadillo-440 液晶モデルの標準状態では、ボタンのイベントデバイスは /dev/input/event0 にマップされます。

	イベントデバイスの番号は、検出された順番に割り振られます。そのため、USB キーボードなど他のインプットデバイスが起動時に検出されると、ボタンのイベントデバイス番号は変わる可能性があります。

Armadillo-440 LCD 拡張ボード及びArmadillo-400 RTC オプションモジュールには、リアルタイムクロックが搭載されています。

リアルタイムクロックは、/dev/rtc0 として認識されます。Armadillo-440 液晶モデルに RTC オプションモジュールを接続した場合、RTC オプションモジュールのリアルタイムクロックが /dev/rtc0 となり、LCD 拡張ボードのリアルクロックは /dev/rtc1 として認識されます。

Armadillo-400 シリーズで採用している i.MX25 プロセッサは、内蔵ウォッチドッグタイマーを有しています。

Armadillo-400 シリーズの標準ブートローダーでは、起動直後にこの内蔵ウォッチドッグタイマーを有効にします。標準状態でのタイムアウト時間は 10 秒に設定されます。

Linux カーネルでは、自動でウォッチドッグタイマーをキックします。

もし、何らかの要因で Linux カーネルがフリーズしてウォッチドッグタイマーをキックできなくなりタイムアウトが発生すると、システムリセットが発生します。

i.MX25 プロセッサは、I2C1 から I2C3 の 3 個の I2C コントローラーを内蔵しています。Armadillo-400 シリーズでは、標準で I2C1 はボード内蔵バスとして使用し、I2C2 は CON14 に、I2C3 は CON11 に割り当てています。

I2C バスドライバーは以下の機能を有します。

I2C バスにスレーブデバイスを接続し、それを使用可能にするためには、デバイスに対応したチップドライバを有効にする必要があります。また、チップドライバが "new style"^[18] で記述されていた場合、struct i2c_board_info を適切に設定しなければいけません。Armadillo-400 シリーズでは、linux-2.6.26-at/arch/arm/maxh-mx25/armadillo400.c の armadillo400_i2cN_board_info配列(Nはバスに対応した数値)に記述してください。

I2C 機能に関連するカーネルコンフィギュレーションを表8.16「I2C コンフィギュレーション」に示します。

i.MX25 プロセッサは、CSPI1 から CSPI3 の 3 個の SPI コントローラーを内蔵しています。Armadillo-400 シリーズでは、カーネルコンフィギュレーションにより、CSPI1 及び CSPI3 を CON9 に割り当てることが可能です。

SPIドライバーは以下の機能を有します。

SPI バスにスレーブデバイスを接続し、それを使用可能にするためには、デバイスに対応したドライバを有効にする必要があります。また、struct spi_board_info を適切に設定しなければいけません。Armadillo-400シリーズでは、linux-2.6.26-at/arch/arm/maxh-mx25/armadillo400.c の armadillo400_spiN_board_info配列(Nはバスに対応した数値)に記述してください。

SPI 機能に関連するカーネルコンフィギュレーションを表8.17「SPI コンフィギュレーション」に示します。

Armadillo-400 シリーズでは、CON9_2 と CON9_26 を one wire マスターとして使用することができます。CON9_2 では、i.MX25 プロセッサ内蔵の one wire コントローラーを使用して機能を実現し、CON9_26 では GPIO one wire ドライバを用いて機能を実現しています。

one wire バスにスレーブデバイスを接続し、それを使用可能にするためには、デバイスに対応したスレーブデバイスドライバーを有効にする必要があります。

one wire 機能に関連するカーネルコンフィギュレーションを表8.18「one wire コンフィギュレーション」に示します。

i.MX25 プロセッサは、PWM1 から PWM4 の 4 個の PWM モジュールを内蔵しています。Armadillo-400 シリーズでは、標準では PWM1 を LED バックライト (CON11_12)として使用しています。カーネルコンフィギュレーションを変更することにより、PWM2 を CON9_25 に、PWM4 を CON14_3 に割り当てることができます。

i.MX25のPWMドライバでは、/sys/class/mxc_pwm/(PWM_NAME) 以下のファイルに値を書き込むことで設定変更することができます。設定に使用するファイルを、表8.19「PWM sysfs」に示します。

PWM 機能に関連するカーネルコンフィギュレーションを表8.20「PWM コンフィギュレーション」に示します。

i.MX25 プロセッサは、CAN1 及び CAN2 の 2 個の CAN コントローラ(FlexCAN)を内蔵しています。Armadillo-400 シリーズでは、カーネルコンフィギュレーションにより、CAN2 を CON14 に割り当てることが可能です。

CAN機能は、SocketCANフレームワークを使用して実現しています。SocketCANについては、linux-2.6.26-at/Documentation/networking/can.txtなどを参照してください。

CAN ドライバーは以下の機能を有します。

/sys/devices/platform/FlexCAN.1/ 以下のファイルに値を書き込むことで設定変更することができます。設定に使用するファイルを、表8.21「CAN sysfs」に示します^[19]。

通信速度は以下の計算式により算出されます。

src_clk = 66,500,000 (br_clksrc = bus の場合)
src_clk = 24,000,000 (br_clksrc = osc の場合)
通信速度[bps] = src_clk / br_presdiv / (1 + br_propseg + br_pseg1 + br_pseg2)

CAN 機能に関連するカーネルコンフィギュレーションを表8.22「CAN コンフィギュレーション」に示します。

i.MX25 プロセッサは、キーパッドコントローラを内蔵しています。Armadillo-400では、カーネルコンフィギュレーションにより、CON11をキーパッドに割り当てることが可能です。

	キーパッドドライバーを有効にすると、イベントデバイスは /dev/input/event0 にマップされます。そのため、ボタン及びタッチスクリーンのイベントデバイス番号が変わります。

キーパッド機能に関連するカーネルコンフィギュレーションを表8.23「キーパッドコンフィギュレーション」に示します。

ROW及びCOLのどの範囲をキーパッドとして使用するかは、linux-2.6.26-at/arch/arm/maxh-mx25/armadillo400.c の armadillo440_keypad_data 変数に適切な値を指定してください。また、各ボタンがどのイベントに対応するかというキーマップは armadillo440_keymapping 変数で指定してください。

Armadillo-400 シリーズは Linux パワーマネジメントのスリープ機能をサポートします。スリープ状態では、アプリケーションの実行は一時停止し、カーネルはサスペンド状態となります。スリープ状態では外部デバイスの動作を停止するため、消費電力を抑えることができます。スリープ状態から実行状態に復帰すると、カーネルのリジューム処理が行われた後、アプリケーションの実行を再開します。

/sys/power/state ファイルに、standby もしくは mem を書き込むことにより、スリープモードへ移行することができます。また、スリープモード中にウェイクアップ要因による割り込みが発生すると、スリープモードから実行状態へ復帰します。

各モードによる、状態の違いは表8.24「スリープモード」を参照してください。power-on suspend 状態に比べ、suspend-to-RAMの方がより少ない消費電力でスリープすることができます。

ウェイクアップ要因になることができるデバイスを、ウェイクアップ要因にするかどうかは、各デバイスに対応する sysfs エントリの power/wakeup ファイルで指定することができます。power/wakeup ファイルに enabled と書き込むとウェイクアップ要因になり、 disabled と書き込むとウェイクアップ要因ではなくなります。

表8.25「ウェイクアップ要因の指定」を参照してください。