View source for TS-7180

{{Warning|This product is about to enter the Engineering Sampling program.  This means the documentation and product itself may change several times before the product is deemed ready for large quantity orders.  Please force-refresh (shift-f5 on most browsers) to clear your cache when visiting this page to ensure you are viewing the most recent version of this documentation.  Of course also please check back often as this information is subject to change.}}

{{Infobox
|title        = TS-7180
|image        = https://www.embeddedarm.com/images/boards/medium/ts-7180.gif
|titlestyle   =  
|headerstyle  = background:#ccf;
|labelstyle   = width:33%
|datastyle    = 
|data1        = [http://www.embeddedarm.com/products/board-detail.php?product=TS-7180 Product Page]
|data2        = [https://www.embeddedarm.com/product-images/TS-7180 Product Images]
|data3        = [https://www.embeddedarm.com/products/TS-7180?tab=specs Specifications]
|header4      = Documentation
|data5        = [http://www.embeddedarm.com/documentation/ts-7180-schematic.pdf Schematic]
|data7        = [http://www.embeddedarm.com/documentation/ts-7180-mechanical.pdf Mechanical Drawing]
|data8        = [ftp://ftp.embeddedarm.com/ts-arm-sbc/ts-7180-linux/ FTP Path]
|header9      = Processor
|data10       = Freescale i.MX6ul 696MHz
|data11       = [http://www.nxp.com/products/microcontrollers-and-processors/arm-processors/i.mx-applications-processors/i.mx-6-processors/i.mx6qp/i.mx-6ultralite-processor-low-power-secure-arm-cortex-a7-core:i.MX6UL? i.MX6ul Product Page]
|data12       = [http://www.nxp.com/products/microcontrollers-and-processors/arm-processors/i.mx-applications-processors/i.mx-6-processors/i.mx6qp/i.mx-6ultralite-processor-low-power-secure-arm-cortex-a7-core:i.MX6UL?fpsp=1&tab=Documentation_Tab# CPU Documentation]
}}

= Overview =
The TS-7180 is an SBC designed for low power systems and is ideal for remote deployment and fleet tracking.

= 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 device.}}

Get console input by plugging a USB type B cable into P4.  Connect the host side to a workstation for development.  Console can be viewed before or after power is applied.  Boot messages will only be printed once the device is powered on.


The cp210x (USB Serial) driver is included in most popular distributions.  This will show up as /dev/ttyUSB0.  For other operating systems:
* [http://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx 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 linux client to use which can be run with the following command:
<source lang=bash>
sudo picocom -b 115200 /dev/ttyUSB0
</source>

This will output some serial setting information and then "Terminal ready".  Any messages after this point will be from the device via the serial output.  The terminal is now ready and power can be applied in order to boot up the device.  Power is applied through the power connector, CN7.  This accepts an 8-28 VDC input.

Once power is applied, the device will output information via the console.  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 2016.03-14506-gfee2f5b (Jan 13 2017 - 12:29:29 -0700)                    
                                                                                
CPU:   Freescale i.MX6UL rev1.1 at 396 MHz                                      
Reset cause: POR                                                                
Board: Technologic Systems TS-7180                                              
FPGA:  Rev 0                                                                    
I2C:   ready                                                                    
DRAM:  512 MiB                                                                  
MMC:   FSL_SDHC: 0, FSL_SDHC: 1                                                 
*** Warning - bad CRC, using default environment                                
                                                                                
Net:   FEC0 [PRIME]
Press Ctrl+C to abort autoboot in 1 second(s) 
</pre>

You may break into U-Boot at this point, by pressing Control+C at your terminal; otherwise, what U-Boot does next depends on the "U-Boot" jumper.  If installed, U-Boot will check for USB updates, and then drop to the U-Boot prompt.  If the U-Boot jumper is ''not'' installed, then the "SD Boot" jumper will be examined: when installed, it will cause U-Boot to boot to SD; otherwise, U-Boot will boot to eMMC.

[[File:20170224_140329.jpg|300px]]

{{Note|The "*** Warning - bad CRC, using default environment" can be safely ignored.   This indicates that u-boot scripts are not being customized.  Typing "env save" will hide these messages, but this is not essential.}}

{{:Console from Windows Workstation}}

= U-Boot =
{{:TS-7180 U-boot Sections}}

= Debian =
{{:TS-7180 Debian Sections}}

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

== eMMC ==
{{:TS-7180 eMMC Backup/restore}}

= Compile the Kernel =
{{:TS-7180 Kernel Compile Guide}}

= Features =
== ADC ==
{{:TS-7180 CPU ADC}}

== Bluetooth ==
{{:TS-7180 Bluetooth}}

== CAN ==
{{:TS-7180 CAN}}

== COM Ports ==
{{:TS-7180 COM Ports}}

== CPU ==
{{:TS-7180 CPU}}

== eMMC ==
{{:TS-7180 EMMC}}

== Ethernet Ports ==
{{:TS-7180 Ethernet}}

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

== FRAM ==
{{:TS-7180 FRAM}}

== GPIO ==
{{:TS-7180 DIO}}

== GPS ==
{{:TS-7180 GPS}}

== IMU ==
{{:TS-7180 IMU}}

== Interrupts ==
{{:TS-7180 interrupts}}

== Jumpers ==
The TS-7180 has a set of jumpers located near the SuperCaps on the edge of the SBC.  


[[File:20170224_140329.jpg|300px]]

These jumpers control a number of aspects of the TS-7180's behavior.  The jumpers are labeled on the silkscreen rather than numbered:

{|class="wikitable"
!Label
!Description
|-
| NO Charge
| When jumper is set, disable charging of the SuperCaps. Beneficial for early development and testing.
|-
| 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 CAN1 H and L pins. (Note: the CAN2 interface always has a 120 ohm termination)
|-
| 485
| When jumper is set, adds a 120 ohm termination resistor across RS-485 + and - pins.
|}

== LEDs ==
{{:TS-7180 LEDs}}

== MicroSD Card Interface ==
{{:TS-7180 MicroSD Card Interface}}

== PWM ==
{{:TS-7180 PWM}}

== Quadrature & Edge-Counters ==
{{:TS-7180 Quadrature}}

== RTC ==
{{:TS-7180 RTC}}

== SPI ==
{{:TS-7180 CPU SPI Controller}}

== SuperCaps ==

{{Note|This section is incomplete at this time.}}
The TS-7180 has an option to add two 2.7 V 10 F supercapacitors.  These two SuperCaps can provide up to 20 seconds of power hold time automatically if the external power input is removed.  The Power Fail input signal (see the [[#DIO|DIO Section]]) can be used to determine if the exterior power has been removed or fallen below a valid input level.  Using this signal, a proper shutdown can be issued to ensure that all data is flushed from cache to disk, and all disks are unmounted properly.

The SuperCaps charge and discharge is managed transparently by the supervisory microcontroller.  A [[#Jumpers|jumper]] is provided to disable the charging and use of the SuperCaps.  This mode is very useful for development to allow for proper power-off conditions without having to wait for the SuperCaps to discharge.  The supervisory microcontroller will also not allow the TS-7180 to boot if power input is invalid.  If the system shuts-down safely due to a power failure, it will remain in a powered off state until external power is re-applied, or the SuperCaps discharge below the sustainable threshold.

By default, a script is started with systemd to monitor the Power Fail pin, and present all logged in users with a message saying that the power has failed and a graceful shutdown is taking place if the power input has failed.  This script is located at /usr/local/bin/tssilomon

Additionally, U-Boot can delay booting until the SuperCaps are charged to a certain percentage, and optionally print the current percentage once per second.  These are controlled with the environment variables "chrg_pct" and "chrg_verb"  By setting chrg_pct to anything other than 0 (0 means do not wait, which is the default behavior), booting will be delayed until that percentage is reached.  Setting chrg_verb to 1 will enable the verbose printing of the current percentage every second.  Note that the SuperCaps may be at "0%" for a large period of time, this is due to the charge level being below a voltage that can sustain the TS-7180.  See the [[#U-Boot_Environment|U-Boot section]] for information on setting environment variables.

A recommended value is 100%.  This value was chosen because it can ensure the system is powered long enough to boot up and safely shut down (and provide an additional 8 s of power) if power is immediately cut once booting has started.  Please note that this only applies to the default stock image, any further changes to the TS-7180 hardware or software, such as connecting powered devices like USB or adding additional applications may cause the recommended value to not sustain the TS-7180 until a safe shutdown is completed.  The time it takes to reach 100% charge will vary depending on the current charge of the SuperCaps.  On average, it will take about 20 seconds to charge the SuperCaps to 100%; this is assuming the SuperCaps have very recently fallen below the threshold voltage to sustain the TS-7180.

== TWI ==
{{:TS-7180 TWI}}

== USB ==
The TS-7180 has both a Host connector and a Device connector.

[[File:TS-7180-USB-Connectors.png|300px]]
=== USB Host ===
{{:TS-7180 USB Host}}

=== USB DEVICE ===
{{:TS-7180 USB DEVICE}}

== Watchdog ==
{{:TS-7180 Watchdog}}

== WIFI ==
{{:TS-7180 WIFI}}


= Physical Interfaces =
== Internal Interfaces ==
=== HD1 ===

== External Interfaces ==
=== Power Connector ===
{{:TS-7180 Power Connector}}
=== Terminal Blocks ===
{{:TS-7180 Terminal Blocks}}

= Specifications =
== Power Consumption ==
All tests are performed at 12V, with Ethernet, USB, supercaps, SD, disconnected or disabled unless otherwise specified.

{| class="wikitable sortable"
|+ TS-7180-SRW9I
! Test
! Average
! Max
|-
| Idle
| 49mA/0.59W
| 148mA/1.78W
|-
| Idle with one Ethernet connected
| 76mA/0.91W
| 139mA/1.67W
|-
| Idle with both Ethernets connected
| 105mA/1.20W
| 156mA/1.87W
|-
| Idle CPU booting with Supercaps Enabled
| 51.1mA/0.61W<ref>Draws near peak and approaches typical power consumption over a minute as caps charge.</ref>
| 531mA/6.37W
|-
| Busy CPU (openssl speed)
| 113mA/1.36W
| 156mA/1.87W
|-
| Sleep Mode
| 1.8mA/22mW
| 58mA/70mW
|}

<References />

= Revisions and Changes =
== TS-7180 PCB Revisions ==
{{:TS-7180 PCB Changelog}}

== U-Boot Changelog ==
{{:TS-7180 U-boot changelog}}

== FPGA Changelog ==
{{:TS-7180 FPGA Changelog}}

== Software Images ==
=== Debian Changelog ===
{{:TS-7180 Debian Changelog}}

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

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