Atmark Armadillo-IoT Gateway G3 User manual

Armadillo-IoT Gateway G3
Product Manual - INTL
AGX3150
Version 1.0.0
2018/02/19
Atmark Techno, Inc [http://www.atmark-techno.com]
Armadillo Official Site [http://armadillo.atmark-techno.com]

Armadillo-IoT Gateway G3Product Manual - INTL
Atmark Techno, Inc
Copyright © 2016-2018 Atmark Techno, Inc.
Version 1.0.0
2018/02/19

Table of Contents
1. Precautions .......................................................................................................................................... 10
1.1. Safety Precautions ...................................................................................................................... 10
1.2. Handling Precautions .................................................................................................................. 11
1.3. Software Usage Precautions ......................................................................................................... 12
1.4. Write Prohibited Regions ............................................................................................................. 13
1.5. Electromagnetic Interference ........................................................................................................ 13
1.6. Warranty .................................................................................................................................. 13
1.7. Exporting .................................................................................................................................. 14
1.8. Trademarks ............................................................................................................................... 14
2. Product Overview ................................................................................................................................. 15
2.1. Product Features ........................................................................................................................ 15
2.1.1. What is Armadillo ............................................................................................................ 15
2.1.2. What is Armadillo-IoT Gateway ......................................................................................... 15
2.2. Product Lineup .......................................................................................................................... 16
2.3. Specifications ............................................................................................................................ 16
2.4. Armadillo-IoT Gateway Exterior ................................................................................................... 18
2.5. Block Diagram .......................................................................................................................... 19
2.6. Software Make-up ...................................................................................................................... 19
3. Before Turning on Armadillo .................................................................................................................. 21
3.1. Preparation ............................................................................................................................... 21
3.2. Setup of Environment for Development and Operational Checks ......................................................... 21
3.2.1. ATDE6 Setup ................................................................................................................. 22
3.2.2. Using Removable Devices ................................................................................................. 26
3.2.3. Starting the Command Line Terminal (GNOME Terminal) ...................................................... 26
3.2.4. Using Serial Communication Software (minicom) .................................................................. 27
3.3. Interface Layout ......................................................................................................................... 28
3.4. Connections .............................................................................................................................. 29
3.5. Slide Switch Configuration .......................................................................................................... 31
3.6. Using the vi Editor ..................................................................................................................... 31
3.6.1. Starting vi ...................................................................................................................... 31
3.6.2. Character Input ................................................................................................................ 32
3.6.3. Moving the Cursor ........................................................................................................... 32
3.6.4. Deleting Characters .......................................................................................................... 33
3.6.5. Saving and Quitting ......................................................................................................... 33
4. Startup and Shutdown ............................................................................................................................ 34
4.1. Startup ..................................................................................................................................... 34
4.2. Login ....................................................................................................................................... 46
4.3. Managing Debian Users .............................................................................................................. 46
4.4. Shutdown ................................................................................................................................. 47
5. Operational Checks ............................................................................................................................... 51
5.1. Before Performing the Operational Checks ...................................................................................... 51
5.2. Network ................................................................................................................................... 51
5.2.1. Supported Networks ......................................................................................................... 51
5.2.2. Network Configuration ..................................................................................................... 51
5.2.3. Basic Usage of nmcli ........................................................................................................ 52
5.2.4. Wired LAN .................................................................................................................... 55
5.2.5. Wireless LAN ................................................................................................................. 56
5.2.6. 3G ................................................................................................................................ 58
5.2.7. Configuration Example with NetworkManager ...................................................................... 65
5.2.8. Firewall ......................................................................................................................... 69
5.2.9. Network Applications ....................................................................................................... 69
5.3. Storage ..................................................................................................................................... 70
5.3.1. Using Storage ................................................................................................................. 70
Armadillo-IoT Gateway G3Product Manual - INTL Product Manual - INTL
3

5.3.2. Changing and Formatting Storage Partitions ......................................................................... 71
5.4. LED ........................................................................................................................................ 72
5.4.1. Activating and Deactivating LEDs ...................................................................................... 73
5.4.2. Using Triggers ................................................................................................................ 74
5.5. RTC ........................................................................................................................................ 74
5.5.1. Setting the Time on the RTC .............................................................................................. 74
5.6. User Switches ............................................................................................................................ 76
5.6.1. Confirming Events ........................................................................................................... 76
5.7. Temperature Sensor .................................................................................................................... 77
5.7.1. Obtaining the Temperature ................................................................................................ 77
5.8. AD Converter ............................................................................................................................ 77
5.8.1. Obtaining the Voltage ....................................................................................................... 77
5.8.2. Monitoring Power Supply Voltage ...................................................................................... 78
5.9. Armadillo-IoT RS232C Add-on Module RS00 ................................................................................. 79
5.10. Armadillo-IoT Isolated RS232C/422/485 Add-on Module RS01 ........................................................ 80
5.10.1. Changing RS422/RS485 Communication Settings ................................................................ 81
5.11. Armadillo-IoT Wi-SUN Add-on Module WS00 ............................................................................. 82
5.11.1. Obtaining Configuration Information ................................................................................. 82
5.12. Armadillo-IoT Isolated RS485 Add-on Module RS02 ...................................................................... 83
5.12.1. Changing RS422/RS485 Communication Settings ................................................................ 84
5.13. Armadillo-IoT Isolated Digital I/O / Analog Input Add-on Module DA00 ........................................... 85
5.13.1. Setting the Digital Output State ......................................................................................... 86
5.13.2. Getting the Digital Input State .......................................................................................... 86
5.13.3. Getting the Analogue Input Voltage ................................................................................... 86
6. Bootloader Specifications ....................................................................................................................... 88
6.1. Bootloader Boot Modes ............................................................................................................... 88
6.2. Bootloader Functions .................................................................................................................. 88
6.2.1. How to Specify the Linux Kernel Image and Device Tree Blob ................................................ 88
6.2.2. Specifying the Root File System ......................................................................................... 89
6.2.3. Saving Environment Variables ........................................................................................... 90
6.2.4. Linux Kernel Boot Options ................................................................................................ 90
7. Build Procedure .................................................................................................................................... 92
7.1. Building the Bootloader ............................................................................................................... 92
7.2. Building the Linux Kernel ............................................................................................................ 93
7.3. Building a Debian GNU/Linux Root File System ............................................................................. 94
7.3.1. Creating the Factory Default Root File System Archive ........................................................... 94
7.3.2. Creating a Customized Root File System Archive .................................................................. 94
8. Rewriting Image Files ............................................................................................................................ 96
8.1. Using the Installation Disc ........................................................................................................... 96
8.1.1. Creating an Installation Disk .............................................................................................. 96
8.1.2. Running the Installation .................................................................................................... 97
8.2. Rewriting Only Specific Image Files .............................................................................................. 98
8.2.1. Rewriting the BootLoader Image ........................................................................................ 98
8.2.2. Rewriting the Linux Kernel Image ...................................................................................... 99
8.2.3. Rewriting the DTB ........................................................................................................... 99
8.2.4. Rewriting the Root File System .......................................................................................... 99
9. Utilizing SD Booting ........................................................................................................................... 101
9.1. Boot Disk Creation ................................................................................................................... 101
9.2. Creating a Root File System ....................................................................................................... 104
9.2.1. Creating a Debian GNU/Linux Root File System ................................................................. 105
9.3. Storing the Linux Kernel Image and DTB ..................................................................................... 105
9.4. Performing an SD Boot ............................................................................................................. 106
10. Electrical Specifications ..................................................................................................................... 108
10.1. Absolute Maximum Ratings ..................................................................................................... 108
10.2. Recommended Operating Conditions .......................................................................................... 108
Armadillo-IoT Gateway G3Product Manual - INTL Product Manual - INTL
4

10.3. Input / Output Interface Electrical Specifications .......................................................................... 109
10.4. Power Supply Circuit Structure ................................................................................................. 109
11. Interface Specifications ...................................................................................................................... 111
11.1. Interface Layout ..................................................................................................................... 111
11.2. CON1 Add-on Interface 1 ........................................................................................................ 113
11.3. CON2 Add-on Interface 2 ........................................................................................................ 115
11.4. CON4 SD Interface ................................................................................................................. 117
11.5. CON6 LAN Interface .............................................................................................................. 118
11.6. CON7 USB Host Interface ....................................................................................................... 118
11.7. CON9 Debug Serial Interface ................................................................................................... 119
11.8. CON10 WWAN Expansion Interface ......................................................................................... 119
11.9. CON11 MicroSIM Interface ..................................................................................................... 120
11.10. CON13 RTC Backup Interface 1 .............................................................................................. 121
11.11. CON14 Power Input Interface 1 ............................................................................................... 121
11.12. CON15 Power Input Interface 2 ............................................................................................... 122
11.13. CON16 Power Output Interface ............................................................................................... 123
11.14. CON17 3G Antenna Interface ................................................................................................. 123
11.15. CON20 WLAN Interface ........................................................................................................ 123
11.16. CON22 RTC Backup Interface 2 .............................................................................................. 125
11.17. JP1 Boot Device Setting Jumper .............................................................................................. 126
11.18. SW1 to SW3 User Switches .................................................................................................... 126
11.19. SW4 Reset Switch ................................................................................................................. 126
11.20. LED1 WWAN LED .............................................................................................................. 126
11.21. LED2 to LED5 User LEDs ..................................................................................................... 127
Armadillo-IoT Gateway G3Product Manual - INTL Product Manual - INTL
5

List of Figures
2.1. Armadillo-IoT Gateway Exterior ........................................................................................................... 18
2.2. Armadillo-IoT Gateway Block Diagram ................................................................................................. 19
3.1. Starting the GNOME Terminal ............................................................................................................. 26
3.2. GNOME Terminal Window ................................................................................................................. 27
3.3. Configuring minicom .......................................................................................................................... 27
3.4. Starting minicom ................................................................................................................................ 27
3.5. Minicom Quit Confirmation ................................................................................................................. 28
3.6. Interface Layout Diagram .................................................................................................................... 28
3.7. Armadillo-IoT Gateway Connection Example .......................................................................................... 30
3.8. Slide Switch Configuration .................................................................................................................. 31
3.9. Starting vi ......................................................................................................................................... 31
3.10. Explanation of Commands for Switching to Input Mode .......................................................................... 32
3.11. Explanation of Commands for Deleting Characters ................................................................................. 33
4.1. Log Messages Immediately After Power On ............................................................................................ 34
4.2. Boot Log .......................................................................................................................................... 34
4.3. Shutdown ......................................................................................................................................... 47
5.1. nmcli Command Format ...................................................................................................................... 51
5.2. List of Connections ............................................................................................................................. 52
5.3. Enabling a Connection ........................................................................................................................ 52
5.4. Disabling a Connection ....................................................................................................................... 52
5.5. Creating a Connection ......................................................................................................................... 52
5.6. Deleting a Connection ......................................................................................................................... 53
5.7. Static IP Address Configuration ............................................................................................................ 54
5.8. DHCP Configuration .......................................................................................................................... 54
5.9. Specifying a DNS Server ..................................................................................................................... 54
5.10. Applying Connection Modifications ..................................................................................................... 54
5.11. List of Devices ................................................................................................................................. 55
5.12. Connecting Devices .......................................................................................................................... 55
5.13. Disconnecting Devices ...................................................................................................................... 55
5.14. Creating a Wired LAN Interface (eth0) Connection ................................................................................. 56
5.15. Ping Confirmation of Wired LAN ........................................................................................................ 56
5.16. Connecting to a Wireless LAN Access Point .......................................................................................... 56
5.17. Creating a Wireless LAN (wlan0) Connection ........................................................................................ 57
5.18. Ping Confirmation of Wireless LAN .................................................................................................... 58
5.19. microSIM ....................................................................................................................................... 59
5.20. Installing MicroSIM .......................................................................................................................... 59
5.21. Creating a 3G Connection .................................................................................................................. 60
5.22. 3G Data Connection .......................................................................................................................... 60
5.23. Ping Confirmation of 3G .................................................................................................................... 60
5.24. Ending Data Communication .............................................................................................................. 62
5.25. Starting Data Communication ............................................................................................................. 62
5.26. Setting a 3G Passphrase with the nmcli connection modify Command ........................................................ 62
5.27. Stopping the 3G Reconnection Service ................................................................................................. 63
5.28. Starting the 3G Reconnection Service ................................................................................................... 63
5.29. Obtaining a List of Recognized Modems ............................................................................................... 63
5.30. Obtaining Modem Information ............................................................................................................ 64
5.31. Obtaining MicroSIM Information ........................................................................................................ 64
5.32. Obtaining Communication Line Information .......................................................................................... 65
5.33. Network Structure Diagram ................................................................................................................ 66
5.34. iptables ........................................................................................................................................... 69
5.35. Armadillo Top Page .......................................................................................................................... 70
5.36. mount Command Format ................................................................................................................... 71
5.37. Mounting Storage ............................................................................................................................. 71
Armadillo-IoT Gateway G3Product Manual - INTL Product Manual - INTL
6

5.38. Unmounting Storage ......................................................................................................................... 71
5.39. Altering Partitions with the fdisk Command ........................................................................................... 71
5.40. Creating a EXT4 File System .............................................................................................................. 72
5.41. User LEDs Location .......................................................................................................................... 73
5.42. Turning on an LED ........................................................................................................................... 73
5.43. Turning off an LED .......................................................................................................................... 73
5.44. Displaying the State of an LED ........................................................................................................... 74
5.45. Specifying timer for the LED Trigger ................................................................................................... 74
5.46. Displaying the LED Trigger ............................................................................................................... 74
5.47. Setting System Clock ........................................................................................................................ 75
5.48. Setting the Hardware Clock ................................................................................................................ 75
5.49. User Switch: Event Confirmation ........................................................................................................ 76
5.50. Obtaining the measurement temperature of the i.MX 7 Dual ..................................................................... 77
5.51. Calculation Formula of Input Voltage to the AD Converter ....................................................................... 77
5.52. Obtaining the Input Voltage to the AD Converter .................................................................................... 78
5.53. Calculation Formula of the Power Supply Voltage .................................................................................. 78
5.54. vintrigger Command Help .................................................................................................................. 79
5.55. vintrigger Command Example ............................................................................................................. 79
5.56. Changing the Digital Output State ........................................................................................................ 86
5.57. Getting the Digital Input State ............................................................................................................. 86
5.58. Calculation Formula of Input Voltage to the AD Converter ....................................................................... 87
5.59. Obtaining the Input Voltage to the AD Converter .................................................................................... 87
6.1. Displaying U-Boot Command Help ....................................................................................................... 88
6.2. Booting from a Linux Kernel Image Stored on Partition 1 of eMMC ............................................................ 89
6.3. Specifying the Root File System Stored in Partition 2 of eMMC .................................................................. 89
6.4. Restoring All Environment Variables to Default Values ............................................................................. 90
6.5. Setting the Available Memory Amount to 384M ...................................................................................... 91
7.1. Procedure for Creating the Factory Default Root File System Archive .......................................................... 94
7.2. Error Message when Incorrect Package Name Specified ............................................................................ 95
9.1. Unmounting an Automatically Mounted SD Card ................................................................................... 101
9.2. saveenv Messages for SD Boot ........................................................................................................... 107
10.1. Power Supply Circuit Structure ......................................................................................................... 110
11.1. Armadillo-IoT Interface Layout (Side A) ............................................................................................ 111
11.2. Interface Layout (Side B) ................................................................................................................. 112
11.3. AC Adapter Polarity Mark ................................................................................................................ 122
Armadillo-IoT Gateway G3Product Manual - INTL Product Manual - INTL
7

List of Tables
2.1. Add-on Module Lineup ....................................................................................................................... 16
2.2. Specifications .................................................................................................................................... 16
2.3. Part Names and Functions .................................................................................................................... 18
2.4. Software Available for Armadillo-IoT .................................................................................................... 19
2.5. QSPI Flash Memory Memory Map ........................................................................................................ 20
2.6. eMMC Memory Map - When Using Installation Disk v20160928 or Later .................................................... 20
2.7. eMMC Memory Map - When Using Installation Disk v20160705 or Earlier .................................................. 20
3.1. Usernames and Passwords ................................................................................................................... 25
3.2. Removable Devices Used for Operational Checks .................................................................................... 26
3.3. Serial Communication Configuration ..................................................................................................... 27
3.4. Interfaces .......................................................................................................................................... 28
3.5. Commands to Enter Input Mode ............................................................................................................ 32
3.6. Commands to Move the Cursor ............................................................................................................. 32
3.7. Commands to Delete Characters ............................................................................................................ 33
3.8. Commands for Saving and Quitting ....................................................................................................... 33
4.1. Serial Console Login Username and Password ......................................................................................... 46
5.1. Networks and Network Devices ............................................................................................................ 51
5.2. Static IP Address Configuration Example ............................................................................................... 54
5.3. APN Information Configuration Example ............................................................................................... 60
5.4. Network Address Information ............................................................................................................... 66
5.5. Making the Device State disconnected .................................................................................................... 67
5.6. Storage Devices ................................................................................................................................. 70
5.7. LEDs and LED Class Directories .......................................................................................................... 72
5.8. trigger Types ..................................................................................................................................... 74
5.9. Time Format Fields ............................................................................................................................ 75
5.10. Input Device Files and Event Codes ..................................................................................................... 76
5.11. Files Needed for Calculating Input Voltage ........................................................................................... 78
5.12. Add-on Interfaces and TTY Device Files .............................................................................................. 80
5.13. Add-on Interfaces and TTY Device Files .............................................................................................. 80
5.14. RS485 Setting and Default Values ....................................................................................................... 81
5.15. Setting RS485 from Linux kernel Boot Options ...................................................................................... 82
5.16. Add-on Interfaces and TTY Device Files .............................................................................................. 82
5.17. Add-on Interfaces and TTY Device Files .............................................................................................. 84
5.18. RS485 Setting and Default Values ....................................................................................................... 84
5.19. Setting RS485 from Linux kernel Boot Options ...................................................................................... 85
5.20. Add-on Interfaces and GPIO Class Directories ....................................................................................... 85
5.21. Files Needed for Calculating Input Voltage ........................................................................................... 87
6.1. Bootloader Boot Modes ....................................................................................................................... 88
6.2. Useful Maintenance Mode Commands List ............................................................................................. 88
6.3. mmcdev Configuration Values and Boot Devices ..................................................................................... 89
6.4. Bootloader Types and Default Values for mmcdev and mmcpart ................................................................. 89
6.5. Bootloader Types and mmcroot Default Values ........................................................................................ 89
6.6. Linux Kernel Boot Options Examples .................................................................................................... 90
8.1. File Used for Creating Installation Disk .................................................................................................. 96
8.2. Image Files and their Destinations ......................................................................................................... 98
9.1. Files Used to Create Boot Disk ........................................................................................................... 101
9.2. Boot Disk Configuration Example ....................................................................................................... 102
9.3. File Used for Creating Root File System ............................................................................................... 105
9.4. Files Used to Create Boot Disk ........................................................................................................... 105
9.5. Conditions Under which the Bootloader can Detect the Linux Kernel ......................................................... 106
10.1. Absolute Maximum Ratings ............................................................................................................. 108
10.2. Recommended Operating Conditions .................................................................................................. 108
10.3. Input / Output Interface Power Supply Electrical Specifications ............................................................... 109
Armadillo-IoT Gateway G3Product Manual - INTL Product Manual - INTL
8

10.4. Input / Output Interface Electrical Specifications (OVDD = VCC_3.3V, VCC_3.3V_IO) ............................. 109
10.5. WWAN Expansion Interface Pin 9 (LED1_CTRL) Electrical Specifications .............................................. 109
11.1. Armadillo-IoT Interface List (Side A) ................................................................................................. 111
11.2. Armadillo-IoT Interface List (Side B) ................................................................................................. 112
11.3. CON1 Signals ................................................................................................................................ 113
11.4. CON2 Signals ................................................................................................................................ 115
11.5. CON4 Signals ................................................................................................................................ 117
11.6. CON4 Card Detection and Write Protect Detection ............................................................................... 117
11.7. CON6 Signals (10BASE-T/100BASE-TX) .......................................................................................... 118
11.8. CON6 Signals (1000BASE-T) .......................................................................................................... 118
11.9. LAN Connector LEDs ..................................................................................................................... 118
11.10. CON7 Signals .............................................................................................................................. 119
11.11. CON9 Signals .............................................................................................................................. 119
11.12. CON10 Signals ............................................................................................................................ 120
11.13. CON11 Signals ............................................................................................................................ 120
11.14. CON13 Signals ............................................................................................................................ 121
11.15. RTC Versions and Average Monthly Difference (Reference Value) at 25°C Ambient Temperature .............. 121
11.16. CON14 Signals ............................................................................................................................ 122
11.17. CON15 Signals ............................................................................................................................ 122
11.18. CON16 Signals ............................................................................................................................ 123
11.19. CON20 Signals ............................................................................................................................ 124
11.20. CON22 Signals ............................................................................................................................ 125
11.21. RTC Versions and Average Monthly Difference (Reference Value) at 25°C Ambient Temperature .............. 125
11.22. JP1 Signals .................................................................................................................................. 126
11.23. Jumper Function ........................................................................................................................... 126
11.24. User Switch Connections ................................................................................................................ 126
11.25. Reset Switch Connections ............................................................................................................... 126
11.26. WWAN LED Connections .............................................................................................................. 127
11.27. User LED Connections .................................................................................................................. 127
Armadillo-IoT Gateway G3Product Manual - INTL Product Manual - INTL
9

Chapter 1. Precautions
1.1. Safety Precautions
In order to use this product safely, please take special note of the following precautions.
•Be sure to read all product manuals and related documentation before using
thisproduct.Pleaseusethisproductcorrectlyandsafelymakingsuretofollow
all usage precautions.
•Whenoperatingorextendingthisproductinawaynotdescribedintheproduct
manuals, please do so safely and on your own responsibility after having fully
understood the materials on our web site and any other technical information.
•Please do not install this product in a place with a lot of water, moisture, dust
or soot. This could cause a fire, product failure or electric shock.
•Some parts of this product generate heat and can reach high temperatures.
Depending on the surrounding temperature and on how this product is han-
dled, this may cause burns. Please do not touch the electronic components or
the surrounding area while the product is powered on or before it has cooled
down after being powered off.
•When using this product in the development of devices or systems to original
specifications, please carry out the design and development after having thor-
oughly read and fully understood the product manuals and related materials,
the technical information offered on our web site and related device data
sheets. Also, please carry out full tests beforehand in order to provide and
maintain reliability and safety.
•This product is not intended for uses that require extremely high reliability
and safety in terms of functionality and accuracy (such as medical equipment,
traffic control systems, combustion control systems, safety equipment and so
on). If this product is used in these kinds of equipment, devices or systems,
thiscompanywillnotbeheldresponsibleinanywayforanyaccidentresulting
in injury or death, fire or damage and so on.
•Thisproductusessemiconductorcomponentsdesignedforgenericelectronics
equipmentsuch asoffice automationequipment, communicationsequipment,
measurement equipment and machine tools. It is possible that a foreign noise
or surge may cause this product to malfunction or fail. To ensure there will
be no risk to life, the body or property in the event of malfunction or failure,
be sure to take all possible measures in regard to device safety design, such
as using protection circuits like limit switches or fuse breakers, or system
redundancy, and to only use the device after taking measures to ensure suf-
ficient reliability and safety.
Armadillo-IoT Gateway G3Product Manual - INTL Precautions
10