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

•Please do not use products with Wireless LAN functionality in places near
medical devices such as heart pacemakers and hearing aids, automatic control
equipment such as fire alarms and automatic doors, microwave ovens, ad-
vanced electronic equipment or televisions and radios, or near "Premises Ra-
dio Stations" for "Mobile Body Identification" or "Specified Low Power Ra-
dio Stations". The radio waves emitted by this product may cause these types
of devices to malfunction.
1.2. Handling Precautions
Please pay attention to the following points when handling this product in order to avoid causing any irreversible damage.
Areas Easily Damaged The inter-board connectors can be easily damaged. Please be careful not to dam-
age 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].
Attaching and Detaching Connec-
tors While Powered On Apartfrom the hot-pluggable interfaces (LAN, SD/SDIO and USB),donotunder any circumstances attach or detach connectors or cards while power is supplied
to this product or peripheral circuits.
Static Electricity As CMOS devices are used in this product it can be damaged by static electricity.
When opening this product be careful not to do so in low humidity conditions,
while also making sure it is done in an environment with anti-static measures
established, like using anti-static mats, anti-static measures for workers such as
conductive shoes and human body earthing and countermeasures against dis-
chargesfromequipment. Also, when storing this product avoid using plastic bags
and containers that are prone to static electricity and store them in conductive
bags and containers or racks and so on.
Latch-up Excessivenoiseorasurgefromthepowersupplyorinput/output,orsharpvoltage
fluctuations can lead to the CMOS devices incorporated in the board causing a
latch-up.Once the latch-up occurs, this situation continues untilthepowersupply
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.
Use Location Restrictions Using this product close to a TV and radio may cause radio disturbance.
Radio Wave Related Precautions
(2.4GHz band radio) In the case that any function using radio waves in the 2.4GHz band (such as wireless LAN) affects automatic control electronic equipment such as automatic
doors, please stop using it immediately.
[1]With the exception of adding connectors to unmounted interfaces.
[2]When mounting connectors, please ensure to apply masking, avoid solder residue coming in contact with surrounding parts and avoid creating solder
balls.
Armadillo-IoT Gateway G3Product Manual - INTL Precautions
11

This wireless device (AEH-AR9462) uses the 2.4GHz band. All of the band is
used, and the band used by mobile identification devices can be avoided. The
modulation systems used are DS-SS and OFDM, and the estimated interference
distance is 40 meters or less.
This wireless device (AEH-AR9462) uses the 2.4GHz band. All of the band is
used, and the band used by mobile identification devices can be avoided. The
modulation system used is FH-SS, and the estimated interference distance is 80
meters or less.
Radio Wave Related Precautions
(5GHz band radio) This wireless device (AEH-AR9462) uses the 5GHz band.
W52 and W53 outdoor use is prohibited under radio law.
PleasedonotuseAPmodeinW53,W56asithasnotreceivedconstructiondesign
certification as of June 2016.
Radio Wave Related Precautions
(3G) This wireless device (PDS6) performs 3G wireless communication.
Please do not use the 3G wireless communication function near implantable
medical devices such as cardiac pacemakers or defibrillators (within about 15
cm).
1.3. Software Usage Precautions
About Software Contained in this
Product The source code of the Linux-compatible software preinstalled in the default shipping state of this product is provided as open source, unless otherwise indi-
vidually specified (including written, electronic data, or oral notification). For
redistribution and so on, please do so at your own risk according to the license
notice included in each source code file. In addition, the software and documen-
tation contained in this product are provided “AS IS”. The customer is required
to assume the responsibility of only using this product after having fully consid-
ered and tested its suitability to the intended purpose and use. There is no guar-
antee of fitness for a particular purpose, reliability, correctness and no guarantee
of any outcomes resulting from the use of this product.
Middleware and various other software solutions offered for Armadillo branded
productsin cooperationwith partnersandso onis allindividuallylicensed. Please
refertothereadme fileetc includedin eachpieceofsoftwarefortheredistribution
rights and so on. For other bundled software, please contact the provider.
Armadillo-IoT Gateway G3Product Manual - INTL Precautions
12

The following software preinstalled in the default shipping state of this product is
not open source software.
• Board info capture tool (get_board_info)
1.4. Write Prohibited Regions
The data stored by the i.MX 7 Dual electric fuse (e-Fuse) is used by the software
contained in this product. Please do not write to these regions as the product may
stop operating correctly. Purposefully writing to these regions voids the product
warranty.
1.5. Electromagnetic Interference
This device is Class B Information Technology Equipment. Although this device
is intended for use in a home environment, if this device is used close to a radio or
television receiver it may cause radio interference. Please use it correctly in ac-
cordance with the instruction manual.
In order to comply with the technical standards of VCCI, it is necessary to supply
power from the DC jack (CON14) with an AC adapter.
The add-on modules have not been subjected to the VCCI compliance check test as
single modules. It has been confirmed that they meet VCCI technical standards
when connected to Armadillo-IoT. Please use the add-on modules connected to the
add-on interface of Armadillo-IoT.
1.6. Warranty
As laid out in the Product Warranty Policy which is provided with this product or available on our web site, the main
boardofthis productis coveredbyaoneyearreplacementwarranty fromtime ofpurchase.Pleasenotethattheother included
goods and software are not covered by the warranty.
Product warranty policy http://www.atmark-techno.com/support/warranty-policy
Armadillo-IoT Gateway G3Product Manual - INTL Precautions
13

1.7. Exporting
•When exporting this product, it is the responsibility of the exporter to follow all export-related laws and regulations
of Japan and related foreign countries, and carry out all required procedures.
•Our product may not be exported or sold etc. to nations, organizations, corporations or individuals under sanctions
or trade suspension by Japan and other related countries.
•Our product and related technology may not be used for the purpose of development of weapons of mass destruction,
for the purpose of military use or other military related uses, or in devices which have had their production, use, sale
or procurement prohibited by national or overseas law or regulations.
1.8. Trademarks
•Armadillo is a registered trademark of Atmark Techno, Inc. All other company names, product names and related
trademarks are the property of their respective owners. ™ and ® marks are omitted.
• The SD, SDHC, SDXC, microSD, microSDHC, microSDXC and SDIO logos are trademarks of SD-3C, LLC.
Armadillo-IoT Gateway G3Product Manual - INTL Precautions
14

Chapter 2. Product Overview
2.1. Product Features
2.1.1. What is Armadillo
"Armadillo" is an embedded system platform brand with ARM core processors and Linux support. Armadillo brand
products have the following features.
• ARM processors with power-saving design
ARM based processor boards with power saving designs that operate between one to several watts, they generate
little heat and don't require a fan.
• Small Size
The CPU boards are mostly the size of a business card. A lineup of ultra-small modules including a CPU module
about one third the size of a business card and also a wireless LAN module are also available.
• Linux Preinstalled as the Standard Operating System
Linux as the default operating system provides access to rich software resources and proven stability. Source code
is provided as open source.
• Development Environment
"Atmark Techno Development Environment" (ATDE) is provided free of charge as the development environment
for Armadillo. ATDE is a virtual machine image for VMware. The image is based on a Linux desktop environment
and has GNU cross development tools and other necessary tools preinstalled. Using ATDE reduces the work in-
volved with setting up a development environment like preparing a development PC and installing required tools.
2.1.2. What is Armadillo-IoT Gateway
The Armadillo-IoT Gateway is a platform for easily and quickly developing gateways for IoT / M2M and is based on the
proven Armadillo embedded platform. It combines a high degree of flexibility, ease of development and robustness as an
embeddeddeviceinawell-balancedmanner,andissuitableforthose whowanttodeveloporiginalcommercialIoTgateways
in a timely manner according to market needs.
Expansion with Add-on Modules
Two expansion interfaces are available allowing optional add-on modules to be connected. Add-on modules for
wiredconnectionssuchasRS232C/RS422/RS485,digitalinput/outputandanaloginput,andalso thosesupporting
energy-saving wireless communication standards such as EnOcean and Wi-SUN are available.
Also, as the interface standards for add-on modules are published, original modules can be developed. As various
requirements can be met by developing just an add-on module, it is possible to reduce the overall development time
and cost compared to when developing a full CPU board from scratch.
Mobile Communication (3G) Support
3G communication modules can be equipped for mobile communication. Various mobile carriers offer dedicated
line plans for Armadillo-IoT, so 3G support capability can be introduced immediately.
Armadillo-IoT Gateway G3Product Manual - INTL Product Overview
15

Linux Based Software Stack
As Linux is preinstalled as the standard operating system, various software resources, starting with open source
software, can be utilized. Also, as languages like Ruby and Oracle Java are supported, it is possible to develop
software without using the C/C++.
Cloud Support
A software stack which includes components like a MQTT client and is highly suited to use with cloud systems is
preinstalled. In addition, as the edge agents from various cloud services have already been ported to Armadillo-IoT
it is simple to develop a system that works with the cloud.
2.2. Product Lineup
The lineup of add-on modules is as follows.
Table 2.1. Add-on Module Lineup
Name Product Number
Armadillo-IoT RS232C Add-on Module RS00 OP-AGA-RS00-00
Armadillo-IoT Isolated RS232C/422/485 Add-on Module RS01 OP-AGA-RS01-00
Armadillo-IoT Isolated RS485 Add-on Module RS02 OP-AGA-RS02-00
Armadillo-IoT RN4020 Add-on Module BT00 OP-AGA-BT00-00
Armadillo-IoT EnOcean Add-on Module EN00[a] OP-AGA-EN00-00
Armadillo-IoT Wi-SUN Add-on Module WS00 OP-AGA-WS00-00
Armadillo-IoT Isolated Digital I/O / Analog Input Add-on Module DA00 OP-AGA-DA00-00
[a]Scheduled to be released
2.3. Specifications
The main specifications of Armadillo-IoT Gateway G3 are as follows.
Table 2.2. Specifications
Product Number AGX3150
Processor
NXP Semiconductors i.MX 7 Dual
ARM Cortex-A7 x 2
- Instruction / data cache 32KByte/32KByte
- L2 Cache 512KByte
- Internal SRAM 256KByte
- Media processing engine (NEON)
- Thumb code (16 bit instruction set) support
ARM Cortex-M4
- Instruction / data cache 16KByte/16KByte
System Clock
CPU Core Clock (ARM Cortex-A7): 996MHz
CPU Core Clock(ARM Cortex-M4): 200MHz
DDR Clock: 533MHz
Oscillation Clock: 32.768kHz, 24MHz
RAM DDR3L: 1GByte
32bit bus
ROM QSPI NOR Flash Memory: 8MByte
eMMC: about 3.8GB (about 3.6GiB))[a]
LAN (Ethernet) RJ-45 x 1
1000BASE-T/100BASE-TX/10BASE-T, AUTO-MDIX
Wireless LAN WLAN + BT Combo Module: AEH-AR9462
IEEE 802.11a/b/g/n
Armadillo-IoT Gateway G3Product Manual - INTL Product Overview
16

Product Number AGX3150
ellular Module 3G module: Gemalto PDS6[b]
MicroSIM slot x 1
Serial (UART) 3.3V CMOS x 1
SD/MMC SD slot x 1
USB USB 2.0 Host x 1 (High Speed)
Calendar Clock Real-time Clock
Power Supply Connector For External Backup[c]
Add-on Module[d] None
Switch User switch x 3, reset switch x 1
LED User LED x 4, 3G LED x 1
Power Supply Voltage DC 8V to 26.4V
Power Consumption (reference)[e] 3.6W approx. (standby), 4.5W approx. (during communication)[f]
Operating Temperature[g][h] -10 to 50℃[i]
Dimensions 155.8 x 125.8 x 47.0mm (including flange)
[a]Size for SLC use. SLC is set at the factory.
[b]3G mobile communication MicroSIM card sold separately.
[c]Batteries are not included.
[d]Two add-on modules can be equipped.
[e]Power consumption is measured when LAN, USB and serial connectors are connected to external equipment. Consumption of externally connected
equipment is not included.
[f]Power consumption varies depending on the radio wave environment during communication.
[g]This temperature is when power consumption is limited, such as by stopping communication of the 3G module at high temperature.
[h]With no condensation.
[i]The operating temperature the board by itself (without a case) is -20°C to 70°C.
Armadillo-IoT Gateway G3Product Manual - INTL Product Overview
17

2.4. Armadillo-IoT Gateway Exterior
Figure 2.1. Armadillo-IoT Gateway Exterior
Table 2.3. Part Names and Functions
Number Name Description
1 LAN Connector Used to connect a LAN cable.
2 USB Connector Used to connect devices USB memory.
3 Power Connector 1 Used to connect the included AD adapter.
4 Power Connector 2 Used to connect power cables other than the included AD adapter.
5 SD slot Used to connect SD cards.
6 Debug Serial Connector Used to connect the included USB serial converter.
7 MicroSIM Slot Used to connect a MicroSIM card.
8 User LED1
A green LED which users can freely assign functions to.
9 User LED2
10 User LED3
11 User LED4
12 WWAN LED Green LED that indicates the communication status of the 3G module.
13 User Switch 1
A tact switch which users can freely assign functions to.14 User Switch 2
15 User Switch 3
16 Reset Switch Tact switch for resets.
17 Serial Connector Used to connect the serial cross cable.
18 Antenna Connector Used to connect the supplied antenna.
Armadillo-IoT Gateway G3Product Manual - INTL Product Overview
18

2.5. Block Diagram
The block diagram of the Armadillo-IoT gateway is as follows.
Figure 2.2. Armadillo-IoT Gateway Block Diagram[1]
2.6. Software Make-up
The following explains about the makeup of the software that runs on Armadillo-IoT.
The software available for Armadillo-IoT is shown in Table 2.4, “Software Available for Armadillo-IoT”.
Table 2.4. Software Available for Armadillo-IoT
Software Description
U-Boot The bootloader. In the factory default state the bootloader image is located in the QSPI Flash memory, but it can also be placed
on the SD card.
Linux Kernel A Linux kernel in the uImage format can be used. In the factory default state the Linux kernel image is located in the eMMC,
but it can also be placed on the SD card by using bootloader functionality.
[1]For the dotted line blocks, whether they are mounted or not depends on the product model. For the model with the 3G module, the 3G module, CON11
and CON17 are equipped and CON10 is not equipped. For the model without the 3G module, CON10 is equipped and the 3G module, CON11 and CON17
are not equipped.
Armadillo-IoT Gateway G3Product Manual - INTL Product Overview
19

Software Description
Debian GNU/
Linux
A Linux distribution created by the Debian Project. With its package management system, it is easy to add a wealth of software
packages provided by the Debian Project. In the factory default state, the Debian GNU/Linux root file system is located in
eMMC, but it can also be placed in a storage device supported by Linux kernel such as an SD card.
The memory map of the Armadillo-IoT QSPI Flash memory is shown in Table 2.5, “QSPI Flash Memory Memory Map”.
Table 2.5. QSPI Flash Memory Memory Map
Physical Address Size Description
0x00000000
｜
0x001003FF Approx. 1MByte U-Boot bootloader image
0x00100400
｜
0x001403FF 256 KBytes License information
0x00140400
｜
0x007FFFFF Approx. 6.7 MBytes Reserved area
The memory map of Armadillo-IoT's eMMC is shown below.
Table 2.6. eMMC Memory Map - When Using Installation Disk v20160928 or Later
Partition Size Description
1 32 MBytes Linux kernel image / Device tree blob
2 Approx 3.4 GBytes Debian GNU/Linux
3 128 MBytes Recovery image
Table 2.7. eMMC Memory Map - When Using Installation Disk v20160705 or Earlier
Partition Size Description
1 32 MBytes Linux kernel image / Device tree blob
2 Approx. 3.5 GBytes Debian GNU/Linux
3 32 MBytes Recovery image
Armadillo-IoT Gateway G3Product Manual - INTL Product Overview
20