Atmark Techno Armadillo-420 User guide

Armadillo-420 Basic Model
Development Set
Startup Guide
A4200-D00Z
Version 1.0.1
2010/11/05
Atmark Techno, Inc.
Armadillo Developers Site

Armadillo-420 Basic Model Development Set Startup Guide
Atmark Techno, Inc.
060-0035 AFT Bldg. 6F, N5E2, Chuo-ku, Sapporo
TEL [phone] FAX [phone]
製製製製 © 2010 Atmark Techno, Inc.
Version 1.0.1
2010/11/05


1. Preface ................................................................................................................................................. 8
1.1. Who Should Read This Document ................................................................................................... 8
1.2. Document Structure ...................................................................................................................... 8
1.3. Typographical Conventions ............................................................................................................ 8
1.3.1. Fonts ............................................................................................................................... 8
1.3.2. Command Entry Examples .................................................................................................. 9
1.3.3. Icons ............................................................................................................................... 9
1.4. Acknowledgements ...................................................................................................................... 9
1.5. Safety Precautions ...................................................................................................................... 10
1.6. Handling Precautions .................................................................................................................. 10
1.7. Software Usage Precautions ......................................................................................................... 10
1.8. Trademarks ............................................................................................................................... 11
2. Before Getting Started ........................................................................................................................... 12
2.1. Layout Diagram ......................................................................................................................... 12
2.2. Preparation ............................................................................................................................... 13
2.3. Connections .............................................................................................................................. 13
2.3.1. microSD Insertion ............................................................................................................ 13
2.4. Jumper Pin Configuration ............................................................................................................ 14
2.5. Serial Console Software Configuration ........................................................................................... 14
3. Startup and Shutdown ............................................................................................................................ 15
3.1. Startup ..................................................................................................................................... 15
3.2. Login ....................................................................................................................................... 18
3.3. Shutdown Method ...................................................................................................................... 18
4. Network .............................................................................................................................................. 20
4.1. Default Network Connection Mechanisms ...................................................................................... 20
4.1.1. DHCP Connections .......................................................................................................... 20
4.1.2. Zeroconf Connections ....................................................................................................... 20
4.2. Changing Network Configuration .................................................................................................. 20
4.2.1. Using a Web Browser to Change Network Configuration ........................................................ 21
4.2.2. Logging In to Change Network Configuration ....................................................................... 21
4.2.3. Checking The Connection ................................................................................................. 22
4.3. Firewall .................................................................................................................................... 22
4.4. Network Applications ................................................................................................................. 22
4.4.1. Telnet ............................................................................................................................ 22
4.4.2. FTP ............................................................................................................................... 23
4.4.3. SSH .............................................................................................................................. 23
4.4.4. Web Server ..................................................................................................................... 24
4.4.5. NTP Client ..................................................................................................................... 24
4.4.6. SMTP Client ................................................................................................................... 24
4.4.7. at-cgi ............................................................................................................................. 25
4.5. Using Bonjour ........................................................................................................................... 39
4.5.1. Installing Bonjour ............................................................................................................ 39
4.5.2. Operational Check ........................................................................................................... 41
4.5.3. Bonjour Hostnames .......................................................................................................... 42
5. Storage ............................................................................................................................................... 43
5.1. Devices Which Can Be Used As Storage ........................................................................................ 43
5.2. Storage Initialization and Mounting ............................................................................................... 43
5.2.1. Disk Initialization ............................................................................................................ 43
5.2.2. Filesystem Creation .......................................................................................................... 44
5.2.3. Mounting ....................................................................................................................... 44
5.3. Storage Operational Check ........................................................................................................... 44
5.3.1. Writing Data ................................................................................................................... 44
5.3.2. Checking Data ................................................................................................................ 45
Armadillo-420 Basic Model Development Set Startup Guide Startup Guide
3

6. Input Devices ....................................................................................................................................... 46
6.1. evtest ....................................................................................................................................... 46
6.2. swmgr ...................................................................................................................................... 46
6.3. swmgr Example ......................................................................................................................... 47
7. Other Devices ...................................................................................................................................... 48
7.1. LED ........................................................................................................................................ 48
7.1.1. Activating and Deactivating LEDs ...................................................................................... 48
7.1.2. Using Triggers ................................................................................................................ 48
7.2. GPIO ....................................................................................................................................... 49
7.2.1. Changing I/O Direction ..................................................................................................... 50
7.2.2. Obtaining Input Level ....................................................................................................... 50
7.2.3. Configuring Output Level .................................................................................................. 50
7.3. RTC ........................................................................................................................................ 50
7.3.1. Setting System Clock With date .......................................................................................... 51
7.3.2. Setting System Clock With NTP Client ................................................................................ 51
7.3.3. Setting Hardware Clock .................................................................................................... 51
7.4. UVC Compatible Web Cameras .................................................................................................... 51
8. Boot Modes and Bootloader Functions ...................................................................................................... 53
8.1. Boot Mode Selection ................................................................................................................... 53
8.2. Linux Kernel Boot Option Configuration ........................................................................................ 53
8.2.1. Console Configuration ...................................................................................................... 53
8.2.2. Specifying Image File To Boot ........................................................................................... 54
8.2.3. Other Boot Options .......................................................................................................... 54
8.2.4. Boot Option Configuration Examples .................................................................................. 54
9. Config Region - Configuration File Storage ............................................................................................... 55
9.1. Reading From The Config Region ................................................................................................. 55
9.2. Saving To The Config Region ...................................................................................................... 55
9.3. Initializing The Config Region ...................................................................................................... 55
10. Troubleshooting .................................................................................................................................. 56
10.1. The Armadillo Will Not Boot ...................................................................................................... 56
10.2. The Armadillo Cannot Be Found With Bonjour .............................................................................. 56
10.3. The Screen Does Not Display After Changing The Network Configuration .......................................... 56
Armadillo-420 Basic Model Development Set Startup Guide Startup Guide
4


2.1. Layout Diagram ................................................................................................................................. 12
2.2. Connection Diagram ........................................................................................................................... 13
2.3. microSD Insertion Diagram .................................................................................................................. 14
3.1. Boot Log .......................................................................................................................................... 15
3.2. Shutdown Method .............................................................................................................................. 18
4.1. Static IP Address Configuration ............................................................................................................ 21
4.2. DHCP Configuration .......................................................................................................................... 21
4.3. DNS Server Configuration ................................................................................................................... 21
4.4. Enabling Configuration ....................................................................................................................... 22
4.5. Ping Confirmation .............................................................................................................................. 22
4.6. iptables ............................................................................................................................................ 22
4.7. telnet ............................................................................................................................................... 22
4.8. ftp ................................................................................................................................................... 23
4.9. Starting sshd ...................................................................................................................................... 23
4.10. ssh ................................................................................................................................................. 23
4.11. ntpclient .......................................................................................................................................... 24
4.12. mail ............................................................................................................................................... 24
4.13. Hostname Configuration Confirmation ................................................................................................. 24
4.14. AT Admin: Overview ........................................................................................................................ 25
4.15. AT Admin: System Username / Password Authorization .......................................................................... 26
4.16. AT Admin: System - System Overview ................................................................................................ 28
4.17. AT Admin: System - Network ............................................................................................................. 30
4.18. AT Admin: System - Network Update .................................................................................................. 32
4.19. AT Admin: System - Password ............................................................................................................ 33
4.20. AT Admin: System - Firmware ........................................................................................................... 34
4.21. AT Admin: System - Updating Firmware .............................................................................................. 36
4.22. AT Admin: System - Save & Load ....................................................................................................... 37
4.23. AT Admin: System - Reload ............................................................................................................... 38
4.24. AT Admin: System - Reboot ............................................................................................................... 39
4.25. Internet Explorer Explorer Bar Configuration ......................................................................................... 41
4.26. "Bonjour" Explorer Bar ..................................................................................................................... 41
4.27. Web Server Top Page ........................................................................................................................ 42
5.1. Disk Initialization Method ................................................................................................................... 43
5.2. Filesystem Creation ............................................................................................................................ 44
5.3. Mount Method ................................................................................................................................... 44
5.4. Writing Data To Storage ...................................................................................................................... 45
5.5. Writing Data To Storage ...................................................................................................................... 45
5.6. Storage Data Check ............................................................................................................................ 45
6.1. evtest Command Format ...................................................................................................................... 46
6.2. swmgr Command Format ..................................................................................................................... 46
6.3. swmgr Example 1 ............................................................................................................................... 47
7.1. Turning LED5 On .............................................................................................................................. 48
7.2. Turning LED5 Off .............................................................................................................................. 48
7.3. Displaying LED5 State ........................................................................................................................ 48
7.4. Specifying timer As Trigger For LED3 ................................................................................................... 49
7.5. Displaying LED3 Timer ...................................................................................................................... 49
7.6. Obtaining CON9_1 Input Level ............................................................................................................ 50
7.7. Configuring CON9_2 Output Level ....................................................................................................... 50
7.8. MJPG-Streamer Demo Page ................................................................................................................. 52
8.1. Linux Kernel Boot Option Clear ............................................................................................................ 53
8.2. Console Designation ........................................................................................................................... 53
8.3. Boot Option Configuration Example 1 .................................................................................................... 54
9.1. Reading From The Config Region ......................................................................................................... 55
Armadillo-420 Basic Model Development Set Startup Guide Startup Guide
5

9.2. Saving To The Config Region .............................................................................................................. 55
9.3. Config Region Initialization ................................................................................................................. 55
Armadillo-420 Basic Model Development Set Startup Guide Startup Guide
6


1.1. Fonts ................................................................................................................................................. 9
1.2. Relationship Between Prompt and Execution Environment ........................................................................... 9
1.3. Abbreviations Used In Command Entry Examples ...................................................................................... 9
2.1. Serial Communication Configuration ..................................................................................................... 14
3.1. Serial Console Login Username and Password ......................................................................................... 18
4.1. Static IP Address Configuration Example ............................................................................................... 21
4.2. Username for Telnet Login .................................................................................................................. 22
4.3. Username for FTP Login ..................................................................................................................... 23
4.4. Username for ssh Login ....................................................................................................................... 23
4.5. Armadillo-420 Bonjour Links ............................................................................................................... 41
5.1. Storage Devices ................................................................................................................................. 43
6.1. Input Device Files .............................................................................................................................. 46
6.2. Buttons Supported By swmgr ............................................................................................................... 46
7.1. LEDs and LED Class Directories .......................................................................................................... 48
7.2. trigger Configuration .......................................................................................................................... 49
7.3. GPIO and GPIO Class Directories ......................................................................................................... 49
7.4. direction Configuration ....................................................................................................................... 50
8.1. Boot Modes ...................................................................................................................................... 53
8.2. Console Configuration Effect On Output Destination ................................................................................ 54
Armadillo-420 Basic Model Development Set Startup Guide Startup Guide
7

1. Preface
Thank you for purchasing the Armadillo-420 Basic Model Development Set.
The Armadillo-420 Basic Model is comprised of the Armadillo-420 CPU board and the Armadillo-400 RTC Option
Module.
The Armadillo-420 is a small form factor general purpose CPU board which along with the Freescale ARM9 processor
"i.MX257", LPDDR SDRAM and flash memory, also incorporates interfaces which are often required for embedded
devices, such as serial, LAN, USB 2.0, microSD and GPIO. Armadillo-420 keeps pin compatibility with the existing
Armadillo-220 model while at the same time also offering improved performance and even lower power consumption.
The Armadillo-400 RTC Option Module can be connected to Armadillo-420 or Armadillo-440 to add RTC functionality.
Linux is employed as the standard operating system on Armadillo-420, providing access to a rich array of software
resources. It is also possible to create and run original programs with C and other programming languages. For information
on how to customize software, please refer to the "Armadillo-400 Series Software Manual."
This document contains precautions for use and explanations on how to use the software functionality available in the
default state as at time of purchase. On obtaining the Armadillo-420 Basic Model Development Set, please check the
operation of all hardware and the use of the default software.
The product name "Armadillo" will be used in descriptions that apply to the whole Armadillo Series for the remainder
of this document.
1.1. Who Should Read This Document
• Those undertaking a hardware operation check
• Those seeking to understand basic software use
We hope that this document will prove to be useful to others as well.
1.2. Document Structure
This document describes the basic usage of Armadillo.
The main areas covered are listed below.
• Connections
• Startup and Shutdown
• Configuration
• Application usage
1.3. Typographical Conventions
1.3.1. Fonts
Fonts are used in the following ways in this document.
Armadillo-420 Basic Model Development Set Startup Guide Preface
8

 1.1 Fonts
Font Example Description
Plain text font Used for standard text
[PC ~]$ ls Shell prompt and user input text
text Text that is either displayed, is to be edited, or is a comment
1.3.2. Command Entry Examples
The command entry examples in this document all have an assumed execution environment which is reflected in the
displayed prompt. The directory part “/”will differ depending on the current directory. The home directory of each user is
represented by “~”.
 1.2 Relationship Between Prompt and Execution Environment
Prompt Command Execution Environment
[PC /]# To be executed by a privileged user on the work PC
[PC /]$ To be executed by a general user on the work PC
[armadillo /]# To be executed by a privileged user on Armadillo
[armadillo /]$ To be executed by a general user on Armadillo
hermit> To be executed on Armadillo in maintenance mode
Commands that may change or vary depending on the relevant environment are written as shown below. Please adjust
the commands as necessary.
 1.3 Abbreviations Used In Command Entry Examples
Notation Description
[version] File version number
1.3.3. Icons
Icons are used in the following way in this document.
This is used for precautions.
This is used for helpful information.
1.4. Acknowledgements
The software used on Armadillo is composed from Free Software / Open Source Software. This Free Software / Open
Source Software is the result of efforts from developers from all over the world. We would like to take this opportunity to
express our gratitude.
Armadillo-420 Basic Model Development Set Startup Guide Preface
9

1.5. Safety Precautions
In order to use this product safely, please take special note of the following precaution.
This product uses semiconductor components designed for generic electronics
equipment such as office automation equipment, communications equipment,
measurement equipment and machine tools. Do not incorporate the product into
devices such as medical equipment, traffic control systems, combustion control
systems, safety equipment and so on which can directly threaten human life or pose
a hazard to the body or property due to malfunction or failure. Moreover, products
incorporating semiconductor components can be caused to malfunction or fail due
to foreign noise or surge. To ensure there will be no risk to life, the body or property
even in the event of malfunction or failure, be sure to take all possible measures in
safety system design, such as using protection circuits like limit switches or fuse
breakers, or system redundancy.
1.6. Handling Precautions
Please pay attention to the following points when handling the product in order to avoid causing any irreversible damage.
Areas Easily Damaged The microSD connector and its cover can be easily damaged. Please be careful
not to damage them by handling them with too much force.
Modifications To This Product Please take note that any modifications[1] made to this product are not covered
under warranty. Also, please ensure to undertake a full operational check of this
product before carrying out any modifications or mounting connectors[2].
Mounting and Dismounting of
Connectors While Powered On Apart from hot-pluggable interfaces (LAN, USB), do not under any circumstances add or remove connectors while power is supplied to this product
or peripheral circuits.
Static Electricity As CMOS devices are used in this product, please store it in antistatic packaging
(such as that it was shipped in) until time of use.
Latchup Excessivenoiseorasurgefromthepowersupplyorinput/output,orsharpvoltage
fluctuations can lead to the CMOS devices incorporated in the board causing a
latch-up.Once thelatch-up occurs,this situationcontinues untilthe powersupply
is disconnected, and therefore can damage the devices. Measures such as adding
a protection circuit to noise-susceptible input/output lines or not sharing the
powersupplywithdevicesthatcanbethecauseofnoisearehighlyrecommended.
Physical Stress Please avoid strong physical stress such as drops or other impacts.
1.7. Software Usage Precautions
About Software Contained In This
Product The software and documentation contained in this product is provided “AS IS” without warranty of any kind including warranty of merchantability or fitness for
a particular purpose, reliability, correctness or accuracy. Furthermore, no
guaranteeismadeinregardtoanyoutcomesresultingfromtheuseofthisproduct.
[1]With the exception of adding connectors to unmounted interfaces.
[2]Whenmountingconnectors,pleaseensuretoapplymasking, avoidsolderresiduecomingincontact withsurroundingpartsandavoidcreating solderballs.
Armadillo-420 Basic Model Development Set Startup Guide Preface
10