Jetson TX1 Developer Kit User Guide October 2015 Notice ALL NVIDIA DESIGN SPECIFICATIONS, REFERENCE BOARDS, FILES, DRAWINGS, DIAGNOSTICS, LISTS, AND OTHER DOCUMENTS (TOGETHER AND SEPARATELY, "MATERIALS") ARE BEING PROVIDED "AS IS." NVIDIA MAKES NO WARRANTIES, EXPRESS, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO THE MATERIALS, AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OR CONDITION OF TITLE, MERCHANTABILITY, SATISFACTORY QUALITY, FITNESS FOR A PARTICULAR PURPOSE AND ON-INFRINGEMENT, ARE HEREBY EXCLUDED TO THE MAXIMUM EXTENT PERMITTED BY LAW. Information furnished is believed to be accurate and reliable. However, NVIDIA Corporation assumes no responsibility for the consequences of use of such information or for any infringement of patents or other rights of third parties that may result from its use. No license is granted by implication or otherwise under any patent or patent rights of NVIDIA Corporation. Specifications mentioned in this publication are subject to change without notice. This publication supersedes and replaces all information previously supplied. NVIDIA Corporation products are not authorized for use as critical components in life support devices or systems without express written approval of NVIDIA Corporation. Trademarks NVIDIA, the NVIDIA logo and Tegra are trademarks or registered trademarks of NVIDIA Corporation in the United States and other countries. Other company and product names may be trademarks of the respective companies with which they are associated. Copyright 2014 NVIDIA Corporation. All rights reserved. NVIDIA Corporation | 2701 San Tomas Expressway | Santa Clara, CA 95050 | +1 408 486-2000 | www.nvidia.com Jetson TX1 Developer Kit User Guide Contents Introduction ................................................................................................................ 3 Getting Started ......................................................................................................... 3 Assumptions ........................................................................................................... 3 Powering Up the Tegra Device .................................................................................... 3 Login Credentials .................................................................................................... 4 Force Recovery Mode................................................................................................ 4 To place system in Force USB Recovery Mode: ................................................................. 4 Flashing the Boot Loader and Kernel ................................................................................ 5 Flash Procedure ...................................................................................................... 5 Flash Script Usage ................................................................................................... 6 JetPack ...................................................................................................................... 8 Before you Begin ........................................................................................................ 8 Installing JetPack TX1 ................................................................................................. 8 Run JetPack TX1 Samples ........................................................................................... 16 Compliance ............................................................................................................... 18 United States .......................................................................................................... 18 Canada .................................................................................................................. 19 European Union ....................................................................................................... 20 Australia and New Zealand.......................................................................................... 20 Japan ................................................................................................................... 21 South Korea ............................................................................................................ 21 Taiwan .................................................................................................................. 22 CHINA ................................................................................................................... 22 CMIT ID:XXXXXX ....................................................................................................... 22 ISRAEL .................................................................................................................. 22 Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 2 of 23 Introduction Jetson TX1 Developer Kit User Guide The NVIDIA Jetson TX1 Developer Kit is a full-featured development platform for visual computing. It is ideal for applications requiring high computational performance in a low power envelope. The Jetson TX1 Developer kit is designed to get you up and running quickly: It comes pre-flashed with a Linux environment, includes support for many common APIs, and is supported by NVIDIAs complete development tool chain. The board exposes many standard hardware interfaces, enabling a highly flexible and extensible platform. Go to http://developer.nvidia.com/embedded-computing for access to software updates and the developer SDK supporting the OS image and host development platform that you want to use. The SDK includes an OS image that you will load onto your device, developer tools, supporting documentation, and code samples to help you get started. Getting Started Individual development efforts will vary and may result in modifications to the system configuration. It is recommended that you begin with the basic system configuration (as shipped) to ensure proper system operation prior to any further development. Assumptions
> You have a Jetson TX1 Tegra Developer System, equipped with the NVIDIA Tegra TX1 processor.
> Your developer system should be cabled as follows:
Serial cable plugged into the serial port on the target connected to your Linux host directly or through a serial-to-USB converter. (To setup serial console on the Linux host.)
(Not included in the developer kit) To connect USB peripherals such as keyboard, mouse, and
[optional] USB/Ethernet adapter (for network connection), a USB hub should be connected to the working USB port on the Jetson TX1 system. An HDMI cable plugged into the target which is connected to an external HDMI display. An Ethernet cable plugged into the on board Ethernet port. Powering Up the Tegra Device 1. Connect a USB keyboard to the USB Type A connector of your device. 2. Connect an HDMI-compatible display to the HDMI connector on your device. 3. Connect the AC adapter supplied in your kit to the power connector of your device. Use the supplied AC adapter since it is appropriately rated for your kit. 4. Plug the power adapter into an appropriately rated electrical outlet. 5. They system should power on. If not, press and release the power button on the device. Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 3 of 23 Jetson TX1 Developer Kit User Guide Login Credentials
> Username: ubuntu
> Password: ubuntu Force Recovery Mode To update your system, you will need to be in Force USB Recovery Mode so you can transfer system software to the developer board. When in Force USB Recovery Mode, you are able to update system software and write the boot loader, boot configuration table (BCT), and partition configuration to the Tegra device. See the Developer SDK documentation for OS specific instructions when updating system software on your developer board. To place system in Force USB Recovery Mode:
1. Power down the device. If connected, remove the AC adapter from the device. The device MUST be powered OFF, not in a suspend or sleep state. 2. Connect the Micro-B plug on the USB cable to the Recovery (USB Micro-B) Port on the device [4] and the other end to an available USB port on the host PC. 3. Connect the power adapter to the device. 4. With the system powered on, press and release the POWER button, if necessary; press and hold the RECOVERY FORCE button; while depressing the RECOVERY FORCE button, press and release the RESET button; wait two seconds and release the RECOVERY FORCE button. Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 4 of 23 Jetson TX1 Developer Kit User Guide Flashing the Boot Loader and Kernel This section describes the steps required to flash and boot the target Tegra device. It also provides usage information for the flash.sh helper script. Flash Procedure First, flash the board with the boot loader and kernel, and, optionally, flash the rootfs to internal eMMC. Prerequisites The following directories must be present:
/bootloaderboot loader plus flashing tools (NvFlash, CFG, BCTs, etc.)
/kernela kernel zImage /vmlinux.uimg, DTB files, and kernel modules
/rootfsthe root file system that you download (This directory starts empty and you populate it with the sample file system.)
/nv_tegraNVIDIA Tegra user space binaries and sample applications You must also have the USB cable connected to the recovery port prior to running the commands listed in the procedure. For more information, see the Requirements topic in this section. To flash the boot loader and kernel 1. Put the target board into reset/recovery mode. Do so by first powering on the board and then holding the recovery button, and then pressing the reset button as described in the Quick Start Guide for the board. 2. Run the flash.sh script that is in the top level directory of this release. The script must be supplied with the target board (jetson-tx1) for the root file system:
$ sudo ./flash.sh <platform> <rootdev>
If the root file system will be on a USB disk, execute the script as follows:
$ sudo ./flash.sh <platform> sda1 Note: If a SATA device is connected, that device enumerates as sda1. If the root file system will be on an SD card, execute the script as follows:
$ sudo ./flash.sh <platform> mmcblk1p1 If the root file system will be on the internal eMMC, execute the script as follows:
$ sudo ./flash.sh <platform> mmcblk0p1 Where <platform> is jetson-tx1. The above examples are for u-boot. For fastboot, add the following argument:
Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 5 of 23 Jetson TX1 Developer Kit User Guide
-L <PATH_TO_FASTBOOT_BIN_FILE>
For example:
$ sudo ./flash.sh L bootloader/<platform>/fastboot.bin <platform>
<rootdev>
The boot loader and kernel will load. For more information on U-Boot, see the U-Boot Guide chapter of this document. Flash Script Usage You can find the most up-to-date usage information by running flash.sh h (using the flash.sh script included in the release). The basic usage information is as follows. Usage sudo ./flash.sh [options] <platform> <rootdev>
Where you specify the required parameters and one or more of the options shown in the following table. Parameters
<platform>
<rootdev>
Description Is jetson-tx1. Is one of following:
mmcblk0p1 Specifies internal eMMC. mmcblk1p1 Specifies external SDCARD. sda1 Specifies external USB device (such as, USB memory stick or HDD). Specifies nfsroot via external USB Ethernet interface. eth0 Description Specifies to print this usage information. Specifies the NvFlash Boot Configuration Table (BCT) file. Specifies the NvFlash configuration file. Optionally specifies a device tree file to use instead of the default. Options
-h
-b <bctfile>
-c <cfgfile>
-d <dtbfile>
-e <emmc_file> Specifies the eMMC size of the target device.
-f <flashapp>
-i
-k <partition id>
-n <nfs args>
Specifies the path to flash application: nvflash or tegra-rcm. Specifies to pass the user kernel command line to the kernel as-is. Specifies the kernel partition ID to be updated (minimum = 5). Specifies the static NFS network assignments:
<Client IP>:<Server IP>:<Gateway IP>:<Netmask>
Specifies the ODM data value. Total eMMC HW boot partition size. Specifies to skip building and reuse existing system.img.
-o <odmdata>
-p
-r Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 6 of 23 Jetson TX1 Developer Kit User Guide
-s
<ubootscript>
-C <cmdline>
-F <flasher>
-I <initrd>
-K <kernel>
-L
<bootloader>
-P
<end_of_PPT_p lus_1>
-R <rootfs dir>
-N <nfsroot>
-S <size>
-T <ITS file>
Specifies the boot script file for U-Boot. Specifies the kernel command line. Warning: Each option in this kernel command-line gets higher precedence over the same option from fastboot. In case of NFS booting, this script adds NFS booting related arguments if the -i option is omitted. Specifies the flash server, such as fastboot.bin. Specifies initrd file. Null initrd is the default. Specifies the kernel image, such as zImage. Specifies the full path to the boot loader, such as fastboot.bin or u-boot.bin. Specifies the sum of the primary GPT start address, the size of PPT, plus 1. Specifies the sample rootfs directory. Specifies the nfsroot, for example:
<my IP addr>:/my/exported/nfs/rootfs Specifies the rootfs size in bytes. This is valid only for internal rootdev. KiB, MiB, GiB style shorthand is allowed. For example, 1GiB signifies 1024 * 1024 * 1024 bytes. ITS file name. Valid only for u-boot. Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 7 of 23 JetPack Jetson TX1 Developer Kit User Guide This section is intended to help you get familiar with installing Jetson TX1 Developer Pack (JetPack TX1), using the tools and running sample code. Before you Begin
> You have a Jetson TX1 Tegra Developer Kit equipped with the NVIDIA Tegra TX1 processor.
> You have a host machine that is running Linux.
> Your developer system is cabled as follows:
Serial cable plugged into the serial port J1A2 UART4 on the target connected to your Linux host directly or through a serial-to-USB converter. (To setup serial console on the Linux host.) USB Micro-B cable connecting Jetson TX1 (J1E1 USB0) to your Linux host for flashing.
(Not included in the developer kit) To connect USB peripherals such as keyboard, mouse, and
[optional] USB/Ethernet adapter (for network connection), a USB hub should be connected to the working USB port (J1C2 USB2) on the Jetson TX1 system. An HDMI cable plugged into "J1C1 HDMI1" on the target which is connected to an external HDMI display. An Ethernet cable plugged into the J1D1 on board Ethernet port.
> Download latest JetPack TX1 The latest version of Jetson TX1 Development Pack (JetPack TX1) is available at NVIDIA Developer. All available JetPack TX1 downloads here. Installing JetPack TX1 Assumes you downloaded the latest JetPack TX1 version, jetpack-${VERSION}.run. ${VERSION}
refers to the version string for the installer you got. 1. Add execute permissions for the jetpack-${VERSION}.run chmod +x jetpack-${VERSION}.run Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 8 of 23 Jetson TX1 Developer Kit User Guide 2. Run the jetpack-${VERSION}.run by double-clicking on it in the file browser. 3. Accept the license agreement to continue Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 9 of 23 Jetson TX1 Developer Kit User Guide 4. Enter or navigate to desired installation directory. 5. Select installation type. Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 10 of 23 Jetson TX1 Developer Kit User Guide 6. Select components to install. 7. Review Setup and click the Next button proceed with setup or click Back button to return to the Select Components screen. Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 11 of 23 Jetson TX1 Developer Kit User Guide 8. Click next and follow instructions on popup window to put device into recovery mode, then begin flashing device. Sample output when flashing OS on Jetson. Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 12 of 23 Jetson TX1 Developer Kit User Guide 9. After successfully flashing device, enter your device information in the dialog that comes up. 10. After installing CUDA on the device, the installer will compile CUDA and GameWorks OpenGL samples. You can choose whether to deploy the compiled binaries to device. Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 13 of 23 Jetson TX1 Developer Kit User Guide Sample output when compiling CUDA samples. 11. Copy CUDA samples to device. Run matrixMul sample remotely on device. Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 14 of 23 Compiling Jetson TX1 Developer Kit User Guide JetPack TX1 automatically compiles all samples if Compile Samples was checked during components selection. If you selected CUDA components, CUDA samples will be found in the following directory:
<JetPack_Install_Dir>/NVIDIA_CUDA-<version>_Samples directory. You could recompile the samples by running:
OPENMPDIR=/usr/arm-linux-gnueabihf/lib EXTRA_LDFLAGS=--unresolved-
symbols=ignore-in-shared-libs ARMv7=1 GCC=arm-linux-gnueabihf-g++ make If you selected GameWorks OpenGL samples, GameWorks OpenGL samples will be available in the following directory:
< JetPack_Install_Dir >/GameWorksOpenGLSamples You could cross compile them by running the make command under the samples/build/linux-
arm32 subfolder. Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 15 of 23 Jetson TX1 Developer Kit User Guide Run JetPack TX1 Samples The CUDA samples directory is copied to home directory on the device by JetPack TX1. The built binaries can be found in the following directory:
/home/ubuntu/NVIDIA_CUDA-6.5_Samples/bin/armv7l/linux/release/gnueabihf/
Run them by calling them in terminal or double clicking on them in the file browser. For example, when you run the oceanFFT sample, the following screen will be displayed. Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 16 of 23 Jetson TX1 Developer Kit User Guide GameWorks OpenGL samples will be copied to home directory on device. The built binaries can be found in the following directory:
/home/ubuntu/GameWorksOpenGLSamples/samples/bin/linux-arm32 Run them by calling them in terminal or double clicking on them in the file browser. For example, when you run FeedbackParticlesApp, you will see smoke particles rising. Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 17 of 23 Compliance Jetson TX1 Developer Kit User Guide The NVIDIA Jetson TX1 Developer Kit is compliant with the regulations listed in this section. Compliance marks, including the FCC and IC ID numbers, can be found http://developer.nvidia.com/embedded-
computing United States Federal Communications Commission (FCC) FCC ID: VOB-P2180 This device complies with part 15 of the FCC Rules. 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 any interference that may cause undesired operation of the device. This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures:
Reorient or relocate the receiving antenna. Connect the equipment into an outlet on a circuit different from that to which the receiver is Increase the separation between the equipment and receiver. connected. Consult the dealer or an experienced radio/TV technician for help. FCC Warning: The FCC requires that you be notified that any changes or modifications to this device not expressly approved by the manufacturer could void the users authority to operate the equipment. RF Radiation Exposure Statement This equipment complies with FCC RF radiation exposure limits set forth for an uncontrolled environment. This equipment should be installed and operated with a minimum distance of 20 centimeters between the radiator and your body. Only those antennas with same type and lesser/equal gain filed under this FCC ID number can be used with this device. Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 18 of 23 Jetson TX1 Developer Kit User Guide Underwriters Laboratories (UL) I.T.E E204896 Canada Industry Canada (IC) IC: 7361A-P2180 CAN ICES-3(B)/NMB-3(B) This device complies with Industry Canadas licence-exempt RSSs of the Industry Canada Rules. Operation is subject to the following two conditions: (1) this device may not cause interference, and (2) this device must accept any interference, including interference that may cause undesired operation of the device. 51505250 MHz is only for indoor use to reduce the potential for harmful interference to co-channel mobile satellite systems;
Ce dispositif est conforme la norme RSS-247 d'Industrie Canada applicable aux appareils radio exempts de licence. Son fonctionnement est sujet aux deux conditions suivantes: (1) le dispositif ne doit pas produire de brouillage prjudiciable, et (2) ce dispositif doit accepter tout brouillage reu, y compris un brouillage susceptible de provoquer un fonctionnement indsirable. RF Radiation Exposure Statement:
Jetson Dev Kit has been tested and complies with IC RSS 102 RF radiation exposure limits set forth for an uncontrolled environment when used with the NVIDIA accessories supplied or designated for this product. To satisfy IC exposure requirements, a separation distance of at least 20 cm must be maintained between the antenna of this device and persons during device operation.. The use of any other accessories may not ensure compliance with IC RSS 102RF exposure guidelines. Dclaration d'exposition aux radiations:
La Jetson Dev Kit a ete testee conformemment aux normes dexposition demission RF de la IC RSS 102 pour un environement non controle lors dutilisation avec les accessoires fournis or recommendes par NVIDIA. Pour satisfaire aux exigences d'exposition IC, une distance de sparation d'au moins 20 cm doit tre maintenue entre l'antenne de cet appareil et des personnes pendant le fonctionnement de l'appareil. Lutilisation daccessoires autres que ceux recommendes par NVIDIA ne guarantis pas la compatibilite avec les normes demission RF de la IC RSS 102. Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 19 of 23 Jetson TX1 Developer Kit User Guide European Union European Conformity; Conformit Europenne (CE) This device bears the CE mark and class-2 identifier in accordance with Directive 1999/5/EC This device complies with the following Directives:
R&TTE Directive for radio equipment Low Voltage Directive for electrical safety RoHS Directive for hazardous substances A copy of the Declaration of Conformity to the essential requirements may be obtained directly from NVIDIA GmbH (Floessergasse 2, 81369 Munich, Germany). Australia and New Zealand Australian Communications and Media Authority (RCM) This product meets the applicable EMC requirements for Class B, I.T.E equipment and applicable radio equipment requirements Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 20 of 23 Jetson TX1 Developer Kit User Guide Japan Voluntary Control Council for Interference (VCCI) Radio/ Telecommunications Certification W52/W53 are indoor use only South Korea Radio Research Agency (RRA) Korean Agency for Technology and Standards (KATS) MSIP-RMM-NVA-P2180 MSIP-CMM-NVA-P2597 B
(B )
( )
,
. Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 21 of 23 Jetson TX1 Developer Kit User Guide Taiwan National Communications Commission CCXXxxYYyyyZzW 5.600-5.650 GHz CHINA CMIT ID:XXXXXX CMIIT ID: XXXXYYZZZ ISRAEL Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 22 of 23 Jetson TX1 Developer Kit User Guide 2015 NVIDIA Corporation. All rights reserved. NVIDIA, the NVIDIA logo, and JETSON DEV KIT are trademarks and/or registered trademarks of NVIDIA Corporation in the U.S. and other countries. Other company and product names may be trademarks of the respective companies with which they are associated. Jetson | DA-07498-001v01 | Copyright 2014 NVIDIA Corporation. All rights reserved. Page 23 of 23