第7章 Linuxカーネル仕様

第7章 Linuxカーネル仕様

本章では、工場出荷状態のArmadillo-X1 のLinuxカーネル仕様について説明します。

7.1. デフォルトコンフィギュレーション

工場出荷状態のフラッシュメモリに書き込まれているLinuxカーネルイメージには、デフォルトコンフィギュレーションが適用されています。 Armadillo-X1用のデフォルトコンフィギュレーションが記載されているファイルは、Linux カーネルソースファイル(linux-4.9-x1-at[version].tar.gz)に含まれるarch/arm/configs/x1_defconfigです。

x1_defconfigで有効になっている主要な設定を表7.1「Linuxカーネル主要設定」に示します。

表7.1 Linuxカーネル主要設定

コンフィグ	説明
SMP	Symmetric Multi-Processing
SMP_ON_UP	Allow booting SMP kernel on uniprocessor systems
ARM_CPU_TOPOLOGY	Support cpu topology definition
HAVE_ARM_ARCH_TIMER	Architected timer support
VMSPLIT_2G	Memory split (2G/2G user/kernel split)
NO_HZ	Tickless System (Dynamic Ticks)
PREEMPT	Preemptible Kernel
ARM_PATCH_IDIV	Runtime patch udiv/sdiv instructions into __aeabi_{u}idiv()
AEABI	Use the ARM EABI to compile the kernel
HIGHMEM	High Memory Support
CPU_SW_DOMAIN_PAN	Enable use of CPU domains to implement privileged no-access
BOUNCE	Enable bounce buffers
CMA	Contiguous Memory Allocator

7.2. デフォルト起動オプション

工場出荷状態のArmadillo-X1 のLinuxカーネルの起動オプションについて説明します。デフォルト状態では、次のように設定されています。

表7.2 Linuxカーネルのデフォルト起動オプション

起動オプション	説明
console=ttymxc4,115200	起動ログなどが出力されるイニシャルコンソールにttymxc4(CON9)を、ボーレートに 115200bps を指定します。
root=/dev/mmcblk2p2	ルートファイルシステムにeMMCを指定します。
rootwait	"root="で指定したデバイスが利用可能になるまでルートファイルシステムのマウントを遅らせます。
rw	ルートファイルシステムを読み書き可能としてマウントします。

7.3. Linuxドライバ一覧

Armadillo-X1 で利用することができるデバイスドライバについて説明します。各ドライバで利用しているソースコードの内主要なファイルのパスや、コンフィギュレーションに必要な情報、及びデバイスファイルなどについて記載します。

7.3.1. Armadillo-X1

Armadillo-X1のハードウェアの構成情報やピンマルチプレクスの情報、i.MX 7Dualの初期化手順などが定義されています。

関連するソースコード

arch/arm/mach-imx/

arch/arm/mach-imx/armadillo_iotg_addon/

arch/arm/boot/dts/armadillo_x1.dts

arch/arm/boot/dts/imx7s.dtsi

arch/arm/boot/dts/imx7d.dtsi

arch/arm/boot/dts/armadillo_iotg_addon.dtsi

Device Treeドキュメント

Documentation/devicetree/bindings/arm/arch_timer.txt

Documentation/devicetree/bindings/arm/cpus.txt

Documentation/devicetree/bindings/interrupt-controller/arm,gic.txt

Documentation/devicetree/bindings/clock/fixed-clock.txt

Documentation/devicetree/bindings/sram/sram.txt

Documentation/devicetree/bindings/pinctrl/fsl,imx-pinctrl.txt

カーネルコンフィギュレーション

  System Type  --->
      [*] Freescale i.MX family                                                  <ARCH_MXC>
          --- Freescale i.MX family
          [*]   i.MX7 Dual support                                              <SOC_IMX7D>
          [*]     Add-On Module Auto Detect                       <AIOTG_ADDON_AUTO_DETECT>

7.3.2. SPIフラッシュメモリ

Armadillo-X1 では、フラッシュメモリを制御するソフトウェアとして MTD(Memory Technology Device) を利用しています。MTDのキャラクタデバイスまたはブロックデバイスを経由して、ユーザーランドからアクセスすることができます。

関連するソースコード

drivers/mtd/*

drivers/mtd/spi-nor/spi-nor.c

drivers/mtd/spi-nor/fsl-quadspi.c

デバイスファイル

デバイスファイル	デバイスタイプ	対応するパーティション名
/dev/mtd0	キャラクタ	bootloader
/dev/mtd0ro	キャラクタ
/dev/mtdblock0	ブロック
/dev/mtd1	キャラクタ	license
/dev/mtd1ro	キャラクタ
/dev/mtdblock1	ブロック
/dev/mtd2	キャラクタ	reserved
/dev/mtd2ro	キャラクタ
/dev/mtdblock2	ブロック

カーネルコンフィギュレーション

  Device Drivers  --->
      <*> Memory Technology Device (MTD) support  --->                         <CONFIG_MTD>
          <*>   Command line partition table parsing             <CONFIG_MTD_CMDLINE_PARTS>
          <*>   OpenFirmware partitioning information support         <CONFIG_MTD_OF_PARTS>
          <*>   Caching block device access to MTD devices               <CONFIG_MTD_BLOCK>
          <*>   SPI-NOR device support  --->                           <CONFIG_MTD_SPI_NOR>
               <*>   Freescale Quad SPI controller                 <CONFIG_SPI_FSL_QUADSPI>

7.3.3. UART

Armadillo-X1 のシリアルは、i.MX 7Dual の UART(Universal Asynchronous Receiver/Transmitter) を利用しています。

Armadillo-X1 の標準状態では、UART5(CON4)をコンソールとして利用しています。

フォーマット

データビット長: 7 or 8ビット

ストップビット長: 1 or 2ビット

パリティ: 偶数 or 奇数 or なし

フロー制御: CTS/RTS or XON/XOFF or なし

最大ボーレート: 4Mbps

関連するソースコード

drivers/tty/n_tty.c

drivers/tty/tty_buffer.c

drivers/tty/tty_io.c

drivers/tty/tty_ioctl.c

drivers/tty/tty_ldisc.c

drivers/tty/tty_ldsem.c

drivers/tty/tty_mutex.c

drivers/tty/tty_port.c

drivers/tty/serial/serial_core.c

drivers/tty/serial/earlycon.c

drivers/tty/serial/serial_mctrl_gpio.c

drivers/tty/serial/imx.c

Device Treeドキュメント

Documentation/devicetree/bindings/serial/fsl-imx-uart.txt

デバイスファイル

シリアルインターフェース	デバイスファイル
UART5	/dev/ttymxc4
UART7	/dev/ttymxc6

カーネルコンフィギュレーション

  Device Drivers  --->
      Character devices  --->
          [*] Enable TTY                                                              <TTY>
              Serial drivers  --->
                  <*> IMX serial port support                                  <SERIAL_IMX>
                  [*]   Console on IMX serial port                      <SERIAL_IMX_CONSOLE>

7.3.4. Ethernet

Armadillo-X1 のEthernet(LAN)は、i.MX 7Dual の ENET(Ethernet MAC)を利用しています。

機能

通信速度: 1000Mbps(1000BASE-T), 100Mbps(100BASE-TX), 10Mbps(10BASE-T)

通信モード: Full-Duplex(全二重), Half-Duplex(半二重)^[17]

Auto Negotiationサポート

キャリア検知サポート

リンク検出サポート

関連するソースコード

drivers/net/Space.c

drivers/net/loopback.c

drivers/net/mii.c

drivers/net/ethernet/freescale/fec_fixup.c

drivers/net/ethernet/freescale/fec_main.c

drivers/net/ethernet/freescale/fec_ptp.c

drivers/net/phy/mdio_bus.c

drivers/net/phy/mdio_device.c

drivers/net/phy/phy.c

drivers/net/phy/phy_device.c

drivers/net/phy/vitesse.c

Device Treeドキュメント

Documentation/devicetree/bindings/net/fsl-fec.txt

ネットワークデバイス

eth0

カーネルコンフィギュレーション

  Device Drivers  --->
      [*] Network device support  --->                                         <NETDEVICES>
          [*]   Ethernet driver support  --->                                    <ETHERNET>
              [*]   Freescale devices                                <NET_VENDOR_FREESCALE>
              <*>     FEC ethernet controller (of ColdFire and some i.MX CPUs)        <FEC>
          -*-   PHY Device support and infrastructure  --->                        <PHYLIB>
              <*>   Vitesse PHYs                                              <VITESSE_PHY>

7.3.5. WLAN

Armadillo-X1 には、Qualcomm Atheros製 AEH-AR9462 または SparkLAN 製 WPEB-265AXI(BT) [B33] が搭載されています。AEH-AR9462 および WPEB-265AXI(BT) [B33] のWLAN機能は、「PCI Express」に示す PCI Express に接続されています。

WPEB-265AXI(BT) [B33]では、BTのスキャン動作中に2.4GHz帯のWLAN通信が途切れる場合があります。これは、BTと2.4GHz帯のWLANでアンテナリソースが共有されており、BTのスキャン中はWLAN通信を行うことができない為です。スキャン以外のBT通信時にはこのような現象は発生しません。

BTのスキャン動作中にWLAN通信を行う場合は、次のような対策をとることをお勧めします。

WLANを5GHz帯で利用する。
2.4GHz帯のWLANを利用する場合は、APとSTAの接続が切断された際に再接続する。

AEH-AR9462 機能

IEEE 802.11 a/b/g/n 準拠

最大通信速度: 300Mbps(論理値)

動作モード: インフラストラクチャモード(STA/AP), アドホックモード

チャンネル(2.4GHz): 1-13

チャンネル(5GHz): 36-48, 52-64, 100-140

WPEB-265AXI(BT) [B33] 機能

IEEE 802.11 a/b/g/n/ac/ax 準拠

最大通信速度: 1200Mbps(論理値)

動作モード: インフラストラクチャモード(STA/AP), アドホックモード

チャンネル(2.4GHz)(STA/AP): 1-13

チャンネル(5GHz)(STA): 36-64, 100-140 (W52/W53/W56)

チャンネル(5GHz)(AP): 36-48 (W52)

ネットワークデバイス

wlan0

関連するソースコード

drivers/net/wireless/ath/ath9k/

drivers/net/wireless/bcmdhd/

カーネルコンフィギュレーション

  Device Drivers  --->
      [*] Network device support  --->                                         <NETDEVICES>
          [*]   Wireless LAN  --->                                                   <WLAN>
              [*]   Atheros/Qualcomm devices                              <WLAN_VENDOR_ATH>
              [*]     Atheros dynamic user regulatory hints
                                                           <ATH_REG_DYNAMIC_USER_REG_HINTS>
              <*>     Atheros 802.11n wireless cards support                        <ATH9K>
              [*]       Atheros ath9k PCI/PCIe bus support                      <ATH9K_PCI>
              [*]       Atheros DFS support for certified platforms   <ATH9K_DFS_CERTIFIED>
              [*]       Atheros ath9k rfkill support                         <ATH9K_RFKILL>
			  [*]       Atheros ath9k support for PC OEM cards                <ATH9K_PCOEM>
              <*>   Broadcom FullMAC wireless cards support                        <BCMDHD>
              (bcmdhd/fw_bcm43752a2_pcie_ag_apsta.bin) Firmware path       <BCMDHD_FW_PATH>
              (bcmdhd/nvram_ap6275p_mp.txt) NVRAM path                  <BCMDHD_NVRAM_PATH>
                      Enable Chip Interface (PCIe bus interface support)  --->
                                                                              <BCMDHD_PCIE>

7.3.6. BT

Armadillo-X1 には、Qualcomm Atheros製 AEH-AR9462 または SparkLAN 製 WPEB-265AXI(BT) [B33] が搭載されています。AEH-AR9462 および WPEB-265AXI(BT) [B33] のBT機能は、「USBハブ」に示す USB3503 に接続されています。

AEH-AR9462 および WPEB-265AXI(BT) [B33] は、Bluetooth(R) version 4.0に対応しており、BLE(Bluetooth Low Energy)、HS(High Speed)およびEDR(Enhanced Data Rate)が利用できます。

デバイス

hci0

関連するソースコード

drivers/bluetooth/ath3k.c

drivers/bluetooth/btusb.c

カーネルコンフィギュレーション

  [*] Networking support  --->                                                        <NET>
      <*>   Bluetooth subsystem support  --->                                          <BT>
          [*]   Bluetooth Classic (BR/EDR) features                              <BT_BREDR>
          <*>   RFCOMM protocol support                                         <BT_RFCOMM>
          [*]     RFCOMM TTY support                                        <BT_RFCOMM_TTY>
          <*>   BNEP protocol support                                             <BT_BNEP>
          [*]     Multicast filter support                              <BT_BNEP_MC_FILTER>
          [*]     Protocol filter support                            <BT_BNEP_PROTO_FILTER>
          <*>   HIDP protocol support                                             <BT_HIDP>
          [*]     Bluetooth High Speed (HS) features                                <BT_HS>
          [*]   Bluetooth Low Energy (LE) features                                  <BT_LE>
                Bluetooth device drivers  --->
                    <*> HCI USB driver                                        <BT_HCIBTUSB>
                    [*]   Atheros AR300x serial support                     <HCIUART_ATH3K>
      Device Drivers  --->
      [*] Network device support  --->                                         <NETDEVICES>
          [*]   Wireless LAN  --->                                                   <WLAN>
              [*]   Atheros/Qualcomm devices                              <WLAN_VENDOR_ATH>
              [*]     Atheros bluetooth coexistence support          <ATH9K_BTCOEX_SUPPORT>
      [*] USB support  --->                                                   <USB_SUPPORT>
              <*>   USB Serial Converter support  --->                         <USB_SERIAL>
                  <*>   USB CP210x family of UART Bridge Controllers    <USB_SERIAL_CP210X>

AEH-AR9462のファームウェアは、ATDEにインストールされているfirmware-atherosパッケージに含まれています。ファームウェアはLinuxカーネルイメージ内に改変無く配置されます。

firmware-atherosの著作権およびライセンス情報については、ATDE上で/usr/share/doc/firmware-atheros/copyrightを参照してください。


	WPEB-265AXI(BT) [B33]のファームウェアは、ATDEにインストールされているfirmware-bcmdhdパッケージに含まれています。ファームウェアはLinuxカーネルイメージに組み込まれます。

7.3.7. SDホスト

Armadillo-X1 のSDホストは、i.MX 7Dual の uSDHC(Ultra Secured Digital Host Controller)を利用しています。

Armadillo-X1 では、SDスロット拡張ボードのSDインターフェース(CON2)がuSDHC1を利用しています。

機能

カードタイプ: SD/SDHC/SDXC/SDIO

バス幅: 1bit or 4bit

スピードモード: Default Speed(24MHz), High Speed(48MHz), UHS-I(196.36MHz)

カードディテクトサポート

ライトプロテクトサポート

デバイスファイル

メモリカードの場合は、カードを認識した順番で/dev/mmcblkN (Nは'0'または'1')となります。

I/Oカードの場合は、ファンクションに応じたデバイスファイルとなります。

関連するソースコード

drivers/mmc/card/block.c

drivers/mmc/card/queue.c

drivers/mmc/core/

drivers/mmc/host/sdhci-esdhc-imx.c

drivers/mmc/host/sdhci-pltfm.c

drivers/mmc/host/sdhci.c

Device Treeドキュメント

Documentation/devicetree/bindings/mmc/fsl-imx-esdhc.txt

Documentation/devicetree/bindings/mmc/mmc-pwrseq-emmc.txt

カーネルコンフィギュレーション

  Device Drivers  --->
      <*> MMC/SD/SDIO card support  --->                                              <MMC>
                *** MMC/SD/SDIO Card Drivers ***
          <*>   MMC block device driver                                         <MMC_BLOCK>
          (8)     Number of minors per block device                      <MMC_BLOCK_MINORS>
          [*]     Use bounce buffer for simple hosts                     <MMC_BLOCK_BOUNCE>
                *** MMC/SD/SDIO Host Controller Drivers ***
          <*>   Secure Digital Host Controller Interface support                <MMC_SDHCI>
          <*>   SDHCI platform and OF driver helper                       <MMC_SDHCI_PLTFM>
          <*>       SDHCI support for the Freescale eSDHC/uSDHC i.MX controller
                                                                      <MMC_SDHCI_ESDHC_IMX>

SDIOカードを利用する場合は、arch/arm/mach-imx/armadillo_iotg_addon/addon_atmark_techno_sd_x1_intf1.dtsの"usdhc1"ターゲットに"use-sdio"プロパティを追加してください。

	fragment@2 {
		target = <&usdhc1>;
		__overlay__ {
			pinctrl-names = "default", "state_100mhz", "state_200mhz",
					"state_power_off";
			pinctrl-0 = <&pinctrl_usdhc1>;
			pinctrl-1 = <&pinctrl_usdhc1_100mhz>;
			pinctrl-2 = <&pinctrl_usdhc1_200mhz>;
			pinctrl-3 = <&pinctrl_usdhc1_power_off>;
			cd-gpios = <&gpio5 0 1>;
			wp-gpios = <&gpio5 1 0>;
			pinctrl-assert-gpios = <&gpio5 4 1>,	/* SD1_CMD */
					       <&gpio5 5 1>,	/* SD1_DATA0 */
					       <&gpio5 6 1>,	/* SD1_DATA1 */
					       <&gpio5 7 1>,	/* SD1_DATA2 */
					       <&gpio5 8 1>;	/* SD1_DATA3 */
			tuning-step = <2>;
			vmmc-supply = <&reg_sd1_vmmc_intf1>;
			enable-sdio-wakeup;
			keep-power-in-suspend;
			max-frequency = <100000000>;
			use-sdio;
			status = "okay";
		};
	};

"use-sdio"プロパティを追加しない場合、Advanced DMAエラーが発生する場合があります。

7.3.8. USBホスト

Armadillo-X1 のUSBホストは、i.MX 7Dual の USB-PHY(Universal Serial Bus 2.0 Integrated PHY) および USB(Universal Serial Bus Controller) を利用しています。

Armadillo-X1 では、USB ホストインターフェース(CON2)が OTG1 を利用しています。HSIC HOSTには「USBハブ」に示す USB3503 が接続されています。

機能

Universal Serial Bus Specification Revision 2.0 準拠

Enhanced Host Controller Interface (EHCI)準拠

転送レート: USB2.0 High-Speed (480Mbps), Full-Speed (12Mbps), Low-Speed (1.5Mbps)

デバイスファイル

メモリデバイスの場合は、デバイスを認識した順番で/dev/sdN (Nは'a'からの連番)となります。

I/Oデバイスの場合は、ファンクションに応じたデバイスファイルとなります。

関連するソースコード

drivers/usb/chipidea/ci_hdrc_imx.c

drivers/usb/chipidea/ci_hdrc_msm.c

drivers/usb/chipidea/ci_hdrc_zevio.c

drivers/usb/chipidea/core.c

drivers/usb/chipidea/debug.c

drivers/usb/chipidea/host.c

drivers/usb/chipidea/otg.c

drivers/usb/chipidea/usbmisc_imx.c

drivers/usb/host/ehci-hcd.c

drivers/usb/host/ehci-hub.c

drivers/usb/phy/phy-generic.c

drivers/usb/phy/phy.c

Device Treeドキュメント

Documentation/devicetree/bindings/usb/ci-hdrc-usb2.txt

Documentation/devicetree/bindings/usb/usbmisc-imx.txt

Documentation/devicetree/bindings/usb/usb-nop-xceiv.txt

Documentation/devicetree/bindings/regulator/fixed-regulator.txt

カーネルコンフィギュレーション

  Device Drivers  --->
      [*] USB support  --->                                                   <USB_SUPPORT>
          <*>   Support for Host-side USB                                             <USB>
                  *** USB Host Controller Drivers ***
          <*>     EHCI HCD (USB 2.0) support                                 <USB_EHCI_HCD>
          <*>   ChipIdea Highspeed Dual Role Controller                      <USB_CHIPIDEA>
          [*]     ChipIdea device controller                             <USB_CHIPIDEA_UDC>
          [*]     ChipIdea host controller                              <USB_CHIPIDEA_HOST>
                  USB Physical Layer drivers  --->
              <*>     NOP USB Transceiver Driver                            <NOP_USB_XCEIV>

7.3.9. USBハブ

Armadillo-X1 には、Microchip製 USB3503 が搭載されています。USB3503 には、AEH-AR9462 または WPEB-265AXI(BT) [B33]が接続されています。

関連するソースコード

drivers/usb/misc/usb3503.c

Device Treeドキュメント

Documentation/devicetree/bindings/usb/usb3503.txt

カーネルコンフィギュレーション

  Device Drivers  --->
      [*] USB support  --->                                                   <USB_SUPPORT>
          <*>   USB3503 HSIC to USB20 Driver                             <USB_HSIC_USB3503>

ドライブストレングス変更方法

Armadillo-X1はCON7,CON8に、USB3503からUSB信号を引き出すことが可能です。 CON7,CON8に引き出すUSB信号のドライブストレングスを変更したい場合は以下を参考にdtsを修正してください。

usb_hub: usb3503@08 {
	compatible = "smsc,usb3503";
	reg = <0x08>;

	clocks = <&clks IMX7D_CLKO2_ROOT_PRE_DIV>;
	clock-names = "refclk";
	bst21-boost-iout = <0x02>; 
	bstup3-boost-iout = <0x40>; 
	refclk-frequency = <24000000>;
	intn-gpios = <&gpio2 14 GPIO_ACTIVE_HIGH>;
	connect-gpios = <&gpio2 15 GPIO_ACTIVE_HIGH>;
	reset-gpios = <amp;gpio2 13 GPIO_ACTIVE_HIGH>;
	initial-mode = <1>;	/* MODE_HUB */
};

	CON7に引き出されているUSB信号のドライブストレングスを変更します。この例では+10%です。
	CON8に引き出されているUSB信号のドライブストレングスを変更します。この例では+20%です。

表7.3 CON7 ドライブストレングス

-5%	Nominal	+5%	+10%	+15%	+20%	+25%	+30%
0x01	0x00	0x03	0x02	0x05	0x04	0x07	0x06

表7.4 CON8 ドライブストレングス

-5%	Nominal	+5%	+10%	+15%	+20%	+25%	+30%
0x10	0x00	0x30	0x20	0x50	0x40	0x70	0x60

7.3.10. PCI Express

Armadillo-X1 のPCI Express、i.MX 7Dual の PCIe_PHY(PCI Express PHY) を利用しています。

Armadillo-X1 では、AEH-AR9462 または WPEB-265AXI(BT) [B33] が接続されています。

機能

PCI Express Base Specification 2.1 準拠

PIPE Specification 2.0 準拠

リンク幅: x1

転送レート: 5.0GT/s

割り込み通知方式: INTx, MSI-X

関連するソースコード

drivers/pci/host/pcie-designware.c

drivers/pci/host/pci-imx6.c

drivers/pci/*

drivers/pci/pcie/*

カーネルコンフィギュレーション

  Bus support  --->
      [*] PCI support                                                                 <PCI>
      -*- PCI Express Port Bus support                                        <PCIEPORTBUS>
      [ ] Message Signaled Interrupts (MSI and MSI-X)                             <PCI_MSI>
      [*] PCI IOV support                                                         <PCI_IOV>
      [*] PCI PRI support                                                         <PCI_PRI>
      [*] PCI PASID support                                                     <PCI_PASID>
          PCI host controller drivers  --->
              [*] Freescale i.MX6 PCIe controller                                <PCI_IMX6>


	PCI_MSIを有効化すると、AEH-AR9462 および WPEB-265AXI(BT) [B33] が利用できなくなります。

7.3.11. リアルタイムクロック

Armadillo-X1 のリアルタイムクロックは、Board Management ICのRTC機能を利用しています。 Board Management ICのRTC機能は、I2C4 (I2Cノード: 3-0011) に接続されています。

機能

アラーム割り込みサポート

デバイスファイル

/dev/rtc

/dev/rtc0

関連するソースコード

drivers/rtc/class.c

drivers/rtc/hctosys.c

drivers/rtc/interface.c

drivers/rtc/rtc-bmic.c

drivers/rtc/rtc-dev.c

drivers/rtc/rtc-lib.c

drivers/rtc/rtc-proc.c

drivers/rtc/rtc-sysfs.c

drivers/rtc/systohc.c

カーネルコンフィギュレーション

  Device Drivers  --->
      [*] Real Time Clock  --->                                                 <RTC_CLASS>
          [*]   Set system time from RTC on startup and resume                <RTC_HCTOSYS>
          [*]   Set the RTC time based on NTP synchronization                 <RTC_SYSTOHC>
          (rtc0)  RTC used to set the system time                      <RTC_HCTOSYS_DEVICE>
                *** RTC interfaces ***
          [*]   /sys/class/rtc/rtcN (sysfs)                                <RTC_INTF_SYSFS>
          [*]   /proc/driver/rtc (procfs for rtcN)                          <RTC_INTF_PROC>
          [*]   /dev/rtcN (character devices)                                <RTC_INTF_DEV>
          [*]     RTC UIE emulation on dev interface                <RTC_INTF_DEV_UIE_EMUL>
                *** I2C RTC drivers ***
          <*>   Atmark Techno BMIC RTC                                       <RTC_DRV_BMIC>

アラーム割り込みは、sysfs RTCクラスディレクトリ以下のファイルから利用できます。

wakealarmファイルにUNIXエポックからの経過秒数、または先頭に+を付けて現在時刻からの経過秒数を書き込むと、アラーム割り込み発生時刻を指定できます。アラーム割り込み発生時刻を変更するにはwakealarmファイルに"+0"を書き込み、アラーム割り込みのキャンセル後に再設定する必要があります。アラーム割り込みの利用例を次に示します。

[armadillo ~]# cat /proc/interrupts | grep bmic_rtc_irq 
 74:          0          0  gpio-mxc  13 Edge      bmic_rtc_irq, bmic_adc_irq
[armadillo ~]# echo +10 > /sys/class/rtc/rtc0/wakealarm 
[armadillo ~]# cat /sys/class/rtc/rtc0/wakealarm 
1458781144
[armadillo ~]# cat /sys/class/rtc/rtc0/since_epoch 
1458781145
[armadillo ~]# cat /proc/interrupts | grep bmic_rtc_irq 
 74:          1          0  gpio-mxc  13 Edge      bmic_rtc_irq, bmic_adc_irq

	アラーム割り込みの発生回数を確認します。この例では0回です。
	アラーム割り込みの発生時刻を10秒後に設定します。
	アラーム割り込みの発生時刻(UNIXエポックからの経過秒数)を確認します。この例では1458781144秒です。
	現在時刻(UNIXエポックからの経過秒数)を確認します。アラーム割り込みの発生時刻を超えるまで待ちます。
	再度アラーム割り込みの発生回数を確認します。1増えているのでアラーム割り込みが発生したことを確認できます。


	デバイスファイル(`/dev/rtc0`)経由でもアラーム割り込みを利用することができます。より詳細な情報については、Linuxカーネルのソースコードに含まれているドキュメント(`Documentation/rtc.txt`)やサンプルプログラム(`tools/testing/selftests/timers/rtctest.c`)を参照してください。


	`date`コマンドを利用して、UNIXエポックからの経過秒数を日時に変換することができます。 `[armadillo ~]#` date --date=@`cat /sys/class/rtc/rtc0/since_epoch` Thu Mar 24 10:02:56 JST 2016

7.3.12. 温度センサー

Armadillo-X1 の温度センサーは、i.MX 7Dualの TEMPMON(Temperature Monitor)を利用しています。

起動直後の設定では、i.MX 7Dualの測定温度が 105℃以上になった場合、Linuxカーネルが/sbin/poweroffコマンドを実行し、システムを停止します。システム停止後、温度が低下しても自動的には復旧はせずシステムが停止した状態となります。

sysfsディレクトリ

/sys/class/thermal/thermal_zone1/

関連するソースコード

drivers/thermal/imx_thermal.c

drivers/thermal/of-thermal.c

drivers/thermal/step_wise.c

drivers/thermal/thermal_core.c

drivers/thermal/thermal_hwmon.c

カーネルコンフィギュレーション

  Device Drivers  --->
      <*> Generic Thermal sysfs driver  --->                                      <THERMAL>
          [*]   Expose thermal sensors as hwmon device                      <THERMAL_HWMON>
          [*]   APIs to parse thermal data out of device tree                  <THERMAL_OF>
          [*]   Enable writable trip points                        <THERMAL_WRITABLE_TRIPS>
                Default Thermal governor (step_wise)  --->  <THERMAL_DEFAULT_GOV_STEP_WISE>
          -*-   Step_wise thermal governor                          <THERMAL_GOV_STEP_WISE>
          <*>   Temperature sensor driver for Freescale i.MX SoCs             <IMX_THERMAL>

7.3.13. ADコンバーター

Armadillo-X1に搭載されたBoard Management ICのADコンバーター機能およびArmadillo-IoT 絶縁デジタル入出力/アナログ入力アドオンモジュール DA00(以降、絶縁IOアドオンモジュールと記載します)を利用することができます。

Board Management ICのADコンバーター機能は、I2C4(I2Cノード: 3-0012)に接続されています。Armadillo-X1の電源電圧およびBoard Management ICの外部バッテリーの電圧を測定することができます。

絶縁IOアドオンモジュールには、Microchip製 MCP3202 が搭載されています。MCP3202は、ECSPI1に接続されます。

機能(Board Management IC)

分解能: 12bit

測定範囲: 0V 〜 3.3V(Board Management ICの電源電圧)

機能(MCP3202)

分解能: 12bit

測定範囲: 0V 〜 5.0V(MCP3202の電源電圧)

sysfsディレクトリ

デバイスを認識した順番で /sys/bus/iio/devices/iio:deviceN (Nは'0'からの連番)となります。

デバイスファイル

デバイスを認識した順番で /dev/iio:deviceN (Nは'0'からの連番)となります。

関連するソースコード

drivers/iio/industrialio-buffer.c

drivers/iio/industrialio-core.c

drivers/iio/industrialio-event.c

drivers/iio/industrialio-trigger.c

drivers/iio/inkern.c

drivers/iio/adc/bmic_adc.c

drivers/iio/adc/mcp320x.c

カーネルコンフィギュレーション

  Device Drivers  --->
      <*> Industrial I/O support  --->                                                <IIO>
          [*]   Enable buffer support within IIO                               <IIO_BUFFER>
          -*-     Industrial I/O buffering based on kfifo                   <IIO_KFIFO_BUF>
          -*-   Enable triggered sampling support                             <IIO_TRIGGER>
          (2)     Maximum number of consumers per trigger       <IIO_CONSUMERS_PER_TRIGGER>
                Analog to digital converters  --->
                    <*> Atmark Techno BMIC ADC                                   <BMIC_ADC>
                    <*> Microchip Technology MCP3x01/02/04/08                     <MCP320X>

7.3.14. LED

Armadillo-X1 に搭載されているソフトウェア制御可能なLEDには、GPIOが接続されています。Linuxでは、GPIO接続用LEDドライバ(leds-gpio)で制御することができます。

sysfs LEDクラスディレクトリ

/sys/class/leds/led1

関連するソースコード

drivers/leds/led-class.c

drivers/leds/led-core.c

drivers/leds/led-triggers.c

drivers/leds/leds-gpio.c

drivers/leds/trigger/ledtrig-backlight.c

drivers/leds/trigger/ledtrig-default-on.c

drivers/leds/trigger/ledtrig-gpio.c

drivers/leds/trigger/ledtrig-heartbeat.c

drivers/leds/trigger/ledtrig-oneshot.c

drivers/leds/trigger/ledtrig-timer.c

Device Treeドキュメント

Documentation/devicetree/bindings/leds/leds-gpio.txt

カーネルコンフィギュレーション

  Device Drivers  --->
      -*- LED Support  --->                                                      <NEW_LEDS>
          <*>   LED Class Support                                              <LEDS_CLASS>
                *** LED drivers ***
          <*>   LED Support for GPIO connected LEDs                             <LEDS_GPIO>
                *** LED Triggers ***
          -*-   LED Trigger support  --->                                   <LEDS_TRIGGERS>
              <*>   LED Timer Trigger                                  <LEDS_TRIGGER_TIMER>
              <*>   LED One-shot Trigger                             <LEDS_TRIGGER_ONESHOT>
              <*>   LED Heartbeat Trigger                          <LEDS_TRIGGER_HEARTBEAT>
              <*>   LED backlight Trigger                          <LEDS_TRIGGER_BACKLIGHT>
              <*>   LED GPIO Trigger                                    <LEDS_TRIGGER_GPIO>
              <*>   LED Default ON Trigger                        <LEDS_TRIGGER_DEFAULT_ON>

7.3.15. ユーザースイッチ

Armadillo-X1 に搭載されているユーザースイッチには、GPIOが接続されています。GPIOが接続されユーザー空間でイベント(Press/Release)を検出することができます。Linuxでは、GPIO接続用キーボードドライバ(gpio-keys)で制御することができます。

ユーザースイッチには、次に示すキーコードが割り当てられています。

表7.5 キーコード

ユーザースイッチ	キーコード	イベントコード
SW1	KEY_1	2

デバイスファイル

/dev/input/event1^[18]

関連するソースコード

drivers/input/evdev.c

drivers/input/ff-core.c

drivers/input/input-compat.c

drivers/input/input-mt.c

drivers/input/input-polldev.c

drivers/input/input.c

drivers/input/keyboard/gpio_keys.c

Device Treeドキュメント

Documentation/devicetree/bindings/input/gpio-keys.txt

カーネルコンフィギュレーション

  Device Drivers  --->
      Input device support  --->
          -*- Generic input layer (needed for keyboard, mouse, ...)                 <INPUT>
          -*-   Polled input device skeleton                                <INPUT_POLLDEV>
                *** Userland interfaces ***
          <*>   Event interface                                               <INPUT_EVDEV>
                *** Input Device Drivers ***
          [*]   Keyboards  --->                                            <INPUT_KEYBOARD>
              <*>   GPIO Buttons                                            <KEYBOARD_GPIO>

7.3.16. I2C

Armadillo-X1 のI2Cインターフェースは、i.MX 7Dual の I2C(I2C Controller) を利用します。また、GPIOを利用したI2Cバスドライバ(i2c-gpio)を利用することで、I2Cバスを追加することができます。

Armadillo-X1 で利用しているI2Cバスと、接続されるI2Cデバイスを次に示します。

表7.6 I2Cデバイス

I2Cバス	I2Cデバイス
I2Cバス	アドレス	デバイス名
2(I2C3)	0x50	M24C01-W EEPROM^[a]
3(I2C4)	0x08	USB3503 USBハブ
	0x09	PF3000 パワーマネジメントIC
	0x10 〜 0x17	Board Management IC
^[a]アドオンインターフェース(CON7)にアドオンモジュールを接続した場合。

Armadillo-X1 の標準状態では、CONFIG_I2C_CHARDEVが有効となっているためユーザードライバでI2Cデバイスを制御することができます。ユーザードライバを利用する場合は、LinuxカーネルでI2Cデバイスに対応するデバイスドライバを無効にする必要があります。

機能

最大転送レート: 400kbps

デバイスファイル

/dev/i2c-2 (I2C3)

/dev/i2c-3 (I2C4)

関連するソースコード

drivers/i2c/i2c-boardinfo.c

drivers/i2c/i2c-core.c

drivers/i2c/i2c-dev.c

drivers/i2c/algos/i2c-algo-bit.c

drivers/i2c/busses/i2c-gpio.c

drivers/i2c/busses/i2c-imx.c

Device Treeドキュメント

Documentation/devicetree/bindings/i2c/i2c-imx.txt

カーネルコンフィギュレーション

  Device Drivers  --->
      <*> I2C support  --->                                                           <I2C>
          <*>   I2C device interface                                          <I2C_CHARDEV>
                I2C Algorithms  --->
                    -*- I2C bit-banging interfaces                                  <I2C_ALGOBIT>
                I2C Hardware Bus support  --->
              <*> GPIO-based bitbanging I2C                                      <I2C_GPIO>
              <*> IMX I2C interface                                               <I2C_MXC>

7.3.17. SPI

Armadillo-X1 のSPIインターフェースは、i.MX 7Dual の ECSPI(Enhanced Configurable SPI)を利用します。

標準状態では無効になっている CONFIG_SPI_SPIDEV を有効化すると、ユーザードライバでSPIデバイスを制御することができます。

関連するソースコード

drivers/spi/spi-bitbang.c

drivers/spi/spi-imx.c

drivers/spi/spi.c

drivers/spi/spidev.c

Device Treeドキュメント

Documentation/devicetree/bindings/spi/fsl-imx-cspi.txt

カーネルコンフィギュレーション

  Device Drivers  --->
      [*] SPI support  --->                                                           <SPI>
                *** SPI Master Controller Drivers ***
          -*-   Utilities for Bitbanging SPI masters                          <SPI_BITBANG>
          <*>   Freescale i.MX SPI controllers                                    <SPI_IMX>
                *** SPI Protocol Masters ***
          < >   User mode SPI device driver support                            <SPI_SPIDEV>

7.3.18. ウォッチドッグタイマー

Armadillo-X1 のウォッチドッグタイマーは、i.MX 7Dual の WDOG(Watchdog Timer) を利用しています。

ウォッチドッグタイマーは、U-Bootによって有効化されます。標準状態でタイムアウト時間は10秒に設定されます。Linuxカーネルは、ウォッチドッグタイマードライバの初期化時にタイムアウト時間を10秒に再設定します。

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

関連するソースコード

drivers/watchdog/imx2_wdt.c

drivers/watchdog/watchdog_core.c

drivers/watchdog/watchdog_dev.c

Device Treeドキュメント

Documentation/devicetree/bindings/watchdog/fsl-imx-wdt.txt

カーネルコンフィギュレーション

  Device Drivers  --->
      -*-   WatchDog Timer Driver Core                                      <WATCHDOG_CORE>
      [*] Watchdog Timer Support  --->                                           <WATCHDOG>
          <*>   IMX2+ Watchdog                                                   <IMX2_WDT>

i.MX 7Dual の WDOG は、一度有効化すると無効化することができません。そのため、haltコマンドなどを実行してLinux カーネルを停止した場合は、ウォッチドッグタイマーのキックができなくなるためシステムリセットが発生します。

WDOGドライバーの終了処理では、タイムアウト時間をWDOGの最大値である128秒に設定します。

7.3.19. パワーマネジメント

Armadillo-X1のパワーマネジメント機能は、LinuxのSPM(System Power Management)およびDPM(Device Power Management)を利用しています。パワーマネジメント状態を省電力モードに遷移させることにより、Armadillo-X1の消費電力を抑えることができます。


	パワーマネジメント機能を利用する場合は、Linuxカーネル linux-4.9-x1-at2 以降(カーネルイメージ uImage-x1-v4.9-at2 以降)をご利用ください。

パワーマネジメント状態を省電力モードに遷移させると、アプリケーションの実行は一時停止し、Linuxカーネルはサスペンド状態となります。起床要因が発生すると、Linuxカーネルのリジューム処理が行われた後、アプリケーションの実行を再開します。

sysfsファイル

/sys/power/state

関連するソースコード

kernel/power/

カーネルコンフィギュレーション

  Power management options  --->
      [*] Suspend to RAM and standby                                              <SUSPEND>
      -*- Device power management core functionality                                   <PM>

Armadillo-X1が対応するパワーマネジメント状態と、/sys/power/stateに書き込む文字列の対応を次に示します。

表7.7 対応するパワーマネジメント状態

パワーマネジメント状態	文字列	説明
Power-On Suspend	standby	Suspend-to-RAMよりも短時間で復帰することができる。
Suspend-to-RAM	mem	Power-On Suspendよりも消費電力を抑えることができる。

起床要因として利用可能なデバイスは次の通りです。

表7.8 起床要因として利用可能なデバイス

デバイス	起床要因の有効化	起床要因
UART5(CON4)	`[armadillo ~]#` `echo enabled > /sys/bus/platform/drivers/imx-uart/30a70000.serial/tty/ttymxc4/power/wakeup`	データ受信
UART7(CON7)	`[armadillo ~]#` `echo enabled > /sys/bus/platform/drivers/imx-uart/30a90000.serial/tty/ttymxc6/power/wakeup`	データ受信
Ethernet(CON1)	`[armadillo ~]#` `apt-get install ethtool` `[armadillo ~]#` `ethtool -s eth0 wol g`	Wake-on-LANのマジックパケットを受信
USBホスト(CON2)	`[armadillo ~]#` `echo enabled > /sys/bus/platform/devices/30b10000.usb/power/wakeup` `[armadillo ~]#` `echo enabled > /sys/bus/platform/drivers/ci_hdrc/ci_hdrc.0/power/wakeup` `[armadillo ~]#` `echo enabled > /sys/bus/platform/drivers/ci_hdrc/ci_hdrc.0/usb1/power/wakeup`	USBデバイスの挿抜

Ethernetから起床要因であるWake-on-LANのマジックパケットを、ATDEから送信する例を次に示します。

[PC ~]$ sudo apt-get install wakeonlan
[PC ~]$ wakeonlan [MAC Address]

Armadillo-X1の有線LANのMACアドレスを指定します。

^[17]1000BASE-Tは半二重通信非サポート

^[18]USBデバイスなどを接続してインプットデバイスを追加している場合は、番号が異なる可能性があります


第6章動作確認方法	PDF version	第8章 Debian ユーザーランド仕様