User manual DynaGATE 10-12-6x Automotive 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.
DynaGATE 10-12 User manual Rev. 2-1 How to get started HOW TO GET STARTED To get started with the DynaGATE 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)
DynaGATE 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 Caution: product's surfaces may become hot 9 9 9 10 10 10 10 2 Consignes de securite 2.1 Messages d’avertissement 2.1.
Contents DynaGATE 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 32 32 32 33 34 34 34 35 35 35 36 8 Interfaces overview 8.
DynaGATE 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 supercap 9.13 Watchdog 9.14 Accelerometer and Gyroscope 9.15 Programmable pushbutton Contents 61 62 62 63 63 63 63 63 63 10 The Software 10.1 The Linux OS distribution 10.2 The bootloader procedure 10.
Contents DynaGATE 10-12 User manual Rev. 2-1 12.18 How to know the programmable pushbutton status 12.19 How to read the Vehicle Ignition Sense status 12.20 The TPM and the tpm2-tools package 12.21 Optional: How to manage the ReliaCELL power supply 88 88 88 89 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.
DynaGATE 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 DynaGATE 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.
DynaGATE 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 DynaGATE 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.
DynaGATE 10-12 User manual Rev. 2-1 2.4 2 Consignes de securite Attention: les surfaces du produit peuvent devenir chaudes Selon la température ambiante lors de l’utilisation, les surfaces du produit peuvent devenir brûlantes, engendrant un risque de brûlure. Laisser toujours les surfaces du produit refroidir avant de les toucher.
(This page has been intentionally left blank)
DynaGATE 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)
DynaGATE 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)
DynaGATE 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)
DynaGATE 10-12 User manual Rev. 2-1 6 Product overview 6 PRODUCT OVERVIEW 6.1 Product description The DynaGATE 10-12 is a family of IoT Edge Gateways designed to deliver LTE connectivity with 2G/3G fallback to automotive and lightly rugged applications. The DynaGATE 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 DynaGATE 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.
DynaGATE 10-12 User manual Rev. 2-1 6.3 6 Product overview Technical specifications The DynaGATE 10-12 family is available in several -XY versions, for example: DynaGATE 10-12-63 (where: X = 6, Y = 3).
6 Product overview DynaGATE 10-12 User manual Rev.
DynaGATE 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 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.4/5 GHz Wi-Fi/BT Telematic-mount Antenna: Linx Technologies ANT-DB1-RAF-RPS 99ACC-60750-C0007 2.
6 Product overview DynaGATE 10-12 User manual Rev.
DynaGATE 10-12 User manual Rev. 2-1 6.
(This page has been intentionally left blank)
DynaGATE 10-12 User manual Rev. 2-1 7 7 Regulatory information REGULATORY INFORMATION This section provides regulatory information for the DynaGATE 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 15). 7.
7 Regulatory information 7.1.5 DynaGATE 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.
DynaGATE 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 DynaGATE 10-12 User manual Rev. 2-1 Some versions of this product are FCC marked (for more information see "Technical specifications" on page 23). 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.
DynaGATE 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 DynaGATE 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.
DynaGATE 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 DynaGATE 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.
DynaGATE 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.
8 Interfaces overview 8.2 DynaGATE 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.
DynaGATE 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 DynaGATE 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 60 l "How to enable the 3.
DynaGATE 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 DynaGATE 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.
DynaGATE 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 DynaGATE 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 70. 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 DynaGATE 10-12 User manual Rev.
DynaGATE 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 DynaGATE 10-12 User manual Rev.
DynaGATE 10-12 User manual Rev. 2-1 9.2.2.
9 Interfaces in detail 9.2.3 DynaGATE 10-12 User manual Rev.
DynaGATE 10-12 User manual Rev. 2-1 9.2.
9 Interfaces in detail DynaGATE 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.
DynaGATE 10-12 User manual Rev. 2-1 9.3 9 Interfaces in detail Internal GNSS The DynaGATE 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 73. 9.3.
9 Interfaces in detail 9.4 DynaGATE 10-12 User manual Rev. 2-1 Digital I/Os The DynaGATE 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 83. 9.4.1 Insulated Digital Inputs 9.4.1.
DynaGATE 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 DynaGATE 10-12 User manual Rev.
DynaGATE 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) 56 / 114 DynaGATE 10-12 User manual Rev.
DynaGATE 10-12 User manual Rev. 2-1 9.6 9 Interfaces in detail CAN 0 and CAN 1 The DynaGATE 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 74. No CAN termination resistors are present internally. If required, they need to be added externally.
9 Interfaces in detail 9.7 DynaGATE 10-12 User manual Rev. 2-1 ETH 0 and ETH 1 The DynaGATE 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 83. 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.
DynaGATE 10-12 User manual Rev. 2-1 9.8 9 Interfaces in detail USB 0, USB 1, USB 2 The DynaGATE 10-12 provides 3x Host 2.0 USB ports (Noise and Surge Protected) for general purpose applications: l USB 0 on the rear side (high retention connector) l USB 1 on the rear side (high retention connector) 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 DynaGATE 10-12 User manual Rev. 2-1 Expansion connector The DynaGATE 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 40 l "How to enable the 3.
DynaGATE 10-12 User manual Rev. 2-1 9.10 9 Interfaces in detail TTL Serial Console The DynaGATE 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 74. 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 DynaGATE 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.
DynaGATE 10-12 User manual Rev. 2-1 9.12 9 Interfaces in detail RTC (Real Time Clock) The DynaGATE 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.
(This page has been intentionally left blank)
DynaGATE 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 DynaGATE 10-12 User manual Rev. 2-1 The TPM The DynaGATE 10-12 includes a TPM 2.0 hardware module: Infineon SLB9670. This is connected to the CPU via an SPI interface. By default, the DynaGATE 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 88.
DynaGATE 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 DynaGATE 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 DynaGATE 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 DynaGATE 10-12 runs a zeroconf implementation.
DynaGATE 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 DynaGATE 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.
DynaGATE 10-12 User manual Rev. 2-1 12.5 12 How to manage interfaces in Linux How to manage the Internal Cellular Modem The DynaGATE 10-12 supports the following Telit LE910 modem variants, according to product versions based on the geographic area of usage: Product version Modem variant Technology -63, -65 Telit LE910-NA1 - North America LTE Cat 1 3G Fallback -64, -66 Telit LE910C1-EU - Europe LTE Cat 1 2G/3G Fallback -67 Telit LE910C1-AP - Japan LTE Cat 1 Before using the modem: 1.
12 How to manage interfaces in Linux 12.5.2.1 DynaGATE 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.
DynaGATE 10-12 User manual Rev. 2-1 12.6 12 How to manage interfaces in Linux How to manage the Internal GNSS The DynaGATE 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 DynaGATE 10-12 User manual Rev. 2-1 How to manage the CAN ports The DynaGATE 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.
DynaGATE 10-12 User manual Rev. 2-1 12.9 12 How to manage interfaces in Linux How to manage the COM ports The DynaGATE 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 DynaGATE 10-12 User manual Rev.
DynaGATE 10-12 User manual Rev.
12 How to manage interfaces in Linux DynaGATE 10-12 User manual Rev.
DynaGATE 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 DynaGATE 10-12 User manual Rev.
DynaGATE 10-12 User manual Rev.
12 How to manage interfaces in Linux DynaGATE 10-12 User manual Rev.
DynaGATE 10-12 User manual Rev. 2-1 12 How to manage interfaces in Linux 12.10 How to manage the Digital I/Os The DynaGATE 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 69. 12.
12 How to manage interfaces in Linux DynaGATE 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.
DynaGATE 10-12 User manual Rev. 2-1 12 How to manage interfaces in Linux 12.
12 How to manage interfaces in Linux DynaGATE 10-12 User manual Rev. 2-1 12.15 How the Watchdog is exposed The DynaGATE 10-12 exposes the watchdog as follows: l Watchdog: /dev/watchdog1 12.15.
DynaGATE 10-12 User manual Rev. 2-1 12 How to manage interfaces in Linux 12.16 How to output Accelerometer and Gyroscope values The DynaGATE 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 watch
12 How to manage interfaces in Linux DynaGATE 10-12 User manual Rev. 2-1 12.17 How to read the Internal Temperature Sensor The DynaGATE 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.
DynaGATE 10-12 User manual Rev. 2-1 12 How to manage interfaces in Linux 12.21 Optional: How to manage the ReliaCELL power supply If the ReliaCELL is installed, the DynaGATE 10-12 exposes the ReliaCELL power supply as a GPIO as follows: l /sys/class/gpio/gpio73/value To manage this GPIO, see "How to drive the GPIOs: the GPIO Utility" on page 69.
(This page has been intentionally left blank)
DynaGATE 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 DynaGATE 10-12 are available here: https://eurotech.github.io/linux-releases/ 2.
(This page has been intentionally left blank)
DynaGATE 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 / 114 DynaGATE 10-12 User manual Rev.
DynaGATE 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 DynaGATE 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.
DynaGATE 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 aluminum alloy enclosure having the following dimensions: 139 (L) x 118 (W) x 52 (H); mm - Antennas Connectors and Mounting Bracket included. All dimensions are in millimeters.
(This page has been intentionally left blank)
DynaGATE 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). 16.1 How to install the product To install the product in place, complete the following steps: 1. See "Mechanical specifications" on page 97 2.
(This page has been intentionally left blank)
DynaGATE 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 DynaGATE 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.
DynaGATE 10-12 User manual Rev. 2-1 17 Power supply. How to turn ON/OFF and reset the product 7. Connect Pin 3 (Key Signal) to "Power IN +". The DynaGATE 10-12 automatically turns ON and the LED 6 (POWER) turns ON NOTICE When connecting Pin 3 to "Power IN +", keep it connected for at least 10 seconds. If you disconnect "Power VIN +" from the Pin 3 before 10 seconds have passed, the startup procedure will not be completed correctly and an immediate and unsafe power down will occur. 8.
(This page has been intentionally left blank)
DynaGATE 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)
DynaGATE 10-12 User manual Rev. 2-1 Appendix 1: Advanced boot options APPENDIX 1: ADVANCED BOOT OPTIONS 1.1 Advanced boot options availability The DynaGATE 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 DynaGATE 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.
DynaGATE 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 DynaGATE 10-12 User manual Rev. 2-1 APPENDIX 2: EXPANSION CONNECTOR PIN MAP WITH RESPECT TO DEVICE TREE PIN ASSIGNMENT The DynaGATE 10-12 provides an Expansion connector on the right side. For more information see: l "Right Side Interface overview" on page 40 l "Expansion connector" on page 60 l "How to enable the 3.3V and 5V power supply on the Expansion connector" on page 84.
(This page has been intentionally left blank)
DynaGATE 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.
