TS-7100-Z GPIO
| Note: | This section is incomplete at this time. |
The i.MX6UL CPU and FPGA GPIOs are exposed using a kernel character device. This interface provides a set of files and directories for interacting with GPIO which can be used from any language that interact with special files in linux using ioctl() or similar. For our platforms, we pre-install the "libgpiod" library and binaries. Documentation on these tools can be found here. This section only covers using these userspace tools and does not provide guidance on using the libgpiod library in end applications. Please see the libgpiod documentation for this purpose.
A user with suitable permissions to read and write /dev/gpiochip* files can immediately interact with GPIO pins. For example, to see if input power has failed:
gpioget $(gpiofind POWER_FAIL_3V)
Multiple pins in the same chip can be read simultaneously by passing multiple pin numbers separated by spaces.
To write to a pin, the gpioset command is used. For example, to set Relay 1:
gpioset $(gpiofind EN_RELAY_1)=1
Multiple pins in the same chip can be set simultaneously by passing multiple pin=value pairs separated by spaces.
If a call with gpioset or gpioget fails with "Device or resource busy," that means that specific GPIO is claimed by another device. The command cat /sys/kernel/debug/gpio can be used to get a list of all of the system GPIO and what has claimed them.
The gpiomon tool can be used to monitor pins for changes to GPIOs that generate interrupts (i.e., CPU GPIOs).
In the following table, gpiochips 0, 3 and 4 are on the CPU, and gpiochips 5 through 7 are on the FPGA.
Because this numbering is subject to change, it is advisable to use the gpiofind command to look it up by its label, as shown in the usage examples above and elsewhere in this manual.
| Label | Chip | Pin | Location |
|---|---|---|---|
AN_CH4[1]
|
0 | 0 | AIN 4 or Digital Input AIN 4 on CN32 Terminal |
RTC_BATT_FAIL
|
0 | 1 | Battery failed/missing on the Battery Connector |
AN_CH0[1]
|
0 | 4 | AIN 0 on CN32 Terminal |
AN_CH1[1]
|
0 | 5 | AIN 1 or Digital Input AIN 1 on CN32 Terminal |
AN_CH2[1]
|
0 | 8 | AIN 2 or Digital Input AIN 2 on CN32 Terminal |
AN_CH3[1]
|
0 | 9 | AIN 3 or Digital Input AIN 3 on CN32 Terminal |
| 0 | 18 | CPU Board Red LED | |
| 0 | 19 | CPU Board Green LED | |
NIM_STATUS
|
3 | 14 | Pin 13 on CN16 (XBee/Nimbelink_Socket) |
POWER_FAIL_3V
|
4 | 0 | Power Input Failure |
FPGA_IRQ[1]
|
4 | 1 | FPGA Interrupt input pin |
EN_RELAY_1
|
4 | 4 | Relay 1 on CN32 Terminal |
EN_RELAY_2
|
4 | 5 | Relay 2 on CN32 Terminal |
NIM_RESET
|
4 | 6 | Pin 5 on CN16 (XBee/Nimbelink_Socket) |
DIO_1_OUT
|
5 | 0 | DIO 1 Out or PWM on CN32 Terminal |
DIO_2_OUT
|
5 | 1 | DIO 2 Out or PWM on CN32 Terminal |
DIO_1_IN
|
5 | 2 | DIO 1 In on CN32 Terminal |
DIO_2_IN
|
5 | 3 | DIO 2 In on CN32 Terminal |
DIO_3_IN
|
5 | 4 | DIO 3 In on CN32 Terminal |
DIO_6
|
5 | 5 | FPGA DIO 06 |
DIG_IN_1
|
5 | 6 | Digital In 1 on CN32 Terminal |
DIG_IN_2
|
5 | 7 | Digital In 2 on CN32 Terminal |
DIG_IN_3
|
5 | 8 | Digital In 3 on CN32 Terminal |
EN_CL_1
|
5 | 9 | AIN 1 4-20 mA current loop enable |
EN_CL_2
|
5 | 10 | AIN 2 4-20 mA current loop enable |
EN_CL_3
|
5 | 11 | AIN 3 4-20 mA current loop enable |
| 5 | 12 | Reserved | |
| 5 | 13 | Reserved | |
EN_CL_4
|
5 | 14 | AIN 4 4-20 mA current loop enable |
EN_HS_SW
|
5 | 15 | High-Side Switch or HSPWM |
EN_ADC1_12V
|
6 | 1 | AIN 1 0-12 V meas. mode [2] |
EN_ADC2_12V
|
6 | 2 | AIN 2 0-12 V meas. mode [2] |
EN_ADC3_12V
|
6 | 3 | AIN 3 0-12 V meas. mode [2] |
EN_ADC4_12V
|
6 | 4 | AIN 4 0-12 V meas. mode [2] |
EN_USB_HOST_5V
|
6 | 5 | en usb host 5v |
PHY_RESET#[1]
|
6 | 6 | Ethernet PHY reset |
WIFI_RESET#[1]
|
6 | 7 | WiFi module reset |
IO_RED_LED#[1]
|
6 | 8 | I/O Board Red LED |
IO_GREEN_LED#[1]
|
6 | 9 | I/O Board Green LED |
| 6 | 12 | Reserved | |
DIO_3_OUT
|
6 | 13 | DIO 3 Out or PWM on CN32 Terminal |
EN_HSPWM
|
6 | 14 | Enable high-side PWM |
EN_LSPWM
|
6 | 15 | Low-side PWM drain enable |
CPU_TOUCH_IRQ#[1]
|
7 | 0 | Touchscreen IRQ |
| 7 | 2 | FPGA Strapping Pin | |
| 7 | 3 | FPGA Strapping Pin | |
| 7 | 4 | FPGA Strapping Pin | |
| 7 | 5 | FPGA Strapping Pin | |
NIM_3V3#_4V
|
7 | 6 | Data 0: Select 3.3 V power on CN16 XBee Socket [3] |
| Data 1: Select 4 V power on CN16 XBee Socket [3] | |||
NIM_PWR_ON
|
7 | 8 | Pin 20 (Power Button) on CN16 XBee Socket |
SEL_NIM_USB
|
7 | 9 | Enable USB interface on CN16 XBee Socket [4] |
DIO_FAULT#
|
7 | 10 | I/O over-current/over-voltage breaker tripped [5] |
| 7 | 11 | FPGA Strapping Pin | |
| 7 | 12 | FPGA Strapping Pin | |
| 7 | 13 | Reserved | |
EN_BK_LT#[1]
|
7 | 14 | LCD backlight enable |
- ↑ 1.00 1.01 1.02 1.03 1.04 1.05 1.06 1.07 1.08 1.09 1.10 1.11 Claimed by driver. Not available for use.
- ↑ 2.0 2.1 2.2 2.3 This bit is read only. Clearing the associated current loop enable bit will set this bit, setting the CL enable will clear this bit
- ↑ 3.0 3.1 To disable power on this pin, set the GPIO as an input with 'gpioset' or otherwise
- ↑ This will relocate the USB channel connected to the top USB host port
- ↑ This bit must be cleared manually after a trip to de-assert the associated IRQ
Digital Inputs
The digital inputs on the TS-7100-Z are capable of supporting various voltage ranges and input modes. The digital inputs support dry contact switches as well as a driven input voltage. The table below lists each digital input, the bank and pin number for reading the input, the maximum input voltage range, the threshold voltages, as well as the location of the input. VIH Min is the minimum voltage on the input to trigger a logic 1 input. VIL Max is the maximum voltage on the input to trigger a logic 0 input. All of the digital inputs are hysteretic. The driving input must be able to at least sink current to drive the input low, but all digital inputs are compatible with push-pull drivers.
| Input Name | Bank | Pin | V Range | VIH Min | VIL Max | Location |
|---|---|---|---|---|---|---|
| Digital In 1 | 5 | 6 | 0-30 V | ~2.57 V | ~0.95 V | CN32 Terminal, pin 9 |
| Digital In 2 | 5 | 7 | 0-30 V | ~2.57 V | ~0.95 V | CN32 Terminal, pin 11 |
| Digital In 3 | 5 | 8 | 0-30 V | ~2.57 V | ~0.95 V | CN32 Terminal, pin 13 |
| DIO 1 In [1] | 5 | 2 | 0-30 V | ~2.54 V | ~0.90 V | CN32 Terminal, pin 14 |
| DIO 2 In [1] | 5 | 3 | 0-30 V | ~2.54 V | ~0.90 V | CN32 Terminal, pin 16 |
| DIO 3 In [1] | 5 | 4 | 0-30 V | ~2.54 V | ~0.90 V | CN32 Terminal, pin 18 |
| AIN 1 In [2] | 0 | 5 | 0-12 V | ~8.60 V | ~7.90 V | CN32 Terminal, pin 25 |
| AIN 2 In [2] | 0 | 8 | 0-12 V | ~8.60 V | ~7.90 V | CN32 Terminal, pin 23 |
| AIN 3 In [2] | 0 | 9 | 0-12 V | ~8.60 V | ~7.90 V | CN32 Terminal, pin 21 |
| AIN 4 In [2] | 0 | 0 | 0-12 V | ~8.60 V | ~7.90 V | CN32 Terminal, pin 19 |
- ↑ 1.0 1.1 1.2 This GPIO should only be read as an input. Its value reflects the voltage on the physical CN32 pin, regardless of output status
- ↑ 2.0 2.1 2.2 2.3 The AIN pins can be used as Digital Inputs, but require software changes first. See the ADC section for more information
Digital Outputs
The TS-7100-Z supports a handful of digital output pins. These are able to act as high-current low-side switches. The table below lists each digital output, the bank and pin number for accessing it, the maximum voltage rating, the maximum current output, as well as the location of the pin.
| DIO Name | Bank | Pin | Max V Rating | Max A Rating | Location |
|---|---|---|---|---|---|
DIO_1_OUT
|
5 | 0 | 30 V | 700 mA (sink) [1] | CN32 Terminal, pin 14 |
DIO_2_OUT
|
5 | 1 | 30 V | 700 mA (sink) [1] | CN32 Terminal, pin 16 |
DIO_3_OUT
|
6 | 13 | 30 V | 700 mA (sink) [1] | CN32 Terminal, pin 18 |
EN_HS_SW
|
5 | 15 | 48 V [2] | 300 mA (source) [3] | CN32 Terminal, pin 27 |
- ↑ 1.0 1.1 1.2 Not to exceed 1000 mA total across all three Digital I/O, doing so will cause the over-current breaker to trip
- ↑ The output voltage is the same as the TS-7100-Z input voltage
- ↑ Exceeding 330 mA will cause the over-current breaker to trip
Digital Output Over-Current Breaker
The TS-7100-Z I/O PCB in combination with the FPGA on the TS-7100, implements an electronic over-current breaker. When this breaker is tripped all three DIO Out paths will be disabled, the High-Side Switch output will be disabled, analog current loops will be disabled, and the red LED on the TS-7100-Z I/O board will be illuminated. That is, digital outputs will cease to sink or source any amount of current, and the AIN inputs will have 4-20 mA input disabled. The tripped breaker will also trigger a DIO fault breaker interrupt as well as set the associated GPIO flag DIO_FAULT#. The GPIO output DIO_FAULT# must be cleared manually in order to reset the IRQ output. However, once the breaker trips, and the trip condition is cleared; all relevant GPIO settings can immediately be re-enabled without clearing this GPIO output bit.
Trip Conditions
See the table above for each DIO channel's maximum current rating. Note that the breaker does NOT enforce these ratings per DIO channel. The breaker will trip if the combined total amount of current sunk from all three digital outputs exceeds 1 A.
See the table above for the High-Side Switch's maximum current rating. If the rated max supply current is exceeded, the breaker will trip.
Note that all of these are in parallel. If the combined DIO sink current OR High-Side Switch current is exceeded, then the breaker will trip. The over-current breaker will also disable analog 4-20 mA current loop measurements.