Home

View - to emtrion`s Support Center

1. Form Factors HTML Designer Platform Builder For CE H Windows IIA ee acetal S T a x Default output location on device Transport tcp Connect Transport Configure Bootstrapper activesync Startup Provider y Configure 4 cod ea IV Detect when device is disconnected l vn Le Ready 5 Click the Configure button beside the Transport drop down box We are going to configure the TCP Connect Transport Configure TCP IP Transport Use fixed port number 5655 Device IP address C Obtain an IP address automatically using ActiveSync Use specific IP address 192 168 105 145 DI e 6 Inthe case when an USB ActiveSync connection exists between the workstation and the device the option Obtain an IP address is to select In the other case the option Use specific IP address is to select and the IP address you got on the device by ipconfig has to be inserted 7 Click OKthrough all ofthe dialogs Application development Preparing the target 1 Atthe command shell type ConmanClient2 2 Then type cmaccept You have 3 minutes to establish a connection with your managed application Deploying the managed application 1 Select Debug Start Debugging from VS2005 2 Select WindowsCE5 0 Device from the list of devices in the Deploy MyName box and click Deploy VS2005 will deploy several cab files to the device in addition to your application Yo ur application i
2. retWert RegOpenKeyEx HKEY LOCAL MACHINE T Software 0 0 amp hRegKey if retWert ERROR SUCCESS Error handling Here new entries are made entries changed or deleted SCH Save registry to Flash retWert RegFlushKey hRegKey Hint Here a valid handle for the registry key will need to be specified s the online help The complete registry will always be saved to Flash if retWert ERROR SUCCESS Error handling llose registry key retWert RegCloseKey hRegKey if retWert ERROR SUCCESS Error handling Persistent Registry 33 11 1 Deleting the Persistent Registry The persistent registry can be deleted in either of the following ways 1 Using the bootloader 2 Ma an application under Windows CE 11 1 1 Deleting the Registry by the Bootloader The persistent registry can be deleted via menu item 2 of the extended bootloader menu described in section Bootmenu The persistent registry can be deleted via menu item 4 of the second bootloader menu For more detailed information please refer to the user manual of the bootloader 11 1 2 Deleting the Registry by means of an Application under Windows CE IMPORTANT This works only with images which contains the RAM based registry For images with Hive based registry you have to use the bootloader to clear the registry A Win
3. reading or writing ERROR INVALID PARAMETER 00000057h context ERROR NOT ENOUGH MEMORY 00000008h Driver is out of memory or the structure elements inLen and outLen don t agree with the total length ofthe corresponding buffer HTX ERROR INVALID DEVICEADDRESS 20000001h Device address is not set HTX ERROR INVALID FLAGS 20000002h Internal driver flags are not set HTX ERROR NORESPONSE 20000003h Device is not responding to the master HTX ERROR BUSBUSY 20000004h the bus is used or affected by another device HTX ERROR ERROR RESPONSE 20000005h Device is not responding while transferring data PC Bus Driver Error Code Value Description HTX ERROR UNKNOWN 20000006h known Licence Agreements 46 16 Licence Agreements SOFTWARE LICENSE TERMS WINDOWS EMBEDDED CE 6 0 CUSTOMIZED OEM SOFTWARE DEVELOPMENT KIT for Windows Embedded CE 6 0 Developer Kit for DIMM SH7723 02 0 0 These license terms are an agreement between you and emtrion GmbH Company Please read them They apply to the software named above which includes software licensed by Microsoft Corporation or their affiliates Microsoft to Company The software also includes documentation and any media on which you received it The terms also apply to any e updates supplements Internet based services and D support services for this software unless other terms accompany those items If so those terms apply By using the software you acce
4. Design Ti Connect to Database Gi EN P Eo u Connect to Server od Solution MylName P MyName 9 Ea Properties Choose Toolbox Items a Connect to Device E Code Snippets Manager C aj References ES Formi cs e Program cs Macros ActiveX Control Test Containe Add in Manager E Create GUID B mainMenul Dotfuscator Community Edition Error Lookup ATL MFC Trace Tool ILDasm elle Show output from Windows CE Debug Spy Visual Studio 2005 Command F External Tools 3 Device Emulator Manager Import and Export Settings Customize E4Cod 2SlCall E Fin ABoo Sherr Options o Ready 2 Inthe options window expand the Device Tools node and select Devices 3 Inthe Show device for platform drop down box select WindowsCE5 0 Device 4 Click on WindowsCE5 0 Device and select Properties Application development 21 MyName Microsoft Visual Studio File Edit View Project Build Debug Target Data Tools Window Community DAS ld BH X amp Ba O Cv a b Deby y wet amm i an o CH r 1 A4 Whe Nin Tha PP Sonno t m mi T Environment Show devices for platform l Projects and Solutions wndowsctso e Source Control Text Editor Devices H Database Tools Windows CE 5 0 Device Y Debugging A Device Tools General Devices
5. Ethernet and USBF and all the kemels are supporting this 7 1 VS2005 for Application Development When you using VS2005 for application development based on a specific kernel some hints shall be considered e Since Win32 API functions may be omitted in the creation of operating system kernels under Windows Embedded CE there is no SDK Software Development Kit which suits all Windows CE operating system kernels Actually each operating system kemel has an SDK of its own which must be installed in addition to the development environment e Please consult the online help of VS2005 search for Requirements to obtain information on whether a specific function is available in an SDK If the name of the OS kernel e g DIMM 7723DewKit CE600 SDK for starter kit kernel is listed the function will be supported by this OS kernel e The list of parameters of the Win32 API functions is identical with that of the corresponding API functions of Windows 9x NT XP With some functions certain parameters must be set to 0 For more information please refer to the online help 7 1 1 Creating a new Managed Project The first step is starting a new instance of VS2005 1 Select File NewProject from the Visual Studio menu 2 Inthe NewProject window select Visual C SmartDevice WindowsCE5 0 3 Selectthe Device Application template 4 Name your project MyName and click ok go e Project types Templates BB jo El Visu
6. Host Support BSP contents 15 USB Human Input Device HID Class Driver IN USB HID Keyboard and Mouse 1B 2X USB HID Keyboard only EA USB HID Mouse only o X USB Printer Class Driver PCL 3 ln ee Ss USB Storage Class Driver x 6 5 Device Management C S Simple Network Management Protocol SNMP a SX i Device Management Client ch XL i 6 6 File Systems and Data Store Kem A ES Commsson A Database Support CEDB Database Engine CN UE File and Database Replication bit based X File Cache Manager File System Internal RAM and ROM File System ROM only File System Registry Storage Hive based Registry RAM bas ed Registry Storage Manager H FAT System O Parton Driver OA Release Directory ile System A Storage Manager Control Applet X system Passe X 6 7 Fonts Kami AN Arial Subset1_30 X CowerNew Susei 30 X symbol Tahoma Subset 1 89 ThomaBod nages O 6 8 Graphics and Multimedia Technologies ER 2 Audio Audio Compression Manager __ x Waveform Audio C ADE ace Graphics Direct3D Mobil CRE TE BSP contents 16 X lO ur Gradient Fill Support CX Still Image Codec Support Encode and Decode LL X Still Image Encoders and Decodes CTX EA E LA AA o A Audio Codecs and Renderes gt gt gt A MPEG Layer 1 and 2 Audio Codec gt MSAD
7. Microsoft knew or should have known about the possibility of the damages The above limitation may not apply to you because your country may not allow the exclusion or limitation of incidental consequential or other damages Please note As this software is distributed in Quebec Canada some of the clauses in this agreement are provided below in French Remarque Ce logiciel tant distribu au Qu bec Canada certaines des clauses dans ce contrat sont fournies ci dessous en francais EXON RATION DE GARANTIE Le logiciel vis par une licence est offert tel quel Toute utilisation de ce logiciel est votre seule risque et p ril L entreprise ou Microsoft n accorde aucune autre garantie expresse Vous pouvez b n ficier de droits additionnels en vertu du droit local sur la protection dues consommateurs que ce contrat ne peut modifier La ou elles sont permises par le droit locale les garanties implicites de qualit marchande d ad quation un usage particulier et d absence de contrefagon sont exclues Licence Agreements 48 LIMITATION DES DOMMAGES INT R TS ET EXCLUSION DE RESPONSABILIT POUR LES DOMMAGES Vous pouvez obtenir de Microsoft et de ses fournisseurs une indemnisation en cas de dommages directs uniquement hauteur de 5 00 US Cette indemnisation ne couvre pas les r ductions qu une entreprise vous ait donn es Vous ne pouvez pr tendre aucune indemnisation pour les autres dommages y compris les dommages
8. Services and Document Object Model XML Query Languages XQL BSP contents 14 6 3 Communication Services and Networking Kemel TA Networking General NDIS Usermode VO Protocol Drier X Network Driver Architecture NDIS X Network Utities Ipconfg ping route nesta Tx E ERI IP Helper API TCI IPv6 Support Windows Networking API Redirector SMB CIFS Ps Winsock Support E Networking Local Area Network LAN Wired Local Area Network 802 3 802 5 Networking Wide Area Network WAN Dial Up Networking RAS PPP AutoDial Standard Modem Support for Dial Up Networking Telephony API TAPI 2 0 Unimodem Support X x x gt x X CoeSewrSupot H FeSewr SMBICIFS Cd meser A IA RAS ServerPPTP Server Incoming SNPClenwihDST H X Gentse OOOO X 6 4 Core OS Services EAT L b Tohdpapl Device Manager X DisplaySuppot SeaPPotSupot X LUI Proxy for Kernel Mode Drivers X Windows Embedded CE Driver Development Kit Support Library x Kernel Funtionality Fiber API Format Message API Format Message API System Error Messages Memory Mapped Files Message Queue Point to Point Target Control Support Shell exe Notification Non UI based Notification UI based Notification Power Management Power Management Full Power Management Minimal USB Host Support USB Function Driver USB
9. a previously started program Starting an application at system start 25 Please also note section Persistent Registry Note Entry 2 specifies the dependency of the application An application stored on a mass storage cannot be started until the corresponding entry has been made in the folder structure It may happen in this context that the registry entries in the HKEY LOCAL MACHINEVinit key will be processed faster than the mass storages are entered in the folder structure This must be taken into account in the startsequence Data Exchange between Target and Workstation 26 9 Data Exchange between Target and Workstation The Developer Kit kernel allows the exchange of data between the target and your workstation For this Microsoft s ActiveSync program is needed The latest version is available on the intemet at http s earch microsoft com s earch results as px st b amp qu ActiveS ync amp view en us If you have not yet worked with Microsoft s ActiveSync we recommend to you a look at section Remarks on Using ActiveS ync 9 1 Preparing the Desktop Computer If Microsoft ActiveSync has not yet been installed on your desktop computer it must be prepared as follows Windows 2000 1 From the Control panel choose Modem and install the communications cable between two computers 2 Start ActiveSync 45 eng setup exe or ActiveSync 45 ger setup exe Both have been placed in the subdirectory ActiveSync ofthe Starter Kit CD
10. is provided for the command line parameters of the application Optionally the same registry key may also contain an entry called WaitCycles This entry a type of REG DWORD lets you extend the time that the autostart program is waiting for the directories to be linked e g a FlashDisk If the entry is notfound a default value of 100 is taken Optionally the same registry key may also contain an entry called FailureOptions This entry is also a type of REG DWORD and is bit coded Please set only these bits that are really necessary The meaning of the individual bits is shown in the table below Starting an application at system start 24 Setting this bit message is displaying in a message box when the custom application cannot be started With this bit you can specify the message showing in the message box 0 message gt Cannot start the application which was specified to launch at startup is showing 1 gt more detailed information is showing like the name and search path of the application Setting this bit the autostart program doesn t exit and is showing continuously the message when the custom application cannot be started Specifies the start up process for the custom application 0 gt the explorer is notstarted and the custom application is started atlaunch time of the autostart program 1 2 the explorer is started and the custom application is started by the startup mechanism of the e
11. network When you want to update the image a TFTP Server is required too 3 1 2 HW Requirements e Speed 933 MHz recommended 2 GHz e RAM 512 MB recommended 1 GB e Interfaces 1xEthernet port 1xRS232 1xUSB 1 1 2 0 e DVD ROM drive 3 2 Requirements on the target For the target the following devices are recommended e USB keyboard e USB mouse Setting up the host 10 4 Setting up the host At this point we assume Microsoft Visual Studio 2005 with SvP1 Microsoft and Microsoft ActiveSync are already installed on the host 4 1 Installing the SDK The SDK allows you to develop applications based on the delivered kernel To make this possible install the SDK from the DVD when VS2005 is not open During installation the SDK is added to the list Installed SDKs from VS2005 At this point HICODIMM7723 resp DIMM SH7723 can be chosen in VS2005 for generating applications on DIMM SH7723 4 2 Setting up Ethernet TCP IP TCP IP is used for Ethernet connection to DIMM SH7723 Make sure that TCP IP is already set for the network protocol at the host 4 3 Setting up a TFTP server This is only required when you intend to update the image on the target In this case make sure the TFTP is running and its browse directory points to the location ofthe image Alink fora TFTP server is stated in the section SW Requirements 4 4 Setting up aTerminal As terminal software use the terminal software that comes with you
12. sp ciaux indirects ou accessoires et pertes de b n fices Cette limitation s applique aussi e tout ce qui est reli au logiciel aux services ou au contenu y compris le code figurant sur des sites Internet tiers ou dans des programmes tiers et e les r clamations au titre de violation de contrat ou de garantie ou au titre de responsabilit stricte de n gligence ou d une autre faute dans la limite autoris e par la loi en vigueur e Ce que l entreprise ou Microsoft savaient ou auraient du savoir sur les dommages int r ts Elle s applique galement m me si Microsoft connaissait ou devrait connaitre l ventualit d un tel dommage Si votre pays n autorise pas l exclusion ou la limitation de responsabilit pour les dommages indirects accessoires ou de quelque nature que ce soit il se peut que la limitation ou l exclusion ci dessus ne s appliquera pas votre gard EFFET JURIDIQUE Le pr sent contrat d crit certains droits juridiques Vous pourriez avoir d autres droits pr vus par les lois de votre pays Le pr sent contrat ne modifie pas les droits que vous conf rent les lois de votre pays si celles ci ne le permettent pas 15 ADDITIONAL TERMS if applicable End User License Agreement Emtrion GmbH Greschbachstrasse 12 76229 Karlsruhe Germany hereinafter referred to as Emtrion provides to businesspersons which are Unternehmer in the sense of Sect 14 BGB German Civil Code hereinafter the Cus
13. storage device nand 8 1 Emtrion s autostart mechanism One possibility to start your application atsystem start is using the autostart mechanism from emtrion For them an autostart program was written and included into the kernel The registry of the Developer Kit kernel includes a launch link to that autostart program and starting itat system start Additional a shortcut of the autostart program is located in the StartUp folder of the explorer so that the start up mechanism of the explorer is also useable Now the autostart program itself looks in a spedfic registry key whether or not what application shall be started The registry key includes several entries But this is not the only task of the autostart program The autostart program is also controlling the starting of the explorer The autostart program looks in HKEY LOCAL MACHINESoftwarelemtrionMAutoStart for the entry CustomerApp The entryis oftype REG SZ and is provided for the filename and if necessary the path of the application that shall be started When the entry is empty no further action will be done In the case of a valid entry the autostart program tries to start the application When a path is not stated the system searches in the folder Windows and in the folders of the supported storage devices of the Developer Kit mentioned in the introduction of the chapter The entry AppParameter can be found in the same registry ke y The entry is also a type of REG SZ and
14. supported Some small improvements Using Windows CE 6 0 R3 07 06 2010 Ft QFEs followed up to 2010M03 Updated USB Host driver Support of Hive bas ed registry This document is published by Emtrion GmbH Greschbachstr 12 D 76229 Karlsruhe Tel 49 721 62725 0 Fax 49 721 62725 19 E mail mail emtrion de Internet http www emtrion de June201 0 004 Index 3 1 3 1 1 3 1 2 3 2 Ae ROMS anu Na o Am D Fb amp w ND 000000000000 Oo N 20 wo Introduction DVD of the ADK Requirements Requirements on the host SW Requirements HW Requirem ents Requirements on the target Setting up the host Installing the SDK Setting up Ethernet TCP IP Setting up a TFTP server Setting up a Terminal Setting up the target Setting up for application development Setting up for updating the image BSP contents Applications End User Applications and Services Development Communication Services and Networking Core OS Services Device Management File Systems and Data Store Fonts Graphics and Multimedia Technologies International Internet Client Services Security Shell and User Interface Device Driver Application development VS2005 for Application Development Creating a new Managed Project Deploying to the target Starting an application at system start Emtrion s autostart mechanism Autostart with launchXX and dependXX Data Exchange between Target and Workstation Preparing th
15. 1VM1CBA TX14 To offer a wide flexibility the used display has to be selected in the booloader For this purpose the bootloader holds the environment variable display Set the variable to the corresponding name of the used display and then save the environment variable However the environment variable is already setto the connected display by delivery The following example shows the setting for the display NEC NL6448BC20 on the bootloader output HICO7723 presents the prompt of the bootloader To getto the bootloader prompt you have to leave the bootloader menu For more information please refer to the chapter The Bootloader 07723 se env dis y NL6448 ronment to NVRAM g Parameters 10 to NVRAM Anytime you change the display the touch has to be recalibrated This can be done with the calibration applet Stylus in the control panel After this make the new calibration data persistent by using the tool writereg exe 13 8 Supported File Formats The bootloader requires a special file It consists of the raw binary nk nbO extended by a special header The special header contains all the information needed by the bootloader like length start address etc 14 Serial Ports The SH7723 has two three channel serial communication interfaces with FIFO SCIF and SCIFA Two channels ofthe interface SCIF and all channels of the SCIFA are supported in asynchronous mode That makes a total of 5 serial interfaces available Se
16. DIMM SH7723 ADK CE 6 0 R3 User manual Copyright emtrion O Copyright 2010 emtrion GmbH All rights reserved Without written permission this documentation may neither be photocopied nor stored on electronic media The information contained in this documentation is subject to change without prior notification We do not assume any liability for erroneous information or its consequences The trademarks of other companies that are used identify the products of these companies exclusively Microsoft Windows Windows 95 Windows98 Windows NT Windows 2000 Windows XP Windows CE and MS DOS are registered trademarks of the Microsoft Corporation E First edition 17 03 2009 MI Eo Improving stabilisation and performance of NAND 30 06 2009 MI Synchronising of AUDIO Replacing of USBH driver with DMA support Supporting additional dis play UMSH8272 Reset of the hardware can be triggered from software Graphical hardware accelerator Multimedia Video IN PAL NTSC digital Video OUT PAL NTSC Video decoding MPEG4 Blending PIP QFEs followed up to 2009M05 New section Licensing of the WINCE Image IIC Bus driver Repeated start condition supported Sample applications for multimedia Licence agreements replaced 11 09 2009 MI QFEs followed up to 2009M08 SDCard Both interfaces SDHIO and SDHI1 of the SH7723 are supported High Capacity is now supported New multimedia demo application Available as msi file Update video decoder new revision
17. E computer is connected with the desktop computer as a guest only The connection as a guestis sufficient if you wish to exchange data or to debug an application via an USB connection Yes will establish a partnership which is necessary for data synchronisation The following dialogs appear New Partnership xi Select Synchronization Settings Select the type of information you want to synchronize To synchronize a particular type of information select its check box To stop synchronization of that information clear its check box Mobile Device Synchronized Files To find out more about and to customize what gets synchronized click n on that information type in the list and then click Settings Settings EESTI NEN Data Exchange between Target and Workstation 29 Accept the default setting or activate Files by clicking on the small boxleft of Files and click Next New Partnership Setup Complete You are now ready to start exchanging information between your mobile device and this computer Upon exiting this wizard Microsoft ActiveSync will open and If your device is a guest click Explore on the toolbar and start exploring vour device If your device has a partnership synchronization starts Please wait until synchronization is complete before using your device Click Finish to exit this wizard After that a dialog box appears telling you that the partnership has been successfull
18. PCMAdioCodeo Wave AlFF aulsnd File Tags Waveform AudioRenderer MA Ce CE AcMWmpperFiler o o SE EE L L A C Bess E eet se HEN e Sl Sel e Windows Media Pear Windows Media Player OA Vinos Media Player OOO Windows Media recois 6 9 International rend Xe UmwtWekodWamger MM OA D Engin US National Language Supportony T NawmilagageSwpotiS S E 6 10 Internet Client Services mel AR Internet Explorer 6 0 for Windows Embedded CE Standard Components X Internet Explorer 6 0 Sample Browser E E Internet Explorer 6 0 for Windows Embedded CE Components I EE Internet Explorer Browser Control Host ho dre x1 Internet Explorer HTML DHTML API 0 X A BSP contents 17 Internet Explorer Multiple Language Base API IN URL Moniker Services NEED UNE E Windows Internet Services vb Internet Options Control Panel a X Jseript56 EA VBScript 56 EA 6 11 Security mel JOA Authentication Services A XX omi NTML EE ES A x Geier D Conan Gao H HT 6 12 Shell and User Interface Kem AK Graphics Windowing and Events Minima GDI Configuration X Minimal GWES Configuration X Minimal Input Comfguraton H X lt ze Minimal Window Manager Configuration EEEEEN Command Shell Aygshell API Set Command Processor Console Window Graphical Shell Standard Sh
19. With all other Windows versions 1 Start ActiveSync 45 eng setup exe or ActiveSync 45 ger setup exe in the ActiveSync directory of the starter kit CD 9 2 Preparing the Windows CE Device USB function is the default setting for communication with ActiveSync This communication is sufficient for file transfer and for application debugging When you do application development by VS2005 communication via Ethernet is also possible In this case USB ActiveSync can be used to get the ip address of the device 9 3 USB ActiveSync e Using a USB cable to connect the device to the workstation e When not yet powered on turn on the power on the target The Windows CE OS kernel which is stored in the flash will be executed The running kernel will initiate an ActiveSync connection at the desktop computer When the target is unknown as USB Device at the workstation Acti veSync will ask for the corresponding USB function driver which has to be installed The driver is located in the subdirectory US BFDriver of the installation e When ActiveSync does not start automatically on the workstation then you must perform this manually Please note USB has to be selected in the connectivity settings of ActiveSync The target establishes a connection with the desktop computer and possibly prompts you to login and enter your password Enter the same name and password as you are using for your desktop computer Note When the connection is not automatically e
20. al C ATL Visual Studio installed templates CLR T Device Application Class Library General I Control Library Bi Console Application MFC Empty Project Smart Device Win32 My Templates Other Languages E Visual C search Online Templates Windows E Smart Device Pocket PC 2003 Smartphone 2003 Windows CE 5 0 Database Starter Kite Ei A project for creating a NET Compact Framework 2 0 Forms application For Windows CE 5 0 and later Name Myname Now you can start with your application development 7 1 2 Deploying to the target The connection between VS2005 and the target is made by network For this reason the IP address ofthe target is necessary To make the IP address known to VS2005 there are two options The first option is to ask manually by means of the function ipconfig on the device For that ipconfig must be executed from the command shell Application development 20 The second is receiving the IP address automatically by an existing USB ActiveSync connection After getting this address the next step is preparing the managed application development environment for deployment 1 In VS2005 select Tools Options from the menu MyName Microsoft Visual Studio File Edit View Project Build Debug Target Data Window Community Gi G G d dii aiio C B Platform Builder For CE 6 0 SIS amp Sos ah ill ote He k Attach to Process eve A fa Be Solution Expl H X Form1 cs
21. comply with any technical limitations in the software that only allow you to use it only in certain ways For more information see the software documentation Except and only to the extent permitted by applicable law despite these limitations you may not e work around any technical limitations in the software e reverse engineer decompile or disassemble the software e make more copies of the software than specified in this agreement e publish the software for others to copy e rent lease or lend the software e transfer the software or this agreement to any third party or e use the software for commercial software hosting services 4 BACK UP MEDIA You may make one backup copy of the software You may use it only to reinstall the software 5 TRADEMARKS This agreement does not grant you any rights in connection with any trademarks or service marks of Company Microsoft or their suppliers Licence Agreements 47 6 EXPORT RESTRICTIONS The software is subject to United States export laws and regulations You must comply with all domestic and international export laws and regulations that apply to the software These laws include restrictions on destinations end users and end use For additional information see www microsoft com exporting 7 PRODUCT SUPPORT Contact Company for support options Refer to the support number provided with the device Microsoft does not provide support services for components provided to you in th
22. d is listed in the table below Folder Filename remarks manuals HiCODIMM7723 ADK CE600 v en pdf This manual HiCODIMM ECOBase v en pdf Hardware manual of the HiCODIMM EcoBase HiCODIMM Base HW v en pdf Hardware manual of the HiCODIMM Base manual uboot hico7723 v en pdf Manual ofthe bootloader Includes description of the multimedia UMP User Developer Documentation v1len pdf NAE application ump 600 v2 exe Includes description ofthe multimedia application videointest exe wce hico7723 Image ofthe licensed kernel HiCODIMM7723DevKit CE600 SDK Software Development Kit for the kernel EE Wceusbsh inf inf file for the Microsoft Acti veS ync driver Wceusbsh sys Microsoft Acti veS ync driver Dependent on the delivered edition of the ADK CEU Driver user Documentation v1en pdf Requirements 3 Requirements 3 1 Requirements on the host The requirements you need for application development are mentioned below 3 1 1 SW Requirements e Operating System Windows XP SvP2 or Windows 2000 SvP4 e Microsoft ActiveSync Version 4 2 0 for development purpose and data exchange between target and host e Microsoft Visual Studio 2005 e When you want to update the image a TFTP Server is required too One can be downloaded for free for example at http tftod32 jounin net tftpd32 download html When you are using this tftp be sure its dhcp service is disabled to avoid conflicts with the current dhcp at your
23. dows CE application can be enabled to use the persistent registry by calling the Win32 API function KernelloControl For this purpose emtrion has created the following device specific I O control code define IOCTL HAL SETREGISTRYTODEFAULT CTL CODE FILE DEVICE HAL 0x810 METHOD BUFFERED FILE ANY ACCESS In this code CTL CODE is a macro FILE DEVICE HAL METHOD BUFFERED and FILE ANY ACCESS are specified as define statements Both the macro and the definitions were defined by Microsoft in the winioctl h header file This file is usually linked to applications with the include windows h statement When you want to learn more details about KernelloControl we refer to the online help ofthe Platform Builder IOC TL HAL SETREGISTRYTODEFAULT This control code will delete the currently stored persistent registry As a result the default registry will be used when the system is started again However a reset will not be issued automatically Such a reset can be performed by using the IOC TL HA REBOOT control code IOCTL HAL SETREGISTRYTODEF AULT expects the following parameters of the KernelloControl function IpinBuf ninBufSize These parameters will not be analyzed IpOutBuf nOutBufSize IpBytes Retumed Pointer to a DWORD variable containing the number of bytes returned here 0 The control code deletes the flash sectors where the registry is saved by means ofthe erase function suppli
24. e bNumberOfBytesToRead Number of bytes to read bNumberOfBytes ToWrite Number of bytes to write bData Start of room for the data to write through I2C The amount of data must agree with bNumberOfBytes ToWrite inLen Number of bytes of the whole in buffer sizeof sI2CControlln bNumberOfBytes ToWrite inOutBuf out buffer that receives the data read form I2C outLen Number of bytes to be read from DC gt bNumberOfBytes ToRead IpBytes Retumed Pointer to the number of bytes read Due to determine the same size ofthe structure sI2CControlln at application and driver level the structure has to be compiled as packed Return value PC Bus Driver 43 If returns TRUE the IOCTL was successfully processed otherwise returns FALSE To obtain extended error information call GetLastError function and look for identifying the error atthe table below 15 3 3 ReadFile ReadFile reads data through I2C Before reading from the device be sure the corresponding device address is setbylOCTL I2CBUS SETADDRESS Proto BOOL ReadFile hl2cDrv IpBuf nNumberOfBytes ToRead IpNumberOfBytes Read NULL Parameters hl2cDrv IIC driver handle created by CreateFile IpBuf Pointer to the buffer that receives the data read from I2C nNumberOfBytes ToRead Number of bytes to be read from I2C IpNumberOfBytesRead Pointer to the number of bytes read Return value Nonzero indicates success Zeros indicates failure To get extended error info
25. e Desktop Computer Preparing the Windows CE Device USB ActiveS ync Remarks on Using ActiveS ync Multimedia sample applications UMP 600 V2 exe Videointest exe Persistent Registry Deleting the Persistent Registry Deleting the Registry by the Bootloader Deleting the Registry by means ofan Application under Windows CE 13 13 13 14 14 15 15 15 15 16 16 17 17 17 19 19 19 19 23 23 24 26 26 26 26 27 31 31 31 32 33 33 33 12 12 1 13 13 13 13 13 13 13 13 13 Am Dm bk amp w ND A 14 15 15 1 15 2 15 3 15 3 1 15 3 2 15 3 3 15 3 4 15 3 5 15 3 6 16 15 3 2 1 15 3 2 2 Downloading the image to the target Perform downloading The Bootloader Location of the bootloader Communication settings Console mode Boot mode Bootmenu Get to the bootloader prompt Changing the display Supported File Formats Serial Ports FC Bus Driver General Information Implementation API CreateFile DeviceloControl ReadFile WriteFile CloseHandle Error Codes Licence Agreements IOCTL I2CBUS SETADDRESS is IOCTL I2CBUS READWRITE 34 34 35 35 35 35 35 35 36 37 37 Introduction 7 1 Introduction This application package addresses all software engineers who don t want to care about the details of the Windows embedded CE 6 0 R3 kemel and who directly want to start writing applications Thats why emtrion GmbH bundles packages with all the files which are necessa
26. e is a Microsoft Acti veS ync link in the Programs group of the Windows Start menu When pointing to this link the following window appears Microsoft ActiveSync zloj xl File View Tools Help Sync Stop Details Explore Options WM rri Not connected Information Type Status Please verify that the USB connection is enabled Connection Settings menu item ofthe File menu lfa connection has been establis hed for the first time after power on the following dialog box displays Data Exchange between Target and Workstation 28 New Partnership x Set Up a Partnership Before you can synchronize information between your mobile device and this computer you must set up a partnership between them Would you like to set up a partnership Set up a partnership so that can synchronize information between my device and this computer No don t want to synchronize information Set up my device as a quest so that can copy or move information between my device and this computer Zur ck Abbrechen Hilfe The window shows that no partnership has been established between the Windows CE computer and the desktop PC Hint If a partnership has already been created with a device with persistent registry the dialogs displayed here do not show up Any of the offered options will be using the USB interface with following property No means that the Windows C
27. ed bythe bootloader Downloading the image to the target 34 12 Downloading the image to the target The images generated for DIMM SH7723 are uncompressed and equipped with a special header Furthermore the name of the image has to be the same as the value of the environment variable wimg of the bootloader By delivery wimg is set to wce hico7723 Without changing of wimg rename the name ofthe image to wce hico7723 when notset yet When this condition is achieved the image can be downloaded through TFTP bythe menu ofthe bootloader 12 1 Perform downloading We assume the target and host have been set up as described in Setting up the target and Setting up the host Make sure a TFTP server is running and its base directory is pointed to the location ofthe extended wince image Power ON or reset the target so that the menu of the bootloader is displaying at the terminal gf COMA PuTTY Clean the Persistent Registry within the item Extended functionality Choose item 4 or 5 to start downloading of the image either to Flash or SDRAM The Bootloader 35 13 The Bootloader This section gives a briefly description of the bootloader used in this Developer Kit When you are more interested in the function scope of the bootloader please refer to the bootloader manual The main task of the bootloader is to download a WINCE Image to the target and starting it To achieve this work the b
28. ell Common Controls Como X CommonDibgSupot Control Panel Apple Mouse OA Network User beer SotwaebmedmpuPand SP OA SPhrSmal amp wem X Sofware based Input Panel Diver OA Toun Screen Syu OO 6 13 Device Driver Keme AD Audio Drver for 772380 LORS X N uLDspyDiwrub Display Driver LCDC_SH7723 TFT Res 640 480 320040 co 188 O Native keyboard support EECHER EC Asynemac NDIS Driver X BSP contents 18 X Serial ntoraces SOF SCFASHTT2 OOO O X BEIER Storage Deviess OA NADFHahFieSpum E x X X Xx e CX BEER USSFmdonCietSem SEET E Kaka X Application development 19 7 Application development Application development is only possible with VS2005 Developing with Embedded Visual C is not supported with Windows Embedded CE 6 0 kernel If there is a need for this please don t hesitate to contact emtrion GmbH VS2005 supports unmanaged and managed code and programming languages like C CA Visual Basic and more are available The communication interface for debugging can be Ethemet as well as USB ActiveSync Sole Ethernet communication without a little help from USB ActiveSync is possible but needs some special tools instead For a more detailed description see the next chapters We recommend a combination of
29. ent does not change your rights under the laws of your country if the laws of your country do not permit it to do so 12 NOWARRANTIES FOR THE SOFTWARE The software is provided as is You bear all risks of using it Microsoft gives no express warranties guarantees or conditions When allowed by your local laws Company and Microsoft exclude implied warranties of merchantability fitness for a particular purpose and non infringement If your local laws give you any implied warranties guarantees or conditions despite this exclusion your remedies are limited to Company and its suppliers using reasonable efforts to repair or replace the software to the extent permitted by your local laws Any warranties you receive regarding the software do not originate from and are not binding on Microsoft or their affiliates 13 LIMITATION ON AND EXCLUSION OF REMEDIES AND DAMAGES You can recover from Microsoft and their suppliers only direct damages up to U S 5 00 Except for any refund Company may provide you cannot recover any other damages including consequential lost profits special indirect or incidental damages It also applies even if e anything related to the software services content including code on third party internet sites or third party programs and e Claims for breach of contract breach of warranty guarantee or condition strict liability negligence or other tort to the extent permitted by applicable law e Company or
30. is software 8 HIGH RISK ACTIVITIES The software is not fault tolerant and is not designed manufactured or intended for any use requiring fail safe performance in which the failure of the software could lead to death serious personal injury or severe physical and environmental damage High Risk Activities such as the operation of aircraft or nuclear facilities You agree not to use or license the use of the software in connection with any High Risk Activities Company customized this software and is responsible for how it operates 9 Entire Agreement This agreement and the terms for supplements updates Internet based services and support services that you use are the entire agreement for the software and support services 10 Applicable Law United States If you acquired the software in the United States Washington state law governs the interpretation of this agreement and applies to claims for breach of it regardless of conflict of laws principles The laws of the state where you live govern all other claims including claims under state consumer protection laws unfair competition laws and in tort Outside the United States If you acquired the software in any other country the laws of that country apply 11 Legal Effect This agreement describes certain legal rights You may have other rights under the laws of your country You may also have rights with respect to the party from whom you acquired the software This agreem
31. ist of or contains third party software distributed by Emtrion in altered or unaltered form The use of such Software may be further restricted by additional terms and conditions hereinafter also Third Parties License Rights with priority to the terms set out herein Licence Agreements 49 VI ADDITIONAL RESTRICTION ON USE THE OBJECT CODE SOURCE CODE AND THIRD PARTY MATERIALS ARE NOT FAULT TOLERANT AND ARE NOT DESIGNED MANUFACTURED OR INTENDED FOR USE OR RESALE AS ONLINE CONTROL EQUIPMENT IN HAZARDOUS ENVIRONMENTS REQUIRING FAIL SAFE PERFORMANCE SUCH AS IN THE OPERATION OF NUCLEAR FACILITIES AIRCRAFT NAVIGATION OR COMMUNICATION SYSTEMS AIR TRAFFIC CONTROL DIRECT LIFE SUPPORT MACHINES OR WEAPONS SYSTEMS IN WHICH THE FAILURE OF THE OBJECT CODE SOURCE CODE AND THIRD PARTY MATERIALS COULD LEAD DIRECTLY TO DEATH PERSONAL INJURY OR SEVERE PHYSICAL OR ENVIRONMENTAL DAMAGE Confidentiality Restrictions Restrictions Without limiting and in addition to the use restrictions under Sect Il and Sect III above all Confidential Information delivered pursuant to this agreement shall a be used by Customer for the Purpose and subject to Section Il above only and b be treated by Customer with the same degree of care to avoid unauthorized disclosure to any third party as with respect to Customer s own confidential information of like importance but with no less than the degree of care described in this agreement and c not be distrib
32. itten documentation e is approved for release by written agreement of Emtrion f is required to be disclosed to comply with legal mandatory regulations a judicial or official order or decree provided that written advance notice of such judicial action was timely given to Emtrion Prohibition on Development of Competing Products Customer shall at no time during the term of this agreement and hereafter for a tem of five 5 years use Confidential Information for the purpose of developing or distributing products which are competing with Emtrion s Hardware as a stand alone product WARRANTIES Emtrion makes no warranties either express or implied with respect to the object code or source code or with respect to Software or other products or intellectual property obtained from Third Parties Emtrion expressly disclaims any such warranties including but not limited to the implied warranties of merchantability and fitness for a particular purpose Licence Agreements 50
33. n Flash Ethernet controller sto in SDRAM and ei With item 1 the currently stored image can be executed manually The image will be first copied from NAND to RAM and is then started With item 4 and 5 an image can be downloaded via tftp and either stored to the NAND or to the RAM The name ofthe image is defined by the environment variable wimg of the bootloader The name ofthe image for this Developer Kit is setto wce hico7723 Choose item 6 the extended menu gets open higher self test an WinCE Per t Return to main menu Quit and return to command prompt With item 2 you can manually clean the Persistent Registry of WINCE This should always be done at anytime before downloading the WINCE Image 13 6 Getto the bootloader prompt q From the second menu you can change to the bootloader prompt by choosing the item q B x or higher Return to main r At this prompt level you can executing all the commands of the bootloader looking how the environment variables of the bootloader are defined to by the command printenv setting environment variables like for networking booting and so on Serial Ports 37 To get back to the menu ofthe bootloader enter the command bootmenu at the prompt 13 7 Changing the display The kernel just supports two displays TFT 640x480 16bpp Name for display NEC NL6448BC20 NL6448 TFT 320x240 16bpp Name for display TX14D1
34. ootloader can be serviced through a terminal running on a host For it the hosthas to be connected to the serial port UART Aat the target 13 1 Location of the bootloader The bootloader is located in the lower address area of the NOR Flash and starts running at power ON or a reset At this point the bootloader is evaluating the environment variable bootemd which is set to the command bootmenu However the work of the bootloader is dependent on the mode he is configured 13 2 Communication settings The bootloaders communication settings are Baudrate 115200bps Data bits 8 Stop bits 1 Parity none Handshake none 13 3 Console mode In console mode the bootmenu is putting out via the serial port UART A To configure the bootloader for using the console the switch SW1 4 has to be turned off on DIMM SH7723 DIP Switch SW1 for console mode 4 3 2 1 of B x x x on 13 4 Boot mode In boot mode the bootloader doesn t make any output to the serial port UART A But due to the boot mode item 1 ofthe bootmenu is launched and the stored image is executed The bootmode is active when switch SW1 4 is turned on DIP Switch SW1 for boot mode 4 3 2 1 off X X X on A 13 5 Bootmenu When the bootloader is set for console and the target is connected to the host where a terminal is running the bootloader is putting out a menu after power ON or a reset The Bootloader 36 r higher Ethernet controller and store i
35. pt these terms If you do not accept them do not use the software Instead contact Company www emtrion com to determine its return policy If you comply with these license terms you have the rights below 1 INSTALLATION AND USE RIGHTS You may install and use one copy of the software on each computer on your premises to design develop test and demonstrate your programs running validly licensed copies of Microsoft Visual Studio 2005 Team Suite Visual Studio 2005 Team Edition for Software Architects Visual Studio 2005 Team Edition for Software Developers Visual Studio 2005 Team Edition for Software Testers Visual Studio 2005 Professional Edition Visual Studio 2005 Tools for the Microsoft Office System or Visual Studio 2005 Standard Edition including evaluation versions 2 SPEECH RECOGNITION If the software includes speech recognition component s you understand that speech recognition is an inherently statistical process and that recognition errors are inherent in the process Neither Company nor Microsoft or their suppliers shall be liable for any damages arising out of errors in the speech recognition process 3 SCOPE OF LICENSE The software is licensed not sold This agreement only gives you some rights to use the software Company and Microsoft reserve all other rights Unless applicable law gives you more rights despite this limitation you may use the software only as expressly permitted in this agreement In doing do you must
36. r hostor any software you are already using In the terminal setting window set the communication protocol as follows 1 Use the supplied serial cable to connect serial port COM1 on the target to the host 2 Startthe terminal software on the host and make the settings following below Baudrate 115200 bps gt Data length 8 bits Parity None gt Stop bit 1 gt Flow control None Setting up the host XS PuTTY Configuration CR Session Y Terminal E Window 11 Setting up the target 12 5 Setting up the target This Developer Kit is delivered with the core module DIMM SH7723 and dependent on the scope ofthe delivery with one of the two available HiCO DIMM base boards To make a fast operation possible the target is already assembled For developing purpose only a few steps are necessary Please note that everything is discharged when touching the target 5 1 Setting up for application development There are only two steps to do Connect the targetto the host via the supplied USB cable A B to allow a Microsoft ActiveSync connection The USB B type connector is located at the front of the target Usethe Ethernet cable to connectthe target to the network where the hostis linked to 5 2 Setting up for updating the image Configure the bootloader at the target for using the console For it turn off the switch SW1 4 on DIMM SH7723 DIP Switch SW1 4 3 2 1 of B x x x on Connec
37. rial Ports 38 The relationship between the names and serial ports from the hardware and software point of view and some more supported features are summarised in the table below Channel SCIF1 SCIF2 SCIF3 SCIF4 SCIF5 interface SCIF SCIFA SCIFA SCIFA HiCO DIMM Base UART x UART E UART D UART A Connector pin header pin header D Sub J15 J15 bottom HiCO DIMM ECOBase UART x UART E UART D Connector on pin header pin header J12 J12 HW Handshake Hardware Flow Control HW FiFo Receive 16Byte 16Byte 64Byte 64Byte 64Byte Transmit 64Byte 64Byte Baudrates 1200 2400 4800 9600 14400 19200 38400 57600 115200 gt 115200 Suitable RS232 adapters are available by emtrion For more details please refer to the corresponding HW manual Only on request All the serial ports can be accessed by the WIN32 API of WINCE But with the debug version of the Developer Kit kernel COMI is reserved for debug purpose PC Bus Driver 15 PC Bus Driver 15 1 General Information 39 PC Bus Driver 40 The processor module DIMM SH7723 has one PC bus The bus is available on the HiCO DIMM connector Dependent on the base board from emtrion the bus is routed to J17 on the HiCO DIMM Base or to J4 on the HiCO DIMM ECOBase The I2C bus is running at 100KHz and several devices are already connected to it such as RTC touch controller and the audio codec Their device addresses are 0x68 0x48 and O
38. rmation call GetLastError function and look for identifying the error atthe table below 15 3 4 WriteFile WriteFile writes data through I2C Before writing to the device be sure the corresponding device address has beensetbylOCTL I2CBUS SETADDRESS first Proto BOOL WriteFile hl2cDrv IpBuf nNumberOfBytes ToWrite IpNumberOfBytes Write NULL Parameters hl2cDrv IIC driver handle created by CreateFile IpBuf Pointer to the buffer containing the data to write through I2C nNumberOfBytes ToWrite Number of bytes to write through I2C IpNumberOfBytesRead Pointer to the number of bytes written Return value PC Bus Driver 44 Nonzero indicates success Zeros indicates failure To get extended error information call GetLastError function and look for identifying the error at the table below 15 3 5 CloseHandle This API closes the I2C handle Proto BOOL CloseHandle HANDLE hl2cDrv Parameters hl2cDrv IIC driver handle created by CreateFile Return value Nonzero indicates success Zeros indicates failure To get extended error information call GetL astError function function and look for identifying the error at the table below 15 3 6 Error Codes In this section the driver errors are listed that can be occurred during processing the API Error Code Value Description ERROR INVALID HANDLE ffffffffh The handle hl2cDrvis not valid ERROR ACCESS DENIED 00000005h The handle has no access permission for
39. ry for writing applications Mainly a kernel and its associated SDK with a typical set of components are available Itis based on rich experiences with different customer specific kemels and so it is suitable for the most applications The kernel is a GUI based kernel The details of the kernel are depicted in latter chapters Anyway if the kernel doesn t nt to the applications needs there are two possibilities to fix this problem The first one is that the customer purchases a SYSDeveloper Kit and does all the modifications of the BSP by means of the MS Platform Builder by himself or he asks emtrion GmbH to do this work for him The following chapters of this documentation give a brief overview about all what is good to know when starting writing applications for emtrion s DIMM SH7723 Parts of the following chapters are excerpts of the documents which are part of the Developer Kit packages Important The kernels coming with this package are not licensed and have a limited live time You can use them for demonstration tests and application development If you need a kernel for your series production it is mandatory to activate the kernel by emtrion Gm bH and to have a license from Microsoft for each CPU on which this kernel is running Please contact emtrion GmbH about the details of licensing and on how to get such licenses from Microsoft DVD of the ADK 8 2 DVD of the ADK The content of the DVD is tailored for application development an
40. s executed on the target device 22 Starting an application at system start 23 8 Starting an application at system start There are two options to start an application atstart up Using only one option is allowed at any time In any case the execution ofthe explorer is controlled by emtrion s autostart mechanism described in the section below This means no launch entry may be existed in the registry for the explorer To use the autostart functionality the registry must be modified For it you can use the remote Registry Editor of VS2005 Making the changes persistent the emtrion tool WriteReg exe is available Additional items have to be considered when you wantto realise starting your application at system start Folderstructures and shortcuts get lost at power off or reset when it have been created at runtime The same as above happens with files that have been copied to the object store of the kernel Changes to the registry also getting lost when it have not been made persistent Due to supporting autostart of applications from a storage device the kernel is configured with search paths of any supported storage device Dependent on the supported storage devices ofthe Developer Kit the storage folders are specified as following ASD Card for storage device microSD or SD Card MultiMediaCard for storage device MMC AMHard Disk for storage device USB stick AFlashDisk for storage device flash ANAND Flash for
41. stablished between the target and desktop you should start the repllog program on the target manually To do this select Run from the Start menu then enter repllog and click the OK button The New Partnership dialog appears on the desktop computer e Selectthe options as described in section Remarks on Using ActiveSync e After establishing a connection click Explore to open a window Via this window you may then exchange files with the target using drag and drop For this drag the files onto the desired directory on the target Note Data Exchange between Target and Workstation 27 The folders ofthe kernel and their contents are created when Windows CE is starting If you copy any files to these folders they are not available any more when Windows CE is restarted again This does not apply to folders and files which are directly located at mass storages like the AFlashDisk or the SD Cara These folders are available only if the corresponding devices are detected in the system during the start up phase The subfolders ofthe Network folder are a special case These folders represent drives when a connection via network was established To terminate the connection click the ES symbol on the Windows CE s task bar The connection can be detached in the dialog that appears Another easy way to stop ActiveSync is just to unplug the USB cable 9 4 Remarks on Using ActiveSync After installing Acti veSync ther
42. stry 32 11 Persistent Registry By default Microsofts Windows Embedded CE does not support a persistent registry That is all modifications made to the registry while Windows CE is running will not be kept when Windows CE is restarted To permanently keep these modifications two functions are available which have to be implemented by the hardware manufacturer These functions are already implemented in the kemel They will be called by the operating system in order to write the registry onto the Flash in the last 512 kBytes Note Systems with a non persistent registry have the advantage that a system cannot be damaged due to possibly wrong registry settings made while the system is running In order to have the registry write to the flash disk the RegFlushKey function must be called by the application However this function should not be called after each modification to avoid performance bottlenecks Call this function after having made several changes to the registry The Developer Kits operating system kernels include a tool called WriteReg exe This tool calls the RegFlushKey function to make the desired changes For example it can be used for system modifications that are to be kept pemanently writereg default sets the registry to its default values this means that all changes are lost and the settings of the default registry are used A programming sample HKEY hRegKey DWORD retWert open the registry key
43. t the target to the host via the serial cable Use the 9 pin D Sub jack of serial port UART Aat the target Power ON or reset the target When a terminal program is running on the host the bootloader outputs the following menu gf COMI PuTTY Make a physical Ethernet connection like in application development above Set the network environment variables to your requirements like dhcp or ipaddr and netmask Assign the IP address of the TFTP server to serverip The settings have to be made at the level of the bootloader prompt Get to the bootloader prompt BSP contents 13 6 BSP contents This chapter describes briefly the contents of the kernel delivered by CD or available online at our support site The kernel is a typical one that should be suitable for most of the applications If modifications are necessary you may consider purchasing a SYS Developer Kit from emtrion or just asking emtrion to design an individual kernel for your needs 6 1 Applications End User Active Sync File Sync CAB File Installer Uninstaller NET Compact Framework 2 0 STs Active Template Library ATL C Runtime Support for Exception Handlind and Runtime Type Information E El R CRmime H SemadlO SIDO Standard VOASCI STDIOA StndadSHmgFundons ASCI COM and DCOM DcOMmdCOMSbag HHE Minimal COM No OLE Support EE Sting Safe UtliyFunctions x p X XML Core
44. tomer certain Software to be run as embedded software on hardware boards hereinafter the Software subject to Emtrion s Terms and Conditions l Definitions 1 Software shall mean the operating software to be embedded into the Hardware including any documentation hereto 2 Confidential Information shall mean any information know how and data owned or controlled by Emtrion or by Third Parties license Rights Il Limited Use Rights With respect to Software Customer is granted a non exclusive non transferable non sub licensable worldwide license to use or have used the Software for validating or testing Against an extra fee and an advanced EULA Customer can use Software for projects Customer shall not and shall prevent others from doing so copy translate modify create derivative works disassemble reverse engineer decompile or otherwise use the Software except as specifically authorized hereunder in this item or except provided otherwise by compulsory law Whenever compulsory law permits the above actions Recipient shall in any case i inform Emtrion of these actions in advance and ii request support of Emtrion which Emtrion may offer against reasonable consideration All rights granted to Software hereunder shall only apply to the code format to be provided as agreed upon which is if not explicitly agreed upon otherwise solely the binary code to the Software Customer is aware that Software may cons
45. uted disclosed or disseminated in any way or form by Customer to anyone except its own employees who have a reasonable need to know such Confidential Information with respect to the Purpose and who are bound to confidentiality by written agreements not less stringent than under the obligations of this agreement and d be stored in secure areas only that are protected against unauthorized access and are regularly monitored to assure their sufficient security e be treated by Customer in compliance with any additional security guidelines the parties may agree Exceptions The obligations as per Sect IV 1 above shall not apply to any information which the Customer can prove a is at the time of disclosure already in the public domain or becomes available to the public through no breach by the Customer of this agreement except that Confidential Information shall not be deemed to be in the public domain merely because any part of the Confidential Information is embodied in general disclosures or because individual features components or combinations thereof are now or become known to the public b is received by the Customer from a third party free to lawfully disclose such information to Customer c was in the Customer s lawful possession prior to receipt from the Discloser as evidenced by written documentation d is independently developed by the Customer without the benefit of any of the Confidential Information as evidenced by wr
46. vice address to the open context of the specified driver handle Proto BOOL DeviceloControl hl2cDrv IOCTL I2CBUS SETADDRESS IpInBuf 6 NULL 0 NULL NULL Parameters hl2cDrv IIC driver handle created by CreateFile IpinBuf Pointer to the buffer that passes the device address to the driver as follows Description Device address only 7bit addresses allowed Reserved for future use set to O Return value If returns TRUE the IOCTL was successfully processed otherwise returns FALSE To obtain extended error information call GetLastError function function and look for identifying the error atth e table below PC Bus Driver 42 15 3 2 2 IOCTL I2CBUS READWRITE The API performs either only writing or writing and reading to an IIC address In the case of writing and reading the function is executed as repeated start condition Proto BOOL DeviceloControl hl2cDrv IOCTL I2CBUS READWRITE IpInBuf inLen IpOutBuf outLen IpBytes Retruned NULL Parameters hl2cDrv WC driver handle created by CreateFile IpinBuf The in buffer comprises the structure sI2CControlln and passes the information to the driver as follows typedef struct I2CControlln WORD wAddress DWORD dwFlags BYTE bNumberOfBytesToRead BYTE bNumberOfBytesToWrite BYTE bData sI2CControlln psl2 CControlln Structure element Description wAddress Device address only 7bit addresses allowed dwFlags Reserved for future us
47. x1b Theyare serviced bythe kernel s I2C interface For supporting additional devices the kernel s I2C interface is extended to a Stream Interface one 15 2 Implementation The driver has been implemented as Stream Interface driver and is included to the kernel The user is thus able to serve the interface similar to a serial interface with the Win32 API functions CreateFile ReadFile WriteFile CloseHandle and DeviceloControl As a prefix for the interface IIC is used instead of COM The interface IICO may be opened several times This is useful when several components on the PC bus are to be accessed The application thus gets various handles on the interface which allows the access of different devices 15 3 API 15 3 1 CreateFile Create and return a handle for DC driver Proto HANDLE CreateFile TEXT IICO GENERIC_READ GENERIC_WRITE 0 NULL OPEN_EXISTING FILE_ATTRIBUTE_NORMAL NULL Parameters Return value Ahandle of IIC driver is returned if the function is successfully processed otherwise NULL is retumed To obtain extended error information call GetLastError function PC Bus Driver 41 15 3 2 DeviceloControl The following IO Codes are supported by the driver IOCTL code Value Description IOCTL I2CBUS SETADDRESS 08002000h Sets the device address IOCTL I2CBUS READWRITE 08002004h Reads and writes to the specified device 15 3 2 1 IOCTL I2CBUS SETADDRESS The API sets the de
48. xplorer Setting this bit the explorer will be started in any case Setting this bit when the kernel is a headless one Due to no graphic exists the console is started instead Reserved for future extensions A further entry is Timeout On that you can specify the time between two consecutive WaitCycles The type of Timeoutis REG DWORD 8 2 Autostart with launchXX and dependXX Setting this bit the explorer is started when the custom application cannot be started This section describes how you can modify the kernel in order to start your application atsystem start by the two registry entries launchXX and dependXX Using this option be sure the registry key CustomerApp in Emtrion s autostart mechanism is empty In the case of using the explorer by the kernel the registry ke y FailureOptions has to be set to 00000020h for execution The application and its own DLLs that shall be started have to be stored in one of the supported storage devices e Here are the settings to do on the registry key HKEY LOCAL MACHINEVnit e Entry 1 Name LaunchXX where XX stands for a two digit number This number must be between 51 and 99 with the operating system kernel belonging to the starter kit kernel Type REG SZ Value Name ofthe file that shall be executed e Entry2 Name DependXX where XX must be the same two digit number as specified with entry 1 Type REG BINARY Value Hexadecimal digits thatspedfy the dependency on
49. y established After clicking the Finish button the ActiveSync program will open on your desktop Microsoft ActiveSync WM rri Connected Synchronized The connection has been established Data transfer Clicking the Explore button will bring up a window where you can search the Windows CE computer Data Exchange between Target and Workstation 30 The data exchange between the Windows CE computer and the desktop computer can be initiated by dragging a file from the window to another window that does not belong to Acti veSync or vice versa Multimedia sample applications 31 10 Multimedia sample applications To demonstrate the excellent multimedia characteristics of the SH7723 two sample applications have been included into the image Please consider that both applications require the HiCO DIMM Base 10 1 UMP 600 V2 exe This application is playing decoded video files of several formats What formats exactly and how to serve the application is described in the manual UMP User Developer Documentation 10 2 Videointest exe This application is capturing of video input like PAL NTSC or from digital interface The video input can be select v a command line parameter Default is set PAL By a second command line parameter you can demonstrate the influence of blending by HW or by SW More details about the application are described in section 4 of the CEU Driver User Documentation Persistent Regi

View - to emtrion`s Support Center

Contents

Download Pdf Manuals

Related Search

Related Contents