View source for TS-TPC-7990

{{Infobox
|title        = TS-TPC-7990
|image        = https://www.embeddedarm.com/images/boards/medium/ts-tpc-7990.gif
|titlestyle   =  
|headerstyle  = background:#ccf;
|labelstyle   = width:33%
|datastyle    = 
|data2        = [http://www.embeddedarm.com/products/board-detail.php?product=TS-TPC-7990 Product Page]
|data3        = [https://www.embeddedarm.com/product-images/TS-TPC-7990 Product Images]
|data4        = [https://www.embeddedarm.com/products/TS-TPC-7990?tab=specs Specifications]
|header4      = Documentation
|data5        = [https://www.embeddedarm.com/documentation/ts-tpc-7990-schematic.pdf Schematic]
|data6        = [https://www.embeddedarm.com/documentation/ts-tpc-7990-mechanical-drawing.pdf Mechanical Drawing]
|data7        = [https://www.embeddedarm.com/documentation/ts-tpc-7990-mounting-clearance-drawing.pdf Bezel Mechanical Drawing]
|data8        = [https://www.embeddedarm.com/documentation/ts-tpc-7990-mounting-cutout-pattern.pdf Panel Cutout Drawing]
|data9        = [https://files.embeddedarm.com/ts-arm-sbc/ts-7990-linux/ FTP Path]
|header10     = Processor
|data11       = NXP i.MX6 Quad core, or Solo
|data12       = [http://www.nxp.com/products/microcontrollers-and-processors/arm-processors/i.mx-applications-processors/i.mx-6-processors/i.mx-6quad-processors-high-performance-3d-graphics-hd-video-arm-cortex-a9-core:i.MX6Q i.MX6 Quad Product Page]
|data13       = [http://www.nxp.com/products/microcontrollers-and-processors/arm-processors/i.mx-applications-processors/i.mx-6-processors/i.mx-6solo-processors-single-core-multimedia-3d-graphics-arm-cortex-a9-core:i.MX6S i.MX6 Solo Product Page]
|data14       = [https://www.nxp.com/webapp/Download?colCode=IMX6DQRM IMX6Q Reference Manual]
|data15       = [https://www.nxp.com/webapp/Download?colCode=IMX6SDLRM IMX6S Reference Manual]
}}

= Overview =
The TS-TPC-7990 is a touch panel computer supporting either capacitive or resistive touch using the i.MX6 800 MHz Solo or 1 GHz Quad core CPU.

= Getting Started =
{{:Getting started}}

== Getting Console and Powering up ==
{{Warning|Be sure to take appropriate Electrostatic Discharge (ESD) precautions. Disconnect the power source before moving, cabling, or performing any set up procedures.  Inappropriate handling may cause damage to the unit.}}

To get the initial console first connect a USB micro cable to the Console/P2 header near the bottom of the board, and connect the host cable to your workstation.  This can be done before or after power is applied, but bringing up a serial connection before applying power will allow viewing of the first few console messages.

Most Linux distributions include the cp210x driver and will register this as /dev/ttyUSB0.  For other operating systems:
* [https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers Silabs USB-to-UART drivers]
The serial console is provided through this port at 115200 baud, 8n1, with no flow control.  Picocom is the recommended client which can connect with:
<source lang=bash>
sudo picocom -b 115200 /dev/ttyUSB0
</source>

This will output some serial settings and then "Terminal ready".  Any messages after this will be from the unit itself.  Now that the terminal is ready, power can be applied.  The power input for the TS-TPC-7990 uses a removable terminal block which accepts 5 VDC, or 8-36 VDC input.  Only one should be connected at a time.

A power supply should be prepared to provide 20 W, but the device power consumption will typically be around 8 W on an idle quad core.  See the [[#Specifications|Specifications section]] for further details on power requirements, differences between build options, and options to reduce power.

{| 
| [[File:TS-TPC-7990_removable_power_connector.png|300px|left|Power connector]] 
|}

Console output should appear immediately after power input is applied.  The first output is from U-Boot:
<pre style="font-family:monospace,Courier New ;background:black; width:18cm; white-space: pre-wrap; white-space: -moz-pre-wrap; word-wrap: break-word; color:white; ">
U-Boot 2015.04-07904-g87ba17a (Jan 23 2017 - 11:56:50)

CPU:   Freescale i.MX6Q rev1.2 at 792 MHz
CPU:   Temperature 42 C
Reset cause: POR
Board: TS-TPC-7990 REV B
I2C:   ready
DRAM:  1 GiB
MMC:   FSL_SDHC: 0, FSL_SDHC: 1
SF: Detected N25Q64 with page size 256 Bytes, erase size 4 KiB, total 8 MiB
auto-detected panel LXD-WSVGA
Display: LXD-WSVGA (1024x600)
In:    serial
Out:   serial
Err:   serial
FPGA Rev: 8
SilabRev: 2
Net:   using phy at 1
FEC [PRIME]
SF: Detected N25Q64 with page size 256 Bytes, erase size 4 KiB, total 8 MiB
SF: 7655 bytes @ 0x200000 Read: OK
</pre>

[[#Jumpers|Jumpers]] on the DIO header are used to influence where and how the system boots.  When set, the "SD Boot" jumper will cause the unit to boot to SD, otherwise boot to eMMC.  Setting the "U-Boot" jumper will cause the unit to check for [[TS-4900_Production|USB updates]] on startup, and then stop at a U-Boot console.  If it is not set then U-Boot will quickly boot to the selected boot media as fast as possible.

{{Note|The "*** Warning - bad CRC, using default environment" message is expected if the U-Boot scripts and/or environment variables have not been modified from factory defaults, and can be safely ignored.  Using the U-Boot command 'env save' will save the current environment to flash, and cause this message to be removed.}}

== First Linux Boot ==
U-Boot is loaded from the onboard SPI flash, which is the CPU boot source.  U-Boot can boot to to Linux, Android, or other operating systems, from a variety of source mediums (most commonly SD or eMMC).  The eMMC and SD cards shipped with the unit will be programmed with Debian Jessie.  Other OS sections on this wiki can provide further guidance on switching to [[#Yocto|Yocto]], [[#Ubuntu|Ubuntu]], [[#Android|Android]], or others.
<pre>
[  OK  ] Started Serial Getty on ttymxc0.
[  OK  ] Reached target Login Prompts.
[  OK  ] Started SLiM Simple Login Manager.
[  OK  ] Created slice user-0.slice.
         Starting LSB: RPC portmapper replacement...
         Starting User Manager for UID 0...
[  OK  ] Started User Manager for UID 0.
[  OK  ] Started LSB: RPC portmapper replacement.
[  OK  ] Reached target RPC Port Mapper.
         Starting Authenticate and Authorize Users to Run Privileged Tasks...

Debian GNU/Linux 8 ts-imx6 ttymxc0

ts-imx6 login: 
</pre>
By default, the boot output is fairly verbose and includes kernel messages and Debian's startup messages from systemd.  On the touch panel, Debian will boot to a minimal XFCE desktop.  This is intended as an example to try out the display.  In an actual shipping application this is typically disabled and only the applications specifically intended to run are given access to draw on the screen.  See [[#Debian_Starting_Automatically|Starting automatically in Debian]] for more details.

{{Note|During development it is recommended to leave the verbose boot output on as these can help with debugging.  The messages can be disabled by [[#Modify_Linux_Kernel_cmdline|modifying the kernel cmdline]] for a quiet boot which will only print error messages.}}

The login prompt will ask for a username/password.  Under Debian this is just "root" with no password which will allow the initial login.  From here, development can continue as suggested in the [[#Debian|Debian section]] of the manual.

== Comparison of Distributions ==
We currently offer a Debian, Ubuntu, Yocto, and Android OS for the TS-TPC-7990.  Each of these have their pros and cons.  We typically recommend Debian if the user does not require GPU support, or Yocto if the goal is to use QT with remote debug support.

{| class=wikitable
|-
! Distribution
! Pros
! Cons
|-
| [[#Debian|Debian]]
| 
* [https://wiki.debian.org/DebianReleases Long Life cycles]
* Strong focus on reliability
* [https://www.debian.org/distrib/packages Huge online repository of prebuilt applications available]
* Lots of examples and documentation available
|
* Cross compiler requires running the same Debian release
* Not conveniently patched for hardware support
** No OpenGL or 2D acceleration from GPU, though framebuffer access is typically fast enough for most applications
|-
| [[#Ubuntu|Ubuntu]]
| 
* [https://wiki.ubuntu.com/Releases Long Life cycles]
* More focus on up to date packages
* [http://packages.ubuntu.com/ Huge online repository of pre-built applications available]
* Lots of examples and documentation available
| 
* Cross compilation requires running the same Ubuntu release on a host PC
* Not conveniently patched for hardware support
** No OpenGL or 2D acceleration from GPU, though framebuffer access is typically fast enough for most applications
|-
| [[#Yocto|Yocto]]
| 
* Large focus on up-to-date packages
* Allows rebuilding all packages with custom modifications
* Supports fairly portable toolchain packages that integrate with QtCreator and Eclipse
* Includes all patches needed for graphics support.
* Distribution can be rebuilt to include specific needs.
| 
* [https://wiki.yoctoproject.org/wiki/Releases Short life cycles]
* Does not support any online repository of pre-built applications.  Adding packages requires rebuilding Yocto or building the required package manually.
* Less examples and documentation available online
|-
| [[#Android|Android]]
| 
* Simple well defined API using well documented tools.
* Allows existing apps to be run without huge customization
|
* Under Android it is difficult to access hardware that is not typically on an Android tablet/phone such as UARTs, GPIO, ADC, etc.  Often users write a standard application that communicates over a localhost socket to an Android application.
* Slow boot time
* Poor documentation for OS customization
|}

= U-Boot =
{{:TS-TPC-7990 U-boot Sections}}

= Yocto =
{{:TS-TPC-7990 Yocto Sections}}

= Debian =
{{:TS-TPC-7990 Debian Sections}}

= Ubuntu =
{{:TS-4900 Ubuntu Sections}}

= Android =
{{:TS-TPC-7990_Android}}

= Backup / Restore =
== MicroSD Card ==
{{:TS-TPC-7990 MicroSD Backup/restore}}

== eMMC ==
{{:TS-TPC-7990 eMMC Backup/restore}}

= Compile the Kernel =
{{:TS-TPC-7990 Kernel Compile Guide}}

= Production Mechanism =
On startup, if the "U Boot" [[#Jumpers|jumper]] is set when power is applied, then U-Boot will attempt to load a file from a USB drive called /tsinit.ub.  If found, it will copy this to ${loadaddr} and "source ${loadaddr}" to run it as a U-Boot script.  This is intended for the initial production of boards and allows mass programming boards with a USB thumbdrive.

{{:Tsimx6_usb_production}}

= Features =
== Accelerometer ==
{{:TS-7680 Accelerometer}}

== Backlight ==
{{:TS-TPC-7990 Backlight}}

== Bluetooth ==
{{:TS-TPC-7990 Bluetooth}}

== CAN ==
{{:TS-TPC-7990 CAN}}

== CPU ==
{{:TS-TPC-7990 CPU}}

== eMMC ==
{{:TS-TPC-7990 EMMC}}

== Ethernet Port ==
The i.MX6 includes a 10/100/1000 Ethernet port which is located near the speaker.  In Linux this is the eth0 interface.  The TS-TPC-7990 includes second Ethernet located near the USB socket that is based on the SMSC LAN9514 chipset.  This is a 10/100 Ethernet port.

The MAC address uses the Technologic Systems 00:d0:69:00:00:00 OUI, and the last 3 octets are assigned from our pool.  The MAC address is burned into the CPU's fuses during production, and will be read back automatically by software in Linux or U-Boot.  The eth1 port will use the next mac address after eth0.

{{Note|NXP has a published erratum regarding the maximum Ethernet speed.  The max achievable speed for the 10/100/1000 ethernet port is ~400 Mb/s.}}

== FPGA ==
{{:TS-7990 FPGA Sections}}

== Graphics ==
=== Rotate the Display ===
{{:TS-4900 display rotation}}

== GPIO ==
{{:TS-TPC-7990 DIO}}

=== CPU GPIO Table ===
{{:TS-TPC-7990 CPU GPIO Table}}

=== FPGA GPIO Table ===
{{:TS-TPC-7990 FPGA GPIO Table}}

== I2C ==
{{:TS-TPC-7990 TWI}}

== Interrupts ==
{{:TS-TPC-7990 interrupts}}

== Jumpers ==
The TS-TPC-7990 has a set of jumpers located on the [[#DIO_Header|DIO Header]] near the edge of the SBC.  These jumpers control a number of aspects of the TS-7990's behavior.  The jumpers are labeled on the silkscreen rather than numbered:

{|class="wikitable"
!Label
!Description
|-
| SD Boot
| When jumper is set, boot kernel and Debian from the SD card.  Otherwise boot kernel and Debian from eMMC.  This jumper influences U-Boot behavior.
|-
| U Boot
| When jumper is set, pause booting in U-Boot and drop to a U-Boot shell.  Otherwise boot straight to Debian.
|-
| CAN
| When jumper is set, adds a 120 ohm termination resistor across CAN0 H and L pins.
|}

== LEDs ==
{{:TS-TPC-7990 LEDs}}

== MicroSD Card Interface ==
{{:TS-TPC-7990 MicroSD Card Interface}}

== RTC ==
{{:TS-TPC-7990 RTC}}

== SATA ==
{{:TS-TPC-7990 SATA}}

== Sleep Mode ==
{{:TS-TPC-7990 Sleep mode}}

== SPI ==
{{:TS-TPC-7990 CPU SPI Controller}}

=== Onboard SPI Flash ===
{{:TS-TPC-7990 Onboard SPI Flash}}

== UARTs ==
{{:TS-4900 COM Ports}}

All of the CPU UARTs are routed through the [[#FPGA|FPGA Crossbar MUX]] to allow rerouting, or to enable flow control for a UART.  These mappings can be changed by adjusting the crossbar, but these are the default mappings:

{|class=wikitable
|-
! UART
! Type
! TX (or 485 +)
! RX (or 485 -)
! CTS
! RTS
|-
| ttymxc0
| USB <ref> This is connected to the onboard microcontroller which presents the USB as a cp210x USB serial device on P2.  This is not intended for application use. </ref>
| Onboard Silabs
| Onboard Silabs
| N/A
| N/A
|-
| ttymxc1
| TTL 1.8
| Onboard Bluetooth
| Onboard Bluetooth
| Onboard Bluetooth
| Onboard Bluetooth
|-
| ttymxc2
| RS232
| COM3_TXD_232_3V / COM3 header pin 3
| COM3_RXD_232_3V / COM3 header pin 2
| N/A
| N/A
|-
| ttymxc3
| RS485
| TXD3_485_3V / COM3 header pin 1
| RXD3_485_3V / COM3 header pin 6
| N/A
| N/A
|-
| ttymxc4
| RS232
| COM2_TXD_232_3V / COM2 header pin 3
| COM2_RXD_232_3V / COM2 header pin 2
| N/A
| N/A
|-
| ttyMAX0
| RS485
| TXD2_485_3V / COM2 header pin 1
| RXD2_485_3V / COM2 header pin 6
| N/A
| N/A
|-
| ttyMAX1
| RS485
| TXD1_485_3V / COM1 header pin 1
| RXD1_485_3V / COM1 header pin 6
| N/A
| N/A
|-
| ttyMAX2
| RS232
| COM1_TXD_232_3V / COM1 header pin 3
| COM1_RXD_232_3V / COM1 header pin 2
| N/A
| COM1_RTS_232_3V / COM1 header pin 7
|}

<References />

== USB ==
=== USB OTG ===
{{:TS-TPC-7990 USB OTG}}

=== USB Host ===
{{:TS-TPC-7990 USB Host}}

== Watchdog ==
{{:TS-TPC-7990 Watchdog}}

== WIFI ==
{{:TS-TPC-7990 WIFI}}

= External Interfaces =
== Buttons ==
The back of the unit includes two buttons for general use.  These can be sampled with:
<source lang=bash>
echo 73 > /sys/class/gpio/export # Home
echo 74 > /sys/class/gpio/export # Back

echo in > /sys/class/gpio/gpio73/direction
echo in > /sys/class/gpio/gpio74/direction

# These will read 1 when not pressed, and 0 when pressed
cat /sys/class/gpio/gpio73/value
cat /sys/class/gpio/gpio74/value
</source>

== Displays ==
The TS-TPC-7990 includes support for three different displays.  U-boot will print out the detected display during startup:
  Display: LXD-WSVGA (1024x600)

=== LXD Display ===
The LXD is a 1024x600 7" 800 nit display with capacitive touch.  The capacitive touch is using a pixcir tango c series controller providing 5 points of touch simultaneously.

=== Okaya Display ===
The Okaya is a 800x480 7" 800 nit display with resistive touch.  This uses the onboard resistive touch controller the TSC2046.  This provides one point of touch.

=== Microtips Display ===
The Microtips display is a 800x480 7" 400 nit display with resistive touch.  This uses the onboard resistive touch controller the TSC2046.  This provides one point of touch.

== Audio ==
The TS-TPC-7990 provides audio output to an AC'97 audio header and an on-board piezo speaker.  The piezo speaker can be disabled to force audio output from only the AC97 header:
<source lang=bash>
echo 0 > /sys/class/leds/en-speaker/brightness
</source>

The utility 'aplay' can be used to play WAV files as a simple test of audio functionality. The 'arecord' utility will take input from the microphone and create a WAV file:
<source lang=bash>
arecord -d 5 recording.wav
aplay recording.wav
</source>

=== Audio Header ===
The TS-TPC-7990 includes a 2x5 0.1" pitch header which includes speaker and headphone output, as well as microphone input.  This header is compatible with AC'97 which is commonly found on desktop motherboards.  Third party cabling can be used to break out the interface to 3.5 mm jacks.

{|
| 
{| class=wikitable
|-
! Pin
! Description
|-
| 1
| MIC
|-
| 2
| GND
|-
| 3
| MIC Bias
|-
| 4
| GND
|-
| 5
| HP_R
|-
| 6
| NC
|-
| 7
| SPKR+
|-
| 8
| SPKR-
|-
| 9
| HP_L
|-
| 10
| NC
|}
| 
[[File:TS-7990-Audio.png|300px]]
|}

=== Speaker ===
[[File:cmt_piezo_response.png|thumb|350px|Audio Frequency Response]]

The TS-TPC-7990 includes an on-board piezo speaker for basic audio.  It can produce 81 dB of sound pressure with a 4 kHz square wave.  This speaker is ideal for implementing alarm and siren type of noises.

<source lang=bash>
amixer sset 'PCM' 100%
amixer sset 'Headphone' 100%

# This will produce a 1 second 4 kHz beep from the speaker at full volume.
timeout 1s speaker-test -f 4000 --test=sine

# 2 kHz
timeout 1s speaker-test -f 2000 --test=sine
</source>

== COM Headers ==
The COM ports all use 0.1" pitch 2x5 headers.  You can use the RC-DB9 cable in the accessories section to bring this to a DB9 cable.

{|
| 
{|
| 
{| class=wikitable
|+ COM1 Header
|-
! Pin
! Description
|-
| 1
| [[#COM_Ports|COM1_485+ (/dev/ttyMAX1)]]
|-
| 2
| [[#COM_Ports|COM1_232_RXD (dev/ttyMAX2)]]
|-
| 3
| [[#COM_Ports|COM1_232_TXD (/dev/ttyMAX2)]]
|-
| 4
| NC
|-
| 5
| GND
|-
| 6
| [[#COM_Ports|COM1_485- (/dev/ttyMAX1)]]
|-
| 7
| [[##COM_Ports|COM1_232_RTS (/dev/ttyMAX2)]]
|-
| 8
| [[#COM_Ports|COM1_232_CTS (/dev/ttyMAX2)]]
|-
| 9
| NC
|-
| 10
| NC
|}
|- 
| 
{| class=wikitable
|+ COM2 Header
|-
! Pin
! Description
|-
| 1
| [[#COM_Ports|COM2_485+ (/dev/ttyMAX0)]]
|-
| 2
| [[#COM_Ports|COM2_232_RXD (/dev/ttymxc4)]]
|-
| 3
| [[#COM_Ports|COM2_232_TXD (/dev/ttymxc4)]]
|-
| 4
| [[#CAN|CAN_2_H (can0 interface)]]<ref name=permterm>This can bus includes 120ohm termination</ref>
|-
| 5
| GND
|-
| 6
| [[#COM_Ports|COM2_485-]]
|-
| 7
| NC
|-
| 8
| NC
|-
| 9
| [[#CAN|CAN_2_L (can0 interface)]] <ref name=permterm />
|-
| 10
| NC
|}
|-
|
{| class=wikitable
|+ COM3 Header
|-
! Pin
! Description
|-
| 1
| [[#COM_Ports|COM3_485+ (/dev/ttymxc3)]] <ref name=rs485>This uart must be set up before RS485 will work.  See the [[#COM Ports]] section for more information.</ref>
|-
| 2
| [[#COM_Ports|COM3_232_RXD (/dev/ttymxc2)]]
|-
| 3
| [[#COM_Ports|COM3_232_TXD (/dev/ttymxc2)]]
|-
| 4
| [[#CAN|CAN_3_H (can1 interface)]] <ref name=optterm>Has optional termination 120ohm termination if DIO header pins 21/22 are shorted.</ref>
|-
| 5
| GND
|-
| 6
| [[#COM_Ports|COM3_485- (/dev/ttymxc3)]] <ref name=rs485 />
|-
| 7
| NC
|-
| 8
| NC
|-
| 9
| [[#CAN|CAN_3_L (can1 interface)]] <ref name=optterm />
|-
| 10
| NC
|}
|-
|}
| [[File:TS-7990-COM.png|300px]]
|}

<References />

== Mini PCIe ==
The Mini PCIe socket provides USB, mSATA, and a PCIe lane.  The TS-TPC-7990 can support a SIM card socket connected to the Mini PCIe interface, but it is not populated by default. [https://www.embeddedarm.com/support/ Contact us for more information on supporting this header].

== Power Connector ==
The TS-TPC-7990 includes a removable terminal block (Eurocomp ETB205/3A) which accepts 8-36 V, or 5 V DC for the power input.  Only one power input may be connected at a time.  A typical power supply for this platform should provide 25 W; see the [[#Power Consumption|power consumption]] section for more information on power requirements based on specific CPU and peripheral configurations.

{| class=wikitable
|-
| Pin
| Description
|-
| 1 <ref> Near 8-36 V label</ref>
| 8-36 VDC
|-
| 2
| 5 VDC
|-
| 3
| GND
|}

<References />

[[File:TS-TPC-7990 removable power connector.png|500px]]

{{Warning|Connecting both 8-36 V and 5 V inputs can damage the device and power sources.}}

== DIO Header ==
The DIO header includes [[#I2C|I2C]], [[#SPI|SPI]], [[#GPIO|GPIO]], and [[#Jumpers|jumpers]]. The [[#TS-DC799-SILO|TS-DC799-SILO daughter card]] is also supported on this header.  If pin 7 is held low at the start of U-Boot then all of the DIO will be used for managing the TS-DC799-SILO daughter card. However, after the unit is started up and the pins configured, any of the DIO pins can be used as normal GPIO.

{|
| 
{| class=wikitable
|-
! Pin
! Description
|-
| 1
| [[#I2C|DC_I2C_DAT]] (/dev/i2c-1)
|-
| 2
| VIN
|-
| 3
| [[#I2C|DC_I2C_CLK]] (/dev/i2c-1)
|-
| 4
| VIN
|-
| 5
| [[#TS-Silo|SUP_CAP_ANALOG]]
|-
| 6
| SW_5V <ref> This 5 V rail is switched on/off with power. </ref>
|-
| 7
| GPIO 244 [[#FPGA GPIO Table|(FPGA DIO_1_SEL0)]] <ref>If this pin is low on u-boot's startup, u-boot will assume the TS-SILO daughtercard is present and this may prevent boot.</ref>
|-
| 8
| 3.3V rail
|-
| 9
| GPIO 245 [[#FPGA GPIO Table|(FPGA DIO_2_SEL1)]]
|-
| 10
| GPIO 247 [[#FPGA GPIO Table|(FPGA DIO_4_PWM)]]
|-
| 11
| GPIO 246 [[#FPGA GPIO Table|(FPGA DIO_3_SEL2)]]
|-
| 12
| GPIO 248 [[#FPGA GPIO Table|(FPGA DIO_5_SILAB_DATA)]]
|-
| 13
| [[#SPI|DC_SPI_MISO]]
|-
| 14
| GPIO 249 [[#FPGA GPIO Table|(FPGA DIO_6_POWER_FAIL)]]
|-
| 15
| [[#TS-Silo|SUP_CAP_4.6V]]
|-
| 16
| GPIO 250 [[#FPGA GPIO Table|(FPGA DIO_7)]]<ref>This pin defaults to an RTS signal.  To use this as DIO run: <source lang=bash>DIO_7=GPIO tshwctl --set</source></ref>
|-
| 17
| [[#SPI|DC_SPI_MOSI]]
|-
| 18
| [[#USB|USB_OTG_M]]
|-
| 19
| [[#SPI|DC_SPI_CLK]]
|-
| 20
| [[#USB|USB_OTG_P]]
|-
| 21
| CAN_3_L <ref>It is not recommended to use this pin as a CAN signal, this is meant to optionally be connected to the CAN termination resistor via a [[#Jumper|jumper]].</ref>
|-
| 22
| [[#Jumpers|CAN_TERM_3]]
|-
| 23
| [[#Jumpers|JP_OPTION#]] <ref>If this pin reads low on startup it will stop in U-Boot.  After the initial read this pin can be reused as a GPIO. </ref>, GPIO 231 [[#FPGA GPIO Table|(FPGA DIO_9)]], DC_SPI_CS#
|-
| 24
| Ground
|-
| 25
| [[#Jumpers|JP_SDBOOT]] <ref>This pin is latched on startup and sets the "jpsdboot" value.  This decides if the default scripts boot to SD or eMMC. </ref>, GPIO 230 [[#FPGA GPIO Table|(FPGA DIO_8)]]
|-
| 26
| Ground
|}
| 
[[File:TS-7990-DIO.png|300px]]
|}

<References />

== XBee Header ==
For using this header to connect a standard XBee peripheral, contact us [https://support.embeddedarm.com/support/tickets/new here]; by default the TS-TPC-7990 only supports Nimblelink radios on this header.

Some basic commands to manipulate pins on this interface:
<source lang=bash>
# Enable 3.3V to XBee header:
tshwctl --addr 58 --poke 0x2

# Take XBee out of reset:
eval $(tshwctl --addr 59 --peek)
tshwctl --addr 59 --poke $(($addr59 | 0x20))
</source>

The Nimbelink modem can use the USB on this header, but still needs power enabled:
<source lang=bash>
# Enable 4 V to Nimbelink
tshwctl --addr 58 --poke 0x3

# The Nimbelink needs to be taken out of reset after being turned on:
eval $(tshwctl --addr 59 --peek)
tshwctl --addr 59 --poke $(($addr59 | 0x20))
# The nimblelink can take ~ 10-15 seconds to show up on USB.
</source>

{|
| 
{| class=wikitable
|-
! Pin
! Description
|-
| 1
| VIN (3.3V or 4V based on [[#FPGA|FPGA reg 58]])
|-
| 2
| XBEE_RXD
|-
| 3
| XBEE_TXD
|-
| 4
| GND
|-
| 5
| Not connected
|-
| 6
| VIN
|-
| 7
| USB_DN4_P
|-
| 8
| USB_DN4_M
|-
| 9
| GND (DTR)
|-
| 10
| GND
|-
| 11
| GND
|-
| 12
| (CTS) Not connected
|-
| 13
| Not connected
|-
| 14
| 3.3V (VREF)
|-
| 15
| GND
|-
| 16
| GND (RTS)
|-
| 17
| Not connected
|-
| 18
| Not connected
|-
| 19
| Not connected
|-
| 20
| GND (POWER_ON)
|}
| 
[[File:TS-7990-XBEEHeader.png|300px]]
|}

== USB Ports ==
The TS-TPC-7990 includes 2 standard type 'A' USB ports on J8.  Two more ports are avaialble on other interfaces such as the Mini PCIe header, and the XBee header for supporting NimbleLink cell modems.

= Peripherals =
== TS-DC799-SILO ==
[[File:TS-7990_DC799-SILO.jpg|500px|right|TS-DC799-SILO]]
The TS-TPC-7990 supports [https://www.embeddedarm.com/about/resource/unveiling-the-ts-silo-super-capacitor-technology TS-SILO] via the TS-DC799-SILO daughter card. TS-SILO technology is a UPS-like system that uses supercapacitors to deliver up to 100 seconds of backup power.  Providing protection against short power glitches as well as backup power to perform a safe shutdown in the event of a long power loss. A safe shutdown is critical in applications using writable storage media in order to prevent filesystem damage.

A boot cycle with the TS-DC799-SILO daughter card will typically go through these steps:
* The TS-TPC-7990 will detect the TS-DC799-SILO daughter card on startup and enable charging the supercapacitors.
* U-Boot will load the kernel, device tree, and optionally the FPGA.
* U-Boot will then wait until the supercapacitors are charged to a configurable percentage level.
* Once the supercapacitors are charged and VIN is still valid, U-Boot will then begin booting the kernel.
* In Linux, a daemon monitors a GPIO pin to detect power failure. If a power failure occurs, the daemon will monitor the charge of the supercapacitors.
* If the supercapacitor charge falls below a specific threshold, the daemon will start a safe reboot of the TS-TPC-7990.
* The unit will reboot to U-Boot and wait as it did above.
** If power does not return, the supervisory microcontroller will remove power from the i.MX6 and slowly allow the caps to fully drain.
** If power does return, then the caps will be recharged and the unit will boot up again as normal.

If the "No Charge" [[#Jumpers|jumper]] is set, then U-Boot will not attempt to charge the supercapacitors and will begin booting the kernel as soon as possible. This is beneficial for development and testing without having to wait for the supercapacitors to charge.

On startup, U-Boot evaluates pin 7 on the [[#DIO_Header|DIO header]]. If this pin is low (logic 0) then U-Boot will assume the presence of the TS-DC799-SILO daughter card. Pins 9, 10, 11, and 14 will then also be configured to communicate with the charging circuit on the daughter card.

The percentage of charge that U-Boot will stall booting for is set via the [[#U-Boot_Environment|environment variable]] "silochargpct". The percentage is a linear representation of the charge voltage from 0 to 12 VDC. The default we specify is 90% and can be changed with the following commands in U-Boot:
<source lang=bash>
env set silochargpct 80
env save
</source>

The value chosen should be a high enough charge to support power being removed immediately after the kernel begins booting. That is, a high enough charge to fully boot the system and fully reboot all on the supercapacitor support. If the charge is too low and backup power fails before a safe reboot occurs then it is possible for filesystem corruption to occur.

The supercapacitors will charge up to 12 VDC total and are able to sustain the TS-TPC-7990 as long as their voltage remains above 6 VDC. A full charge when completely drained will take approximately 2 minutes. Fully charging the supercapacitors from a partial charge, 6 VDC, will take approximately 1 minute.
{|
| [[File:TS7990ChargingGraph.jpg|400px|Charging Graph]]
|}

The supercapacitors discharge rate will vary depending on [[#Power Consumption|power consumption]] of the whole platform.  The graph below shows a fast charge of a loaded CPU and GPU on the TS-TPC-7990-QMW3E quad core with the PCAP display.  The slow discharge shows a TS-TPC-7990-SMN2E solo with the resistive which is using the powersaving CPU governor, LCD off, and an idle CPU.
{|
| [[File:TS7990DischargeGraph.jpg|400px|Discharge Graph]]
|}

Once booted to Linux, the [https://github.com/embeddedarm/ts4900-utils/blob/master/script/tssilomon tssilomon] service is started.  This script monitors for input power failure. If a power failure is detected, the daemon will sample the charge level of the supercapacitors. If the charge level falls below 90% then a reboot is initiated. The supercapacitors can provide roughly 35 to 85 seconds of backup power to the TS-TPC-7990 when at a 90% charge level.

U-Boot the next boot until the supercapacitors have finished charging again, or the power runs out and the power rails collapse.  The on-board supervisory microcontroller will power down the main power rails and ARM CPU so all power and signals available on headers will collapse cleanly rather than fluctuating.

== TS-DC799-POE ==
This daughter card provides PoE+ support for the TS-TPC-7990.  This allows the whole platform to be fully powered via PoE+ on J1, the Ethernet connector near the RTC battery and Mini PCIe connector.  
{|
| https://cdn.embeddedarm.com/media/part-images/929/conversions/ts-dc799-poe-a1-thumb.jpg
|}
This daughter card can be detected by the POE_DETECT# signal which can be read on the EIM_DA11 [[#GPIO|GPIO]].

= Specifications =
{{:TS-TPC-7990_Specifications}}

= Revisions and Changes =
== TS-TPC-7990 PCB Revisions ==
{{:TS-TPC-7990 PCB Changelog}}

== U-Boot Changelog ==
{{:TS-TPC-7990 U-boot changelog}}

== FPGA Changelog ==
{{:TS-TPC-7990 FPGA Changelog}}

== Microcontroller Changelog ==
{{:TS-7990 Silabs Changelog}}

== Software Images ==
=== Yocto Changelog ===
{{:TS-4900 Yocto Changelog}}

=== Debian Changelog ===
{{:TS-4900 Debian Changelog}}

=== Arch Linux Changelog ===
{{:TS-4900 Arch Linux Changelog}}

=== Ubuntu Linux Changelog ===
{{:TS-4900 Ubuntu Linux Changelog}}

== Product Change Notices ==
=== SPI Flash Vendor Change ===
{{:imx6-newuboot SPI flash change}}

=== New eMMC chip ===
{{:imx6 new emmc}}

= Product Notes =
== FCC Advisory ==
{{:FCC Advisory Statement}}

== Limited Warranty ==
{{:Limited Warranty}}