Armadillo-400 Series
Software Manual


1. Preface
1.1. Who Should Read This Document
1.2. Document Structure
1.3. Typographical Conventions
1.3.1. Fonts
1.3.2. Command Entry Examples
1.3.3. Icons
1.4. Acknowledgements
1.5. Software Usage Precautions
1.6. Trademarks
2. System Overview
2.1. Armadillo-400 Series Basic Specifications
2.2. Basic Specifications of Armadillo-420 Basic Model
2.3. Basic Specifications of Armadillo-440 LCD Model
2.4. Memory Map
2.5. Software Make-up
2.5.1. Bootloader
2.5.2. Kernel
2.5.3. Userland
2.5.4. Downloader
2.6. Boot Modes
3. Before Getting Started
3.1. Preparation
3.2. Connections
3.3. Serial Console Software Configuration
4. Development Environment Set-up
4.1. Installing Cross Development Environment Packages
4.2. Installing Packages Required for Atmark-Dist Builds
4.3. Installing Cross Development Library Packages
5. Rewriting Flash Memory
5.1. Flash Memory Writing Regions
5.2. Installing Downloader
5.2.1. For Linux
5.2.2. For Windows
5.3. Rewriting Flash Memory With A Downloader
5.3.1. Preparation
5.3.2. For Linux
5.3.3. For Windows
5.4. Rewriting Flash Memory With tftpdl
5.5. Rewriting Flash Memory With netflash
5.6. Restoring Bootloader to Factory State
5.6.1. Preparation
5.6.2. For Linux
5.6.3. For Windows
6. Building
6.1. Building Kernel and Userland Images
6.1.1. Preparing Source Code
6.1.2. Applying Default Configuration
6.1.3. Building
6.1.4. Customizing Images
6.1.5. Adding An Application To The Userland Image
6.2. Building Bootloader Images
6.2.1. Preparing Source Code
6.2.2. Building
7. Kernel and Userland Placement
7.1. Loading From A TFTP Server
7.1.1. File Placement
7.1.2. Boot Options
7.2. Loading From Storage
7.2.1. Partitioning
7.2.2. Creating Filesystems
7.2.3. Kernel Image Placement
7.2.4. Creating A Root Filesystem
7.2.5. Boot Device and Kernel Parameter Settings
7.3. Return Settings To Defaults
8. Linux Kernel Device Driver Specifications
8.1. UART
8.2. Ethernet
8.3. SD/MMC/SDIO Host
8.4. USB 2.0 Host
8.5. Frame Buffer
8.6. LED Backlight
8.7. Touchscreen
8.8. Audio
8.9. GPIO
8.9.1. GPIO sysfs
8.9.2. Armadillo-200 Series Compatible GPIO Driver
8.10. LED
8.10.1. LED Class
8.10.2. Armadillo-200 Series Compatible LED Driver
8.11. Buttons
8.12. Real-time Clock
8.13. Watchdog Timer
8.14. I2C
8.15. SPI
8.16. One Wire
8.17. PWM
8.18. CAN
8.19. Keypad
8.20. Power Management
8.20.1. Treatment of External Devices During Sleep
A. Hermit-At Bootloader
A.1. version
A.1.1. version Example
A.2. info
A.2.1. info Example
A.3. memmap
A.3.1. memmap Example
A.4. mac
A.4.1. mac Example
A.5. md5sum
A.5.1. md5sum Example
A.6. erase
A.6.1. erase Example
A.7. setenv and clearenv
A.7.1. setenv/clearenv Example
A.7.2. Linux Kernel Parameters
A.8. setbootdevice
A.8.1. setbootdevice Example
A.9. frob
A.10. tftpdl
A.10.1. tdtpdl Example
A.11. tftpboot
A.11.1. tdtpboot Example
A.12. boot
A.12.1. boot Example
A.13. Note On Versions


2.1. Armadillo-420/440 Block Diagram
2.2. Basic Layout of Armadillo-420 Basic Model
2.3. Basic Layout of Armadillo-440 LCD Model
3.1. Armadillo-440 LCD Model Connections
3.2. Armadillo-420 Basic Model Connections
4.1. Install Command
4.2. Installed Version Display Command
4.3. Cross Development Library Package Creation
4.4. Installing Cross Development Library Packages
4.5. apt-cross Command
5.1. Installing Downloader (Linux)
5.2. Download Command
5.3. Download Command (With Port Option)
5.4. Download Command (Unprotected)
5.5. Hermit-At Win32: Download Window
5.6. Hermit-At Win32: Download Dialog
5.7. tftpdl Command Example
5.8. netflash Command Example
5.9. shoehorn Command Example
5.10. shoehorn Command Log
5.11. Hermit-At Win32: Shoehorn Window
5.12. Hermit-At Win32: shoehorn Dialog
6.1. Source Code Preparation
6.2. Atmark-Dist Build
6.3. Atmark-Dist Configuration
6.4. menuconfig: Main Menu
6.5. menuconfig: Kernel/Library/Defaults Selection
6.6. menuconfig: Do you wish to save your new kernel configuration?
6.7. menuconfig: Linux Kernel Configuration
6.8. menuconfig: Userland Configuration
6.9. Userland Image Customization
6.10. Hermit-At Source Archive Extraction
6.11. Hermit-At Build Example
7.1. tftpboot Command
7.2. tftpboot Command Example
7.3. Partitioning Procedure
7.4. Filesystem Creation Procedure
7.5. Kernel Image Placement
7.6. Root Filesystem Creation With Debian Archives
7.7. Root Filesystem Creation With Atmark-Dist Image
7.8. Boot Device Designation
7.9. Root Filesystem Designation Example
7.10. Assigning Flash Memory As Boot Device
7.11. Return Kernel Parameters To Default State With clearenv
8.1. GPIO sysfs Interrupt Sample Program
8.2. CAN Transmission Speed Calculation
A.1. version Syntax
A.2. version Example
A.3. info Syntax
A.4. info Example
A.5. memmap Syntax
A.6. memmap Example
A.7. mac Syntax
A.8. mac Example
A.9. md5sum Syntax
A.10. md5sum Example
A.11. erase Syntax
A.12. erase Example
A.13. setenv/clearenv Syntax
A.14. setenv and clearenv Example
A.15. setbootdevice Syntax
A.16. Assigning Flash Memory As Boot Device
A.17. Assigning TFTP Server As Boot Device
A.18. Assign SD/MMC Card As Boot Device
A.19. tftpdl Syntax
A.20. tftpdl Example
A.21. tftpboot Syntax
A.22. tftpboot Example
A.23. boot Syntax
A.24. boot Example


1.1. Fonts
1.2. Relationship Between Prompt and Execution Environment
1.3. Abbreviations Used In Command Entry Examples
2.1. Armadillo-400 Series Basic Specifications
2.2. Basic Specifications of RTC Option Module
2.3. Pin Layout of Armadillo-420 Basic Model Expansion Interfaces
2.4. Basic Specifications of Expansion Board
2.5. Pin Layout of Armadillo-440 LCD Model Expansion Interfaces
2.6. Armadillo-420 Flash Memory Map
2.7. Armadillo-440 Flash Memory Map
2.8. Jumper Settings
3.1. Serial Communication Configuration
4.1. List of Packages Required for Atmark-Dist Builds
5.1. Region Names and Corresponding Image Files
5.2. Downloader List
5.3. Region Names and Corresponding Options
5.4. Region Names and Corresponding Device Files
6.1. Product Name List
7.1. Kernel Image Download URLs
7.2. Debian Archive Download URLs
7.3. Atmark-Dist Image Download URL
8.1. Serial Interface Device Files
8.2. UART Configuration
8.3. SD/MMC/SDIO Host Controller Configuration
8.4. Frame Buffer Device Files
8.5. Touchscreen Events
8.6. Audio Configuration
8.7. GPIO_NAME and GPIO Pins
8.8. GPIO I/O Direction Configuration
8.9. GPIO Interrupt Type Configuration
8.10. Armadillo-200 Series Compatible GPIO Driver GPIO List
8.11. Armadillo-200 Series Compatible GPIO Driver Device File
8.12. Armadillo-200 Series Compatible GPIO Driver ioctl Commands
8.13. LED List
8.14. LED Node
8.15. LED Manipulation Commands
8.16. Armadillo-440 LCD Model Button Events
8.17. I2C Configuration
8.18. SPI Configuration
8.19. One Wire Configuration
8.20. PWM sysfs
8.21. PWM Configuration
8.22. CAN sysfs
8.23. CAN Configuration
8.24. Keypad Configuration
8.25. Sleep Modes
8.26. Wakeup Basis Designation
A.1. Well Used Linux Kernel Parameters
A.2. frob Command
A.3. tftpdl Options