KTLX800/pITX KTD-S0023-A
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 6 ACPI Thermal Management............................................................... 17 6.1 Active Cooling ............................................................................................................17 6.2 Temperature Limits .....................................................................................................17 6.3 Temperature Identifier.............................................................................................
KTD-S0023-A 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-S0023-A 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-S0023-A 2 Page 3 BIOS Update BIOS Update The KONTRON update tool (based on the AMD utility 'FlashROM.com') is only available for the DOS operating system. First copy the files IPLXUPD.EXE, UPDATE.EXT (absolutely essential) and the BIOS file to a directory. Only the following combination of command line arguments has been tested and should be used for the update process. Note: COMMAND.COM must reside in the same directory or alternatively there has to be a valid path in the variable COMSPEC.
KTD-S0023-A Page 4 3 Graphics Interface 3.1 LCD/LVDS Technology Overview 3.1.1 Detailed Timing Descriptor (EDID or DisplayIDTM) Graphics Interface 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.
KTD-S0023-A Page 5 Graphics Interface Example 2 (not useable on KTLX800/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-S0023-A 3.1.2 Page 6 Graphics Interface ace 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 (F 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-S0023-A 3.2 Page 7 Graphics Interface EDID 1.3 Specification (VESA) The EDID (Extended Display Identification Data) record has a fixed structure. The first 8 bytes contain the distinctive identification 00h, FFh, FFh, FFh, FFh, FFh, FFh, 00h. 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-S0023-A 3.3.2 Page 8 Graphics Interface DisplayIDTM Restrictions Depending on the graphic controller not all features can be used. The following table shows the most important restrictions. Restrictions for KTLX800/pITX Panels with dual or quad clock not supported (2 or 4 Pixel per Clock) Variable power sequencing not supported Many displays center the picture automatically using the DE-signal.
KTD-S0023-A 3.3.4 Page 9 Graphics Interface 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-S0023-A Page 10 Graphics Interface 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 transfering this file format into the binary file format for the EEPROM apply the Converter. Building DisplayIDTM File 3.3.5 Start the Windows® tool DisplayID.exe.
KTD-S0023-A 4 Page 11 SDIO/microSD Card Interface SDIO/microSD Card Interface The following operating systems allow booting from a microSD card: DOS, Linux and Windows® XP Embedded. Attention: only the microSD card interface is bootable - not the second SDIO pin header. 4.1 DOS Boot All standard DOS programs for partitioning and formatting can be used (e.g. FDISK.EXE and FORMAT.COM). However it can not be guaranteed that all functions of INT13h respectively INT21h work correctly.
KTD-S0023-A 5 Page 12 CPLD Interface CPLD Interface Various functions are implemented in two CPLDs: e.g. watchdog, digital I/O and fan control. Access to the CPLD register is via an index-data register pair using only two I/O byte locations (fixed addresses).
KTD-S0023-A Page 13 CPLD Interface The GPIO registers represent an exception. The access is executed with linear addressing and 16 bit data width (fixed addresses). Register Range 0xB00 - 0xB0B Register overview: Note: 5.1 Offset Type Reset Function 0x00 RO --- GPIO data input register Bit 0 = GPIO0 ... Bit 15 = GPIO15 0 = define low input 1 = define high input 0x02 RW 0x0000 1) GPIO data output register Bit 0 = GPIO0 ...
KTD-S0023-A 5.2 Page 14 CPLD Interface Programming Examples The following examples (DOS programs) show the access to the CPLD features (C compiler: BORLAND C++). Note: These programs cannot be run on Linux and Windows®. 5.2.1 Watchdog Example #include #include
KTD-S0023-A 5.2.2 Page 15 Digital I/O Example #include #include #include
KTD-S0023-A 5.2.3 Page 16 Fan Control Example #include #include #include
KTD-S0023-A 6 Page 17 ACPI Thermal Management ACPI Thermal Management The ACPI thermal management supports one mode: active cooling (no performance loss, but noise production). 6.1 Active Cooling The operating system continuously polls the temperature using the ACPI method '_TZP' (Thermal Zone Polling). This is done automatically by Linux - for Windows® operating systems an additional tool is needed as Windows® ignores the ACPI method '_TZP'. For example the tool CPUID HWMonitor Vers. 1.14.
KTD-S0023-A 7 Page 18 ACPI Wakeup One wake event is possible: Wake On LAN (WOL). 7.1 Wake On LAN 7.1.1 Windows® XP The Intel® network driver does not support WOL. 7.1.2 Linux (Debian distributions) Linux normally disables the wake functionality.
KTD-S0023-A 8 Page 19 JIDA32 Interface JIDA32 Interface Most KONTRON single board computers (SBCs) are equipped with unique hardware features that cannot be accessed with standard API. The JIDA32 interface allows you to access this features in a hardware independent manner under popular 32-bit operating systems. Not mentioned parts of the JIDA32 interface are not supported and can lead to wrong results. 8.
KTD-S0023-A 8.3.1 Page 20 JIDA32 Interface Bus Number Technology Type Device Count 0 SMBus (primary) JIDA 3 Comment Bus Number 0 (JIDA/Generic) Through this bus several devices can be handled. This bus allows access to the JIDA EEPROM in which KONTRON specific manufacturing parameters are stored. A damage of these parameters leads to a loss of warranty. Due to this a write cycle may only be performed above a defined address. 8.4 Device Address Size Read Access Write Access Temp.
KTD-S0023-A 8.6 Page 21 JIDA32 Interface Digital I/O Part This part defines the availability of digital input/output lines. 8.7 Type Port Pin Count Position Input or Output 0 8 Bit 0 - 7 Input or Output 1 8 Bit 0 - 7 Input/Output 2-7 Not supported Watchdog Part The watchdog can be programmed with discrete timeout values on boards with CPLD implementation or in millisecond resolution with boards using a Super-I/O.
KTD-S0023-A 8.8 Page 22 JIDA32 Interface JIDA32 Windows® Programming For further information see the actual JIDA32 documentation (JIDA32.pdf). 8.8.1 Program Language C The demo program reads and shows the board name and the first 16 bytes of SPD EEPROM (SMBus). The program uses the static linked library JIDA.LIB. Example: #include #include "jida.
KTD-S0023-A 8.8.2 Page 23 JIDA32 Interface Program Language DELPHI The demo program activates the watchdog (timeout = 30 seconds). The keyword 'var' passes the argument by reference.
KTD-S0023-A Page 24 JIDA32 Interface procedure TForm1.Button1Click(Sender: TObject); begin {Method 1} if JidaDLLInitialize () then begin if JidaDllIsAvailable () then begin if JidaBoardOpen (JIDA_BOARD_CLASS_CPU, 0, JIDA_FLAGS_DEFAULT, hJida) then JidaWDogSetConfig (hJida, 0, JIDA_TIMEOUT_VALUE, JIDA_DELAY_VALUE, JIDA_REBOOT_MODE); end; JidaDllUninitialize (); end; end; end.
KTD-S0023-A Page 25 The associated DPR file: program Jidatest; uses Forms, mainU in 'mainU.pas' {Form1}; {$R *.res} begin Application.Initialize; Application.CreateForm (TForm1, Form1); Application.Run; end.
KTD-S0023-A 8.8.3 Page 26 JIDA32 Interface Program Language VISUAL BASIC (VB.NET) The demo program shows the board count value and activates the watchdog (timeout = 10 seconds). Example: Public Class JidaTest Declare Declare Declare Declare Auto Function JidaDllInitialize Lib "JIDA.DLL" () As Boolean Auto Function JidaDllUninitialize Lib "JIDA.DLL" () As Boolean Auto Function JidaDllIsAvailable Lib "JIDA.DLL" () As Boolean Auto Function JidaBoardCount Lib "JIDA.
KTD-S0023-A Page 27 JIDA32 Interface The associated Designer file: Partial Class JidaTest Inherits System.Windows.Forms.Form Protected Overrides Sub Dispose(ByVal disposing As Boolean) Try If disposing AndAlso components IsNot Nothing Then components.Dispose() End If Finally MyBase.Dispose(disposing) End Try End Sub Private components As System.ComponentModel.IContainer
KTD-S0023-A 8.8.4 Page 28 JIDA32 Interface Module Definition File The calling program can refer to the function by name or by ordinal value. The tool IMPDEF.EXE (e.g. BORLAND C++) make it possible to generate the DEF-file (from JIDA.DLL 06/07/2004, in newer DLLs the ordinal value can be changed).
KTD-S0023-A JidaIOIsAvailable JidaIORead JidaIOSetDirection JidaIOWrite JidaIOXorAndXor JidaJ32B JidaJ32BTransAddr JidaPerformanceGetCurrent JidaPerformanceGetPolicy JidaPerformanceGetPolicyCaps JidaPerformanceSetCurrent JidaPerformanceSetPolicy JidaStorageAreaBlockSize JidaStorageAreaCount JidaStorageAreaErase JidaStorageAreaEraseStatus JidaStorageAreaRead JidaStorageAreaSize JidaStorageAreaType JidaStorageAreaWrite JidaTemperatureCount JidaTemperatureGetCurrent JidaTemperatureGetInfo JidaTemperatureSetLi
KTD-S0023-A 8.9 Page 30 JIDA32 Interface JIDA32 Linux Programming Please note that the JIDA32 package does not include full sources. Instead precompiled objects are provided that can be used to build a JIDA32 package for a certain environment (GCC, kernel, libc). In order to handle GCC version incompatibilities and different kernel module build environments the package includes different branches (you can use the GCC_3.x.x subdirectory for GCC 4.x.x compiler versions). GCC_2.x.
KTD-S0023-A Page 31 JIDA32 Interface You can provide a prefix for the above named directories with the INSTALL_MOD_PATH environment variable if you want to install the files into an alternative root file system. (Note: kernel 2.6.x only) After successfull build and installation you should run the sample application jidatst which will display the following message: JIDA system driver is incompatible or not installed.
KTD-S0023-A 9 Page 32 Linux Support Linux Support Many Linux distributions have a problem with the graphic driver. The best choice is the usage of the VESA framebuffer driver. The most unproblematic distribution is 'Knoppix' (based on 'Debian'). Use Knoppix with the boot parameter 'fb????x????' (e.g. fb1024x768).
KTD-S0023-A Page 33 Appendix A: Reference Documents Appendix A: Reference Documents KONTRON Technology A/S can't guarantee the availability of internet addresses. Document Internet Address Advanced Configuration and Power Interface (ACPI) http://www.acpi.info/spec.htm AT Attachment Storage Interface Specification (ATA) http://t13.org Digital Visual Interface (DVI) http://www.ddwg.org High Definition Audio Specification (HD Audio) http://www.intel.
KTD-S0023-A Page 34 Appendix B: Document Revision History Appendix B: Document Revision History Revision Date Author S0023-A 08/30/11 M. Hüttmann Added chapter 'BIOS Update Restrictions' and 'Linux Support' Changes S0023-0 05/12/11 M. Hüttmann Created preliminary manual Corporate Offices Europe, Middle East & Africa North America Asia Pacific Oskar-von-Miller-Str. 1 85386 Eching/Munich Germany Tel.: +49 (0)8165/ 77 777 Fax: +49 (0)8165/ 77 219 info@kontron.