User manual ReliaGATE 10-12-6x IoT Edge Gateway TI AM335x, LTE Cat 1 Rev.
Trademarks All trademarks, registered trademarks, logos, trade names, products names contained in this document are the property of their respective owners. Intended audience of this document This document is intended for system integrators: skilled persons with a thorough knowledge in linking together, physically or functionally, different computing systems and software applications to operate as a coordinated whole in compliance with the applicable regulations.
ReliaGATE 10-12 User manual Rev. 2-1 How to get started HOW TO GET STARTED To get started with the ReliaGATE 10-12, follow these steps: 1. Read carefully and understand the instructions and warnings contained in this manual. To lower the risk of personal injury, electric shock, fire, or damage to equipment, observe the instructions and warnings contained in this manual. For more information see: "Safety instructions" on page 9.
(This page has been intentionally left blank)
ReliaGATE 10-12 User manual Rev. 2-1 Contents CONTENTS Trademarks Intended audience of this document Revision history 2 2 2 How to get started 3 Contents 5 1 Safety instructions 1.1 Warning messages 1.1.1 Warning messages for harm to persons 1.1.2 Warning messages for damage to property 1.2 Warning: power supply safety 1.3 Caution: wireless safety 1.4 Warning: battery safety 9 9 9 10 10 10 11 2 Consignes de securite 2.1 Messages d’avertissement 2.1.
Contents ReliaGATE 10-12 User manual Rev. 2-1 7.4 FCC/ISED Regulatory Notices 7.4.1 FCC marking 7.4.2 FCC Class B Digital Device Notice 7.4.3 FCC restrictions on 5 GHz Wi-Fi usage 7.4.4 ISED Canada Regulatory Notices 7.4.5 ISED Class B Digital Device Notice 7.4.6 Responsible parties: Canadian Representative contact information 7.4.7 RF Radiation Exposure Statement 7.4.8 Labeling Information 7.5 Antennas list 7.6 REACH compliance 34 34 34 35 36 36 36 37 37 37 38 8 Interfaces overview 8.
ReliaGATE 10-12 User manual Rev. 2-1 9.10.1 TTL Serial Console connector specifications 9.11 MicroSD card holder 9.11.1 How to insert / remove the MicroSD card in the holder 9.12 RTC (Real Time Clock) 9.12.1 The RTC Device "/dev/rtc1" 9.12.2 The RTC backup battery 9.13 Watchdog 9.14 Accelerometer and Gyroscope 9.15 Programmable pushbutton Contents 63 64 64 65 65 65 66 66 66 10 The Software 10.1 The Linux OS distribution 10.2 The bootloader procedure 10.
Contents ReliaGATE 10-12 User manual Rev. 2-1 12.18 How to know the programmable pushbutton status 12.19 The TPM and the tpm2-tools package 12.20 Optional: How to manage the ReliaCELL power supply 90 90 90 13 How to compile custom software 13.1 How to setup the toolchain 13.2 How to use the toolchain to compile custom software 91 91 91 14 Eurotech Everyware IoT 14.1 Everyware Software Framework (ESF) 14.2 The ESF Web UI 14.3 The ESF Wires application 14.4 Everyware Cloud (EC) 14.
ReliaGATE 10-12 User manual Rev. 2-1 1 1 Safety instructions SAFETY INSTRUCTIONS IMPORTANT: Read carefully and understand the instructions and warnings contained in this document before installing / using the product. Keep this document for future reference. To lower the risk of personal injury, electric shock, fire or damage to equipment, observe the instructions and warnings contained in this document.
1 Safety instructions 1.1.2 ReliaGATE 10-12 User manual Rev. 2-1 Warning messages for damage to property To indicate potential risks of damage to the supported product (or to other property), the following message is used: NOTICE Sign (if necessary) 1.
ReliaGATE 10-12 User manual Rev. 2-1 1.4 1 Safety instructions Warning: battery safety WARNING SERIOUS HARM IF BATTERY IS USED INCORRECTLY Before using the battery always refer to battery manufacturer's instructions for safety. CAUTION RISK OF EXPLOSION IF BATTERY IS REPLACED BY AN INCORRECT TYPE Use and replace only with correct size and type. Dispose of used batteries according to battery manufacturer's instructions.
(This page has been intentionally left blank)
ReliaGATE 10-12 User manual Rev. 2-1 2 2 Consignes de securite CONSIGNES DE SECURITE IMPORTANT: Lire attentivement et bien respecter les instructions et les avertissements contenus dans ce document avant d'installer / d'utiliser le produit. Conserver ce document pour s'y référer à l'avenir. Pour éviter les risques de blessures, de choc électrique, d'incendie ou de détérioration du matériel, bien suivre les instructions et les avertissements contenus dans ce document.
2 Consignes de securite 2.1.2 ReliaGATE 10-12 User manual Rev. 2-1 Messages d’avertissement relatifs aux dommages matériels Pour signaler les risques potentiels de détérioration du produit (ou des produits annexes), le message suivant est utilisé: AVIS Signal (si besoin) 2.
ReliaGATE 10-12 User manual Rev. 2-1 2.4 2 Consignes de securite Avertissement: Sécurité de la Batterie AVERTISSEMENT BLESSURES GRAVES SI LA BATTERIE EST UTILISÉE DE MANIÈRE INCORRECTE Avant d’utiliser la batterie, reportez-vous toujours aux instructions du fabricant de la batterie pour plus de sécurité. ATTENTION RISQUE D’EXPLOSION SI LA BATTERIE DE REMPLACEMENT NE RESPECTE PAS LES CARACTÉRISTIQUES DE LA BATTERIE INITIALE. N'utilisez que des batteries de dimensions et de caractéristiques préconisées.
(This page has been intentionally left blank)
ReliaGATE 10-12 User manual Rev. 2-1 3 How to receive technical assistance 3 HOW TO RECEIVE TECHNICAL ASSISTANCE 3.1 How to ask for technical support To ask for technical support, complete the following steps 1. Go to the Eurotech Global Support Centre: https://support.eurotech.com/ 2. Submit a support request 3. Wait for the reply from the Eurotech Technical Support with the information you required 3.
(This page has been intentionally left blank)
ReliaGATE 10-12 User manual Rev. 2-1 4 Comment obtenir une assistance technique 4 COMMENT OBTENIR UNE ASSISTANCE TECHNIQUE 4.1 Comment contacter le support technique Pour demander un support technique, procéder comme suit: 1. Se connecter au Support Eurotech sur: https://support.eurotech.com/ 2. Envoyer une demande d’assistance 3. Attendre la réponse de l'équipe de support avec les informations requises 4.
(This page has been intentionally left blank)
ReliaGATE 10-12 User manual Rev. 2-1 5 CONVENTIONS USED 5.1 Conventions for signal names 5.2 Convention Description GND Ground # Active low signal + Positive signal; Positive signal in differential pair - Negative signal; Negative signal in differential pair 3.3 3.
(This page has been intentionally left blank)
ReliaGATE 10-12 User manual Rev. 2-1 6 Product overview 6 PRODUCT OVERVIEW 6.1 Product description The ReliaGATE 10-12 is a family of IoT Edge Gateways designed to deliver LTE connectivity with 2G/3G fallback to industrial and lightly rugged applications. The ReliaGATE 10-12 is based on the TI AM335x Cortex-A8 (Sitara) processor family, with 1GB of RAM, 8GB of eMMC, and user-accessible MicroSD and dual MicroSIM card holders.
6 Product overview 6.2 ReliaGATE 10-12 User manual Rev. 2-1 Intended use and not allowed uses of the product The product is intended for professional use and must be installed by qualified personnel only. The product must be installed in a secured location, accessible to authorized personnel only (for example in a cabinet / technical compartment). 6.2.
ReliaGATE 10-12 User manual Rev. 2-1 6.3 6 Product overview Technical specifications The ReliaGATE 10-12 family is available in several -XY versions, for example: ReliaGATE 10-12-63 (where: X = 6, Y = 3).
6 Product overview ReliaGATE 10-12 User manual Rev.
ReliaGATE 10-12 User manual Rev. 2-1 6.4 6 Product overview Optional accessories To simplify the development of applications, you can request the following optional accessories: Accessory Order Code Accessory Description MEC-40200-00 DIN Rail Mounting Kit, composed of: l 1x DIN Rail Mounting Clip l 3x Phillips Countersunk Screws E16-50-11-00 Power Supply 24W; IN: 100-240VAC; OUT: 24VDC, 1A (EU, US, UK Blades) 99ACC-70190-A0001 TTL-to-USB Cable E29-10-11-00 2.
6 Product overview ReliaGATE 10-12 User manual Rev.
ReliaGATE 10-12 User manual Rev. 2-1 6.
(This page has been intentionally left blank)
ReliaGATE 10-12 User manual Rev. 2-1 7 7 Regulatory information REGULATORY INFORMATION This section provides regulatory information for the ReliaGATE 10-12 (hereafter referred to as "this "product"). Upon request, Eurotech can provide the product Declaration of Conformity. For details and more information contact the Eurotech Technical Support (see "How to receive technical assistance" on page 17). 7.
7 Regulatory information 7.1.5 ReliaGATE 10-12 User manual Rev. 2-1 RoHS 3 compliance This product has been manufactured in compliance with the following Directives: l Directive 2011/65/EU of the European Parliament and of the Council of 8 June 2011 on the restriction of the use of certain hazardous substances in electrical and electronic equipment.
ReliaGATE 10-12 User manual Rev. 2-1 7.1.6.2 7 Regulatory information Class II product According to Commission Decision 2000/299/EC of 6 April 2000, establishing the initial classification of radio equipment and telecommunications terminal equipment and associated identifiers, the product falls within the scope of Class II.
7 Regulatory information 7.4 FCC/ISED Regulatory Notices 7.4.1 FCC marking ReliaGATE 10-12 User manual Rev. 2-1 Some versions of this product are FCC marked (for more information see "Technical specifications" on page 25). They comply with the regulatory information reported in the following sections. Eurotech is not responsible for the use of the product together with equipment (for example: power supplies, personal computers, etc.
ReliaGATE 10-12 User manual Rev. 2-1 l l l l 7.4.3 7 Regulatory information Réorienter ou déplacer l'antenne de réception Augmenter la distance entre le produit et le récepteur Brancher l'appareil sur une prise de courant différente de celle à laquelle le récepteur est raccordé Consulter le revendeur ou un technicien radio/TV expérimenté pour obtenir de l'aide.
7 Regulatory information 7.4.4 ReliaGATE 10-12 User manual Rev. 2-1 ISED Canada Regulatory Notices This device contains licence-exempt transmitter(s)/receiver(s) that comply with Innovation, Science and Economic Development Canada’s licence-exempt RSS(s). Operation is subject to the following two conditions: (1) this device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation.
ReliaGATE 10-12 User manual Rev. 2-1 7.4.7 7 Regulatory information RF Radiation Exposure Statement This product complies with FCC and ISED radiation exposure limits set forth for an uncontrolled environment. The antenna should be installed and operated with minimum distance of 20 cm between the radiator and your body. This device and its antenna(s) must not be co-located or operating in conjunction with any other antenna or transmitter except in accordance with FCC multi-transmitter product procedures.
7 Regulatory information ReliaGATE 10-12 User manual Rev. 2-1 NOTICE Within the EU, antennas have to be used in compliance with the RED requirements. Within the US/Canada, antennas have to be used in compliance with the FCC/ISED requirements. Au sein de l'UE, les antennes doivent être utilisées conformément aux exigences RED. Aux États-Unis et au Canada, les antennes doivent être utilisées conformément aux exigences de la FCC/ISED. 7.
ReliaGATE 10-12 User manual Rev. 2-1 8 Interfaces overview 8 INTERFACES OVERVIEW 8.1 Front Side Interfaces overview The Front Side Interfaces are as follows: Figure 8.1 - Front Side Interfaces layout Ref# Description 1 Antenna connector for 2.4 GHz Wi-Fi / Bluetooth (all vers. except: -61, -63, -64) 2 Main antenna connector for Internal Cellular Modem: CELL MAIN (all vers. except: -61, -62) 3 Antenna Connector for Internal Global Navigation Satellite System (vers.
8 Interfaces overview 8.2 ReliaGATE 10-12 User manual Rev. 2-1 Rear Side Interfaces overview The Rear Side Interfaces are as follows: Figure 8.2 - Rear Side Interfaces layout Ref# Description 1 Ethernet ETH 1 connector 2 Ethernet ETH 0 connector 3 USB 0 connector 4 USB 1 connector 5 Service Panel 6 Power IN connector Table 8.
ReliaGATE 10-12 User manual Rev. 2-1 8.2.1 8 Interfaces overview Service Panel Interfaces The Interfaces available in the Service Panel are as follows: Figure 8.
8 Interfaces overview 8.3 ReliaGATE 10-12 User manual Rev. 2-1 Right Side Interface overview The Right Side Interface is as follows: Figure 8.4 - Right Side Interfaces layout Ref# Description 1 Expansion connector Table 8.4 - Right Side Interfaces description For more information see: l "Expansion connector" on page 62 l "How to enable the 3.
ReliaGATE 10-12 User manual Rev. 2-1 8.4 8 Interfaces overview Left Side Interface overview The Left Side Interface is as follows: Figure 8.5 - Left Side Interface layout Ref# Description 1 2.0 Host USB connector (ready to interface optional USB accessories, e.g.: ReliaCELL 10-20) Table 8.
8 Interfaces overview 8.5 ReliaGATE 10-12 User manual Rev. 2-1 LED Indicators overview The LED Indicators are as follows: Figure 8.6 - LED Indicators layout Ref# Use Color 1 USER1 (General Purpose) Green 2 USER2 (General Purpose) Green 3 USER3 (General Purpose) Amber 4 USER4 (General Purpose) Amber 5 CELLULAR (Internal Cellular Modem activity; all vers.
ReliaGATE 10-12 User manual Rev. 2-1 9 Interfaces in detail 9 INTERFACES IN DETAIL 9.1 Wi-Fi and Bluetooth (all vers. except: -61, -63, -64) The ReliaGATE 10-12 provides the following Wi-Fi / Bluetooth function: l 2.4 GHz Wi-Fi 802.11a,b,g,n / BLE 4.2 BLE Bluetooth l 5 GHz Wi-Fi 802.11a,b,g,n The internal circuitry allows for 2.4 GHz Wi-Fi and Bluetooth coexistence. The antennas connectors are placed on the front side. For more information see: "How to manage Wi-Fi and Bluetooth" on page 72. 9.1.
9 Interfaces in detail 9.1.2 Bluetooth specifications l l l 9.1.3 Supports Bluetooth 4.2 Includes concurrent operation and built -in coexisting and prioritization handling of Bluetooth, BLE, audio processing and WLAN Dedicated Audio processor supporting on chip SBC encoding + A2DP: o Assisted A2DP (A3DP) support - SBC encoding implemented internally o Assisted WB-Speech (AWBS) support - modified SBC codec implemented internally BLE specifications l l l l 9.1.4 ReliaGATE 10-12 User manual Rev.
ReliaGATE 10-12 User manual Rev. 2-1 9.2 9 Interfaces in detail Internal Cellular Modem (all vers.
9 Interfaces in detail 9.2.2.1 ReliaGATE 10-12 User manual Rev.
ReliaGATE 10-12 User manual Rev. 2-1 9.2.2.
9 Interfaces in detail 9.2.3 ReliaGATE 10-12 User manual Rev.
ReliaGATE 10-12 User manual Rev. 2-1 9.2.
9 Interfaces in detail ReliaGATE 10-12 User manual Rev. 2-1 If you are using the holder on the bottom side of the circuit board To insert the MicroSIM card, complete the following steps: 1. Orient the MicroSIM card with the contacts facing the circuit board and the cut corner - highlighted with the letter A - facing the holder 2. Push the MicroSIM card in the holder To remove the MicroSIM card, pull it out from the holder: use a pair of plastic tweezers to simplify the operation.
ReliaGATE 10-12 User manual Rev. 2-1 9.3 9 Interfaces in detail Internal GNSS (vers.: -65G, -66G, -67G) The ReliaGATE 10-12 provides the following GNSS function: Internal Untethered Dead Reckoning; 72 channels GPS, Galileo, GLONASS, BeiDou. The GNSS outputs NMEA data; this data can be read by applications directly. The antenna connector is placed on the front side. For more information see: "How to manage the Internal GNSS" on page 75. 9.3.
9 Interfaces in detail 9.4 ReliaGATE 10-12 User manual Rev. 2-1 Digital I/Os The ReliaGATE 10-12 provides the following Digital I/Os: l 2x Digital Input: 36 V, 1 kV Optoinsulated l 2x Digital Output: 40 V AC/DC, 1 kV Optoinsulated, 500 mA, 1 kHz Max Switching The Digital I/Os connector is available on the front side. For more information see: "How to manage the Digital I/Os" on page 85. 9.4.1 Insulated Digital Inputs 9.4.1.
ReliaGATE 10-12 User manual Rev. 2-1 9.4.2 Insulated Digital Outputs 9.4.2.1 Electrical specifications 9 Interfaces in detail The table below shows the electrical specifications of the digital outputs: 9.4.2.2 Characteristic Value Maximum Voltage 40 V Maximum Current 500 mA Output ON Resistance Typical: 0.83 Ohm Maximum: 2.50 Ohm Maximum switching frequency 1 kHz Electrical schematics The illustration below shows the electrical schematics of one digital output: 9.4.
9 Interfaces in detail 9.5 ReliaGATE 10-12 User manual Rev.
ReliaGATE 10-12 User manual Rev. 2-1 9.5.4 9 Interfaces in detail Note for fail-safe resistors for COM 1 in RS-485 mode To insert the RS-485 fail-safe resistors, use the DIP switch available in the Service Panel. 9.5.4.1 Switches meaning Default DIP switch configuration is OFF; this means no resistors inserted. 9.5.5 SW # Signal Description 1 RS232_RX/485_D+ Line ON: 4.7 kΩ pull-up resistor inserted on COM 1 2 RS232_TX/485_D- Line ON: 4.
9 Interfaces in detail 9.5.6 COM 0 and COM 1 connector specifications Connector Layout: Connector Specifications: l Base strip, Header l Gender: Male l Type: 10-pin, 3.5 mm pitch Mating Connector Specifications: l Pluggable screw terminal block; l Gender: Female l Type: 10-pin, 3.5 mm pitch l Example: Manufacturer: Shenzhen Connection Electronics Co., Ltd. Part Number: MC 1,5/10-STF-3,5 - 1847204 (or equivalent) 58 / 118 ReliaGATE 10-12 User manual Rev.
ReliaGATE 10-12 User manual Rev. 2-1 9.6 9 Interfaces in detail CAN 0 and CAN 1 The ReliaGATE 10-12 provides 2x CAN (Controller Area Network) ports compliant with the CAN Specification 2.0, Parts A and B: l CAN 0 l CAN 1 The CAN connectors are available on the front side. For more information see: "How to manage the CAN ports" on page 76. No CAN termination resistors are present internally. If required, they need to be added externally.
9 Interfaces in detail 9.7 ReliaGATE 10-12 User manual Rev. 2-1 ETH 0 and ETH 1 The ReliaGATE 10-12 provides 2x 10/100 Mbps Ethernet ports: l ETH 0 l ETH 1 The Ethernet connectors are available on the rear side. For more information see: "How the Ethernet ports are exposed" on page 85. 9.7.1 9.7.2 Ethernet specifications Feature Description Network Standard IEEE 802.3u 10/100-BaseTX. IEEE 802.3x full-duplex flow control.
ReliaGATE 10-12 User manual Rev. 2-1 9.8 9 Interfaces in detail USB 0, USB 1, USB 2 The ReliaGATE 10-12 provides 3x Host 2.0 USB ports (Noise and Surge Protected) for general purpose applications: l USB 0 on the rear side l USB 1 on the rear side l USB 2 on the left side (ready to interface optional USB accessories, e.g.: ReliaCELL 10-20). 9.8.
9 Interfaces in detail 9.9 ReliaGATE 10-12 User manual Rev. 2-1 Expansion connector The ReliaGATE 10-12 provides, on the right side, an expansion connector with the following interfaces: l Additional USB OTG interface l I2S Audio interface l GPIO expansion interface l I2C interface l SPI interface For more information see: l "Right Side Interface overview" on page 42 l "How to enable the 3.
ReliaGATE 10-12 User manual Rev. 2-1 9.10 9 Interfaces in detail TTL Serial Console The ReliaGATE 10-12 provides a 3.3 V TTL compatible Serial console in the Service Panel. The voltage levels are as follows: l Log 1 (Hi): 2.0 to 3.3 V l Log 0 (Low): 0 to 0.8 V For more information see: "How the TTL Serial Console is exposed" on page 76. 9.10.1 TTL Serial Console connector specifications Connector Layout: Connector Specifications: l Shrouded header l Gender: Male l Type: Pitch 1.
9 Interfaces in detail 9.11 ReliaGATE 10-12 User manual Rev. 2-1 MicroSD card holder The MicroSD card holder is integrated in a Combo MicroSD (push-pull) + MicroSIM (pull-lever) cards holder, placed on the top side of the circuit board in the Service Panel. The holder allows you to insert a MicroSD card (up to 32 GB) for additional data storage. 9.11.1 How to insert / remove the MicroSD card in the holder To insert the MicroSD card, complete the following steps: 1.
ReliaGATE 10-12 User manual Rev. 2-1 9.12 9 Interfaces in detail RTC (Real Time Clock) The ReliaGATE 10-12 includes the following two RTC (Real Time Clocks) devices: RTC device Description /dev/rtc0 l /dev/rtc1 l l l 9.12.1 Use Internal (in the CPU SoC) Reserved External (I2C-based RTC device) Default RTC used by Linux Accuracy: 25 minutes per year (at 25 °C) User available The RTC Device "/dev/rtc1" The RTC device "/dev/rtc1" offers three timestamp registers.
9 Interfaces in detail 9.12.2.2 ReliaGATE 10-12 User manual Rev. 2-1 How to enable/disable the battery To enable/disable the battery, use the RTC battery jumper: l Jumper inserted = Battery connected l Jumper removed = Battery not connected 9.13 Watchdog The ReliaGATE 10-12 includes a watchdog / supervisor IC, external to the CPU. For more information see: "How the Watchdog is exposed" on page 88. 9.
ReliaGATE 10-12 User manual Rev. 2-1 10 The Software 10 THE SOFTWARE 10.1 The Linux OS distribution Eurotech provides a Linux distribution based on a Yocto framework, www.yoctoproject.org, as well as an SDK for application development. All the documentation for the developer is available from:www.yoctoproject.org/documentation. 10.
10 The Software 10.5 ReliaGATE 10-12 User manual Rev. 2-1 The TPM The ReliaGATE 10-12 includes a TPM 2.0 hardware module: Infineon SLB9670. This is connected to the CPU via an SPI interface. By default, the ReliaGATE 10-12 does not utilise the TPM device. It is therefore fully available for customer use. See "The TPM and the tpm2-tools package" on page 90.
ReliaGATE 10-12 User manual Rev. 2-1 11 11 How to login the Administration Console HOW TO LOGIN THE ADMINISTRATION CONSOLE This section describes how to login the Administration Console to access the ReliaGATE 10-12 Linux Operating System. To login the Administration Console, use one of the following methods: l Direct login via Console Port l Remote login via Secure Shell (SSH) 11.
11 How to login the Administration Console 11.3.1 ReliaGATE 10-12 User manual Rev. 2-1 How to Login Via eth0 To login using eth0, complete the following steps: 1. Enter the command ssh root@172.16.0.1 2. At the prompt, enter the password (see "Default credentials" on the previous page). 11.3.2 How to Login via eth1 To login using eth1, you need to know its IP address. Use a zeroconf implementation to detect it. By default, the ReliaGATE 10-12 runs a zeroconf implementation.
ReliaGATE 10-12 User manual Rev. 2-1 12 12 How to manage interfaces in Linux HOW TO MANAGE INTERFACES IN LINUX Interfaces availability depends on product version. If Everyware Software Framework (ESF) is installed, it will manage the network interfaces, cellular modem, Bluetooth adapter and GPIOs. Any changes you make to the Linux configuration files may be overwritten if the related service is managed by ESF. Refer to the ESF documentation for more information. 12.
12 How to manage interfaces in Linux 12.2 ReliaGATE 10-12 User manual Rev. 2-1 How to determine the version of Linux installed To determine the version of Linux installed, enter the following command: eurotech_versions Example output: eth_name_bsp: xxx eth_vers_bsp: Operating System version eth_partno_bsp: unknown eth_serial_number: xxx eth_model: xxx eth_partno_epr: unknown 12.
ReliaGATE 10-12 User manual Rev. 2-1 12.
12 How to manage interfaces in Linux 12.5.2.1 ReliaGATE 10-12 User manual Rev. 2-1 How to select the AT&T firmware To select the AT&T firmware, use the following command: telit-he910 chat ‘AT#FWSWITCH=0,1’ 12.5.2.2 How to select the Verizon firmware To select the Verizon firmware, use the following command: telit-he910 chat ‘AT#FWSWITCH=1,1’ 12.5.
ReliaGATE 10-12 User manual Rev. 2-1 12.6 12 How to manage interfaces in Linux How to manage the Internal GNSS The ReliaGATE 10-12 exposes the GNSS as follows: l /dev/ttyS5 You need to enable the GNSS before it will work. To enable the GNSS, enter the following command: gpio_utility gpio81 1 To prove that the positioning is working, dump the serial port output by entering the following commands: stty -F /dev/ttyS5 raw speed 9600 cat /dev/ttyS5 Example output: $GNGSA,A,1,,,,,,,,,,,,,99.99,99.99,99.
12 How to manage interfaces in Linux 12.7 ReliaGATE 10-12 User manual Rev. 2-1 How to manage the CAN ports The ReliaGATE 10-12 exposes the CAN ports as follows: can0 l CAN 0 port: can1 l CAN 1 port: CAN ports are added through the SocketCAN kernel extension. For more information on SocketCAN refer to the Linux kernel documentation: www.kernel.org/doc/Documentation/networking/can.txt 12.7.
ReliaGATE 10-12 User manual Rev. 2-1 12.9 12 How to manage interfaces in Linux How to manage the COM ports The ReliaGATE 10-12 exposes the COM ports as follows: l COM port 0 (RS-422/485): /dev/ttyO4 (available on the front side) l COM port 1 (RS-232/485): /dev/ttyO3 (available on the front side) You need to configure the serial ports mode before they will work. 12.9.1 How to set the termination resistors for COM 0 in RS-485 mode The termination resistors are controlled with the "gpio_utility".
12 How to manage interfaces in Linux 12.9.2.2 ReliaGATE 10-12 User manual Rev.
ReliaGATE 10-12 User manual Rev.
12 How to manage interfaces in Linux ReliaGATE 10-12 User manual Rev.
ReliaGATE 10-12 User manual Rev. 2-1 12.9.3 12 How to manage interfaces in Linux How to set the RS-232/485 modes for COM 1 You can configure the serial port mode in the following ways, A or B: A. Using the ethsetserial utility B. Implementing the ioctl in the source code 12.9.3.
12 How to manage interfaces in Linux 12.9.3.2 ReliaGATE 10-12 User manual Rev.
ReliaGATE 10-12 User manual Rev.
12 How to manage interfaces in Linux ReliaGATE 10-12 User manual Rev.
ReliaGATE 10-12 User manual Rev. 2-1 12 How to manage interfaces in Linux 12.10 How to manage the Digital I/Os The ReliaGATE 10-12 exposes the Digital I/Os (GPIOs) as follows: /sys/class/gpio/gpio26/value l Digital Input 1: /sys/class/gpio/gpio27/value l Digital Input 2: /sys/class/gpio/gpio87/value l Digital Output 1: /sys/class/gpio/gpio89/value l Digital Output 2: To manage these GPIOs, see "How to drive the GPIOs: the GPIO Utility" on page 71. 12.
12 How to manage interfaces in Linux ReliaGATE 10-12 User manual Rev. 2-1 12.13 How to enable the 3.3V and 5V power supply on the Expansion connector 3.3V and 5V are OFF by default and are controlled driving specific GPIO’s. To control the 3.3V, enter the following commands: #turn on 3.3V gpio_utility gpio71 1 #turn off 3.
ReliaGATE 10-12 User manual Rev. 2-1 12 How to manage interfaces in Linux 12.
12 How to manage interfaces in Linux ReliaGATE 10-12 User manual Rev. 2-1 12.15 How the Watchdog is exposed The ReliaGATE 10-12 exposes the watchdog as follows: l Watchdog: /dev/watchdog1 12.15.
ReliaGATE 10-12 User manual Rev. 2-1 12 How to manage interfaces in Linux 12.16 How to output Accelerometer and Gyroscope values The ReliaGATE 10-12 includes a 3D digital accelerometer / 3D digital gyroscope: l The accelerometer is exposed as cat /sys/bus/iio/devices/iio\:device1 l The gyroscope is exposed as cat /sys/bus/iio/devices/iio\:device0 To output the three-dimensional values for the accelerometer, use the following commands: watch -n 1 cat /sys/bus/iio/devices/iio\:device1/in_anglvel_x_raw watc
12 How to manage interfaces in Linux ReliaGATE 10-12 User manual Rev. 2-1 12.17 How to read the Internal Temperature Sensor The ReliaGATE 10-12 is provided with a sensor that measures the temperature inside the product. To read the internal temperature, enter the following command: cat /sys/class/hwmon/hwmon0/temp1_input 12.18 How to know the programmable pushbutton status The programmable pushbutton can be programmed to execute a shell script every time the button is pushed.
ReliaGATE 10-12 User manual Rev. 2-1 13 How to compile custom software 13 HOW TO COMPILE CUSTOM SOFTWARE 13.1 How to setup the toolchain To setup the toolchain, complete the following steps: 1. Make sure you're using the correct toolchain version corresponding to the Yocto image installed on your gateway. The latest toolchain and Yocto image for your ReliaGATE 10-12 are available here: https://eurotech.github.io/linux-releases/ 2.
(This page has been intentionally left blank)
ReliaGATE 10-12 User manual Rev. 2-1 14 14 Eurotech Everyware IoT EUROTECH EVERYWARE IOT Eurotech Everyware IoT is a combination of hardware, firmware, operating systems, programming frameworks, and cloud platforms. It enables you to layer you added-value components on a reliable readyto-use infrastructure, dramatically accelerating the time to market of your IoT projects. 14.
14 Eurotech Everyware IoT 14.2 The ESF Web UI ESF provides a web-based user interface: ESF Web UI. The ESF Web UI provides several functions such as: l Monitor the gateway status l Manage the network configuration l Oversee the installed application(s) and services. The ESF Web UI is available on port 80 of the gateway IP. The default user is: admin The default password is: admin The following picture shows an example of the ESF Web UI: 94 / 118 ReliaGATE 10-12 User manual Rev.
ReliaGATE 10-12 User manual Rev. 2-1 14.3 14 Eurotech Everyware IoT The ESF Wires application ESF provides also a dataflow programming model: Wires. Wires simplifies the development of Edge Computing Applications leveraging reusable configurable components. In the dataflow programming model, the application logic is expressed as a directed graph (flow) where each node can have inputs, outputs and independent processing units.
14 Eurotech Everyware IoT 14.4 ReliaGATE 10-12 User manual Rev. 2-1 Everyware Cloud (EC) Eurotech’s Everyware™ Cloud (EC) is an IoT Integration Platform that simplifies system and data management by connecting distributed devices over secure and reliable cloud services. Everyware Cloud allows you to connect, configure and manage devices through all the lifecycle, from deployment through maintenance to retirement.
ReliaGATE 10-12 User manual Rev. 2-1 15 MECHANICAL SPECIFICATIONS 15.1 Product mechanical dimensions 15 Mechanical specifications The product electronics are housed in an ABS enclosure having the following dimensions: 139 (L) x 115 (W) x 46 (H); mm - Antennas Connectors and Mounting Bracket included. All dimensions are in millimeters.
15 Mechanical specifications 15.2 ReliaGATE 10-12 User manual Rev. 2-1 Mounting bracket mechanical dimensions The Mounting Bracket fastened on the bottom side of the ReliaGATE 10-12 has the following dimensions. All dimensions are in millimeters.
ReliaGATE 10-12 User manual Rev. 2-1 16 16 How to install the product HOW TO INSTALL THE PRODUCT The product is intended for professional use and must be installed by qualified personnel only. The product must be installed in a secured location, accessible to authorized personnel only (for example in a cabinet / technical compartment). By default, the ReliaGATE 10-12 comes with a Mounting Bracket fastened on the bottom side. You can use this Mounting Bracket to install the ReliaGATE 10-12.
16 How to install the product ReliaGATE 10-12 User manual Rev. 2-1 16.2 How to replace the Mounting Bracket with the DIN Rail Mounting Clip or vice versa 16.2.1 How to replace the Mounting Bracket with the DIN Rail Mounting Clip To replace the Mounting Bracket with the DIN Rail Mounting Clip on the product, complete the following steps: 1. Remove the 3 screws that hold the Mounting Bracket in place 2. Remove the Mounting Bracket and the 3 spacers (H = 4mm; Ext. diam. = 14mm; Int. diam. = 7mm) 3.
ReliaGATE 10-12 User manual Rev. 2-1 16.2.2 16 How to install the product How to replace the DIN Rail Mounting Clip with the Mounting Bracket To replace the DIN Rail Mounting Clip with the Mounting Bracket on the product, complete the following steps: 1. Remove the 3 screws that hold the DIN Rail Mounting Clip in place 2. Remove the DIN Rail Mounting Clip 3. Place the 3 spacers (H = 4mm; Ext. diam. = 14mm; Int. diam. = 7mm) and the Mounting Bracket 4.
16 How to install the product 16.2.3 ReliaGATE 10-12 User manual Rev. 2-1 Which screws are used with the Mounting Bracket or with the DIN Rail Mounting Clip The 3 screws that hold in place the Mounting Bracket or the DIN Rail Mounting Clip have the following features: l Phillips type H cross flat countersunk head screw KA35x12 l Fully threaded l Stainless steel l Example of Manufacturer and Part Number: Bossard BN 13580 2000997 102 / 118 Reference Value (mm) ΦDK 7.3 T 1.3 L 12 ΦD 3.
ReliaGATE 10-12 User manual Rev. 2-1 16 How to install the product 16.3 How to install/ remove the product on/ from a DIN Rail 16.3.1 How to install the product on a DIN Rail Prerequisite: Replace the Mounting Bracket with the DIN Rail Mounting Clip To install the product on a horizontal DIN rail, complete the following steps: 1. Hook the upper mobile latches of the DIN Rail Mounting Clip on the upper edge of the DIN rail 2. Push the product against the DIN rail.
(This page has been intentionally left blank)
ReliaGATE 10-12 User manual Rev. 2-1 17 17 Power supply. How to turn ON/OFF and reset the product POWER SUPPLY. HOW TO TURN ON/OFF AND RESET THE PRODUCT This product is not provided with any ON/OFF switch. The Power IN connector is the disconnecting means from the power supply network. 17.1 17.
17 Power supply. How to turn ON/OFF and reset the product 17.3 ReliaGATE 10-12 User manual Rev. 2-1 How to supply power and turn ON the product WARNING ELECTRIC SHOCK HAZARD Failure to supply power correctly or to follow all operating instructions correctly, may create an electric shock hazard, which could result in personal injury or loss of life, and / or damage the equipment or other property. To avoid injuries and safely supply power to the product, complete the following steps: 1.
ReliaGATE 10-12 User manual Rev. 2-1 17.4 17 Power supply. How to turn ON/OFF and reset the product How to turn OFF the product To turn the ReliaGATE 10-12 OFF follow these steps: 1. Login the Administration Console 2. Enter the command poweroff. The system turns OFF 3. Remove the power from the Power IN connector. 17.
(This page has been intentionally left blank)
ReliaGATE 10-12 User manual Rev. 2-1 18 18 How to maintain the product HOW TO MAINTAIN THE PRODUCT Periodically inspect the product to verify its integrity and to ensure proper operation. To maintain the product, complete the following steps: 1. Carefully read and understand the instructions contained in the section "Safety instructions" on page 9 2. Safely remove the power supply 3. Verify the installation of the product 4. Clean the product 18.
(This page has been intentionally left blank)
ReliaGATE 10-12 User manual Rev. 2-1 Appendix 1: Advanced boot options APPENDIX 1: ADVANCED BOOT OPTIONS 1.1 Advanced boot options availability The ReliaGATE 10-12 bootloader provides a number of advanced boot options, that allow a developer to run different build artifacts. The following advanced boot options are currently available: Boot option How it works Notes fitboot 1. It retrieves the production fitImage from /boot/fitImage in the filesystem 2. It executes the fitImage 3.
Appendix 1: Advanced boot options 1.1.3 ReliaGATE 10-12 User manual Rev. 2-1 How to change the default boot option The default boot option is fitboot which boots the production kernel fitimage. To change the default option, complete the following steps: 1. Access to the bootloader CLI 2. Enter the following commands: setenv bootcmd ‘run ’ saveenv boot where: l l 1.2 is one of the available boot options saveenvis the command that writes the changes to flash, making them permanent.
ReliaGATE 10-12 User manual Rev. 2-1 Appendix 1: Advanced boot options To configure the system in Linux, insert the following commands: fw_setenv fitboot ‘setenv image_path $fit_path; run imageload; bootm ${loadaddr}:kernel@1 ${loadaddr}:fdt@reliagate-10-12-.dtb; where is either: xx, spi or gpio.
(This page has been intentionally left blank)
Appendix 2: Expansion connector pin map with respect to device tree pin assignment ReliaGATE 10-12 User manual Rev. 2-1 APPENDIX 2: EXPANSION CONNECTOR PIN MAP WITH RESPECT TO DEVICE TREE PIN ASSIGNMENT The ReliaGATE 10-12 provides an Expansion connector on the right side. For more information see: l "Right Side Interface overview" on page 42 l "Expansion connector" on page 62 l "How to enable the 3.3V and 5V power supply on the Expansion connector" on page 86.
(This page has been intentionally left blank)
ReliaGATE 10-12 User manual Rev.
EUROTECH.COM HEADQUARTERS Via Fratelli Solari, 3/a 33020 Amaro (UD) - Italy Tel: +39 0433.485.411 Fax: +39 0433.485.499 Email: welcome@eurotech.com Web: www.eurotech.com For your Eurotech local contact refer to: eurotech.com/contacts For the Eurotech Global Support Centre refer to: support.eurotech.com For the Eurotech Download Area refer to: eurotech.
