Embedded HMI SERIES Software Manual - Garz &...

24
Embedded HMI SERIES · Software Manual Microsoft Windows Embedded CE

Transcript of Embedded HMI SERIES Software Manual - Garz &...

Page 1: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual Microsoft Windows Embedded CE

Page 2: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

1 Important hints Thank you very much for purchasing a Garz & Fricke product. Our products are dedicated to professional use and therefore we suppose extended technical knowledge and practice in working with such products.

The information in this manual is subject to technical changes, particularly as a result of continuous product upgrades. Thus this manual only reflects the technical status of the products at the time of printing. Before design-in the device into your or your customer’s product, please verify that this document and the therein described specification is the latest revision and matches to the PCB version. We highly recommend contacting our technical sales team prior to any activity of that kind. A good way getting the latest information is to check the release notes of each product and/or service.Please refer to the chapter [Online Support]. The attached documentation does not entail any guarantee on the part of Garz & Fricke GmbH with respect to technical processes described in the manual or any product characteristics set out in the manual. We do not accept any liability for any printing errors or other inaccuracies in the manual unless it can be proven that we are aware of such errors or inaccuracies or that we are unaware of these as a result of gross negligence and Garz & Fricke has failed to eliminate these errors or inaccuracies for this reason. Garz & Fricke GmbH expressly informs that this manual only contains a general description of technical processes and instructions which may not be applicable in every individual case. In cases of doubt, please contact our technical sales team. In no event, Garz & Fricke is liable for any direct, indirect, special, incidental or consequential damages arising out of use or resulting from non-compliancy of therein conditions and precautions, even if advised of the possibility of such damages.

Before using a device covered by this document, please carefully read the related hardware manual and the quick guide, which contain important instructions and hints for connectors and setup.

Embedded systems are complex and sensitive electronic products. Please act carefully and ensure that only qualified personnel will handle and use the device at the stage of development. In the event of damage to the device caused by failure to observe the hints in this manual and on the device (especially the safety instructions), Garz & Fricke shall not be required to honour the warranty even during the warranty period and shall be exempted from the statutory accident liability obligation. Attempting to repair or modify the product also voids all warranty claims

Before contacting the Garz & Fricke support team, please try to help yourself by the means of this manual or any other documentation provided by Garz & Fricke or the related websites. If this does not help at all, please feel free to contact us or our partners as listed below. Our technicians and engineers will be glad to support you. Please note that beyond the support hours included in the Starter Kit, various support packages are available. To keep the pure product cost at a reasonable level, we have to charge support and consulting services per effort.

Shipping address:Garz & Fricke GmbH Tempowerkring 2 21079 Hamburg Germany

Support contact: Phone +49 (0) 40 / 791 899 - 30 Fax +49 (0) 40 / 791 899 – 39 Email [email protected] URL www.garz-fricke.com

© Copyright 2010 by Garz & Fricke GmbH. All rights are reserved. Copies of all or part of this manual or translations into a different language may only be made with the prior written approval.

2

Page 3: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

3

Content

1  Important hints 2 

2  Introduction of related hardware 4 2.1  Flash partition and registry location 4 

3  Operating system Microsoft Windows Embedded CE 5 3.1  OS release information 5 3.2  OS update information 5 

4  Services and utilities 6 4.1  Services 6 4.1.1  Autocopy 6 4.1.2  Autostart 6 4.1.3  FTP 7 4.1.4  Telnet 7 4.2  Utilities 8 4.2.1  DisableSerialConsole.exe 8 4.2.2  reset.exe 8 4.2.3  SaveReg.exe 8 4.2.4  EraseRegistry.exe 9 4.2.5  EraseFlash.exe 9 4.2.6  ShowVersion.exe 10 4.2.7  Disp.exe 10 4.2.8  DisableBootScript.exe 11 4.2.9  COM-Tool.exe 11 

5  Connecting the device to a workstation 12 5.1  The development workstation 12 5.1.1  Hardware recommendation 12 5.1.2  Software/operating system recommendation 12 5.1.3  SDK 12 5.2  Connecting the device via Microsoft ActiveSync (USB) 13 5.3  Connecting the unit via TCP/IP (Ethernet) 14 5.3.1  Device IP-address 14 5.3.2  Preparing the embedded HMI for TCP/IP debug connection 15 5.4  Setup the development environment 16 5.4.1  Setup the TCP/IP connection 16 5.4.2  Establish the connection 17 

6  Product specific information 18 6.1  Working with interfaces 18 6.1.1  Registry settings for RS-485 driver (COM3) 18 6.1.2  COM3 activation 18 6.1.3  COM3 duplex mode 18 

7  Securing the device 19 7.1  Default configuration (enabled services) 19 7.1.1  FTP 19 7.1.2  Telnet 19 7.1.3  Webserver 19 7.1.4  Garz & Fricke management protocol service 19 7.1.5  Garz & Fricke autojob (autocopy and autostart) 19 7.1.6  USB Devices 19 7.2  How to deactivate single services/features 20 7.2.1  How to disable or secure FTP 20 7.2.2  How to disable or secure Telnet 20 7.2.3  How to disable or secure webserver 20 7.2.4  How to disable the Garz & Fricke management protocol service 20 7.2.5  How to configure or disable the Garz & Fricke autojob) 20 7.2.6  How to secure the device 20 

8  Online support and related documents 21 8.1  Third party documents and helpful tools 21 

Annex A:  Trademarks and service marks 22 Annex B:  Document history 23 

Page 4: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

4

2 Introduction of related hardware This manual is valid for all versions of NESO LT, NESO and CUPID and thereon based customized variants:

NESO LT Product Name Order Codes

Starter Kit Product NESO LT core RS-485 - 10151 NESO LT core CAN - 10152 NESO LT 4.3 open frame RS-485 10127 10124 NESO LT 4.3 open frame CAN 10128 10137 NESO LT 4.3 boxed RS-485 10139 10136 NESO LT 4.3 boxed CAN 10140 10138

NESO Product Name Order Code

Starter Kit Product NESO core - 10114 NESO 5.7 basic - 10112 NESO 5.7 open frame 10109 10100 NESO 5.7 boxed 10102 10103 NESO 7.0 basic - 10113 NESO 7.0 open frame 10110 10101 NESO 7.0 boxed 10108 10105

CUPID Product Name Order Codes

Starter Kit Product CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID 5.7 boxed 10133 10131 CUPID 7.0 basic - - CUPID 7.0 open frame 10125 10117 CUPID 7.0 boxed 10126 10118

2.1 Flash partition and registry location The main functions and explanations will work for all above mentioned systems. During the development of your application you might face some slight differences in the file system.

Product Name (CPU Type) OS Release Flash Drive Partition Name Location of the Registry

NESO LT (i.MX25) 1.0 NAND Flash Registry NESO (i.MX27) < 1.9.0 NAND Flash NAND Flash NESO (i.MX27) ≥ 1.9.0 NAND Flash Registry CUPID (i.MX35) 1.3.0 FlashDisk SRAM

Page 5: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

5

3 Operating system Microsoft Windows Embedded CE If you have chosen Microsoft Windows Embedded CE as operating system, your Garz & Fricke device will be shipped either with a preinstalled Core or Professional licence. The Starter Kits are always shipped with the Professional version. For an explanation of the difference between both versions, please refer to [ 8.1 Third party documents and helpful tools], which contains a specific link to the Microsoft comparison table. 3.1 OS release information Usually, Garz & Fricke devices will be shipped with the latest OS release. In some cases, it might be possible that shortly after shipment a new OS will be released or – in case of larger productions – that a change within a running production is not recommended. We try to keep our existing customers informed about the latest OS revisions and will not ship devices with new OS without prior notice. Nevertheless it is recommended to check the product download area of our website for the related product, at least before planning and developing a new application. A list with links to these download areas is available in [ 8 Online support and related documents]. 3.2 OS update information Before updating an OS, it is recommended to contact the technical support of Garz & Fricke. Be aware that all failed modifications might cause a temporary breakdown, which can be repaired only by phone assistance. In worst case, the unit must be returned to Garz & Fricke for maintenance. For detailed instructions how to update the OS, please refer to the Garz & Fricke RedBoot manual, which is available on the website or the USB stick of the Starter Kit [ 8 Online support and related documents].

Page 6: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

4 Services and utilities The standard OS image provided by Garz & Fricke includes several useful services for flexible application handling. Some of them are just run-once services directly after the OS has been started, others are available permanently. 4.1 Services 4.1.1 Autocopy This service is executed after the OS has booted and when a storage medium has been inserted. This service provides a comfortable installation and/or update functionality as well as copy mechanism for specific files that are not included in the OS (e.g. for runtime libraries). Subfolders and files within a folder named “autocopy” on a USB stick, SD card or in the NAND flash will be copied to the root of the device resp. its equivalent targets. Non-existing folders will be created automatically.

Autocopy copies files and folders to the root path of the device resp. its subfolders.

Hint: It is also possible to use this mechanism to copy files from USB stick to SD card. In this case, within the autocopy folder on the USB stick a folder named “SD card” must be placed.

4.1.2 Autostart This service is executed after the OS has booted and when a storage medium has been inserted. It checks the NAND flash partition as well as the USB stick and SD-card for an existing autostart folder. All applications found therein will be executed.

Autojob executes applications in “Autostart” folders

To use this service, create an autostart folder on the storage medium or in the NAND flash partition. Copy your application into this folder.

Hint: Executables that have been copied to an autostart folder by the autocopy job will not be executed after copying.

Security Hint: Both services allow the external injection of executables via USB-stick or SD-card. Once, the executables have been copied to the system, the will be started on every reboot. This might be a security leak.

6

Page 7: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

4.1.3 FTP This service is available after OS boot. It enables a file transfer between the device and a workstation over Ethernet without ActiveSync. A proper network connection is required. [ 4.3.1 Device IP-Address]

Look up the current IP address of the device

The FTP connection via IP address is comfortable for fast file transfer

4.1.4 Telnet Telnet gives remote access to the device via a console e.g. to execute applications or utilities directly on the device. Also for this service, a proper network connection is required. [ 4.3.1 Device IP-Address]

After proper connection, the console is available

7

Page 8: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

4.2 Utilities 4.2.1 DisableSerialConsole.exe By default, the serial interface is configured as debug console. This enables also the RedBoot functionality via terminal console. The documentation is delivered separately as GF_RedBoot_User_Manual_rNN.pdf. In this mode, it is not available as serial interface. To switch between both modes, please use the tool that is located in My Device\Windows\DisableSerialconsole.exe

Select YES to operate the COM port as serial interface Output on a serial terminal for debugging

To disable the serial debug output means to operate the COM1 as serial interface. After changing the mode, a reset is required. You can either use the hardware reset button or the utility in the same folder

My Device\Windows\reset.exe

This tool can also be executed via Telnet or called by custom application without a GUI dialog box. Command line: disableserialconsole.exe [-yes|-no]

After that, the COM1 is ready for use as serial interface. To turn on the debug messages again, repeat the procedure with “No”. 4.2.2 reset.exe This tool executes a system reset.

My Device\Windows\reset.exe 4.2.3 SaveReg.exe All changes performed regarding system settings (backlight, power management, desktop, taskbar etc.) will be erased upon the next system boot. If they have to be kept persistent, the registry must be saved before the next power-cycle. This can be done via GUI or by command line.

My Device\Windows\SaveReg.exe

Select OK to save the new settings.

This tool can also be executed via Telnet or called by custom application without a GUI popup. Command line: savereg.exe [-n|-s] -n: perform saving without GUI dialog box. -s: silent mode, without output

8

Page 9: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

4.2.4 EraseRegistry.exe This tool configures whether the registry will be erased on the next boot of the OS. My Device\Windows\EraseRegistry.exe

Select YES to clean the registry to default values

This tool can also be executed via Telnet or called by custom application without a GUI dialog box. Command line: eraseregistry.exe [-yes|-no]

Errata: Currently, the flag will not be reset after the next boot. So the tool has to be executed again, with “No” [or by command line: -no]. This bug is known and will be fixed.

4.2.5 EraseFlash.exe This tool configures whether the flash disk partition either “NAND Flash” or “FlashDisk” will be erased on the next boot of the OS. After the next boot, the flag will be reset to default, i.e. “no”, to keep the flash disk partition persistent. My Device\Windows\EraseFlash.exe

Select YES to erase the flash drive and registry on next reboot

This tool can also be executed via Telnet or called by custom application without a GUI dialog box. Command line: eraseflash.exe [-yes|-no]

Important: This command erases all data on the “NAND Flash” or “FlashDisk” partition. For devices, where the registry is stored as hidden file onto the flash drive, the customized settings within the registry will be deleted on next reboot! Please see [ 2.1 Flash Partition and Registry Location]

9

Page 10: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

4.2.6 ShowVersion.exe In case that you need support by email or via phone, you might be asked to quote your current versions. This tool will help you to display current versions and driver information. You can also save the information to a file and send it to our support team.

My Device\Windows\ShowVersion.exe

For example, this tool displays the current OS version

4.2.7 Disp.exe In case, the device is not installed in 12 o’clock (0°) view, the screen orientation can be changed. For example, the device is turned into vertical position by 90° clock wise (pls. compare below illustration). In this case, the screen must be adopted by a 90° turn counter clockwise.

My Device\Windows\disp.exe

Default display settings 0° = 0

Display settings = 1: Screen rotation by 90° counter clockwise

Hint: This tool can only be executed by command-line or via Telnet without a GUI dialog box. Command line: disp.exe -r [0=0°|1=90°|2=180°|4=270°] All angles/rotations are to be understood as counter clockwise and base on the 0° (12 o’clock) default value (not on the current setting).

After execution of disp.exe, the touch area will rotate immediately, whilst the OS needs to be rebooted. In this condition a proper control of the unit via touch screen is almost impossible. Thus we recommend executing a reset directly after display rotation.

10

Page 11: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

4.2.8 DisableBootScript.exe Garz & Fricke devices are equipped with RedBoot functionality. The boot loader executes a boot script that can be customized. The default functionality of the boot script is just to load and to start the OS. One of the standard purposes of disabling the boot script is to update the OS. The documentation is delivered separately as [ GF_RedBoot_User_Manual_rNN.pdf]

My Device\Windows\DisableBootScript.exe

Select YES to disable the boot script. Disabling boot script will cause the device to stop in RedBoot

This tool can also be executed via Telnet or called by custom application without a GUI dialog box. Command line: disablebootscript.exe [-yes|-no]

Important: The device will not start the OS and stop in RedBoot mode until the boot script has been reactivated. The device can only be controlled via a serial debug console and/or via Telnet over TCP/IP. How to reactivate, please see [ GF_RedBoot_User_Manual_rNN.pdf] We recommend not playing around with this feature unless knowing what to do.

4.2.9 COM-Tool.exe This utility is a small Windows CE application for testing the serial interface. Before use, you should disable the debug output. [ 3.2.1 DisableSerialConsole.exe] It is also possible to send a text string repeatedly for a defined period (in ms).

My Device\Windows\COM-tool.exe

The tool can send the given text repeatedly for testing the serial connection

11

Page 12: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

5 Connecting the device to a workstation The most convenient way to establish a connection to the embedded HMI is made by USB. For this connection type, Microsoft Active Sync is required. Once you have installed it, your Windows XP based workstation will detect the new USB device automatically as Windows CE USB device. Please connect the unit to the PC by USB cable. The detection process will start immediately.

For standard file operations, you may use the workstation Explorer

5.1 The development workstation The development environment varies due to individual requirements. The following lineup makes no claim to be complete, but we suppose it to be practicable for most common requirements. Except as noted otherwise, the mentioned parts are not part of the delivery by Garz & Fricke. 5.1.1 Hardware recommendation

x86 architecture 2.2 GHz CPU or better Min. 512 MB RAM Typ. 80 GB free HDD space Monitor and video card with SXGA resolution (1280 x 1024) 10/100 MBit/s Ethernet (directly, or via switch) RS-232 serial interface USB port

5.1.2 Software/operating system recommendation Microsoft Windows XP Professional or Windows 2000 Professional (SP6) Microsoft ActiveSync 4.1 or higher For application development an adequate software environment is needed, such as Microsoft Embedded Visual C++ 4.0 with SP3, or Microsoft Visual Studio 2005/2008 or higher For operation system development, some more applications are essential: Microsoft Windows CE Platform Builder 6.0 All available hotfix packages (QFE) installed. 5.1.3 SDK The installation of our SDK is not a must. It just offers a simple and convenient help to set up project environments. You will find the SDK installer on the companion USB stick. We update the content on the USB stick before shipment. Nevertheless, we recommend regularly checks for latest support files on our website.

12

Page 13: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

5.2 Connecting the device via Microsoft ActiveSync (USB) Using Microsoft ActiveSync for the communication between the embedded system and PC requires prior software installation. You may find the current version on the Microsoft homepage. After connecting the unit to the PC, Microsoft ActiveSync will automatically start to establish a connection to the embedded system. Please follow the instructions.

Select the preferred setup. For this document, we selected Ja Select Ja to establish a 1:1 relationship

Deselect all options, except “Dateien” This option will create a folder for file synchronisation

After successful setup, please click “Fertig stellen“ Microsoft ActiveSync should confirm the connected status

13

Page 14: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

14

5.3 Connecting the unit via TCP/IP (Ethernet) Using the TCP/IP connection requires some preparation on device side as well as on the workstation. Nevertheless, the integrated FTP service offers simple and fast file transfer over Ethernet. 5.3.1 Device IP-address Connect the unit to Ethernet and power adaptor. After booting, please check the current TCP/IP address management by clicking on the network icon on the right side of the task bar. The default setting is the static IP address 192.168.1.1. Please use the control panel to change the IP address manually or to enable DHCP mode.

Select “Network and Dial-Up Connections” Select “FEC1” and change to your preferred settings

When you are done, please close all open windows and check the success of the changes made:

We activate DHCP to receive a valid IP-address

The example shows DHCP enabled and current TCP/IP address as 172.20.2.252. This depends on your network environment. You might double-check the IP-address by sending a PING to it via the command shell on your workstation.

Page 15: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

5.3.2 Preparing the embedded HMI for TCP/IP debug connection By default, the incoming debug connection via TCP/IP is deactivated for security reasons. An open debug port allows access to almost all system functions. It is highly recommended to keep the debug ports closed when not in use. To active and allow the debug connection, you have to copy some files from your workstation onto the device. Typically, you will find the required files in the following path (which may vary) C:\Programme\Gemeinsame Dateien\Microsoft Shared\CoreCon\1.0\Target\wce400\armv4i

Open the folder as shown above and copy the selected files

Please mark and copy (Ctrl+C) these five files: clientshutdown.exe CMAccept.exe ConmanClient2.exe eDbgTL.dll TcpConnectionA.dll Open the device via FTP by using the Explorer. We recommend creating a folder tcpip in the NAND-Flash. Otherwise you have to copy the files after every re-start of the device. Paste the files (Ctrl+V) to the new folder tcpip on your device.

Access NESO via FTP Create a folder in NAND flash an paste the files into it

15

Page 16: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

5.4 Setup the development environment The steps for a proper setup of the development software may vary from case to case. Please find below a sample project setup within Microsoft Visual Studio 2008 Professional without using the SDK. With installed SDK, setup will be similar, but more convenient. 5.4.1 Setup the TCP/IP connection The first step is to setup the IP address of the device connection properties.

Choose “Optionen” from the “Extras” menu.

Select “Geräte” from “Gerätetools”, mark “Windows CE-Gerät” and click on “Eigenschaften”

Open the TCP/IP configuration mask and enter the current IP address of NESO

Confirm with OK and close all related windows.

Page 17: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

5.4.2 Establish the connection Before creating a new project, we recommend to check the proper connection configuration as per previous chapters [ 4.3.2 Preparing the embedded HMI for TCP/IP debug connection] and [ 4.4 Setup the development environment]. By default, the devices do not accept debug connections via TCP/IP. To enable this service, you have to start the connection client ConmanClient2.exe (after every reboot) and CMAccept.exe (before every new connection).

Please execute “CMAccept.exe“ and “ConmanClient2.exe“from the created tcpip folder.

Within a time frame of 3 minutes, the device will accept the access through Visual Studio. On failure, execute at least CMAccept.exe again. If you are not sure, whether the client ConmanClient2.exe is running, execute (re-)start it as well.

Select “Mit Gerät verbinden” from Extras menu.

Select “Windows CE Gerät” and press Verbinden After connecting the device, close the popup window.

After proper setup, the connection dialogue should confirm the successful connection.

17

Page 18: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

6 Product specific information 6.1 Working with interfaces 6.1.1 Registry settings for RS-485 driver (COM3) Besides the correct hardware settings for RS-485 termination and duplex mode, which are described in the hardware manual of each product, the correct mode has to be set in the registry of the device. These settings are important for the driver to work properly.

The two important keys are Half-Duplex and RS485

6.1.2 COM3 activation The RS-485 interface can be activated or deactivated. The registry key for activation is stored in

HKEY_LOCAL_MACHINE\Drivers\BuiltIn\COM3 Name Type Data (Dec) Function

RS485 REG_DWORD 0x00000000 (0) COM3 off 0x00000001 (1) COM3 on (default)

6.1.3 COM3 duplex mode The RS-485 interface can be operated in Full-Duplex or Half-Duplex mode (default). The mode is stored in

HKEY_LOCAL_MACHINE\Drivers\BuiltIn\COM3 Name Type Data (Dec) Function

HalfDuplex REG_DWORD 0x00000000 (0) Full-Duplex mode

(default value for NESO-LT, CUPID)

0x00000001 (1) Half-Duplex mode (default value for NESO)

Hint: It is required that the RTS handshake control signal is active. On that purpose the fRtsControl field in the dcb struct which holds information about the serial interface has to get the value RTS_CONTROL_TOGGLE. For more information see the Windows API. This is a workaround for .NET applications, where it is not possible to set this flag directly.

Name Type Data (Dec) Function

RtsToggle REG_DWORD 0x00000000 (0)

0x00000001 (1) Sets dcb to RTS_CONTROL_TOGGLE(default value for NESO)

Page 19: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

7 Securing the device The default configuration of the Garz & Fricke devices can be described as “developer friendly”. This means, all services are available and activated. In regard of the later appliance, this might be either helpful or a security risk. Once the development has been finalized, we recommend a review of the required services and to disable all services and features, which are not used.

Important Hint: For the following list of security risks, no claim of completeness can be made. There may arise other risks or – on the opposite – limitations in the design of your application by enabling or disabling single services.

7.1 Default configuration (enabled services) The following services/features are enabled by default. 7.1.1 FTP A password is not required for the login. Files might be deleted, manipulated or replaced. 7.1.2 Telnet A password is not required. Files might be deleted, manipulated or replaced. Together with the DisableBootScript.exe, experienced users might manipulate the device entire configuration. 7.1.3 Webserver 7.1.4 Garz & Fricke management protocol service This service is used by the Garz & Fricke DeviceControlCenter Software. A password is not required to receive, modify and delete the device configuration. 7.1.5 Garz & Fricke autojob (autocopy and autostart) Autocopy This service automatically copies files from/to certain folders after an external storage medium such as USB-stick or SD-card has been connected to the device. Existing files will be overwritten. [ 3.1.1 Autocopy] Autostart This service automatically runs executables in “autostart” folders on external storage media such as USB-stick or SD-card, once it has been connected to the device. [ 3.1.2 Autostart] 7.1.6 USB Devices Mouse and keyboard support is enabled.

19

Page 20: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

7.2 How to deactivate single services/features It is possible to disable single services. Whereas the Garz & Fricke services can be deactivated in the registry of Windows CE, for some of the Microsoft standard services the procedure might be more complicate. For example, to disable the USB support for mouse and keyboard, the Microsoft Platform Builder is required and a new ROM image must be created and uploaded to the device. 7.2.1 How to disable or secure FTP Please follow the Microsoft documentation at [ http://msdn.microsoft.com/en-us/library/ee500827.aspx] 7.2.2 How to disable or secure Telnet Please follow the Microsoft documentation at [ http://msdn.microsoft.com/en-us/library/ee501107.aspx] 7.2.3 How to disable or secure webserver Please follow the Microsoft documentation at [ http://msdn.microsoft.com/en-us/library/ee500332.aspx] 7.2.4 How to disable the Garz & Fricke management protocol service The registry key for activation is stored in

HKEY_LOCAL_MACHINE\Services\Discover (Type: REG_DWORD) Name Type Data (Dec) Function

Flags REG_DWORD 0x00000010 (0) Enabled (default) 0x00000004 (1) Disabled

7.2.5 How to configure or disable the Garz & Fricke autojob) Autocopy The registry keys for this service are stored in

HKEY_LOCAL_MACHINE\SOFTWARE\AutoJob\AutoCopyList By default, the service will scan all media (i.e. Flash drives, USB memory stick, SD card) for “autocopy” folders, for which no separate handling has been configured. To include or exclude single media from the global rule, a separate key must be generated, examples below. Name Type Data (Dec) Function

Default Enable REG_DWORD 0x00000001 (1) All media scan enabled (default) 0x00000000 (0) All media scan disabled

USB-MStick REG_DWORD 0x00000001 (1) Perform autocopy from USB-Stick 0x00000000 (0) Ignore autocopy on USB-Stick

SD-Card REG_DWORD 0x00000001 (1) Perform autocopy from SD card 0x00000000 (0) Ignore autocopy on SD card

NAND Flash REG_DWORD 0x00000001 (1) Perform autocopy from NAND Flash 0x00000000 (0) Ignore autocopy on NAND Flash

Hint: Both ways are possible: You can disable the global scan and activate the service for single media, or – vice versa – enable the global search and exclude medias from the autocopy scan. Please note, that on NESO and NESO-LT, the flash drive is named “NAND Flash”, on CUPID and LIVIUS “FlashDisk”

Autostart The registry keys for this service are stored in

HKEY_LOCAL_MACHINE\SOFTWARE\AutoJob\AutoStartList The functionality is exactly the same as explained before for the Autocopy service. 7.2.6 How to secure the device Please follow the Microsoft documentation at [ http://msdn.microsoft.com/en-us/library/ee498113.aspx]

Page 21: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

8 Online support and related documents Support for your Garz & Fricke embedded device is available on the Garz & Fricke website. You may find a list of the documents available, as well as their latest revision and updates for your system: Product Description NESO-LT Link to Garz & Fricke product website for updated documents

http://www.garz-fricke.com/nesolt-download

Here you will find helpful information such as pin assignment etc. Also on USB stick: NESO Hardware manual

NESO Link to Garz & Fricke product website for updated documents http://www.garz-fricke.com/neso-download

Here you will find helpful information such as pin assignment etc. Also on USB stick: NESO Hardware manual

CUPID

Link to Garz & Fricke product website for updated documents http://www.garz-fricke.com/cupid-download

Here you will find helpful information such as pin assignment etc. Also on USB stick: CUPID Hardware manual

General Here you will find the documentation on RedBoot, e.g. OS update, boot logo, etc. Also on USB stick: Garz & Fricke RedBoot Manual Also on USB stick: Garz & Fricke WindowsCE Manual Also on USB stick: Garz & Fricke Linux Manual

Garz & Fricke offer various support packages. Please refer to [ 1 Important hints] for contact data. 8.1 Third party documents and helpful tools Origin Description and Link Microsoft Comparison of the Windows Embedded CE Versions and their components:

http://www.microsoft.com/windowsembedded/en-us/products/windowsce/component-library.mspx

Microsoft Microsoft ActiveSync http://www.microsoft.com/downloads/details.aspx?FamilyID=9e641c34-6f7f-404d-

a04b-dc09f8141141&displaylang=de

SOTI Software to view and control embedded devices on a PC desktop, i.e. for screen capture, registry editor, command-line interface etc.

http://www.soti.net

Garz & Fricke is not responsible for the content of the above mentioned third party sources and/or information. We quote these sources just for your convenience.

21

Page 22: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

Annex A: Trademarks and service marks There are a number of proprietary logos, service marks, trademarks, slogans and product designations("Marks") used in this document. By making the Marks available in this document, Garz & Fricke GmbH is not granting you a license to use them in any fashion. The following Marks are the property of Garz & Fricke GmbH. This list is not comprehensive; the absence of a Mark from the list does not constitute a waiver of intellectual property rights established by Garz & Fricke GmbH in a Mark. AUCKLAND, ADELAIDE, CALLISTO, CUPID, GANYMED, Flash’nGo, JUPITER, NESO, NESO LT, related XY Starter Kits and subversions (XY “core”, “open frame”, “boxed”) are registered trademarks or products of Garz & Fricke GmbH, Hamburg. Other product or service names may be the property of third parties. Marks owned by third parties include thoselisted below. This list is not comprehensive; the absence of a Mark from the list does not constitute a waiver ofintellectual property rights established by the owner of a Mark. Freescale and the Freescale logo are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off. ARM is the registered trademark of ARM Limited. ARMWXYZ is the trademark of ARM Limited. Dolby Digital, Dolby Surround®, Pro Logic® and the double-D symbol are registered trademarks of Dolby Laboratories; Dolby Digital is manufactured under license from Dolby Laboratories. Java™ and all other Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. inthe United States and/or other countries.

eCosCentric and eCos are registered trademarks of eCosCentric Ltd. Microsoft, Windows, Windows Embedded CE, Windows NT, Visual Studio, Visual C++, Visual C#, MFC and Visual C++ are registered trademarks, trademarks or products of Microsoft Corporation in the United States and/or other countries. Sharp is a registered trademark of Sharp Electronics Europe GmbH. RedBoot is a registered trademark of Red Hat Inc.

Linux is a registered trademark of Linus Torvalds. Their use is subject to national and international laws and agreements. Every use of these names in thisdocumentation occurs subject to the legal regulations. While trademark symbols may be omitted for the purposeof simplification, they are implied when the names of the trademarks are used in the remainder of this documentand should be interpreted as present.

Page 23: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

23

Annex B: Document history Release/Date Title Description V1.0, 7.5.2009 Initial document release Beta release V1.1, 9.10.2009 Revised and completed First release V1.2, 24.04.2009 Revised Changed

from NESO specific to common Added CUPID series information

V1.3, 30.06.2010 Revised Added NESO LT series information TCP/IP connection details Device security Flash partition information

V1.3.1, 6.7.2010 Revised Added Windows CE release and update information

Page 24: Embedded HMI SERIES Software Manual - Garz & …support.garz-fricke.com/products/Cupid/Documentation/GF...CUPID core - 10129 CUPID 5.7 basic - - CUPID 5.7 open frame 10132 10130 CUPID

Embedded HMI SERIES · Software Manual

Art-

Nr.

902-

0217

©

Gar

z &

Fric

ke G

mbH