KTT20/pITX KTD-S0045-D The pulse of innovation
User Information Table of Contents » Table of Contents « 1 User Information .............................................................................1 1.1 About This Document.................................................................................................... 1 1.2 Copyright Notice.......................................................................................................... 1 1.3 Trademarks...............................................................................
User Information Table of Contents 3.3.4 3.3.5 3.3.6 3.3.7 DisplayIDTM Windows® Tool ........................................................................................................ 14 Building DisplayIDTM File ........................................................................................................... 15 Erasing DisplayIDTM Record ........................................................................................................ 15 U-Boot EEPROM Update Tool ..................
User Information Table of Contents 11 Windows® Embedded Compact 7 (WEC7) BSP........................................ 44 11.1 U-Boot Settings..........................................................................................................44 11.1.1 11.1.2 Boot from microSD Card ............................................................................................................ 44 Boot from USB key .........................................................................................
KTD-S0045-D Page 1 1 User Information 1.1 About This Document User Information This document provides information about products from KONTRON Technology A/S and/or its subsidiaries. No warranty of suitability, purpose or fitness is implied. While every attempt has been made to ensure that the information in this document is accurate the information contained within is supplied “as-is” - no liability is taken for any inaccuracies. Manual is subject to change without prior notice.
KTD-S0045-D 1.6 Page 2 User Information Life Support Policy KONTRON Technology's products are not for use as critical components in life support devices or systems without express written approval of the general manager of KONTRON Technology A/S.
KTD-S0045-D 2 Page 3 U-Boot Setup U-Boot Setup The sense of a special Setup part is to avoid expendable changes in the proper operating systems. The Setup entries are valid for all supported operating systems (e.g. Linux®, AndroidTM and Windows® Embedded Compact). For example if you switch from Linux® to AndroidTM or vice versa in the ideal case no changes will be necessary. The Setup data records are stored in a non-volatile memory (EEPROM) and not in an erasable script.
KTD-S0045-D 2.3 Page 4 U-Boot Setup Display Menu This menu part includes several display settings S define the first boot display S define the second boot display S determine a resolution for the lcd panel S define the backlight brightness S define the backlight output level 2.3.1 Boot Display The NVIDIA® Tegra 250 implies a Graphics Processing Unit (GPU) with two independent display controllers.
KTD-S0045-D 2.3.3 Page 5 U-Boot Setup Backlight Brightness This submenu allows the definition of the analog backlight brightness (voltage range: 0V to +5V). The input format is represented by a decimal number with maximal three digits. Examples: Brightness: 0 minimal value = 0V or Brightness: 128 half range = +2.5V or Brightness: 255 2.3.4 maximal value = +5V Backlight Output Level Some backlight inverters need a low level for the enable signal, other inverters a high level (normally +5V).
KTD-S0045-D 2.4.3 Page 6 U-Boot Setup GPIO Interface You can choose between three modes: all interface signals are defined as GPIOs (General Purpose Input Output) or some special signals have another function (I2CTM, SPITM respectively SDIO). For a detailed overview about these signals see the 'KTT20/pITX Users Guide' chapter 'Digital I/O Interface'. The signals are named GPIO16 to GPIO21 respectively GPIO23 to GPIO29, GPIO32 and GPIO36 to GPIO37.
KTD-S0045-D 2.5.5 Page 7 U-Boot Setup Temperature Low Limit The temperature low limit controls the alert output. Dependent on the extended temperature setting the limit can be down to -550C. The input format is represented by a decimal number with maximal three digits. Example: Temp low limit: 5 2.6 Password Command If you want to control the access to the Setup settings it is possible to use a password protection. Maximal eight alphanumeric chars, numbers or special characters are admissible.
KTD-S0045-D 2.9 Page 8 U-Boot Setup Summary Command This Setup command gives a quick overview about all actual settings. An additional feature is the bootcounter report.
KTD-S0045-D Page 9 3 VESA® DisplayIDTM 3.1 LCD/LVDS Technology Overview 3.1.1 Detailed Timing Descriptor VESA® DisplayIDTM The input fields Pixel Clock, Horizontal Active, Horizontal Blank, Horizontal Sync Offset, Horizontal Sync Width, Vertical Active, Vertical Blank, Vertical Sync Offset and Vertical Sync Width must be filled in with the correct values according to the panel’s data sheet. In many cases the value for Horizontal/Vertical Blank cannot be read directly from the data sheet.
KTD-S0045-D Page 10 VESA® DisplayIDTM Example 2 (not useable on KTT20/pITX): SHARP LQ190E1LW01 (double pixel clock) Data sheet specifications (no definition of Sync Offset Clock Frequency [typ.] 54 MHz Horizontal Period (1) [typ.] 844 Clocks Horizontal Display Period 640 Clocks Vertical Period [typ.
KTD-S0045-D 3.1.2 Page 11 VESA® DisplayIDTM 24 Bit Color Mapping Tips The double pixel clock or 24-bit color depth can generally be taken from the datasheet. There are two interface modes existing at 24-bit color depth: FPDI (Flat Panel Display Interface) or LDI (LVDS Display Interface). Some panels use the line SELL LVDS (SELect Lvds data order). The LVDS data assignment in the datasheet can give you an indication by the last channel (e.g.
KTD-S0045-D 3.2 Page 12 VESA® DisplayIDTM EDID 1.3 Specification (VESA®) The EDID (Extended Display Identification Data) record has a fixed structure. The first 8 bytes contain the distinctive identification 0x00, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x00. The end of the record is marked by the checksum (1 byte). The result of the addition of all bytes including the checksum has to be zero. For a comprehensive support of the majority of available panels you don't need all fields of the EDID record.
KTD-S0045-D 3.3.2 Page 13 VESA® DisplayIDTM DisplayIDTM Restrictions Depending on the graphic controller not all features can be used. The following table shows the most important restrictions. Restrictions for KTT20/pITX Panels with dual or quad clock not supported (2 or 4 Pixel per Clock) Variable power sequencing not supported 3.3.3 LCD Panel Selection The choice of a LCD display is basically defined by two parameters. Parameter Value Pixel per Clock (Channels) 1 Pixel Clock Range tdb.
KTD-S0045-D 3.3.4 Page 14 VESA® DisplayIDTM DisplayIDTM Windows® Tool The DisplayIDTM parameter can be modified with the DisplayIDTM Windows® tool. For an example the following picture shows the input fields for the Detailed Timing parameters. For more information see the documentation of the DisplayIDTM tool (software can be downloaded from kontron.com).
KTD-S0045-D Page 15 VESA® DisplayIDTM The DisplayIDTM Editor saves the parameters in a intermediate file format. The file extension is 'KDD' (Kontron DisplayIDTM Data). This file format cannot be used to program the onboard EEPROM. For transferring this file format into the binary file format for the EEPROM apply the Converter. Building DisplayIDTM File 3.3.5 3.3.6 Start the Windows® tool DisplayID.exe.
KTD-S0045-D Page 16 VESA® DisplayIDTM Serial Download The following example demonstrates a serial download via the ymodem protocol: The KTT20/pITX board is connected to a desktop computer with a suitable terminal program (e.g. HyperTerminal or TeraTerm). The file size of wvga.kdb amounts 81 bytes. For downloading the file into memory type the following standard U-Boot command line loady Now U-Boot waits for reply. User input to the desktop terminal program starts the download session.
KTD-S0045-D 4 Page 17 KTT20 Tool Package KTT20 Tool Package The KTT20 Tool Package contains all needed drivers and tools as described below. A short overview: ICreator ImageCreater program (Windows®) Convert.exe Console program (auxiliary program) ImageCreator.exe Main program README.txt Important additional information SPI.cfg Configuration file SPI_Flasher.bin Special U-Boot flash version NVFLASH_Linux SDRAM Executes U-Boot in SDRAM ktt20.
KTD-S0045-D Page 18 USB-Driver_Windows 32bit KTT20 Tool Package 32 bit Client Port Driver (CPD) NOTICE.txt Copyright information WdfCoInstaller01009.dll Driver file WinUSBCoInstaller2.dll Driver file WUDFUpdate_01009.dll Driver file 64bit 64 bit Client Port Driver (CPD) NOTICE.txt Copyright information WdfCoInstaller01009.dll Driver file WinUSBCoInstaller2.dll Driver file WUDFUpdate_01009.dll Driver file CPDWinUSB.
KTD-S0045-D 5 Page 19 Bootloader Modification and Download Bootloader Modification and Download If you want to create your own bootloader and load it into the SPITM flash device you must execute several steps or you use the KONTRON Windows® Image Creator. The KONTRON tool generates a special image file which can be downloaded with NVIDIAs® NVFLASH tool into the RAM. Thereafter one part of the image executes a script and program the bootloader into the SPITM flash device.
KTD-S0045-D Page 20 Bootloader Modification and Download CAUTION KONTRON does not repair a board free of charge if the SPITM flash respectively SDRAM parameters are changed. The third component implies your own bootloader. Maybe in the ASCII equivalent of the Binary Configuration Table the line labeled BootLoader must be changed.
KTD-S0045-D Page 21 Bootloader Modification and Download If the execution ends successfully the following screen appears The image file disposes of the following structure: 5.2 NVFLASH Download Tool NVIDIA® provides a special tool named NVFLASH to download a bootloader to the target platform. This tool is available for Windows® XP, Windows® 7 and Linux®. The Windows® operating system needs an additional USB client driver (also known as APX) however Linux® comes with a built-in APX driver. 5.2.
KTD-S0045-D Page 22 Bootloader Modification and Download Download the bootloader into SDRAM: S S If you want to develop your own U-Boot version use the command file from the directory 'SDRAM'. Copy your binary U-Boot file (default name: u-boot.bin), the file from the directory 'SDRAM' and all files from the NVFLASH root directory into the same directory. Execute the KTT20.bat file.
KTD-S0045-D S Page 23 Bootloader Modification and Download Execute the SPI.bat file. The following screen output must appear: Nvflash started rcm version 0X20001 System Information: chip name: t20 chip id: 0x20 major: 1 minor: 3 chip sku: 0x8 chip uid: ........ macrovision: disabled hdcp: enabled sbk burned: false dk burned: false boot device: spi operating mode: 3 device config strap: 0 device config fuse: 0 sdram config strap: 0 sending file: spi.bct 4080/4080 bytes sent spi.
KTD-S0045-D S Page 24 Bootloader Modification and Download Execute the 'ktt20.sh' file. The following screen output must appear: Nvflash started rcm version 0X20001 System Information: chip name: t20 chip id: 0x20 major: 1 minor: 3 chip sku: 0x8 chip uid: ........ macrovision: disabled hdcp: enabled sbk burned: false dk burned: false boot device: spi operating mode: 3 device config strap: 0 device config fuse: 0 sdram config strap: 0 sending file: KTT20.bct 4080/4080 bytes sent KTT20.
KTD-S0045-D S Page 25 Bootloader Modification and Download Execute the 'spi.sh' file. The following screen output must appear: Nvflash started rcm version 0X20001 System Information: chip name: t20 chip id: 0x20 major: 1 minor: 3 chip sku: 0x8 chip uid: ........ macrovision: disabled hdcp: enabled sbk burned: false dk burned: false boot device: spi operating mode: 3 device config strap: 0 device config fuse: 0 sdram config strap: 0 sending file: SPI.bct 4080/4080 bytes sent SPI.
KTD-S0045-D 6 Page 26 SMSC® USB Hub and LAN Controller SMSC® USB Hub and LAN Controller The SMSC® controller LAN9514 has its own configuration EEPROM. This allows the automatic loading of static configuration data after reset. The EEPROM opens the ability to disable the onchip LAN controller but this option leads to a non-programmable state. This setting makes it impossible to reprogram the EEPROM. It is strongly recommended that the EEPROM content remains unchanged.
KTD-S0045-D 8 Page 27 U-Boot Compilation U-Boot Compilation You can find a suitable compiler without major effort. One option is to use the LinaroTM ARM® compiler downloadable from the internet address http://www.linaro.org/ You need only four command lines to compile the U-Boot sourcecode.
KTD-S0045-D Page 28 U-Boot Compilation /* High-level configuration options */ #define TEGRA2_SYSMEM "mem=384M@0M nvmem=128M@384M mem=512M@512M" #define V_PROMPT "Tegra2 (Harmony) # " .............
KTD-S0045-D 8.1 Page 29 U-Boot Compilation Hardware Components Compatibility Between the KTT20/pITX and the 'Harmony' evaluation board there are following conformities/differences: Component KTT20/pITX vs. 'Harmony' Evalboard SDRAM Compatible NAND Compatible TM SPI Flash Compatible PMU Compatible LAN Compatible DVI ® DVI® vs.
KTD-S0045-D Page 30 U-Boot Compilation // gpio_request is a function from older U-Boot versions - possibly not necessary ret = gpio_request (GPIO_PD6, NULL); // define GPIO30 as GPIO, also labeled D.06 if (ret) { do something; // Error } gpio_direction_output (GPIO_PD6, 0); // Set GPIO as output with low level udelay (1000); // Wait 1 ms gpio_set_value (GPIO_PD6, 1); // Set high level 8.3 UART Declarations For an extensive usage of UARTs the module 'board.
KTD-S0045-D Page 31 U-Boot Compilation #ifdef CONFIG_BOARD_EARLY_INIT_F int board_early_init_f (void) { int uart_ids = 0; // bit mask of which UART ids to enable #ifdef CONFIG_TEGRA2_ENABLE_UARTA uart_ids |= UARTA; #endif #ifdef CONFIG_TEGRA2_ENABLE_UARTB uart_ids |= UARTB; #endif #ifdef CONFIG_TEGRA2_ENABLE_UARTC uart_ids |= UARTC; #endif ........... Add some entries to 'include/configs/harmony.h. For example: #define #define #define #define #define #define 8.
KTD-S0045-D Page 32 9 Linux® BSP 9.1 User Login Arguments Linux® BSP For both, serial remote system or normal display manager login, the arguments are the same. Serial remote system (necessary input with green color): ktt20 login: ktt20 Password: ktt20 Display manager login (necessary input with green color): Note: there is no 'root' password defined. If you need root privileges use 'sudo' and the user password. 9.
KTD-S0045-D Page 33 Linux® BSP ATTENTION The VC1 video codec and AAC audio codec are not supported (for AAC non-accelerated software decoding can be used). Exception: The gst-launch tool can handle AAC audio streams. Only three methods ('sinks' in gstreamer terminology) are supported: S nv_gl_eglimagesink or nvxvimagesink (DVI® monitor) S nv_omx_videosink (LVDS panel) The operating system contains some installed packages S S libgstreamer0.
KTD-S0045-D 9.2.2 Page 34 Linux® BSP Reencoding Examples With the ffmpeg tool you can reencode video files which do not comply the criteria listed above. S Create H.264 baseline profile, avg bitrate 15 Mbps, peak bitrate 20 Mbps: ffmpeg -y -i ./video.mov -vcodec libx264 -profile baseline -b 15M-maxrate 20M -bufsize 1830k -acodec copy ./video_h264_max20_aver15.mov S Create Xvid, avg bitrate 8 Mbps, peak bitrate 10 Mbps: ffmpeg -y -i ./video.
KTD-S0045-D Page 35 Linux® BSP 23 DRC QR Decay Rate 0.
KTD-S0045-D 9.4 Page 36 Linux® BSP 67 DACR Sidetone None 68 DACL Sidetone None 69 Right Capture Mux Right 70 Left Capture Mux Left 71 ADC Input ADC 72 Right Input Mode Mux Single-Ended 73 Right Input Inverting Mux IN1R 74 Right Input Mux IN1R 75 Left Input Mode Mux Single-Ended 76 Left Input Inverting Mux IN1L 77 Left Input Mux IN1L 78 Int Spk Switch on PCI Express® Interface Some mini PCI Express® cards cause a malfunction (e.g.
KTD-S0045-D 9.6 Page 37 Linux® BSP KEAPI Interface For test and demonstration purposes you can find a GUI tool with the menu entries Accessories - Files - File System in the directory usr/bin. Double-click on the keapi-gui script, click on the button Run and after password input the following screen output appears: ATTENTION Do not call directly the keapi-gui.real application. Without the root privileges only few keapi functions are ready for use.
KTD-S0045-D Page 38 Linux® BSP For the I2CTM part some restrictions are valid: S Do not access board devices (e.g. temperature sensor - this device has an own interface). Especially this part should be used for external components on the digital I/O (GPIO) or mini PCI Express® connector. S Some datasheets present the device address as a shifted value (e.g. EEPROM address = 0xA0). Use instead the unshifted value (e.g. real EEPROM address = 0x50). S Bus 1 allows access to the DVI® DDC lines.
KTD-S0045-D Page 39 For digital I/O pin assignment see the 'KTT20/pITX Users Guide' chapter 'Digital I/O Interface'. The display part is only available if you use a LVDS panel.
KTD-S0045-D 9.6.1 Page 40 Linux® BSP KEAPI Command Line Tools In the same directory where the GUI tool is located you can find the following command line tools (for help screen type the command without arguments): Note: some modules are pointless (do not use the grayed out tools - they are only available for compatibility purposes).
KTD-S0045-D Page 41 10 AndroidTM BSP 10.1 Graphics Interface 10.1.1 DVI® Monitor AndroidTM BSP The AndroidTM graphic driver does not offer full EDID support. In most cases two supported resolutions (SXGA and Full-HD) are enough. You need to add the entry 'persist.tegra.hdmi.resolution' in the system file 'build.prop', detectable in the directory /system. The driver accepts following values: Vga, 480p, 576p, 720p, SXGA and 1080p Example for Full-HD: persist.tegra.hdmi.resolution=1080p 10.1.
KTD-S0045-D 10.3 Page 42 AndroidTM BSP Display Density In the system file '/system/build.prop' the entry 'ro.sf.lcd_density' can change the density on both graphic units (DVI® and LCD panel) for a better look. The lower the value (e.g. 180, 160 or 130), the higher density and smaller font your screen will have but it is possible that the navigation bar disappears. 10.4 GPIOs, Temperatures, Backlight and Bootcounter The AndroidTM BSP does not support the KEAPI interface.
KTD-S0045-D 10.4.2 Page 43 AndroidTM BSP Temperatures The board provides two temperatures: CPU (temp2) and sensor onchip (temp1). For temperature display in °C divide the returned values by 1000. Get the sensor onchip temperature: cat /sys/class/hwmon/hwmon0/device/temp1_input Get the CPU temperature: cat /sys/class/hwmon/hwmon0/device/temp2_input 10.4.3 Backlight The backlight functionality is only available if you have activated the LCD panel support in U-Boot.
KTD-S0045-D Page 44 Windows® Embedded Compact 7 (WEC7) BSP 11 Windows® Embedded Compact 7 (WEC7) BSP 11.1 U-Boot Settings The default environment settings intend to load a Linux® or AndroidTM image from an ext2/ext3 filesystem and not from a FAT/FAT32 partition. Two environment arguments have to be changed: bootfile and mmc_boot or usb_boot. Remove the boot device with the operating system or skip the autoboot operation with any key.
KTD-S0045-D 11.2 Page 45 Windows® Embedded Compact 7 (WEC7) BSP Video Decoding The integrated video player in the operating system allows hardware accelerated video decoding. The following table gives an overview about the limitations: Video Format Profile / Level Max. Resolution / Frame Rate Max. Throughput Comment DivX 4/5/6 1080p HD 1920 x 1080 / 30 fps 10 Mbps Xvid Highdef 1920 x 1080 / 30 fps 10 Mbps MPEG-4 Advanced Simple / L4 1920 x 1080 / 30 fps 10 Mbps H.
KTD-S0045-D 11.4 Page 46 Windows® Embedded Compact 7 (WEC7) BSP Graphics Interface You cannot use the U-Boot Setup settings to configure the DVI® or the LCD panel output. Only some entries in 'platform.reg' define for example the boot display or the resolution. 11.4.1 DVI® Monitor The best way to apply the DVI® monitor consists in the usage of EDID data. Example: IF BSP_NV_DISPLAY ... some settings ...
KTD-S0045-D 11.5 Page 47 Windows® Embedded Compact 7 (WEC7) BSP I2CTM Support Do not use the BSP I2CTM example. The connector J2000 involves the camera interface and likely this connector is not assembled in the future. 11.6 Watchdog Example #include #include
KTD-S0045-D Page 48 Windows® Embedded Compact 7 (WEC7) BSP Sleep (WDT_CNT_TIME); } wprintf (TEXT ("Watchdog timer refresh stopped !\r\n")); dwCount = 0; while ((dwCount++) < WDT_CNT_ABORT) { wprintf (TEXT ("Timeout count = %d\r\n"), dwCount); Sleep (WDT_CNT_TIME); } wprintf (TEXT ("Error: watchdog timeout failed\r\n")); CloseHandle (hWdt); return FALSE; } KTT20/pITX Software Guide
KTD-S0045-D 11.7 Page 49 Windows® Embedded Compact 7 (WEC7) BSP GPIO Examples Defines PORT_C as output and sets each pin to low level (alternative to high level): #include #include #include
KTD-S0045-D Page 50 Windows® Embedded Compact 7 (WEC7) BSP Defines PORT_C as input and reads each pin: #include #include #include
KTD-S0045-D Page 51 Appendix A: Reference Documents Appendix A: Reference Documents KONTRON Technology A/S can't guarantee the availability of internet addresses. Document Internet Address ® NVIDIA Development http://developer.nvidia.com/tools/Development Tegra® 2 Technical Reference Manual http://developer.nvidia.com/tegra-2-technical-reference-manual ® ® Linux for Tegra http://developer.nvidia.com/linux-tegra ® Digital Visual Interface (DVI ) http://www.ddwg.
KTD-S0045-D Page 52 Appendix B: Document Revision History Appendix B: Document Revision History Revision Date Author Changes S-0045-D 02/08/13 M. Hüttmann Some minor changes in Android BSP chapter S-0045-C 02/01/13 M. Hüttmann Added chapters for Android and WEC7 BSPs, some changes in 'Linux BSP' S0045-B 12/03/12 M. Hüttmann Added some subchapter under 'Linux BSP' (Login, PCI Express, KEAPI) S0045-A 11/19/12 M. Hüttmann New Kontron design.
