Maxx GW4100: Unterschied zwischen den Versionen

Aus WIKI IoTmaxx GmbH
Zur Navigation springen Zur Suche springen
← Zum vorherigen VersionsunterschiedZum nächsten Versionsunterschied →
Nbrandt (Diskussion | Beiträge)
561 Bearbeitungen
Nbrandt (Diskussion | Beiträge)
561 Bearbeitungen
Zeile 198: Zeile 198:
| Modem State || Status vom Modem
| Modem State || Status vom Modem
'''Locked:'''
'''Locked:'''
'''Initializing:'''


'''Enabled:'''
'''Enabled:'''


'''Searching:'''
'''Searching:'''
'''Connecting:'''
'''Registered:'''


'''Connected:'''
'''Connected:'''

Version vom 28. Dezember 2021, 10:32 Uhr

Quick Guide

Einleitung

Die IoTmaxx Gateway-Serie GW410x ermöglicht über ihre zahlreichen Schnittstellen ein Einfaches einsammeln und verarbeiten von Informationen mit einer sicheren Übertragung über das Mobilfunknetz. Zur Inbetriebnahme ist eine SIM-Karte Ihres Mobilfunkbetreibers mit geeignetem Tarif erforderlich.

Bitte beachten Sie: Eine falsche PIN kann zur Sperrung der SIM-Karte führen. Halten Sie sicherheitshalber die Super-Pin bzw. PUK zur Freischaltung bereit.

Zur Inbetriebnahme des Gateways benötigen Sie:

  • Eine LTE-Antenne mit SMA-Stecker
  • Ein Netzteil mit einer Ausgangsspannung im Bereich von 10 bis 30V DC/>15W
  • Ein Ethernet-Kabel
  • Einen PC oder Laptop mit Ethernet-Anschluss und installiertem Browser
  • Eine SIM-Karte im Formfaktor MINI-SIM (2ff)

Montage der Antenne

Schrauben Sie die Antenne an den „GSM“-Anschluss des Gateways. Wenn Sie eine Antenne mit GPS-Signal benutzen, schließen Sie bitte den zweiten SMA-Stecker an den „GPS“-Anschluss an.

Einlegen der SIM-Karte

Auf der Rückseite des Gateways befinden sich zwei Slots für SIM-Karten sowie ein Slot für eine Micro SD-Karte. Der obige Slot ist für eine MINI-Sim (2ff), der darunter liegenden Slot für eine MICRO-SIM (3ff) vorbereitet.

Im Auslieferungszustand wird nur der Slot für eine MINI-Sim (2ff) unterstützt.

Stecken Sie bitte, wie in der Abbildung dargestellt, die SIM-Karte in den obersten Slot, bis diese einrastet. Verwenden Sie gegebenenfalls ein flaches Werkzeug (z.B. Schraubenzieher) um die SIM einzuschieben.

SIM-Karten Slot

Anschluss der Spannungsversorgung

Schließen Sie bitte das Netzteil an den Steckverbinder mit der „+ -“ Beschriftung an. Achten Sie auf die richtige Polarität. Das Gateway ist mit einem Verpolungsschutz ausgerüstet, bleibt aber bei falscher Polarität inaktiv. Nach dem Einschalten des Netzteils leuchten während der Initialisierungsphase (ca. 5s) die LED A und LED B, die Power-LED leuchtet dauerhaft. Wenn die LED A und LED B erloschen sind, ist das Gerät betriebsbereit.

Konfiguration des GW410x

Die Konfiguration des Gateways erfolgt über das integrierte Webinterface. Bitte gehen Sie wie folgt vor:

a. Verbinden Sie Ihren PC mit dem Ethernet-Kabel direkt mit der Ethernet-Schnittstelle (eth0). Das Gateway ist im Auslieferungszustand als DHCP Server konfiguriert, sodass Ihr PC automatisch eine IP-Adresse erhält.

b. Öffnen Sie einen Browser auf Ihrem PC und geben Sie die IP-Adresse 192.168.1.1:3000 in das Adressfeld ein.

c. Geben Sie im Anmeldefenster als Nutzername und Passwort jeweils „admin“ (ohne Anführungszeichen) ein und klicken Sie auf „LOGIN“.

d. Öffnen Sie den Menüpunkt „Wireless Network“. Tragen Sie hier unter „PIN“ die PIN-Nummer Ihrer SIM-Karte ein, sofern Sie die PIN-Abfrage Ihrer SIM-Karte nicht abgeschaltet haben. In diesem Fall kann das Feld leer bleiben.

e. Bestätigen Sie Ihre Eingaben mit „SUBMIT“.

Wireless Network

Zustandssignalisierung

Der Betriebszustand der Mobilfunkverbindung der Gateway-Serie GW410x wird über die GSM Status LED wie im Folgenden beschrieben signalisiert.

GSM Status LED Netzverbindung
Langsames Blinken (kurz EIN / lang AUS) Netzsuche
Langsames Blinken (lang EIN / kurz AUS) Eingebucht, aber keine Datenverbindung
Schnelles Blinken (kurz EIN / kurz AUS) Eingebucht und eine bestehende Datenverbindung

Manual

Ab diesem Bereich werden die Einstelloptionen im Web based management beschrieben

Konfiguration über WBM (Web Based Management)

Die Konfiguration des maxx GW410x erfolgt über eine Webbrowser basierende Funktion. Hierfür müssen zunächst folgende Bedingungen erfüllt sein:

  • Der PC, der zur Konfiguration des Gateways verwendet wird, verfügt über eine LAN-Schnittstelle.
  • Auf dem PC ist ein Webbrowser installiert (z.B. Google Chrome, Mozilla Firefox, Microsoft Internet Explorer).
  • Das Gateway ist mit einer Spannungsquelle verbunden.

Start der Konfiguration

1. Ethernet-Verbindung zwischen Computer und Gateway herstellen

2. Ggf. die IP-Adresse der LAN-Schnittstelle auf das Subnetz des Gateways abstimmen

3. Webbrowser öffnen

4. Die IP-Adresse des Gateways (Default: 192.168.1.1:3000) in das Adressfeld des Browsers eingeben und die Eingabe bestätigen. Anschließend erfolgt eine Benutzername/Passwort-Abfrage.

Login

Im Auslieferungszustand lautet der Benutzername „admin“ und das Passwort „admin“.

  • Admin: Lese- und Schreibzugriff auf alle Bereiche

Default Passwörter:

  • Admin: admin

Nach der Eingabe des Benutzernamens und des Passwortes öffnet sich das Hauptmenü zur Konfiguration des maxx GW410x.

Hauptseite

Wireless Network

Im Menüpunkt "Wireless Network” legen Sie die Einstellungen für die Nutzung des Mobilfunknetzwerkes vom maxx GW410x fest.

Wireless Network

Wireless Network
APN Name des Anschlusspunktes im Paketdaten-Netzwerk (Providervorgabe)
PIN Eingaben vom PIN für die SIM-Karte
Authentication Type Wählen Sie die Protokolle für die Anmeldung beim Provider:

None: Der APN des Providers erfordert keine Anmeldung (Voreinstellung)

PAP only: Nur Password Authentication Protocol

CHAP only: Nur Challenge-Handshake Authentication Protocol

PAP/CHAP: Password oder Challenge-Handshake Authentication Protocol

Roaming allowed Enabled: Es besteht die Möglichkeit, dass das Gateway sich über ein fremdes Netz einwählen kann. Hierbei können je nach Vertrag zusätzliche Kosten entstehen.

Disabled: Deaktivierung vom Roaming. Es wird automatisch das Heimatnetz des Providers genutzt. Sollte dies nicht möglich sein, kommt keine Verbindung zustande.

Local Network

Im Menüpunkt "Local Network" können Sie die Netzwerkkonfiguration des Gateways anpassen. Das Gateway ist im Auslieferungszustand als DHCP-Server für die Ethernet-Schnittstelle (eth0) konfiguriert.

Local Network

Local Network
DHCP Client Das Gateway kann auch als DHCP Client konfiguriert werden, so dass es automatisch von einem lokalen Router (DHCP Server) eine IP-Adresse, ein entsprechendes Gateway und einen DNS (Namenserver) zugewiesen bekommt. Wenn diese Funktion aktiviert ist, sind weitere Eingaben für die Netzwerkkonfiguration inaktiv. Es wird jedoch die vom lokalen Router (DHCP Server) zugewiesene Konfiguration angezeigt.

Achtung: Stellen Sie sicher, dass Sie im Vorfeld die vom Router (DHCP Server) vergebene IP-Adresse kennen, um weiterhin die Erreichbarkeit des Gateways zu gewährleisten.

IPv4 Eingabe der IPv4-Adresse mit Subnetzmaske in CIDR-Form
IPv6 Eingabe der IPv6-Adresse mit Subnetzmaske in CIDR-Form
Gateway Eingabe der IP-Adresse für das Standardgateway
Nameserver Eingabe der IP-Adresse vom Nameserver für die Namensauslösung (DNS)
DHCP Server Das Gateway kann auch als DHCP Server konfiguriert werden. Dabei wird den Geräten, die über die Ethernet-Schnittstelle (eth0) verbunden (und als DHCP Client konfiguriert) sind automatisch eine IP-Adresse, ein entsprechendes Gateway und ein Nameserver (DNS) zugewiesen.

Offset: Offset des Adresspools vom Beginn des Teilnetzes.

Size: Größe vom Adresspool. Konfigurieren Sie 0 für alle Adressen im Subnetz.

Lease Time: Vergabezeit in Stunden. Konfigurieren Sie 0 für unendlich.

Internet access for connected devices allowed Das Gateway bietet die Möglichkeit für die an der LAN-Schnittstelle angeschlossenen Geräte einen Internetzugang über das Mobilfunkmodem bereitzustellen.

Achtung: Stellen Sie sicher, dass sich die am Gateway angeschlossenen Geräte im selben Subnetz vom Gateway befinden und das ggf. für das Standardgateway an den Geräten die IP-Adresse vom Gateway konfiguriert ist.

Über die USB-Schnittstelle am maxx GW410x kann über einen USB_TO_ETHERNET Adapter eine zweite Ethernet-Schnittstelle (eth1) realisiert werden. Nachdem der USB_TO_ETHERNET Adapter gesteckt ist, erscheint automatisch ein zusätzliches Konfigurationsfeld für eth1. Vom Gateway werden Adapter mit dem Chipsatz Asix IC AX88772B unterstützt.

Network State

In diesem Menüpunkt werden Ihnen aktuelle Status-Informationen zu dem Ethernet-Schnittstellen und den Wireless-Schnittstellen angezeigt.

Network State

Network State >> Ethernet Interfaces
Device State Status der Ethernet-Schnittstelle

Unmanaged: Nicht konfiguriert

Connected: Verbunden

Connection State Verbindungstatus der Ethernet-Schnittstelle

Deactivated: Deaktiviert

Activated: Aktiviert

IPv4 IPv4-Adresse mit Subnetzmaske in CIDR-Form
IPv6 IPv6-Adresse mit Subnetzmaske in CIDR-Form
Gateway IP-Adresse für das Standardgateway
DNS IP-Adresse vom Nameserver für die Namensauslösung (DNS)


Network State


Network State >> Wireless Interfaces
Device State Status der Wireless-Schnittstelle

Disconnected:

Preparing Connection:

Connected:

Modem State Status vom Modem

Locked:

Initializing:

Enabled:

Searching:

Connecting:

Registered:

Connected:

Connection State Verbindungstatus der Wireless-Schnittstelle

Deactivated:

Activated:

Power State Leistungsmodus der Wireless-Schnittstelle
Signal Quality Empfangsqualität vom aktuell eingebuchten Netz

Unknown:

55%:

Access Tech Verbindungsart in das aktuell eingebuchte Netz

Unknown:

GSM:

UMTS:

LTE:

IMEI International Mobile Equipment Identity (15-stellige Seriennummer, anhand derer jedes GSM- oder UMTS-Endgerät weltweit eindeutig identifiziert werden kann)
Registration State Registrierungsstatus

Idle:

Searching:

Home:

Operator ID Provider-Identifikation vom aktuell eingebuchten Netz
Operator Name Provider-Name vom aktuell eingebuchten Netz
SIM Unlock Retries SIM-Entsperrungsversuche. Verbleibenden Versuche bis die SIM gesperrt ist und der PUK eingetragen werden muss
PUK Unlock Retries PUK-Entsperrungsversuche. Verbleibenden Versuche für die Eingaben vom PUK.
SIM Lock State SIM-Lock-Status

SIM requires the PIN code:

SIM requires the PIN 2 code:

IPv4 Zugewiesene IPv4-Adresse mit Subnetzmaske in CIDR-Form vom aktuell eingebuchten Netz
IPv6 Zugewiesene IPv6-Adresse mit Subnetzmaske in CIDR-Form vom aktuell eingebuchten Netz
Gateway Zugewiesene IP-Adresse für das Standardgateway vom aktuell eingebuchten Netz
DNS Zugewiesene IP-Adresse vom Nameserver für die Namensauslösung (DNS) vom aktuell eingebuchten Netz


The Device

Linux login

Per default login to the Linux system is possible by the use of a ssh connection on eth0 or via the serial console on the RS232 interface (115.200 baud, 8N1).

login: root

password: iotmaxx

Please be advised to at least change the password and deactivate the serial console before deploying the device. The use of further security measures (PSK etc.) is strongly encouraged.

Interfaces

The following section describes the various interfaces of the GW4100 in detail. This graphic shows the distribution of the interfaces:


Beschreibung



Pinout RS232, RS485, CAN-Bus, 1-Wire connector

Description Function Label Signal Pin Pin Signal Label Function
#1-wire 1-Wire 1w Data 1 2 +5V 5V Power 1-Wire
#CAN CAN high CH High 3 4 Low CL CAN Low
GND GND GND 5 6 GND GND GND
#RS485 RS485 D- D- 7 8 D+ D+ RS485
#RS232 RS232 TXD TXD 9 10 CTS CTS RS232
RXD RXD 11 12 RTS RTS

Pinout Digital IN/OUT connector

Description Function Label Signal Pin Pin Signal Label Function
#Multi-purpose I/O Multi-purpose I/O 1 G1 GPIO1 1 2 GPIO2 G2 Multi-purpose I/O 2
GND GND GND 3 4 GND GND GND
#Digital inputs Digital Input 1 l1 GPI1 5 6 GPI2 l2 Digital Input 2
Digital Input 3 l3 GPI3 7 8 GPI4 I4 Digital Input 4

Power

The device requires an external ES1/PS2 DC power supply 8-30V, 25W.

Ethernet

10/100MBit ethernet interface, per default configured as DHCP server with IP address 192.168.1.1.

USB

USB 2.0 host interface for connection of external USB devices. Please note that an appropriate Linux driver ist required for many devices.

SD card

Micro SD card interface for adding additional non-volatile memory to the system. Please use a SD card to store rapidly changing data (e.g. databases etc.) as the internal flash memory allows limited write cycles before potential memory corruption may occur.

CAN

The interface according to the CAN 2.0B protocol specification is relaized using the i.MX7D’s flexcan interface and a NXP TJA1051 transceiver. It features a switchable 120R termination resistor.

On the Linux side a SocketCAN interface (can0) with a default bitrate of 250.000 bit/s is provided.

The termination resistor is activated by driving CAN_TERM_EN_n low. See Linux mapping for details.

RS485

A non-isolated RS485 interface is available as /dev/ttymxc3. The interface does not include a termination resistor.

RS232

A 4-wire RS232 interface is available as /dev/ttymxc2. In default configuration this interface will provide a Linux serial console at 115200 baud (8N1).

1-wire

The GW4100 incorporates a DS2482 I2C to 1-wire bridge device from Maxim Integrated (https://www.maximintegrated.com/en/products/interface/controllers-expanders/DS2482-100.html#). The corresponding driver is integrated in the Linux mainline kernel and all 1-wire functions are exposed to the sysfs filesystem.

Please see https://www.kernel.org/doc/html/latest/w1/w1-generic.html for a detailed description of the user space interface.

Digital inputs

The following diagram shows the internal design of the four digital inputs:



This design allows the connection of push-pull- and open-collector-outputs with a threshold of about 4.5V. It is also possible to use a mechanical switch or a relais to connect the input to GND without the need for an additional pullup resistor.

Following diagram shows a simplified design:


Please note that the input is inverted internally so that in case the input is either unconnected or connected to a voltage above the threshold will be read as logical 0 (low level), when connected to a voltage below the threshold (e.g. 0V) it will be read as logical 1 (high level)

The GPIs are exposed to the sysfs filesystem on the linux side an can be automatically inverted again for user conveniance.

TODO: add linux example

Multi-purpose I/O

The device contains two multi-purpose GPIOs which can be configured as in- or output. When required an internal pullup resistor can be activated.

Furthermore can the GPIO be used as an analog input as the input voltage is also connected to one of the internal 12-bit ADC channels (s. On board ADCs) .


The GPIO is current limited (tbd mA) in the high- and lowside current paths so closing high- and lowside switches at the same time will not damage the device (neither will an external short-circuit condition), it is nevertheless not advised to do so and use break-before-make logic instead.

TODO: add linux example

GSM

TE connectivity with fallback to 3G and 2G is provided by an integrated Quectel EC21 module. On the Linux side the device is controlled by ModemManager (see https://core.docs.ubuntu.com/en/stacks/network/modem-manager/docs/).

ModemManager uses /dev/ttyUSB3 for communication with the EC21, /dev/ttyUSB2 is available for AT command execution from user space.

The status of the GSM module can additionally be monitored by the means of GSM_PWR_IND_n which will be driven low when the module is on.

The GW4100 contains two SIM holders to allow the use of 2FF (Mini SIM) or 3FF (Micro SIM) cards. It is possible to populate both cards to allow e.g. the use of different networks. The active SIM card is selected by the following procedure.

SIM select procedure

First the EC21 has to be configured via AT commands to allow SIM hot-swapping:

((ABB))

Please note that a module restart by AT+CFUN is required, the setting will be persistent.

Next the SIM has to be “logically removed” by setting SIM_EN low.

Afterwards the active SIM can be selected by SIM_SEL (default high -> 2FF SIM)

Then the SIM can be “logically inserted” again by driving SIM_EN high

TODO: check if accessible old/new interface

Activating the data connection

The modem can then be used with: 

root@Gateway:~ mmcli -m 0
--------------------------------
General  |            dbus path: /org/freedesktop/ModemManager1/Modem/0
         |            device id: dd1983f3c13bd25a19647d2fca076dad57ef5c57
--------------------------------
Hardware |         manufacturer: Quectel
         |                model: EC21
         |    firmware revision: EC21EFAR06A02M4G
         |            supported: gsm-umts, lte
         |              current: gsm-umts, lte
         |         equipment id: 867962042149685
--------------------------------
System   |               device: /sys/devices/platform/soc/30800000.bus/30b30000.usb/ci_hdrc.1/usb1/1-1/1-1.1
         |              drivers: option1
         |               plugin: Quectel
         |         primary port: ttyUSB2
         |                ports: ttyUSB0 (qcdm), ttyUSB2 (at), ttyUSB3 (at)
--------------------------------
Numbers  |                  own: +4915140075573
--------------------------------
Status   |       unlock retries: sim-pin (3), sim-puk (10), sim-pin2 (3), sim-puk2 (10)
         |                state: disabled
         |          power state: on
         |       signal quality: 0% (cached)
--------------------------------
Modes    |            supported: allowed: 2g, 3g, 4g; preferred: none
         |              current: allowed: 2g, 3g, 4g; preferred: none
--------------------------------
IP       |            supported: ipv4, ipv6, ipv4v6
--------------------------------
3GPP     |                 imei: 867962042149685
--------------------------------
3GPP EPS | ue mode of operation: csps-2
--------------------------------
SIM      |            dbus path: /org/freedesktop/ModemManager1/SIM/0



After every reset the modem increases its number.

To add a new connection issue: 

root@Gateway:~ nmcli c add type gsm ifname "*" con-name telekom apn "internet.t-mobile"
Connection 'telekom' (17bdada4-4361-4eca-8506-f6eab6b26a48) successfully added.


And then to enable the connection: 


root@Gateway:~ nmcli c up telekom
Connection successfully activated (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/3)

root@Gateway:~ mmcli -m 0
--------------------------------
General  |            dbus path: /org/freedesktop/ModemManager1/Modem/0
         |            device id: 794eb538900f787165b66d8af66496a4e7cd0c8b
--------------------------------
Hardware |         manufacturer: QUALCOMM INCORPORATED
         |                model: QUECTEL Mobile Broadband Module
         |    firmware revision: EC21EFAR06A02M4G
         |       carrier config: default
         |         h/w revision: 10000
         |            supported: gsm-umts, lte
         |              current: gsm-umts, lte
         |         equipment id: 867962042149685
--------------------------------
System   |               device: /sys/devices/platform/soc/30800000.bus/30b30000.usb/ci_hdrc.1/usb1/1-1/1-1.1
         |              drivers: qmi_wwan, option1
         |               plugin: Quectel
         |         primary port: cdc-wdm0
         |                ports: cdc-wdm0 (qmi), ttyUSB0 (qcdm), ttyUSB2 (at), wwan0 (net),
         |                       ttyUSB3 (at)
--------------------------------
Numbers  |                  own: 4915140075573
--------------------------------
Status   |                 lock: sim-pin2
         |       unlock retries: sim-pin (3), sim-puk (10), sim-pin2 (3), sim-puk2 (10)
         |                state: connected
         |          power state: on
         |          access tech: gsm
         |       signal quality: 41% (recent)
--------------------------------
Modes    |            supported: allowed: 2g; preferred: none
         |                       allowed: 3g; preferred: none
         |                       allowed: 4g; preferred: none
         |                       allowed: 2g, 3g; preferred: 3g
         |                       allowed: 2g, 3g; preferred: 2g
         |                       allowed: 2g, 4g; preferred: 4g
         |                       allowed: 2g, 4g; preferred: 2g
         |                       allowed: 3g, 4g; preferred: 3g
         |                       allowed: 3g, 4g; preferred: 4g
         |                       allowed: 2g, 3g, 4g; preferred: 4g
         |                       allowed: 2g, 3g, 4g; preferred: 3g
         |                       allowed: 2g, 3g, 4g; preferred: 2g
         |              current: allowed: 2g, 3g, 4g; preferred: 4g
--------------------------------
Bands    |            supported: egsm, dcs, utran-1, utran-5, utran-8, eutran-1, eutran-3,
         |                       eutran-5, eutran-7, eutran-8, eutran-20
         |              current: egsm, dcs, utran-1, utran-5, utran-8, eutran-1, eutran-3,
         |                       eutran-5, eutran-7, eutran-8, eutran-20
--------------------------------
IP       |            supported: ipv4, ipv6, ipv4v6
--------------------------------
3GPP     |                 imei: 867962042149685
         |          operator id: 26201
         |         registration: home
--------------------------------
3GPP EPS | ue mode of operation: csps-2
--------------------------------
SIM      |            dbus path: /org/freedesktop/ModemManager1/SIM/0
--------------------------------
Bearer   |            dbus path: /org/freedesktop/ModemManager1/Bearer/0

GNSS

For geo positioning a GNSS receiver integrated in the Quectel EC21 module is available. NMEA data is output on /dev/ttyUSB1. The GNSS receiver is activated with the following AT command:

AT+QGPS=1

For a detailed description of the available configuration options please consult the EC21 documentation (https://www.quectel.com/product/ec21.htm).

Active antenna supply is provided by regulator 9 of the Qorvo ACT8847 power management ic (PMIC). Following commands from user space are required to activate the supply: 

# regulator 3.0V
i2cset -y 2 0x5a 0x70 0x36 i
# regulator on
i2cset -y 2 0x5a 0x71 0x80 i

User LEDs

The device contains two user controllable LEDs (e.g. status signal). These are exposed to the sysfs under /sys/class/leds/. See Linux mapping for details.

please see https://www.kernel.org/doc/Documentation/leds/leds-class.txt for details.

User Button

There is a consealed button available for user defined functions (e.g. reset to factory default)

TODO: add linux example, picture

On board ADCs

The following diagram shows the usage of the eight 12-bit ADCs of the i.MX7D processor.

ADC 0 provides access to the voltage levels of the two multi-purpose GPIOs and the supply voltage as well as a board temperature indicator while ADC 1 is used to monitor system health status.

All ADC values are accessible from Linux user space via sysfs mapping (/sys/bus/iio/devices/).

Example 1: reading the actual value of the 5V supply lane 

root@Gateway:~ cat /sys/bus/iio/devices/iio:device1/in_voltage0_raw
3789


Calculation of voltage:


Example 2: reading the system supply voltage 

root@Gateway:~ cat /sys/bus/iio/devices/iio:device0/in_voltage2_raw
2145


Calculation of voltage:


Please note that measurement is taken behind the input diode and therefor the actual supply voltage is aprox. 0.5V higher (in this case the actual supply voltage is 24V)

Example 3: reading the board temperature 

root@Gateway:~ cat /sys/bus/iio/devices/iio:device0/in_voltage3_raw
2576


Calculation of NTC resistance:




Consulting the resistance lookup table in the resistors (NCP15XV103J03RC) datasheet the board temperature is at about 37°C.

Linux mapping

Digital and analog I/Os (deprecated sysfs mapping)

Signal Linux mapping Typ
GPIN1 /sys/class/gpio10 digital inputs
GPIN2 /sys/class/gpio11
GPIN3 /sys/class/gpio14
GPIN4 /sys/class/gpio15
GPIO0_IN_n /sys/class/gpio3 Multi-purpose I/Os
GPIO0_ADC /sys/bus/iio/devices/iio:device0/in_voltage0_raw
GPIO0_HIGHSIDE /sys/class/gpio0
GPIO0_LOWSIDE /sys/class/gpio1
GPIO0_PULLUP /sys/class/gpio2
GPIO1_IN_n /sys/class/gpio9
GPIO1_ADC /sys/bus/iio/devices/iio:device0/in_voltage0_raw
GPIO1_HIGHSIDE /sys/class/gpio4
GPIO1_LOWSIDE /sys/class/gpio5
GPIO1_PULLUP /sys/class/gpio8
LED_USR1 /sys/class/leds/iotmaxx:green:usr1/ LED B
LED_USR2 /sys/class/leds/iotmaxx:green:usr2/ LED A
PBSTAT_IRQ_n /sys/class/gpio33 PMIC PBSTAT IRQ
5V_PERIPH_EN /sys/class/gpio34 N/A, always on
ACT8847_IRQ_n /sys/class/gpio90 PMIC IRQ
RTC_INTA_n /sys/class/gpio61 RTC IRQ
USR_SWITCH_n /sys/class/gpio91 User switch
SIM_ENABLE /sys/class/gpio89 SIM select
SIM_SEL /sys/class/gpio112
CAN_TERM_EN_n /sys/class/gpio108 CAN termination resistor
GSM_PWR_IND_n /sys/class/gpio115 GSM power indicator

Digital and analog I/Os (new libgpiod mapping)

Signal Linux mapping line Typ
GPIN1 gpiochip0 line 10 digital inputs
GPIN2 gpiochip0 line 11
GPIN3 gpiochip0 line 14
GPIN4 gpiochip0 line 15
GPIO0_IN_n gpiochip0 line 13 Multi-purpose I/Os
GPIO0_ADC /sys/bus/iio/devices/iio:device0/in_voltage0_raw
GPIO0_HIGHSIDE gpiochip0 line 0
GPIO0_LOWSIDE gpiochip0 line 1
GPIO0_PULLUP gpiochip0 line 2
GPIO1_IN_n gpiochip0 line 9
GPIO1_ADC /sys/bus/iio/devices/iio:device0/in_voltage1_raw
GPIO1_HIGHSIDE gpiochip0 line 4
GPIO1_LOWSIDE gpiochip0 line 5
GPIO1_PULLUP gpiochip0 line 8
LED_USR1 /sys/class/leds/iotmaxx:green:usr1/ LED B
LED_USR2 /sys/class/leds/iotmaxx:green:usr2/ LED A
PBSTAT_IRQ_n gpiochip1 line 1 PMIC PBSTAT IRQ
5V_PERIPH_EN gpiochip1 line 2 N/A, always on
ACT8847_IRQ_n gpiochip2 line 26 PMIC IRQ
RCT_INTA_n gpiochip1 line 29 RTC IRQ
USR_SWITCH_n gpiochip2 line 27 USER switch
SIM_ENABLE gpiochip2 line 25 SIM select
SIM_SEL gpiochip3 line 16
CAN_TERM_EN_n gpiochip3 line 12 CAN termination resistor
GSM_PWR_IND_n gpiochip3 line 19 GSM power indicator

GPIO Linux user space examples (deprecated sysfs mapping)

Example: exporting and reading GPIN1 (high level applied to input pin) 


root@Gateway:~ echo 11 > /sys/class/gpio/export
root@Gateway:~ echo 1 > /sys/class/gpio/gpio11/active_low
root@Gateway:~ cat /sys/class/gpio/gpio11/value
1


Example: exporting and enabling GPIO1 pullup 

root@Gateway:~ echo 8 > /sys/class/gpio/export
root@Gateway:~ echo high > /sys/class/gpio/gpio8/direction


Please see https://www.kernel.org/doc/html/latest/admin-guide/gpio/sysfs.html for a detailed description of the sysfs gpio interface.

GPIO Linux user space examples (new libgpiod mapping)

Example: reading GPIN1 (high level applied to input pin), no export required 


root@Gateway:~ gpioget --active-low gpiochip0 11
1

Example: enabling GPIO1 pullup, no export required 

gpioset gpiochip0 8=1


Please see https://git.kernel.org/pub/scm/libs/libgpiod/libgpiod.git/tree/README for a description of the libgpiod interface.

Serial interfaces and busses

Interface or bus Linux mapping
RS232 /dev/ttymxc2 linux console
RS485 /dev/ttymxc3
1-wire /sys/bus/w1/ see kernel.org
CAN can0 network interface
Ethernet eth network interface
USB device dependent
Abgerufen von „http://wiki.iotmaxx.com/index.php?title=Maxx_GW4100&oldid=1953“