- Industrial & lab equipment
- Electrical equipment & supplies
- Korenix
- 8152 JetBox 8152
- User manual
- 101 Pages
Korenix 8152 JetBox 8152 JetBox User Manual
Below you will find brief information for 8152 JetBox 8152. The 8152 JetBox 8152 is a device with built-in Ethernet port and serial ports. It can be used for applications that require a small footprint, such as industrial controllers, communications hubs, and point-of-sale terminals. The 8152 JetBox 8152 is equipped with a variety of features, including a web server, FTP server, and Telnet server, which allow you to manage and monitor the device remotely.
advertisement
Assistant Bot
Need help? Our chatbot has already read the manual and is ready to assist you. Feel free to ask any questions about the device, but providing details will make the conversation more productive.
▼
Scroll to page 2
of
101
JetBox 8152 User Manual WinCE 5.0 www.korenix.com Copyright Notice Copyright© 2011 Korenix Technology Co., Ltd. All rights reserved. Reproduction without permission is prohibited. Information provided in this manual is intended to be accurate and reliable. However, the original manufacturer assumes no responsibility for its use, or for any infringements upon the rights of third parties that may result from its use. The material in this document is for product information only and is subject to change without notice. While reasonable efforts have been made in the preparation of this document to assure its accuracy, Korenix assumes no liabilities resulting from errors or omissions in this document, or from the use of the information contained herein. Korenix reserves the right to make changes in the product design without notice to its users. Acknowledgments Korenix is a registered trademark of Korenix Technology Co., Ltd. All other trademarks or registered marks in the manual belong to their respective manufacturers. Korenix | Table of Content 2 Table of Content Copyright Notice ................................................................................ 2 Acknowledgments.............................................................................. 2 Table of Content ............................................................................................... 3 Chapter 1 Introduction ................................................................................. 6 1-1 Applied Models .............................................................................. 6 Chapter 2 Software Specifications .............................................................. 7 2-1 Application – End User................................................................... 7 2-2 Applications and Services Development ........................................ 7 2-3 2-4 2-5 Communication Services and Networking ...................................... 9 Core OS Service .......................................................................... 13 Device Management .................................................................... 14 2-6 File System and Data Store ......................................................... 15 2-7 Graphics and Multimedia Technologies........................................ 15 2-8 Security ........................................................................................ 16 2-9 Shell and User Interface ............................................................... 17 2-10 Platform Manager ..................................................................... 18 Chapter 3 Software Feature ...................................................................... 19 3-1 Customized Control Applets ......................................................... 19 3-1-1 Overview ........................................................................... 19 3-1-2 Serial Port Throughput ...................................................... 19 3-1-3 Version Utilities .................................................................. 21 3-1-4 Canver Utilities .................................................................. 22 3-2 Customized System Utilities ......................................................... 23 3-2-1 Overview ........................................................................... 23 3-2-2 User manager Utility .......................................................... 23 3-2-3 Registry Flush Utility .......................................................... 24 3-2-4 Auto Run Utility.................................................................. 25 3-3 Telnet Server ................................................................................ 28 3-4 FTP Server ................................................................................... 30 3-5 Web Server .................................................................................. 33 3-6 File Server .................................................................................... 38 Chapter 4 Web-based Administration ........................................................ 41 Korenix | Table of Content 3 4-1 4-2 Overview ...................................................................................... 41 Remote Administration Page (RemoteAdmin) .............................. 41 4-2-1 Introduction........................................................................ 41 4-2-2 First use Setup Wizard ...................................................... 42 4-2-3 RemoteAdmin Home Page ................................................ 44 4-2-4 Device Management Pages .............................................. 46 4-3 Web Administration Page (WebAdmin) ........................................ 51 4-3-1 Introduction........................................................................ 51 4-3-2 4-3-3 4-3-4 4-3-5 4-3-6 4-4 WebAdmin Home Page ..................................................... 51 Instructions Page............................................................... 53 Logging Page .................................................................... 54 SSL Configuration Page .................................................... 56 Restart Web Server Page .................................................. 57 System Administration Page (SysAdmin) ..................................... 58 4-4-1 Introduction........................................................................ 58 4-4-2 SysAdmin Home Page ...................................................... 58 4-4-3 System Tools Page ............................................................ 59 4-4-4 File Browser Page ............................................................. 61 4-4-5 Registry Editor Page ......................................................... 62 Chapter 5 Connectivity Features ............................................................... 64 5-1 Overview ...................................................................................... 64 5-2 ActiveSync Connection ................................................................ 64 5-2-1 Introduction........................................................................ 64 5-2-2 Connection via COM port .................................................. 65 5-2-3 Explore JetBox .................................................................. 73 5-3 Manual Server Connection ........................................................... 74 5-3-1 Overview ........................................................................... 74 5-3-2 Configure Platform Manager ............................................. 74 5-3-3 Telnet with JetBox ............................................................. 76 5-3-4 Remote Tools via Manual Server Connection.................... 78 Chapter 6 Application Development .......................................................... 81 6-1 Overview ...................................................................................... 81 6-2 Install JetBox SDK ....................................................................... 81 6-3 Hello Word Application with eVC++ 4.0 ........................................ 86 6-4 Hello World Application with VS2005 ........................................... 92 Chapter 7 Appendix .................................................................................. 97 7-1 Table List ...................................................................................... 97 Korenix | Table of Content 4 7-2 7-3 7-4 Figure List .................................................................................... 98 Revision History ......................................................................... 101 Customer Service....................................................................... 101 Korenix | Table of Content 5 Chapter 1 Introduction Microsoft® Windows® CE 5.0 is an open, scalable, 32-bit operating system (OS) that integrates reliable, real time capabilities with advanced Windows technologies. Windows CE allows you to build a wide range of innovative, small footprint devices. A typical Windows CE–based device is designed for a specific use, which often runs disconnected from other computers, and requires a small OS that has a deterministic response to interrupts. Examples include enterprise tools, such as industrial controllers, communications hubs, and point-of-sale terminals, and consumer products, such as cameras, Internet appliances, and interactive appliances (HMI). 1-1 Applied Models JetBox 8152 Note: In WnCE5.0, the JetBox8152 did not provide the audio function because the audio chip vender did not support the driver for WinCE5.0. Korenix | Introduction 6 Chapter 2 Software Specifications 2-1 Application – End User Applications – End User Description ActiveSync This item provides support for synchronizing data between a Windows-based desktop computer and Microsoft® Windows® CE-based devices. CAB File Installer/Uninstaller This item includes an application that enables installing and uninstalling CAB files. This application is for use with devices that include a display. Table 1 Application – End User 2-2 Applications and Services Development Applications and Services Development Description .NET Compact Framework 1.0 The Microsoft® .NET Compact Framework 1.0 is a hardware-independent program execution environment for applications that target resource-constrained computing devices. This environment offers a choice of languages, Microsoft Visual Basic® and Microsoft Visual C#® , and lessens problems with language interoperability. .NET Compact Framework 2.0 SP2 The Microsoft® .NET Compact Framework 2.0 is a hardware-independent program execution environment for applications that target resource-constrained computing Korenix | Software Specifications 7 Applications and Services Development Description devices. This environment offers a choice of languages, Microsoft Visual Basic® and Microsoft Visual C#® , and lessens problems with language interoperability. Active Template Library Includes support for Active Template Library (ATL) for Windows CE. Microsoft Foundation Classes (MFC) MFC for Windows CE is a comprehensive class library and complete object-oriented application framework designed to help build applications, COM components, and controls. You can create anything from a simple dialog box–based application to a sophisticated application that uses the full MFC document or view architecture. C libraries and Runtimes Supports full ANSI C run time, compiler C++ exception handling equivalent to the desktop C++ compilers, compiler Run-Time Type Information (RTTI) equivalent to the desktop C++ compilers, the standard input/output library, the standard input/output ASCII library and the standard ASCII string functions. Component Object The Component Object Model (COM) is a Model (COM & DCOM) platform-independent, object-oriented system for creating binary software components that can interact with other COM-based components in the same process space, in other processes, or on remote devices. Message Queuing The Message Queuing implementation in (MSMQ) Microsoft® Windows® CE makes it possible for applications to communicate with other applications across networks and systems that might be temporarily offline. Korenix | Software Specifications 8 Applications and Services Development Description Object Exchange Protocol (OBEX) The Object Exchange Protocol (OBEX) technology for Microsoft® Windows® CE provides an efficient, compact binary protocol that enables a wide range of devices to exchange data spontaneously in a simple, efficient manner. SOAP Toolkit The client-side SOAP Toolkit functionality in Microsoft® Windows® CE allows an application to invoke Web service operations, while the server-side functionality maps invoked Web service operations to Component Object Model (COM) object method calls. SQL Server CE2.0 SQL Server CE extends Microsoft SQL Server to Microsoft Windows CE-based mobile devices. SQL Server CE delivers relational database functionality, including a data store, a query processor, and scalable connectivity capabilities, all in a small footprint. XML Extensible Markup Language (XML) is the universal format for data on the Web. XML allows developers to describe and deliver rich, structured data from any application in a standard, consistent way. XML does not replace HTML; rather, it is a complementary format. Table 2 Applications and Services Development 2-3 Communication Services and Networking Communication Services and Networking Description Korenix | Software Specifications 9 Communication Services and Networking Description Wired Local Area Network (802.3, 802.5) This item provides support for wired local area networks that use 802.3 and 802.5. Dial Up Networking (RAS/PPP) This item provides support for accessing network resources on a remote computer. Point-to-Point Protocol This item includes the ability to connect over Ethernet (PPPoE) hosts to a Remote Access Concentrator. Telephony API (TAPI 2.0) This item includes an API that simplifies and abstracts the details of making telephony connections between two or more devices. Virtual Private This Item includes a Layer Two Tunneling Networking (VPN) Protocol (L2TP)/IP Security Protocol (IPSec) implementation that enable a more secure virtual private network (VPN) connection to a server computer. This item includes a Point-to-Point Tunneling Protocol (PPTP) implementation that enables a virtual private network connection a server computer. Domain Discovery Domain Discovery for Microsoft® Windows® CE 5.0 enables a Windows CE device to discover an Active Directory server to query. Extensible The Extensible Authentication Protocol Authentication Protocol implementation in Microsoft® Windows® CE allows third-party authentication code to interact with the implementation of the Point-to-Point Protocol (PPP) included in the Windows CE–based Remote Access Service (RAS). The Extensible Authentication Protocol (EAP) is also used with 802.1x and EAP over LAN (EAPOL) authentication. Firewall The IP firewall is typically used on an Internet gateway device. It can also be used Korenix | Software Specifications 10 Communication Services and Networking Description as a host firewall. The firewall protects the device on which it runs and protects devices on the private side of the gateway. The firewall blocks IP traffic at the IP and transport layers. Internet Connection Sharing (ICS) Internet Connection Sharing (ICS) for Microsoft® Windows® CE consists of a collection of technologies and services that make it possible to connect multiple computing and information devices on a network located in a home, a small business, or a corporate branch office to the Internet through a single Internet connection. IPSec v4 IPSec v4 enables two client devices on a network to establish peer-to-peer communication using the IP Security (IPSec) protocol. This technology enables Windows CE-based devices to participate in networks that are secured by IPSec. NDIS Packet Capturing NDIS Packet Capturing captures network traffic so that it can be read by the Microsoft Windows Network Monitor (NetMon). Network Utilities The Network Utilities includes IPConfig, IPv6tun, NetStat, Ping, Route and Tracert that you can use to troubleshoot network connections in your Windows CE-based device. TCP/IP TCP/IP for Microsoft® Windows® CE allows devices to participate as peers and servers on local area networks (LANs) and remote networks. Windows Networking API/Redirector The Windows Networking API/Redirector (SMB/CIFS) implementation in Microsoft® Korenix | Software Specifications 11 Communication Services and Networking Description Windows® CE provides functions to establish and terminate network connections and to access files on servers supporting the Common Internet File System (CIFS). Access to this data is made possible by way of the networking API (WNet). Winsock Windows Sockets (Winsock) for Microsoft® Windows® CE specifies a programming interface based on the familiar socket interface from the University of California at Berkeley. It includes a set of extensions designed to take advantage of the message-driven nature of Windows CE. Windows CE .NET 4.1 and later supports Winsock 2.2, which provides easier access to multiple transport protocols. File Server The File Server functionality in Microsoft® Windows® CE enables clients to access files and other resources over the network. Ftp Server The FTP Server implementation in Microsoft® Windows® CE can copy files to and from remote computer systems over a network using TCP/IP. The source code is provided to you as is, so that you can customize the implementation for your specific requirements. SNTP Client and Server Windows CE supports the Simple Network Time Protocol (SNTP) technology. Telnet Server The Telnet Server functionality in Microsoft® Windows® CE provides a sample Telnet server can be installed on a device to allow remote administration through a standard Telnet client. Using the Korenix | Software Specifications 12 Communication Services and Networking Description Telnet sample, the current device can be manipulated as if it is running the command prompt on the device itself. Web Server The Web Server (HTTPD) implementation in Microsoft® Windows® CE enables you to monitor, configure, and remotely control a device or computer through the use of a Hypertext Transfer Protocol (HTTP) server. The Web server provides this service for network printers, scanners, and other shared equipment. Table 3 Communication Service and Networking 2-4 Core OS Service Core OS Services Description Kernel Features This item includes Fiber API, Format Message API, Memory Mapped Files, and Message Queue Point-to-Point. Device Drivers This item includes display, serial port, USB host, etc… drivers Device Manager Tracks all loaded device drivers and their interfaces, and issues notifications when device interfaces are added or removed. The Device Manager registers special file names with the kernel that do the following tasks: Map the stream interface functions Load and track drivers by reading and writing registry values Unload drivers when their devices are no longer needed PNP Notifications A functionality of the ―AdvertiseInterface‖ system. This functionality is automatically Korenix | Software Specifications 13 Core OS Services Description included if either Storage Manager or Device Manager is selected. Power Management A fully implemented Power Manager framework, including all APIs and features. Power Manager applications and drivers can do the following tasks: Suspend the system Control device power levels Register for notifications of power-related activities such as suspend, absence of user/system activity, and change in battery level. Drivers can intelligently self-manage power. USB Human Input Device (HID) Class A sample USB class driver that supports HID-compatible USB devices on a run-time Driver image. USB Printer Class Driver A sample USB class driver that supports USB printer-class-compatible devices on a run-time image. USB Remote NDIS Class Driver A sample USB class driver that supports Remote NDIS-compatible Ethernet adapters. USB Storage Class Driver A sample USB class driver that supports USB Storage-class compatible devices. Table 4 Core OS Service 2-5 Device Management Device Management Description Device Management Client Provides support for the Device Management Client in the run-time image. Simple Network Management Protocol Provides support for the Simple Network Management Protocol (SNMP) in the run-time image. Table 5 Device Management Korenix | Software Specifications 14 2-6 File System and Data Store File System and Data Store Description Bit-based Provides support for the Device Management Client in the run-time image. Compression Provides support for the Simple Network Management Protocol (SNMP) in the run-time image. Database support An API that provides built-in CEDB database support. Hive-based Registry A registry system that stores data inside files, or hives, which can be kept on any file system RAM and ROM File A file system driver capable of reading data System from the ROM file system and the RAM file system in the object store. Storage Manager The Storage Manager is responsible for all external storage items, such as file systems, file system filters, and partitioning System Password An API that provides support for authentication on a device to prevent unauthorized access. Table 6 File System and Data Store 2-7 Graphics and Multimedia Technologies Graphics and Multimedia Technologies Description Audio Supports Waveform audio. Graphics Supports Alphablend API, Direct3D Mobile, Direct Draw, and Gradient Fill. Imaging Support image decoders and encoders for BMP, GIF, ICO, JPG and PNG formats. Audio Codecs and Includes G.711 Audio Codec, GSM 6.10 Korenix | Software Specifications 15 Graphics and Multimedia Technologies Description Renderers Audio Codec, IMA ADPCM Audio Codec, MP3 Codec, MPEG-1 Layer 1 and 2 Audio Codec, MS ADPCM Audio Codec, Wave/AIFF/au/snd File Parser, Waveform Audio Renderer, WMA Codec and WMA Voice Codec. DirectShow Includes ACM Wrapper Filter, DirectShow Core, DirectShow Display, DirectShow Error Messages and DMO Wrapper Filter. Media Formats Includes AVI Filter and MPEG-1 Parser/Splitter. Video Codecs and Renderers Includes DirectShow Video Renderer, MPEG-1 Video Codes, MS RLE Video Codec, Overlay Mixer, Video/Image Compression Manager and WMV/MPEG-4 Video Codec. WMA and MP3 Local Playback This item provides support for playing Windows Media Audio (.wma) or MP3 files from local storage such as system memory or Compact Flash memory. This is an audio-only item and does not provide any video playback capabilities Table 7 Graphics and Multimedia Technologies 2-8 Security Security Description Authentication Services (SSPI) This catalog item includes support for a programming interface for user authentication, and message protection. Available authentication providers include NTLM, Kerberos, and Secure Sockets Layer (SSL). Each provider contains Korenix | Software Specifications 16 Security Description different authentication and cryptographic schemes. Credential Manager This item includes a service for caching credentials, and enabling the sharing of common credentials. Cryptography Services (CryptoAPI 1.0) This item includes a set of cryptographic services that provide basic cryptography support for hashing, encrypting, and decrypting data. Local Authentication Sub-System This item includes support for the Local Authentication subsystem (LASS) infrastructure that will enable application independent user authentication, provide consistent authentication regardless of the mechanism used, and enable policy-based authentication. Table 8 Security 2-9 Shell and User Interface Shell and User Interface Description Graphics, Windowing and Events Microsoft® Windows® CE combines the Microsoft Win32® application programming interface (API), user interface (UI), and graphics device interface (GDI) libraries into the Graphics, Windowing, and Events Subsystem (GWES) module (Gwes.exe). GWES is the interface between the user, your application, and the operating system (OS). GWES supports all the windows, dialog boxes, controls, menus, and resources that make up the Windows CE user interface (UI), which enables users to control applications. GWES also provides information to the user in the form of bitmaps, Korenix | Software Specifications 17 Shell and User Interface Description carets, cursors, text, and icons. Command Shell Command-line shell Standard Shell Similar to the Windows Explorer shell on Windows-based desktop operating systems. User Interface Includes Common Controls, Common Dialog, Control Panel Applets, Menu Tool Tip, Mouse, Network User Interface, Software Input and Panel. Table 9 Shell and User Interface 2-10 Platform Manager Platform Manager Description Platform Manager This item is a communications technology that manages the communications between a development workstation and a Microsoft® Windows® CE–based device. It allows development tools to download and connect to a target device in a media-independent manner. Remote tools, Microsoft eMbedded Visual C++® 4.0 and later, and the Microsoft .NET Compact Framework use Platform Manager to download files such as applications, Microsoft ActiveX® controls, run times, and remote-tool clients to a target device. Table 10 Platform Manager Korenix | Software Specifications 18 Chapter 3 Software Feature 3-1 Customized Control Applets 3-1-1 Overview Most of the customized device’s control utilities are implemented as the applets of the control panel. These utilities could help user to diagnostic the hardware functionalities. Following figure is the snapshot of the control panel of JetBox Figure 1 Snapshot of the Control Panel of JetBox 3-1-2 Serial Port Throughput The control applet named ―SerPerf‖ provides a simple user interface to test throughput of the serial ports. Loopback adapters or cables are necessary to Korenix | Software Feature 19 perform this test. Figure 2 is the configuration snapshot of the ―SerPerf‖ control. Figure 3 is the snapshot of the ―SerPerf‖ control panel under throughput testing. Table 11 describes the user interface of ―SerPerf‖. Note: the layout of the serial ports is platform dependent. Your system may be different with the following snapshot. In addition, COM4 is a virtual COM port for USB ActiveSync connection, so it can’t be tested. Figure 2 Configuration Snapshot of ―SerPerf‖ Control Applet Figure 3 Run Time Snapshot of ―SerPerf‖ Control Applet Applet Name: SerPerf User Interface Description COMx The ―COMx‖ check box is used to select the serial ports. Check the box means running a through test on the port. Uncheck the box means ignoring the port during testing. Bits per Specifies the baud rate at which the Korenix | Software Feature 20 Applet Name: SerPerf User Interface Description second communication device operates. Data bits Specifies the number of bits in the bytes transmitted and received. Parity Specifies the parity scheme to be used. Stop bits Specifies the number of stop bits to be used. Flow control Specifies the flow control scheme to be used. OK Starts the throughput test. X Exits. Table 11 Description of the Usr Interface of ―SerPerf‖ 3-1-3 Version Utilities The control applet named ―Version Viewer‖ provides a simple user interface to show the OS and Boot loader build information. Figure 4 is the snapshot of the ―Version Viewer‖ control applet. Table 12 describes the user interface of ―Version Viewer‖. Figure 4.Snapshot of “Version Viewer” Control Applet Applet Name: Version Viewer User Interface Description Build number Indicates the serial number of the built image. Korenix | Software Feature 21 Build Date Indicates the date of the image was built. Build Time Indicates the time of the image was built. Build Platform Indicates the BSP of the build image. Build Project Indicates the workspace of the build image. Boot Loader Indicates the version number of the boot loader. X Exits. Table 12 Description of the User Interface of ―Version Viewer‖ 3-1-4 Canver Utilities The control applet named ―Canver Viewer‖ provides a simple user interface to show the Canbus Driver build information. Figure 5 is the snapshot of the ―Canver Viewer‖ control applet. Table 13 describes the user interface of ―Canver Viewer‖. Figure 5.Snapshot of “Canver Viewer” Control Applet Applet Name: Canver Viewer User Interface Description Driver Name Indicates the Driver Name of the built image. Driver Version Indicates the canbus version of the driver. X Exits. Table 13 Description of the User Interface of “Canver Viewer” Korenix | Software Feature 22 3-2 Customized System Utilities 3-2-1 Overview Lots of system utilities are provides to make using JetBox more convenient. 3-2-2 User manager Utility Introduction Microsoft® Windows® CE 5.0 provides authentication services that can be used by application developers to authenticate clients. Services supported by Windows CE include security services for user authentication, credential management, and message protection through a programming interface called the Security Support Provider Interface (SSPI). Within SSPI, different security providers are available, such as the NTLM security support provider (SSP) and Kerberos SSP; each one contains different authentication and cryptographic schemes. Windows CE uses the Windows NT® LAN Manager protocol (RPC_C_AUTHN_WINNT), which is also known as NTLM, to authenticate callers. This is the default authentication service for communications on Windows NT. You can set the domain variable in the DefaultDomain registry value, which is located under the HKEY_LOCAL_MACHINE\Comm\Redir registry key. If the DefaultDomain registry value is not set, Windows CE uses the local user database to set the domain variable. “UsrMgr.exe” Utility By Default, JetBox doesn’t set the DefaultDomain registry value under the HKEY_LOCAL_MACHINE\Comm\Redir registry key. Therefore, one command line utility named ―UsrMgr.exe‖ is provides for the user to add, delete and list users and groups that are local to JetBox. Figure 4 shows the snapshot of ―UsrMgr.exe’. Table 12 shows the arguments description of ―UsrMgr.exe‖. Korenix | Software Feature 23 Figure 6 Snapshot of ―UsrMgr.exe‖ Utility Name: UsrMgr Arguments Description -a <user name> <password> Adds or updates a user. -d <user name> Removes a user. -l Lists all users. -gn <group name> Creates a new group. -gd <group name> Deletes a group. -gl Lists all groups. -gm <group name> Lists members in a group. -gat <user name> <group name> Adds a user to a group. -grf <user name> <group name> Removes a user from a group. Table 134 Arguments Description of ―UsrMgr.exe‖ 3-2-3 Registry Flush Utility Introduction The hive-based registry stores registry data inside files, or hives, which can be kept on any file system. This removes the need to perform backup and restore on power off. Removing this work during boot and power off makes the cold Korenix | Software Feature 24 boot process faster. Outstanding registry data will be flushed on a suspend/resume cycle and any time the system goes through a software shutdown. However, data may be lost if power is suddenly removed. Because a software shutdown is not an UI option of JetBox, so to ensure that data is not lost, call RegFlushKey API in your application. It will flush any unsaved changes in the hive to the persistent file. “rFlush.exe” Utility To save the system resource, JetBox doesn’t implement a daemon to flush registry data periodically. A utility named ―rFlush.exe‖ is provided to flush the changed registry data. Figure 5 shows the snapshot of the user interface of ―rFlush.exe‖ utility. Figure 7 Snapshot of ―rFlush.exe‖ 3-2-4 Auto Run Utility Introduction When Windows CE begins loading, the kernel starts the file system and examines the HKEY_LOCAL_MACHINE\Init registry key to identify what applications to run. To control which applications run at system startup, create launch registry values. Launch registry values do not need to be sorted in the registry, although you can specify dependencies. You can specify up to 32 applications. Table 13 shows the named values for the HKEY_LOCAL_MACHINE\Init registry key. HKEY_LOCAL_MACHINE\Init Korenix | Software Feature 25 Value Description Launchnn : String Specifies the application to launch in order ―nn‖. Depnednn : Binary Launchnn registry values have optional dependencies as denoted by the Dependnn registry value. Table 145 Named Values of HKEY_LOCAL_MACHINE\Init Key Dependnn registry values specify applications that Windows CE must be running before the Launchnn applications run. Dependnn registry values begin with the keyword Depend, followed by the same decimal number as the Launchnn registry value. The Dependnn registry values define an order in which Windows CE launches applications. One or more dependent applications can be specified per Dependnn value. Dependent applications are specified as a series of Words in hexadecimal notation. Table 14 shows a typical Init registry entry using dependencies. HKEY_LOCAL_MACHINE\Init Value Name Value Launch10 shell.exe Launch20 device.exe Launch30 gwes.exe Depend30 hex:14,00 Launch50 taskman.exe Depend50 hex:14,00, 1e,00 Table 156 a Typical Init Registry Entry Using Dependencies In the preceding example, Gwes.exe is dependent on Device.exe starting and Taskman.exe is dependent on Device.exe and Gwes.exe starting. After Windows CE calls an application using the Init registry value, the application must call the SignalStarted function. SignalStarted indicates that the application is ready for the rest of the OS to continue processing. The value that is passed as the parameter to SignalStarted is the value passed on the command line of the application started from the Init key Korenix | Software Feature 26 “AutoRun.exe” Utility If your applications have dependencies with other applications, use the Remote Registry Editor to setup your applications manually. After finishing the registry setup, run ―rFlush.exe‖ utility to flush the changed registry data to hive. Otherwise, JetBox comes with an application launcher utility named ―AutoRun.exe‖ to complete the setup. Figure 6 shows the snapshot of ―AutoRun.exe‖ utility. Table 15 shows the description of user interfaces of ―AutoRun.exe‖ utility. Figure 8 Snapshot of ―AutoRun.exe‖ Utility Name: AutoRun User Interface Description File: Specifies the application path. … Browses the application location. Parameters: Specifies the application arguments. UP Moves up the run order of selected application. DN Moves down the run order of selected application. WaitTime (ms): The wait time in mini-seconds before running application. RunOnce Runs the application only once on the next boot. Korenix | Software Feature 27 Utility Name: AutoRun User Interface Description NOTE: There is a run flag attached with the specified application, and the run flag will be clear after the next boot. New Adds the specified application path into run list. Modify Updates the wait time or run once attributes of the selected application. Delete Removes the selected application from run list. Save & Exit Saves run list information and exit. NOTE: Run flags attached with the specified applications will be set. List Ctrl Shows and Controls the run list information. Table 167 Description of the User Interface of ―AutoRun.exe‖ 3-3 Telnet Server Overview JetBox provides a Telnet server to allow remote administration through a standard Telnet client. Using the Telnet server, the JetBox can be manipulated as if it is running the command prompt on the device itself. The Telnet server is also useful for device bring-up and debugging. NOTE JetBox enables Telnet server without user authentication by default. Default Registry Settings It’s necessary to be aware of the registry settings that impact security. The Telnet server settings are located under the HKEY_LOCAL_MACHINE\Comm\TELNETD registry key. Table 16 shows the named values for the Telnet server registry key. The Telnet server reads the values in the registry before servicing each request. Therefore, changes made to the registry take affect immediately and do not require the Telnet server to Korenix | Software Feature 28 be restarted. HKEY_LOCAL_MACHINE\Comm\TELNETD Value Description IsEnabled : DWORD To disable the Telnet server, set this value to 0; otherwise, set it to nonzero. If the Telnet server is started and this value is not present, this value defaults to accepting connections. UseAuthenticatio To require a password check on the user, set n : DWORD this value to 1; otherwise, set it to 0. By default, the value 0 is set to disable the authentication. UserList : String Provides a comma-separated list of allowed users. Requires UseAuthentication to be enabled. By default, the ―asterisk‖ or the ―at sign‖ and the asterisk (* or @*) is set to allow all users. Table 178 Telnet Server Registry Key and Named Values Security Notes The security on the Telnet server is very light and vulnerable to security attacks. Even if the Telnet server is configured to require password authentication, the password is sent in plain text across the network and is therefore vulnerable to packet sniffing. A malicious user could obtain the password to JetBox by watching packets sent back and forth between the Telnet server and the client during the authentication stage. If a malicious user could log on to JetBox, they would have complete control over it. This could involve deleting or modifying key system files and the registry. Because of these serious security risks, it is strongly recommended you only run the Telnet server for development and debugging purposes, on a controlled, private network where you trust the users. It is strongly recommended that you do not deploy this Telnet server on a public network such as the Internet. Recommendations NOTE: Set the User List and Domain variables to prevent hacker attacks Korenix | Software Feature 29 on your device If Telnet server is used without appropriate values set for the User List and Domain variables, your Telnet server will be vulnerable to hacker attacks. These variables are not set by default. A hacker must only guess the device's password, the way it is set in Control Panel, to obtain access to the server. To prevent such an attack, the user name in the UserList registry value must be set for each of the servers that are currently running. The user will then need to log in with the specified user name and appropriate password to use the server. You can also set the domain variable in the DefaultDomain registry value, which is located under the HKEY_LOCAL_MACHINE\Comm\Redir registry key. Refer with Section 3-2-2 User Manager Utility to learn how to add user information to the local database if no domain controller is available in the network. 3-4 FTP Server Overview JetBox implementation of FTP server enables you to transfer files from a desktop computer using a TCP/IP connection. The implementation of FTP server in JetBox is based on RFC 959. The included FTP server supports the minimum implementation of the FTP protocol defined in RFC 959. This minimum implementation includes configuration values, transfer parameters, and ASCII and Image data types, and allows FTP to operate with a minimum of error messages. NOTE JetBox Enables FTP server by default. Default Registry Settings It’s necessary to be aware of the registry settings that impact security. The FTP server settings are located under the HKEY_LOCAL_MACHINE\Comm\FTPD Korenix | Software Feature 30 registry key. Table 17 shows the named values for the FTP server registry key. HKEY_LOCAL_MACHINE\Comm\FTPD Value Description AllowAnonymous : DWORD Default set to 1. Possible values are 0 (false) or 1 (true). Determines whether the server will allow anonymous access. AllowAnonymousUplo Default set to zero (0). Possible values ad : DWORD are 0 (false) or 1 (true). Determines whether authorization is required to upload files to the server, delete files from the server, and rename files. AllowAnonymousVroo ts : DWORD Default set to zero (0). Possible values are 0 (false) or 1 (true). Specifies whether access to virtual roots is granted or denied to anonymous users. AllowLowPortValues : DWORD Default set to false (0). Possible values are 0 (false) or 1 (true). If this value is set to false, all PORT commands requesting a port equal to or lesser than 1023 will be rejected. If this key is set to true, low ports will be allowed. DefaultDir : String Default root directory. Directory and subdirectories of this key are accessible remotely. If this value is not set in the registry, the default is \Temp. IsEnabled : DWORD To disable the FTP server, set this value to 0; otherwise, set it to nonzero. If the FTP server is started and this value is not present, This value is typically used to keep the server disabled at boot time. UseAuthentication : DWORD To require a password check on the user, set this value to 1; otherwise, set it to 0. By default, the value 0 is set to disable the authentication. UserList : String Korenix | Software Feature Provides a comma-separated list of allowed users. Requires 31 HKEY_LOCAL_MACHINE\Comm\FTPD Value Description UseAuthentication to be enabled. By default, the ―asterisk‖ or the ―at sign‖ and the asterisk (* or @*) is set to allow all users. Table 189 FTP Server Registry Key and Named Values Security Notes If AllowAnonymous is set to true, it will allow users to connect to the server without providing verifiable credentials. Anyone can log in using the username "anonymous" and any password to gain access. It is recommended that you set this value to false and use the UserList registry setting to specify all allowed users. If AllowAnonymousUpload is set to true, unauthenticated users will be able to copy files to, and delete files from, your server. This can be very dangerous because attackers might upload dangerous applications and documents, or they might delete important system files. It is not recommended to allow upload permission for anonymous users. If AllowAnonymousVroots is set to false, anonymous users will only be able to access the main FTP share. If this value is set to true, unauthenticated users will also be able to access VROOTs as well as the main share. Therefore you should use this setting with caution. Setting UseAuthentication to false enables clients to connect to the server without providing credentials. It is therefore strongly recommended that you do not set this value to false. Change this setting only if you have anonymous clients that must access the server but cannot or will not send USER and PASS credentials. It is recommended that you set this value to a list of all users who should have access to the server and its member VROOTs. Specifying the allowed users in UserList and setting AllowAnonymous to false will help protect the device from most attackers and keep your files available only to those users who need to see them. Recommendations Korenix | Software Feature 32 NOTE: Set the User List and Domain variables to prevent hacker attacks on your device If the FTP Server functionality is used without appropriate values set for the User List and Domain variables, the FTP server will be vulnerable to hacker attacks. These variables are not set by default. A hacker must only guess the device's password, the way it is set in Control Panel, to obtain access to the server. To prevent such an attack, the user name in the UserList registry value must be set for each of the servers that are currently running. The user will then need to log in with the specified user name and appropriate password to use the server. You can set the domain variable in the DefaultDomain registry value, which is located under the HKEY_LOCAL_MACHINE\Comm\Redir registry key. Setting the DefaultDomain registry value will require FTP clients to have valid domain credentials to log in. Refer with Section 3-2-2 User Manager Utility to learn how to add user information to the local database if no domain controller is available in the network. 3-5 Web Server Overview Web server facilitates the use of the Internet for communication between JetBox and network printers, scanners, and other shared equipment. The Web server applications send Hypertext Markup Language (HTML) pages to a requesting browser. Users only need to have an Internet connection and a browser to be able to make use of the Web server functionality. The Web server supports IPv6 and also supports the use of Active Server Pages (ASP). Default Registry Settings Korenix | Software Feature 33 It’s necessary to be aware of the registry settings that impact security. The Web server settings are located under the HKEY_LOCAL_MACHINE\Comm\HTTPD registry key. If you make changes to the Web server registry settings, it is necessary to stop the Web server and restart it to make the changes take effect. The IsEnabled registry value is checked only when the Web server is initially loaded. If the registry value is set to zero (0), the Web server does not start. Changing this value to zero (0) while the Web server is running has no effect. You also must stop the Web server to make it stop accepting connections. Table 18 shows the named values for the Web server registry key. HKEY_LOCAL_MACHINE\Comm\HTTPD Value Description BasicRealm : STRING Specifies the string that the Web server will send to clients as its Basic realm when performing basic authentication. If this registry value is not set, the Web server will default to using the string "Microsoft-WinCE". IsEnabled : DWORD If the value is not set in the registry, the Web server is enabled. If the value is set to zero (0), the Web server does not accept connections from the network, even from the local host. Port : DWORD Default setting is 80. This port receives HTTP connections. Do not set the port to zero (0). Basic : DWORD Default setting is zero (0). If this value is nonzero, the Web server uses Basic authentication for client connections. NTLM : DWORD Default setting is 1. If this value is set to nonzero, the Web server uses NTLM authentication for client browser connections. Also, if this value is nonzero, the failure of Basic authentication forces NTLM authentication. If the value is not set in the registry, NTLM is Korenix | Software Feature 34 HKEY_LOCAL_MACHINE\Comm\HTTPD Value Description not used. DirBrowse : DWORD Default setting is zero (0). If this value is set to nonzero, directory browsing is allowed. If this value is not set in the registry, directory browsing is turned off. Filter DLLs : String Default not set in the registry. List of DLL names, separated by commas that specifies the filters to use. DefaultPage : String Default not set in the registry. If the value is not present in the registry, the Web server will use "default.htm;index.htm". List of page names, separated by semicolons that specifies file names interpreted by the Web server to be default pages. When browsing a directory, the Web server traverses this list searching for a file of the same name in the directory. If the file exists, it is sent to the client. If no matching file exists, the Web server sends a directory listing or returns an error, depending on whether directory browsing is enabled. If more than one DefaultPage file name is matched, the Web server uses the first matching file name. AdminUsers : String Default not set in the registry. List of user names, separated by semicolons. A user who has gained user access must be listed in this key to gain Administrator access. LogFileDirectory : String Default setting is "\windows\www" directory. If the name is not set or if the specified directory is inaccessible, no logging is performed. Name of the directory where the logging files are created. PostReadSize : DWORD Korenix | Software Feature If the value is not set in the registry, PostReadSize will default to 48 KB. The 35 HKEY_LOCAL_MACHINE\Comm\HTTPD Value Description Web server uses a minimum value of 8192 bytes (8 KB). If the value in the registry is less than 8 KB, the value is ignored and the Web server will use 8 KB. Specifies the maximum number of bytes that the Web server reads when receiving POST data. To read more data, you must use a raw data filter or call ReadClient in an ISAPI extension. MaxLogSize : DWORD Default setting is 32 KB. If this value is not set in the registry, or if it is set to zero (0), no logging is performed. Maximum size, in bytes, that a log file can become before it is rolled over. MaxHeaderSize : DWORD Default setting is 48 KB in the registry. Maximum number of bytes that the Web server will read of HTTP headers. If the header size exceeds this value, the Web server will terminate the session and return a message to the client: 400 - Bad Request. MaxConnections : DWORD Default is not set in the registry. If the value is not set in the registry, MaxConnections will default to 10. Specifies the maximum number of simultaneous connections to the Web site. After the maximum number of connections is established, additional client requests will be sent a message: 503 – Server Too Busy. ServerID : String Default is not set in the registry. If the value is not set in the registry, ServerID will default to "Microsoft-WinCE/X.Y", where X is the major version and Y is the minor version of Windows CE-based device. If ServerID is set, the Web server returns the specified server name in the response Korenix | Software Feature 36 HKEY_LOCAL_MACHINE\Comm\HTTPD Value Description header. Identifies the server name that is included when the Web server generates HTTP response headers. The response header includes a field name "Server: ". Optionally, you can include the software version number or any similar information in the string. Table 20 Web Server Registry Key and Named Values Security Notes When using Basic authentication, the client browser sends the user identifier and password to the server in clear text. In addition, all data sent between the client and the browser is in clear text and therefore vulnerable to packet sniffing. You should consider using SSL to help protect sensitive information. Although the client browser sends the password to the server in encrypted format, all data sent between the client and the browser is in clear text and therefore vulnerable to packet sniffing. You should consider using SSL to help protect sensitive information. DirBrowse turns on the Web server's ability to provide local directory browsing. This exposes the local file system to a remote browser through HTTP. Users can view file lists and download files depending on virtual root and authentication registry settings. Enabling directory browsing increases the potential attack surfaces, therefore you should enable directory browsing only when necessary. User names in this list identify the administrators of the site who have access to all virtual roots hosted on this Web site, including the restricted sites. Choose these users carefully and ensure that they set proper password, otherwise their accounts could be used to gain access to restricted sites. Setting the value too small can block user access to the site. However, if the value is too large the Web server will consume more system resources. Based on your deployment model, choose this number appropriately. To avoid revealing the server software information to malicious users, you may want to create a custom server name that obfuscates the Web server and operating system versions. Korenix | Software Feature 37 Recommendations A typical deployment uses a Web server in a private network to provide a remote user interface to configure a headless device. The registry defines the number of connections and when the MaxConnections registry value is not set, the registry limits the number to 10. A typical deployment uses the Web server to display status information or to host a family or community Web site. You should not use the Web Server to perform critical operations, such as machine control or financial processing. Use NTLM and/or Basic authentication mechanism to limit access to known users only. You can set the option in the HKEY_LOCAL_MACHINE\COMM\HTTPD registry key. SSL protocol helps to protect data from packet sniffing by anyone with physical access to the network. Carefully choose your virtual roots and limit access to the appropriate files by providing appropriate user access lists. Anonymous users with access to the virtual root may be able to access files and directories within that virtual root. You can set the options in HKEY_LOCAL_MACHINE\Comm\HTTPD\VROOTS registry key. 3-6 File Server Overview The File Server technology enables clients to access files and other resources, such as printer, from a server over a network using TCP/IP. File Server uses the Common Internet File System (CIFS). This is an extension of the Server Message Block (SMB) file sharing protocol. CIFS enables a network-enabled application to access and manipulate files and directories on a remote server in the same way that it the application accesses and manipulates files and directories on the local system. Default Registry Settings The registry stores information necessary to configure the system for Korenix | Software Feature 38 applications and hardware devices. The registry also contains information that the operating system continually references during operation. JetBox enables you to create virtual file server directories. To users who access your file server share, virtual directories appear as subdirectories of the file server share, although these directories may be located in a different folder. You can create a virtual root directory called "myCF" by specifying the following registry key: HKEY_LOCAL_MACHINE\Services\SMBServer\Shares\Hard Disk. Note the maximum length of the virtual root directory is 12 characters. Table 19 shows the named values for the HKEY_LOCAL_MACHINE\Services\SMBServer\Shares registry key. HKEY_LOCAL_MACHINE\Services\SMBserver\Shares Value Description UseAuthenticatio n : DWORD No default set. Setting this value to 0 will disable the authentication on the file server. The file server will be accessible to all users on the network. Table 21 Named Values of HKEY_LOCAL_MACHINE\Services\SMBServer\Shares Key. Table 20 shows the named values that are stored under the virtual root key. An example of such a virtual root key is HKEY_LOCAL_MACHINE\Services\SMBServer\Shares HKEY_LOCAL_MACHINE\Services\SMBserver\Shares Value Description Path : String Specifies the path to be shared. Type : DWORD Setting this value to 1 designates this as a print server share, setting this value to 0 (zero) designates this as a file server share. UserList : String Specifies a comma-separated list of allowed users. Table 22 Named Values of HKEY_LOCAL_MACHINE\Services\SMBServer\Shares\Hard Disk Key Security Notes Korenix | Software Feature 39 It is not recommended that you disable authentication on the file server and you share the \Windows or root directory. You can specify a list of folders that cannot be shared. You can use any name for each folder you specify in the exclusion list. Setting the HKEY_LOCAL_MACHINE\Services\Smbserver\Shares\ExcludePaths registry key prevents the configuration functions from creating the specified shares, so that they cannot be accessed by an un-trusted application. Table 21 shows an example how to exclude the \Windows and \Documents and Settings directories: HKEY_LOCAL_MACHINE\Services\Smbserver\Shares\ExcludePaths Value Name Value ―Windows‖ ―\\Windows‖ ―My Documents‖ ―\\Documents and Settings‖ Table 23 an Example to Exclude the Folders to be Shared Recommendations After you have configured your share folders by editing the registry manually or using the remote configuration tool, you can access and browse the folders you created in the following steps. 1. On the development workstation, from the Start menu, chooses Run. In the Open box, type \\JetBox<model name> (for example: \\JetBox8152), and then choose OK. The Connect to JetBox dialog box appears. 2. In the Connect to JetBox dialog box, type the user name you created and the corresponding password, and then choose OK. A window appears that shows the two root directories you created. 3. You can now browse the folders you created and access specific files in these folders. The net use command can also to be used in the DOS command prompt tool, and Figure 7 shows how to map the myCF folder of JetBox to a drive x: in your development workstation, Korenix | Software Feature 40 Figure 9 Snapshot of Share a Folder via ―net use‖ Command Chapter 4 Web-based Administration 4-1 Overview JetBox can also run without displays (think an industrial controller or a protocol gateway). In this case, a web server running on JetBox itself can dynamically generate HTML and send it back to a remote web browser, which in turn can configure the device remotely. 4-2 Remote Administration Page (RemoteAdmin) 4-2-1 Introduction The Remote Configuration (RemoteAdmin) page for the Web Server enables Korenix | Web-based Administration 41 you to remotely administer JetBox using your Web browser. The functionality of the RemoteAdmin includes a wizard that assists users with the initial JetBox setup and other common tasks. Use your Internet browser and go to http://<JetBox IP Address> to launch RemoteAdmin. Note the RemoteAdmin page is set as the default home page of JetBox. 4-2-2 First use Setup Wizard On first use, the application requires a password. In addition, the application requires authentication—you must use the default username ADMIN and the same password that you typed on first use. Figure 8 to Figure 12 shows the steps to finish the first use setup wizard. Figure 4 First Use Setup Wizard Korenix | Web-based Administration 42 Figure 5 Input Password and Re-type to Confirm Figure 6 Choose ―I do not want to setup an Internet connection now‖ Korenix | Web-based Administration 43 Figure 7 JetBox is resetting Figure 8 Authentication for Remote Configuration 4-2-3 RemoteAdmin Home Page JetBox remote administration page also provides support for user tasks such as configuring user and share and security settings. Additionally, the UI provides advanced gateway features, such as port forwarding. Table 22 shows the description of the user interface of the RemoteAdmin Home page. Figure 13 is the snapshot of the RemoteAdmin home page. Page Name: Home User Interface Description Wide Area Network (WAN) settings Displays a summary of the WAN network settings. Korenix | Web-based Administration 44 Release Releases the dynamically assigned IP address on the WAN network. Renew Obtains a new IP address on the WAN network. Local Area Network (LAN) settings Displays a summary of the LAN network settings. DHCP client List Displays the clients on the LAN network. Table 19 Description of the User Interface of the Reset Base Figure 9 Snapshot of the RemoteAdmin Home Page Korenix | Web-based Administration 45 4-2-4 Device Management Pages 4-2-4-1 Reset Base Station Page Table 23 shows the description of the user interface of the Reset Base Station page. Figure 14 to Figure 16 shows the steps to reset the JetBox. Page Name: Reset Base Station User Interface Description Reset Reset the JetBox (Gateway). Table 20 Description of the User Interface of the Reset Base Station Page Figure 10 Click the Reset Button Korenix | Web-based Administration 46 Figure 11 Click ―OK‖ to Confirm Figure 12 JetBox is Resetting 4-2-4-2 Set Time Page Table 24 shows the description of the user interface of the Set Time page. Figure 17 and Figure 18 show the snapshots of the Set Time page. Page Name: Set Time User Interface Description Time synchronization method Options for time synchronization: Internet time server Specifies the time server name. Set time manually Specifies the time settings. Synchronize to Internet time server or Set time manually. Base station time zone Sets time zone. Apply Applies the settings. Cancel Cancels the settings. Table 21 Description of the User Interface of the Set Time Page Korenix | Web-based Administration 47 Figure 13 Snapshot of the Set Time Pae for Synchronize to Internet Time Server Figure 14 Snapshot of the Set Time Page for Set Time Manually Korenix | Web-based Administration 48 4-2-4-3 Application Port Forwarding Page Table 25 shows the description of the user interface of the Application Port Forwarding page. Figure 19 shows the snapshot of the Application Port Forwarding page. Note Add, Enable, Edit, Delete will cause the related services been reset. Page Name: Application Port Forwarding User Interface Description Description Description of the port forwarding settings. Outbound port Specifies outbound port number. Trigger protocol Specifies the trigger protocol. Inbound TCP ports Specifies inbound TCP port numbers. Inbound UDP ports .Specifies outbound UDP port numbers. Add Adds the current settings. Clear Clears the current settings Enable Enables the specified settings. Edit Edits the specified settings. Delete Deletes the specified settings. Table 22 Description of the User Interface of the Application Port Forwarding Page Figure 15 Snapshot of the Application Port Forwarding Page Korenix | Web-based Administration 49 4-2-4-4 Back Up/ Restoring Settings Page Table 26 shows the description of the user interface of the Back Up/Restoring Settings page. Figure 20 shows the snapshot of the Back Up/Restoring Settings page. Figure 21 shows the snapshot of download the back up settings file. Page Name: Back Up/Restoring Settings User Interface Description Back Up Settings Back ups the current settings to a file. Browse… Browses and selects a back up settings file. Restore Settings Restores the settings from a file. Table 23 Description of the User Interface of the Back Up/ Restoring Settings Page Figure 16 Snapshot of the Back Up/ Restoring Settings Page. Korenix | Web-based Administration 50 Figure 17 Snapshot of Download the Back Up Settings File. 4-3 Web Administration Page (WebAdmin) 4-3-1 Introduction The Web Server Administration (WebAdmin) page for the Web server enables you to remotely administer your Web server using your Web browser. Use WebAdmin to manage the accessibility, security, and file sharing features of your Web server. Include configure which files are shared and how they are accessed and which users have access to which files, and the authentication protocols the Web server will use and configure the Web server log. Use your Internet browser and go to http://<JetBox IP Address>/WebAdmin to launch WebAdmin. Refer with Section 4-3-3 Instructions Page for details before starting configuring the Web server. 4-3-2 WebAdmin Home Page Table 27 is the description of the user interface of the Home page. Figure 22 and Figure 23 show the snapshots of the home page of the Web server administration page. Korenix | Web-based Administration 51 Page Name: Home User Interface Description Help topics For more information about WebAdmin. Configuring Web Sites For more information about configuring Web sites. Default Web Site: Modify Modifies the default Web site. Public Web Site: Modifies the public Web site. Modify Public Web Site: Delete Deletes the public Web site. CreateNew Creates a new Web site. Table 24 Description of the User Interface of the WebAdmin Home Page Figure 18 Snapshot of the WebAdmin Home Page Korenix | Web-based Administration 52 Figure 19 Snapshot of the WebAdmin Home Page 4-3-3 Instructions Page Figure 24 shows the snapshot of the Instructions page. The Help topics provide information about configuring, securing, and managing the Web server on your JetBox device. Korenix | Web-based Administration 53 Figure 20 Snapshot of the Instructions Page 4-3-4 Logging Page Table 28 is the description of the user interface of the Logging page. Figure 25 shows the snapshot of the Logging page. Figure 26 shows the snapshot of the current log file. Page Name: Logging User Interface Description Here For more information about Logging. View the Current Web server log file Views the current Web server log file.. Log File Location: Specifies the log file location. Korenix | Web-based Administration 54 Maximum Log File Size: Specifies the maximum log file size in bytes. Update Settings Updates the settings. Table 25 Description of the User Interface of the Logging Page Figure 21 Snapshot of the Current Logging Page Korenix | Web-based Administration 55 Figure 22 Snapshot of the Log File 4-3-5 SSL Configuration Page Table 29 is the description of the user interface of the SSL Configuration page. Figure 27 shows the snapshot of the SSL Configuration page. Page Name: SSL Configuration User Interface Description Here For more information about SSL Configuration. Enable SSL: Enables SSL on initialization of Web server. Server Certificate Subject Line: Specifies the server certificate subject line. Update Updates the settings. Table 26 Description of the User Interface of the SSL Configuration Page Korenix | Web-based Administration 56 Figure 23 Snapshot of the SSL Configuration Page 4-3-6 Restart Web Server Page Figure 28 shows the snapshot of the Restart Web Server page. Figure 24 Snapshot of the Restart Web Server Page Korenix | Web-based Administration 57 4-4 System Administration Page (SysAdmin) 4-4-1 Introduction The System Administration (SysAdmin) page for the JetBox Web Server enables you to remotely administer JetBox using your Web browser. Use SysAdmin to manage the processes, files and registry of JetBox. Include launch/kill a process, upload/download a file, create/remove a directory and edit the registry. Use your Internet browser and go to http://<JetBox IP Address>/SysAdmin to launch SysAdmin. Note the SysAdmin is discontinued in Windows CE 6.0. 4-4-2 SysAdmin Home Page Figure 29 shows the snapshot of the home page of the System administration page. Choose one Web Browser you are using. Figure 30 shows the snapshot of the home page of the System administration page with framing UI. Figure 25 Snapshot of the SysAdmin Home Page Korenix | Web-based Administration 58 Figure 26 Snapshot of the SysAdmin Home Page 4-4-3 System Tools Page System Info Page Table 30 is the description of the user interface of the System Info page. Figure 31 is the snapshot of the System Info page. It shows the system information, includes version, number of processors, the CPU architecture, the memory and data store size, the network adapters and the system time. Page Name: System Info User Interface Description Refresh Refreshes the current page Table 27 Description of the User Interface of the System Info Page Korenix | Web-based Administration 59 Figure 27 Snapshot of the System Info Page Processes Page Table 31 is the description of the user interface of the Processes page. Figure 32 is the snapshot of the Processes page. Page Name: Processes User Interface Description Refresh Refreshes the current page. Launch processes: Specifies the executable file path. Execute Launches the specified executable file. PID Specifies the process ID. Process Name Specifies the process name. Kill Kills the process. Table 28 Description of the User Interface of the Processes Page Korenix | Web-based Administration 60 Figure 28 Snapshot of the Processes Page 4-4-4 File Browser Page Table 32 is the description of the user interface of the File Browser page. Figure 33 is the snapshot of the File Browser page. Note you may consider looking at the SMB server to do upload and download as it will be way faster and probably a better user experience since it'll look like a remote file share. Page Name: File Browser User Interface Description Refresh Refreshes the working directory. Directory Tree View Selects the working directory. JetBox Indicates the working directory. Upload File: Specifies the upload file path. Browse… Browses and selects the upload file. Upload Uploads the specified file. Copy to: Specifies the copy to file path. New Directory Name: Specifies the new directory name. Korenix | Web-based Administration 61 Page Name: File Browser User Interface Description Create Directory Creates a new directory under working directory. Remove Directory Removes the working directory. Delete Deletes the specified file. Copy Copies the specified file to the specified copy to path. File Name Downloads the specified file. Table 29 Description of the User Interface of the File Browser Page Figure 29 Snapshot of the File Browser Page 4-4-5 Registry Editor Page Table 33 is the description of the user interface of the Registry Editor page. Figure 34 is the snapshot of the Registry Editor page. Korenix | Web-based Administration 62 Page Name: File Browser User Interface Description Refresh Refreshes the current key. Registry Key Tree View Selects the working registry key. HKEY_LOCAL_MACHINE Indicates the working registry key. New Value Name: Specifies the new value name. New value Type: Specifies the new value type. New Value Creates a new value. Modified Value: Specifies the modified value data. New Subkey Name: Specified the new registry key. Create Key Create a new registry key. Delete Key Deletes the working registry key. Delete Deletes the specified value. Modify Modifies the value with specified modified value. Table 30 Description of the User Interface of the Registry Editor Page Figure 30 Snapshot of the Registry Editor Page Korenix | Web-based Administration 63 Chapter 5 Connectivity Features 5-1 Overview Microsoft® Windows® CE provides tools for testing and debugging a Windows CE–based device. Most tools for debugging and testing reside on the development workstation, and thus rely on a connectivity infrastructure that facilitates communication between the development workstation and a target device. Platform Manager supports application connectivity. Application connectivity is a communications framework that allows you to establish a connection between an application running on a development workstation and a target device. Remote Tools and eMbedded Visual C++ use the application connectivity support in Platform Manager to connect to a target device. 5-2 ActiveSync Connection 5-2-1 Introduction ActiveSync allows you to create a synchronization relationship between your mobile device and PC using a cable, cradle, Bluetooth, or infrared connection. ActiveSync can also make it possible for your device to connect to other resources through your PC. It’s recommended to setup an ActiveSync connection during developing your application with Microsoft eVC++4.0 or Visual Studio 2005. You can use a serial cable to connect JetBox to your PC. Note: Setup up Microsoft ActiveSync 4.5 or above before connecting the JetBox with your PC. Microsoft ActiveSync 4.5 can be downloaded from the following link: http://www.microsoft.com/windowsmobile/activesync/activesync45.msp x Korenix | Connectivity Features 64 5-2-2 Connection via COM port An alternative way to setup an ActiveSync connection with JetBox is using the RS232 port. Figure 35 to Figure 45 show the CE side procedures to establish an ActiveSync connection via RS232. Figure 46 to Figure 52 show the PC side procedures to establish an ActiveSync connection via RS232. Note: JetBox configure the default PC connection as USB, so it’s necessary to change the PC connection before establish ActiveSync connection via RS232. Figure 31 Launch ―Network and Dial-up Connections‖ Control Applet Korenix | Connectivity Features 65 Figure 32 Make New Connection Figure 33 Choose ―Direct Connection‖ Option Korenix | Connectivity Features 66 Figure 34 Choose a RS232 COM Port Figure 35 Configure the Selected COM Port Korenix | Connectivity Features 67 Figure 36 Set Flow Control as None Figure 37 Make ―My Connection‖ Is Completed Korenix | Connectivity Features 68 Figure 38 Launch ―PC Connection‖ Control Applet Figure 39 Select ―Change…‖ to Change PC Connection Korenix | Connectivity Features 69 Figure 40 Change PC Connection to ―My Connection‖ Figure 41 Change PC Connection Is Completed Korenix | Connectivity Features 70 Figure 42 Configure ActiveSync Connection Settings Figure 43 Allow Connections to COM1 Figure 44 ActiveSync Is Not Connected Korenix | Connectivity Features 71 Figure 45 Connect JetBox with PC via RS232 Null Modem Cable Figure 46 Choose ―No‖ to Skip Setup a Partnership Figure 47 ActiveSync Is Connected Figure 48 ActiveSync Is Connected Korenix | Connectivity Features 72 5-2-3 Explore JetBox After ActiveSync connection has been established, click the Explore button to explore JetBox. Figure 53 shows a connected Microsoft ActiveSync window. Figure 54 shows a snapshot of exploring JetBox via ActiveSync. It’s recommended to exchange the application data with JetBox via ActiveSync connection during developing your applications. Figure 49 Microsoft ActiveSync Figure 50 Explore the JetBox via ActiveSync Korenix | Connectivity Features 73 5-3 Manual Server Connection 5-3-1 Overview If ActiveSync connectivity is not available, a Manual Server connection should be possible. Manual Server uses TCP/IP communications between host PC and device and supports most of the functions of ActiveSync. It does not support file or outlook synchronization and takes more steps to initiate. Both ActiveSync and Manual Server are used by the Platform Manager component of eVC++. Platform Manager provides communication support for application debugging and add-on tools. You may need to install Microsoft eVC++ 4.0 before establishing a manual server connection with JetBox. 5-3-2 Configure Platform Manager Figure 55 to Figure 59 show how to establish a manual server connection on a Default Device. Figure 51 Configure Platform Manager Korenix | Connectivity Features 74 Figure 52 Setup the Properties of the Default Device Figure 53 Select ―TCP/IP Transport for Windows CE‖ for Transport Korenix | Connectivity Features 75 Figure 54 Select ―Manual Server‖ for Startup Server, then Click Test Figure 55 Manual Server - Action 5-3-3 Telnet with JetBox It’s recommended to Telnet with JetBox and launch CEMGRC.EXE remotely. Figure 60 and Figure 61 show how to identify the IP address of JetBox. Figure 62 and Figure 63 show how to start a telnet session to JetBox from your PC. Figure 64 shows launch Manual Server – Action command on JetBox. Figure Korenix | Connectivity Features 76 65 shows success to establish the Manual Server connection Figure 56 Double Click the Network Icon Figure 57 IP address of the DM9CE1 Network Adapter Figure 58 Start a Telnet Session to JetBox Figure 59 Success to Telnet JetBox Korenix | Connectivity Features 77 Figure 60 Launch ―Manual Server – Action‖ Command Figure 61 Success to Establish the Manual Server Connection 5-3-4 Remote Tools via Manual Server Connection Figure 66 to Figure 70 show the procedures to launch a remote tool via manual server connection. Korenix | Connectivity Features 78 Figure 62 Launch Remote Zoom in Tool Figure 63 Select Default Device Korenix | Connectivity Features 79 Figure 64 Manual Server - Action Figure 65 Launch ―Manual Server – Action‖ Command Figure 66 Success to Launch Remote Zoomin Korenix | Connectivity Features 80 Chapter 6 Application Development 6-1 Overview You can import JetBox SDK eMbedded Visual C++ 4.0 or Visual Studio .NET 2003. An application developer can then use the SDK to create applications that run on JetBox run-time image. 6-2 Install JetBox SDK Figure 71 to Figure 80 show the procedures of setup JetBox SDK. It use JetBox8100 photos as an example. Figure 67 Launch JetBox SDK Setup file to Start Installing SDK Korenix | Application Development 81 Figure 68 JetBox SDK Setup Wizard Figure 69 Accept End-User License Agreement Korenix | Application Development 82 Figure 70 Enter Customer information Figure 71 Choose ―Complete‖ Setup Type Korenix | Application Development 83 Figure 72 Choose the Destination Folder Figure 73 Ready to Install Korenix | Application Development 84 Figure 74 Install JetBox SDK Figure 75 Completing JetBox SDK Setup Wizard Korenix | Application Development 85 6-3 Hello Word Application with eVC++ 4.0 Figure 80 to Figure 88 show the procedures of developing a ―Hello World‖ application with Microsoft Embedded Visual C++ 4.0. Figure 89 to Figure 90 show the procedures of executing a ―Hello World‖ application with Microsoft Embedded Visual C++ 4.0. Note it’s necessary to establish a connection between JetBox with your PC before downloading and executing the application from eVC++4.0. Figure 76 New a Project with eVC++4.0 Korenix | Application Development 86 Figure 77 Hello World Application with Win32 (WCE x86) Figure 78 a typical ―Hello World!‖ Application Korenix | Application Development 87 Figure 79 Complete to Create the ―Hello World‖ Project Figure 80 Select the Active Configuration for Customized WCE OS Devices Korenix | Application Development 88 Figure 81 Rebuild Active Project and All Project Dependencies Figure 82 Connecting to the JetBox Figure 83 Downloading Hello World Application to JetBox Korenix | Application Development 89 Figure 84 Finish Downloading Hello World Application to JetBox Figure 85 Execute Hello World Application Korenix | Application Development 90 Figure 86 Snapshot of the Hello World Application Korenix | Application Development 91 6-4 Hello World Application with VS2005 Figure 91 to Figure 101 show the procedures of developing a ―Hello World‖ application with Microsoft Visual Studio 2005. Figure 87 New an Application Project with VS2005 Korenix | Application Development 92 Figure 88 Create a Hello World Application for Windows CE 5.0 Smart Device Using Visual C# Figure 89 Edit the Appearance Text to Hello World! Korenix | Application Development 93 Figure 90 Configure the Target Device as Windows CE 5.0 Device Figure 91 Connect to Device Korenix | Application Development 94 Figure 92 Connect to Windows CE 5.0 Device Successded Figure 93 Rebuild Solution Figure 94 Start Debugging Korenix | Application Development 95 Figure 95 Deploy Hello World Application to Windows CE 5.0 Device Figure 96 Hello World (Running) Figure 97 Snapshot of the Hello World Application on JetBox Korenix | Application Development 96 Chapter 7 Appendix 7-1 Table List Table 1 Application – End User .......................................................... 7 Table 2 Applications and Services Development ............................... 9 Table 3 Communication Service and Networking ............................ 13 Table 4 Core OS Service ................................................................. 14 Table 5 Device Management ........................................................... 14 Table 6 File System and Data Store................................................. 15 Table 7 Graphics and Multimedia Technologies ............................... 16 Table 8 Security ............................................................................... 17 Table 9 Shell and User Interface ...................................................... 18 Table 10 Platform Manager .............................................................. 18 Table 11 Description of the Usr Interface of ―SerPerf‖...................... 21 Table 12 Arguments Description of ―UsrMgr.exe‖ ............................ 24 Table 13 Named Values of HKEY_LOCAL_MACHINE\Init Key ....... 26 Table 14 a Typical Init Registry Entry Using Dependencies ............. 26 Table 15 Description of the User Interface of ―AutoRun.exe‖ ........... 28 Table 16 Telnet Server Registry Key and Named Values ................. 29 Table 17 FTP Server Registry Key and Named Values ................... 32 Table 18 Web Server Registry Key and Named Values ................... 37 Table 19 Named Values of HKEY_LOCAL_MACHINE\Services\SMBServer\Shares Key. . 39 Table 20 Named Values of HKEY_LOCAL_MACHINE\Services\SMBServer\Shares\Hard Disk Key ................................................................................... 39 Table 21 an Example to Exclude the Folders to be Shared ............. 40 Table 22 Description of the User Interface of the Reset Base ......... 45 Table 23 Description of the User Interface of the Reset Base Station Page ......................................................................................... 46 Table 24 Description of the User Interface of the Set Time Page .... 47 Table 25 Description of the User Interface of the Application Port Korenix | Appendix 97 Forwarding Page ...................................................................... 49 Table 26 Description of the User Interface of the Back Up/ Restoring Settings Page ........................................................................... 50 Table 27 Description of the User Interface of the WebAdmin Home Page ......................................................................................... 52 Table 28 Description of the User Interface of the Logging Page ...... 55 Table 29 Description of the User Interface of the SSL Configuration Page ......................................................................................... 56 Table 30 Description of the User Interface of the System Info Page 59 Table 31 Description of the User Interface of the Processes Page .. 60 Table 32 Description of the User Interface of the File Browser Page ................................................................................................. 62 Table 33 Description of the User Interface of the Registry Editor Page ................................................................................................. 63 7-2 Figure List Figure 1 Snapshot of the Control Panel of JetBox ........................... 19 Figure 2 Configuration Snapshot of ―SerPerf‖ Control Applet .......... 20 Figure 3 Run Time Snapshot of ―SerPerf‖ Control Applet ................ 20 Figure 4 Snapshot of ―UsrMgr.exe‖ .................................................. 24 Figure 5 Snapshot of ―rFlush.exe‖ ................................................... 25 Figure 6 Snapshot of ―AutoRun.exe‖ ............................................... 27 Figure 7 Snapshot of Share a Folder via ―net use‖ Command ......... 41 Figure 8 First Use Setup Wizard ...................................................... 42 Figure 9 Input Password and Re-type to Confirm ............................ 43 Figure 10 Choose ―I do not want to setup an Internet connection now‖ ................................................................................................. 43 Figure 11 JetBox is resetting ........................................................... 44 Figure 12 Authentication for Remote Configuration ......................... 44 Figure 13 Snapshot of the RemoteAdmin Home Page .................... 45 Figure 14 Click the Reset Button ..................................................... 46 Figure 15 Click ―OK‖ to Confirm ....................................................... 47 Figure 16 JetBox is Resetting .......................................................... 47 Figure 17 Snapshot of the Set Time Pae for Synchronize to Internet Time Server .............................................................................. 48 Korenix | Appendix 98 Figure 18 Snapshot of the Set Time Page for Set Time Manually ... 48 Figure 19 Snapshot of the Application Port Forwarding Page ......... 49 Figure 20 Snapshot of the Back Up/ Restoring Settings Page. ....... 50 Figure 21 Snapshot of Download the Back Up Settings File. .......... 51 Figure 22 Snapshot of the WebAdmin Home Page ......................... 52 Figure 23 Snapshot of the WebAdmin Home Page ......................... 53 Figure 24 Snapshot of the Instructions Page ................................... 54 Figure 25 Snapshot of the Current Logging Page............................ 55 Figure 26 Snapshot of the Log File .................................................. 56 Figure 27 Snapshot of the SSL Configuration Page ........................ 57 Figure 28 Snapshot of the Restart Web Server Page ...................... 57 Figure 29 Snapshot of the SysAdmin Home Page........................... 58 Figure 30 Snapshot of the SysAdmin Home Page........................... 59 Figure 31 Snapshot of the System Info Page .................................. 60 Figure 32 Snapshot of the Processes Page .................................... 61 Figure 33 Snapshot of the File Browser Page ................................. 62 Figure 34 Snapshot of the Registry Editor Page .............................. 63 Figure 35 Launch ―Network and Dial-up Connections‖ Control Applet ................................................................................................. 65 Figure 36 Make New Connection .................................................... 66 Figure 37 Choose ―Direct Connection‖ Option ................................. 66 Figure 38 Choose a RS232 COM Port ............................................ 67 Figure 39 Configure the Selected COM Port ................................... 67 Figure 40 Set Flow Control as None ................................................ 68 Figure 41 Make ―My Connection‖ Is Completed .............................. 68 Figure 42 Launch ―PC Connection‖ Control Applet .......................... 69 Figure 43 Select ―Change…‖ to Change PC Connection................. 69 Figure 44 Change PC Connection to ―My Connection‖ .................... 70 Figure 45 Change PC Connection Is Completed ............................. 70 Figure 46 Configure ActiveSync Connection Settings ..................... 71 Figure 47 Allow Connections to COM1 ............................................ 71 Figure 48 ActiveSync Is Not Connected .......................................... 71 Figure 49 Connect JetBox with PC via RS232 Null Modem Cable .. 72 Figure 50 Choose ―No‖ to Skip Setup a Partnership ........................ 72 Figure 51 ActiveSync Is Connected ................................................. 72 Figure 52 ActiveSync Is Connected ................................................. 72 Figure 53 Microsoft ActiveSync........................................................ 73 Korenix | Appendix 99 Figure 54 Explore the JetBox via ActiveSync .................................. 73 Figure 55 Configure Platform Manager............................................ 74 Figure 56 Setup the Properties of the Default Device ...................... 75 Figure 57 Select ―TCP/IP Transport for Windows CE‖ for Transport 75 Figure 58 Select ―Manual Server‖ for Startup Server, then Click Test ................................................................................................. 76 Figure 59 Manual Server - Action .................................................... 76 Figure 60 Double Click the Network Icon......................................... 77 Figure 61 IP address of the DM9CE1 Network Adapter ................... 77 Figure 62 Start a Telnet Session to JetBox ...................................... 77 Figure 63 Success to Telnet JetBox................................................. 77 Figure 64 Launch ―Manual Server – Action‖ Command ................... 78 Figure 65 Success to Establish the Manual Server Connection ...... 78 Figure 66 Launch Remote Zoom in Tool .......................................... 79 Figure 67 Select Default Device ...................................................... 79 Figure 68 Manual Server - Action .................................................... 80 Figure 69 Launch ―Manual Server – Action‖ Command ................... 80 Figure 70 Success to Launch Remote Zoomin ................................ 80 Figure 71 Launch JetBox SDK Setup file to Start Installing SDK ..... 81 Figure 72 JetBox SDK Setup Wizard ............................................... 82 Figure 73 Accept End-User License Agreement .............................. 82 Figure 74 Enter Customer information ............................................. 83 Figure 75 Choose ―Complete‖ Setup Type ...................................... 83 Figure 76 Choose the Destination Folder ........................................ 84 Figure 77 Ready to Install ................................................................ 84 Figure 78 Install JetBox SDK ........................................................... 85 Figure 79 Completing JetBox SDK Setup Wizard ............................ 85 Figure 80 New a Project with eVC++4.0 .......................................... 86 Figure 81 Hello World Application with Win32 (WCE x86) ............... 87 Figure 82 a typical ―Hello World!‖ Application .................................. 87 Figure 83 Complete to Create the ―Hello World‖ Project .................. 88 Figure 84 Select the Active Configuration for Customized WCE OS Devices ..................................................................................... 88 Figure 85 Rebuild Active Project and All Project Dependencies ...... 89 Figure 86 Connecting to the JetBox ................................................ 89 Figure 87 Downloading Hello World Application to JetBox .............. 89 Figure 88 Finish Downloading Hello World Application to JetBox .... 90 Korenix | Appendix 100 Figure 89 Execute Hello World Application ...................................... 90 Figure 90 Snapshot of the Hello World Application .......................... 91 Figure 91 New an Application Project with VS2005 ......................... 92 Figure 92 Create a Hello World Application for Windows CE 5.0 Smart Device Using Visual C#.................................................. 93 Figure 93 Edit the Appearance Text to Hello World! ........................ 93 Figure 94 Configure the Target Device as Windows CE 5.0 Device 94 Figure 95 Connect to Device ........................................................... 94 Figure 96 Connect to Windows CE 5.0 Device Successded ........... 95 Figure 97 Rebuild Solution .............................................................. 95 Figure 98 Start Debugging ............................................................... 95 Figure 99 Deploy Hello World Application to Windows CE 5.0 Device ................................................................................................. 96 Figure 100 Hello World (Running) ................................................... 96 Figure 101 Snapshot of the Hello World Application on JetBox ....... 96 7-3 Revision History V0.2 by 2011/4/8 1. Add utility for version check: version utility, canver utility V0.1 by 2011/ 3/ 30 7-4 Customer Service Korenix Technologies Co., Ltd. Business service: [email protected] Customer service: [email protected] Korenix | Appendix 101
advertisement
Key Features
- Web Server
- FTP Server
- Telnet Server
- Serial Ports
- Ethernet Port
- Device Management
- Remote Administration
Frequently Answers and Questions
What is the JetBox 8152?
The JetBox 8152 is a small footprint device with built-in Ethernet port and serial ports. It can be used for applications that require a small footprint, such as industrial controllers, communications hubs, and point-of-sale terminals.
How do I manage the JetBox 8152 remotely?
The JetBox 8152 can be managed remotely using its built-in web server, FTP server, and Telnet server.
What are some of the key features of the JetBox 8152?
Some of the key features of the JetBox 8152 include its web server, FTP server, Telnet server, serial ports, Ethernet port, and device management capabilities.