Lantronix 900-691-R manuale d’uso

Part Number 900-691-R Revision D February 2014 xPico W i-Fi Embedded Device Server User Guide[...]

xPico® Wi-Fi® Embedded Device Server User Guide 2 Intellectual Property © 2014 Lantronix, Inc. All rights r eserved. No part of th e contents of this book may b e transmitted or reproduced in an y form or by any means without the written permissio n of Lantronix. Lantronix and xPico are re gistered trademarks of Lantroni x, Inc. in the United St[...]

xPico® Wi-Fi® Embedded Device Server User Guide 3 T able of Contents Intellectual Proper ty ___________ _____________ _____________ ______________ _____ 2 Warranty _______ _____________ _____________ ___________ _____________ ________ 2 Contacts __________ __________ _____________ _____________ ______________ _____ 2 Disclaimer ___ _____________ [...]

xPico® Wi-Fi® Embedded Device Server User Guide 4 To Configure Network 2 Interface Settings _______________ _____________ _______ 24 To View Network 2 Interface Sta tus ____________ _____________ _____________ __ 25 Network 2 (wlan0) Link Stat us ________________ _____________ ______________ ____ 25 To View Network 2 Link Status ___ _____________[...]

xPico® Wi-Fi® Embedded Device Server User Guide 5 To View HTTP Status __________________ _____________ _____________ _______ 47 9: Maintenance and Diagnostics Settings 48 File System Settings ___________ _____________ _____________ ______________ ____ 48 File System Statistics ____________ ________________ _____________ __________ 48 To View File[...]

xPico® Wi-Fi® Embedded Device Server User Guide 6 Path Format ____ _____________ __________ _____________ ______________ ____ 66 Other Overrida ble Files __________________ ___________ _____________ _______ 67 13: Updating Firmware 68 Obtaining Firmware _______________ _____________ _____________ ___________ ____ 68 Loading New Firm ware through [...]

xPico® Wi-Fi® Embedded Device Server User Guide 7 End Product L abeling _______________________ __________ ______________ ___ 108 Manual Inform ation To the End User _____________ ______________ __________ _ 108 Industry Canad a Statement _____________ _____________ _____________ _________ 108 Radiation Exposure Statement _____ ________ _________[...]

xPico® Wi-Fi® Embedded Device Server User Guide 8 List of Figures Figure 2-1 xPico Wi-Fi Product Lab el ______________________ ______________ ____________ 16 Figure 3-1 Statu s Page _____________________ _____________ ______________ __________ __ 18 Figure 3-2 Compo nents of the Web Manager Pa ge _______________ _____________ __________ 19 Figure[...]

xPico® Wi-Fi® Embedded Device Server User Guide 9 List of T ables Table 3-3 Web Manager Page s ______ ______________ _____________ __________ __________ 20 Table 4-1 Netwo rk Interface Settings _______________________ ______________ ____________ 21 Table 4-2 Network 1 (ap0 ) Link Settings __________________ _____________ _____________ __ 22 Table[...]

xPico® Wi-Fi® Embedded Device Server User Guide 10 Table D-3 Sa fety ____________________ ___________ _____________ _____________ ______ 106 Table D-4 Europe – EU Declaration of Co nformity __ _____________ _____________ _________ 106 Table D-5 Ap proved Antenna (s) List _____________ __________ ______________ ___________ 110 Table E-1 Binary t[...]

xPico® Wi-Fi® Embedded Device Server User Guide 11 1: Using This Guide Purpose and Audience This guide provides the information nee ded to co nfigure, u se, and upda te the xPico® Wi-Fi® embedded device server. It is in tended for software developers and system in tegrators who are embedding this p roduct into their design s. Summary of Chapter[...]

1: Using This Guide xPico® Wi-Fi® Embedded Device Server User Guide 12 Additional Document ation Visit the Lantronix Web site at www.lantronix.com/su pport/documentation for the latest documentation and the following additional docum entation. Document Description xPico Wi-Fi Embedded Device Server Integration Guide Information about the xPico Wi[...]

xPico® Wi-Fi® Embedded Device Server User Guide 13 2: Introduction This chapter summarizes the b asic information an d features of the xPic o Wi-Fi embedde d device server. Key Features  Wireless LAN Interface: - IEEE 802.11 b/g and IEEE 802.11n (s ingle stream) - WLAN interface (2.4 GHz only) - IEEE 802.11 d/h/i/j/k/w/r - IEEE 802.11i Support[...]

2: Introduction xPico® Wi-Fi® Embedded Device Server User Guide 14 - CLI (Serial Monitor Port) - XML Configura tion Import and Export (X CR, XML S tatus Export [XSR ]) - WebAPI - Field upgrada ble firmware (OTA) - Power Management Framewor k - OEM Support Kit - Simple Customization and device configuration management  Security: - 256-bit AES e[...]

2: Introduction xPico® Wi-Fi® Embedded Device Server User Guide 15 Configuration Methods After installation, the xPico Wi-Fi embedded device server requires configuration. For the unit to operate correctly on a network, it must have a unique IP address on the n etwork. These methods may be used for logging into the xPico Wi-Fi and assigning IP ad[...]

2: Introduction xPico® Wi-Fi® Embedded Device Server User Guide 16 Figure 2-1 xPico Wi-F i Product Label[...]

xPico® Wi-Fi® Embedded Device Server User Guide 17 3: Configuration Using W eb Manager This chapter describes h ow to configure th e xPico Wi-Fi embedd ed device server using Web Manager, the Lan tronix browser -based configurati on tool. The unit’s configuration is stored in nonvolatile memory an d is retained without powe r. All changes take [...]

3: Configuration Using Web Manager xPico® Wi-Fi® Embedded Device Server User Guide 18 Stat u s P a g e The Status page is the first to appear after you log into Web Manage r. The Status page also appears when yo u click Status tab in Web Manager. Figure 3-1 Status Page[...]

3: Configuration Using Web Manager xPico® Wi-Fi® Embedded Device Server User Guide 19 We b Manager Component s The layout of a typical We b Manager page is below. Figure 3-2 Componen ts of the Web Manager Pa ge Navigating We b Manager The Web Manager provides an intu itive point-and-c lick interface. A menu bar on the left side of each page provi[...]

3: Configuration Using Web Manager xPico® Wi-Fi® Embedded Device Server User Guide 20 Table 3-3 Web Manage r Pages Web Manager Page Description See Page Status Shows product information, network, line status, and tunneling settings. 18 CPM Shows information about the Configurable Pins Manager (CPM) and how to set the configurable pins and roles t[...]

xPico® Wi-Fi® Embedded Device Server User Guide 21 4: Network Settings The Network Settings show the status of the So ftware en abled Access Point (SoftAP) or WLAN interface/link and let you configure the settings on the device. Interface sett ings are re lated to the configuration of the IP and related protocols. Link settings are rela ted to th[...]

4: Network Settings xPico® Wi-Fi® Embedded Device Server User Guide 22 To View Network 1 Interface Status Using Web Manager In Network Interface Status, you c an view both the current operational settings as well as the settings that would take effe ct upon a device reboot.  To view current access point (ap0) settings, go to Network on the men[...]

4: Network Settings xPico® Wi-Fi® Embedded Device Server User Guide 23 To Configure Networ k 1 Link Settings Using Web Manager  To modify network (ap0) Lin k information, click Netw ork on the menu and select apo > Link > Configuration . Using CLI  To enter the Access Point command level: config -> Access Point Using XML  Includ[...]

4: Network Settings xPico® Wi-Fi® Embedded Device Server User Guide 24 Network 2 (wlan0) Inte rface Configuration This page is used to configure th e network 2 inte rface on the d evice. To see the ef fect of these items after a reboot, view the Status page. Table 4-3 Network Interface Settings To Configure Network 2 Interface Settings Using Web [...]

4: Network Settings xPico® Wi-Fi® Embedded Device Server User Guide 25 Using XML  Include in your file: <configgroup name = "Interface" instance = "wlan0"> To View Network 2 Interface Status Using Web Manager In Network Interface Status, you c an view both the current operational settings as well as the settings that [...]

4: Network Settings xPico® Wi-Fi® Embedded Device Server User Guide 26 WLAN Profile WEP Settings WEP is a simple and efficient security mode encry pting the data via the RC4 algori thm. However, WEP has become more vulnerable due to advanc es in hacking technology. State of the art equipment can find WEP keys in five minutes. Fo r stronger securi[...]

4: Network Settings xPico® Wi-Fi® Embedded Device Server User Guide 27 Using CLI  To enter the WLAN Profile command level: config -> WLAN Profile <instance> Using XML  Include in your file: <configgroup name = "WLAN Profile" instance = " name "> Table 4-5 WLAN Profil e Basic Settings Table 4-6 WLAN Profile[...]

4: Network Settings xPico® Wi-Fi® Embedded Device Server User Guide 28 Table 4-7 WLAN Profile Advance d Settings WLAN Quick Connect WLAN QuickConnect allows users to view and add up to four WLAN profiles from a list of up to 20 wireless devices sorted by RSSI. Details of the selected networ k are pre-popu lated, so little or no configuratio n is [...]

4: Network Settings xPico® Wi-Fi® Embedded Device Server User Guide 29 Using XML  Not applicable. Table 4-8 WLAN Quick Connect WLAN Quick Connect Settings Description Network Name (search field) Enter a network name and click Scan to search for a network. Scan “<network SSID>” Perform a scan for devices within range of the xPico Wi-F[...]

xPico® Wi-Fi® Embedded Device Server User Guide 30 5: Interface Settings Line Settings The Line Settings allow configuratio n of the serial lines (ports). Some sett ings may be specific to only certain lines. Such s ettings are noted belo w. Note: The settings described below apply to both Line 1 and Line 2 unless otherwise noted. Table 5-1 Line [...]

5: Interface Settings xPico® Wi-Fi® Embedded Device Server User Guide 31 To Configure Line Settings Note: The following section describes the steps to view and configure Line 1 settings; these steps apply to other line instances of the device. Using Web Manager  To configure a specific line, click Line in the menu and select Line 1 -> Confi[...]

5: Interface Settings xPico® Wi-Fi® Embedded Device Server User Guide 32 Serial Perpheral Interface (SPI) Settings SPI settings pertaining to the bus master device can be modified in the xPico Wi-Fi unit. SPI settings, like line settings, allow for the selection of a protocol to be used with SPI. Changes take effect immediately. Table 5-2 SPI Con[...]

5: Interface Settings xPico® Wi-Fi® Embedded Device Server User Guide 33 To View SPI Status Using Web Manager  To view the current status and statisti cs for the SPI bus master device, click SPI in the menu and select Status . Using CLI  To enter the SPI command level: status -> SPI Using XML  Include in your file: <statusgroup nam[...]

xPico® Wi-Fi® Embedded Device Server User Guide 34 6: T unnel Settings The xPico Wi-Fi embe dded device serv er has two lines available for tunneling . T unnel Settings Tunneling allows serial devices to commu nicate over a network, without “b eing aware” of the devices which establish the network connection betwe en them. Tunneling parameter[...]

6: Tunnel Settings xPico® Wi-Fi® Embedded Device Server User Guide 35 Packing Mode With Packing, data from the serial Line is not sent over the network immediately. Instead, data is queued and sent in segments, when either th e ti meout or byte threshold is reached. Packing applies to both Accept and Co nnect Modes. Table 6-2 Tunnel Packing Mode [...]

6: Tunnel Settings xPico® Wi-Fi® Embedded Device Server User Guide 36 To Configure Tunnel Pa cking Mode Settings Using Web Manager  To configure the Packing mode for a sp ecific tunnel, click Tunnel in the menu and select Tunnel 1 -> Packing . Using CLI  To enter the Tunnel command level: config -> Tunnel <instance> Using XML ?[...]

6: Tunnel Settings xPico® Wi-Fi® Embedded Device Server User Guide 37 To Configure Tunnel Ac cept Mode Settings Using Web Manager  To configure the Accept Mode for a specific tunnel, click Tunnel in the menu and select Tunnel 1 -> Accept . Using CLI  To enter the Tunnel command level: config -> Tunnel <instance> Flush Start Char[...]

6: Tunnel Settings xPico® Wi-Fi® Embedded Device Server User Guide 38 Using XML  Include in your file: <configgroup name = "Tunnel Accept" instance = "1"> Connect Mode Specifies the conditions for connecting any A ccept Mode connection that may be established locally. Table 6-4 Tunnel Connect Mode Settings Tunnel Conn[...]

6: Tunnel Settings xPico® Wi-Fi® Embedded Device Server User Guide 39 To Configure Tunnel Co nnect Mode Settings Using Web Manager  To configure the Disconnect Mode for a specific tunnel, click Tunnel in the menu and select Tunnel 1 -> Connect . Using CLI  To enter the Tunnel command level: config -> Tunnel <instance> Using XML [...]

6: Tunnel Settings xPico® Wi-Fi® Embedded Device Server User Guide 40 To Configure Tunnel Disc onnect Mode Settings Using Web Manager  To configure the Disconnect Mode for a specific tunnel, click Tunnel in the menu an d select Tunnel 1 -> Disconnect . Using CLI  To enter the Tunnel command level: config -> Tunnel <instance> Usi[...]

6: Tunnel Settings xPico® Wi-Fi® Embedded Device Server User Guide 41 Using Web Manager  To configure the modem emulati on for a specific tunnel, click Modem Emulation in the menu and select Modem Emulation 1 -> Configuratio n .  To view the modem emulation status for a sp ecific tunnel, click Modem Emulation in the menu and sele ct Mode[...]

6: Tunnel Settings xPico® Wi-Fi® Embedded Device Server User Guide 42 ATUn Accept unknown commands. (n=0: off, n=1: on). ATVn Verbos e mode (n=0: numeric re sult codes, n=1: text result codes.) ATXn Command does nothing and returns OK status. ATZ Restore active settings from defaults. AT&F Reset saved settings in NVR to factory defaults. AT&a[...]

xPico® Wi-Fi® Embedded Device Server User Guide 43 7: Configurable Pin Manager The Configurable Pin Manager (CPM) is resp ons ible for the assignment and contro l of the configurable pins (CPs) available on th e xPico Wi-Fi embedded device server. Ther e are eight configurable pins on the xPico Wi-Fi unit. You must configure the CPs by maki ng th[...]

7: Configurable Pin M anager xPico® Wi-Fi® Embedded Device Server User Guide 44 Note: To modify a CP, all roles in whic h it is a member must be disabled. Note: The changes to a CP configuration ar e no t saved in FLASH. Inst ead, these CP settings are used when th e CP is added to a CP Role. When the CP Ro le is saved, its CP settings are saved [...]

7: Configurable Pin M anager xPico® Wi-Fi® Embedded Device Server User Guide 45 Table 7-3 Role Configuration To Configure CPM Settings Using Web Manager  To view or configure a configurable pin, click CPM in the menu, selec t CPs then the Detail link to the right of a specific CP to configure.  To configure a CPM role, click CPM in the menu[...]

xPico® Wi-Fi® Embedded Device Server User Guide 46 8: Services Settings HTTP Settings Hypertext Transfer Protoco l (HTTP) is the tr ansport pr otocol for co mmunicating hypertext documents on the Int ernet. HTT P defines ho w message s are form atted and transmitted . It also defines the actions web servers and bro wsers sh ould take in response [...]

8: Services Settings xPico® Wi-Fi® Embedded Device Server User Guide 47 To View HTTP Status Using Web Manager  To view HTTP status, c lick HTTP in the menu and select Status . Using CLI  To enter the HT TP Server command level: status -> HTTP Server> Using XML  Look for the status header: <statusgroup name = "HTTP Server &q[...]

xPico® Wi-Fi® Embedded Device Server User Guide 48 9: Maintenance and Diagnostics Settings File System Settings The xPico Wi-Fi embedded device server uses a flas h file system to store files. The file system can be formatted and co mpacted: formatting eras e s all files while preserving configuration, and compacting reclaims dirty space while pr[...]

9: Maintenance and Diagnostics Settings xPico® Wi-Fi® Embedded Device Server User Guide 49 Using XML  Not applicable. File Manipulation The xPico Wi-Fi embe dded device ser ver allows for files to be deleted, moved, renamed, and uploaded via HTTP. Directories can be cre ated, deleted, moved, and rename d. To Transfer or Modify File System File[...]

9: Maintenance and Diagnostics Settings xPico® Wi-Fi® Embedded Device Server User Guide 50 Note: Go to Chapter 13: Updating Firmwa re for directions on up loading new firmware. To Save Configuration, Reboot, Restore Factory Defaults or Upload Firmware Using Web Manager  To access the area with optio ns to reboot, rest ore to factory defaults ,[...]

9: Maintenance and Diagnostics Settings xPico® Wi-Fi® Embedded Device Server User Guide 51 Diagnostics Settings The xPico Wi-Fi embedded device server ha s tools for diagnostics and statistics. Options allow for the viewing of hardware, IP sockets, threads, and buffe r pools. To View Hardware Status Using WebManager  To view hardwa re informat[...]

xPico® Wi-Fi® Embedded Device Server User Guide 52 10: Advanced Settings XML Import and XML Export The xPico Wi-Fi embe dded device server allows for the configuration of devices b y using XML configuration records (X CRs). You can expor t an ex isting configuratio n for use on other xPico Wi- Fi devices or import a save d configuration file. XML[...]

10: Advanced Settings xPico® Wi-Fi® Embedded Device Server User Guide 53 --------------------------------- ---------------------------------- a move cursor to begin of line b move cursor backward word d delete character under cursor f move cursor forward word e move cursor to end of line [A previous command k delete to end of line [B later comman[...]

10: Advanced Settings xPico® Wi-Fi® Embedded Device Server User Guide 54 To Configure Performance Using Web Manager  To modify performance settings, click Performance in the menu. Using CLI  To enter the Performance comma nd level: config -> Performance Using XML  Include in your file: <configgroup name = "Performance"[...]

xPico® Wi-Fi® Embedded Device Server User Guide 55 1 1: Monitor The Monitor feature can be use d to query and captur e desired info rmation during an x Pico Wi-Fi serial port to serial device connection. Monitor Settings Through the Mon itor feature in Web Manage r, yo u may configure the monitoring of a connected serial device through a sequ enc[...]

11: Monitor xPico® Wi-Fi® Embedded Device Server User Guide 56 Rule <Number> Click the Edit link to edit a specific rule in the Step 2: Setup Commands page. Two rule configuration fields will op en for this rule. When you begin enterin g information in these fields, additi onal Rule <Number> options become availab le containing the tw[...]

11: Monitor xPico® Wi-Fi® Embedded Device Server User Guide 57 Configuration Configure the moni toring of a connected seri al device through specific configura tion settings pages : Initialization, Control, Po ll , Filter, and Data. Access th e configuration options displayed in Table 11-2 on the Initialization page. These configuration fields ar[...]

11: Monitor xPico® Wi-Fi® Embedded Device Server User Guide 58 Access the configuration options displaye d in Table 11-4 o n the Poll page. The se configuration fields are the same ones in Step 3: Define Filters if utilizing Explorer. Table 11-4 M onitor Poll Settings Access the configuration options displaye d in Table 11-5 o n the Filter page. [...]

11: Monitor xPico® Wi-Fi® Embedded Device Server User Guide 59 Access the configuration options displaye d in Table 11-6 on the Data pa ge. These configuration fields are the same ones in Step 4: Pick Data if utilizing Explorer. Table 11-6 Monitor Data Set tings To Configure Monitor The easies t way to view m onitor stat us or mo dify monitor set[...]

11: Monitor xPico® Wi-Fi® Embedded Device Server User Guide 60 Example: Dat a Captur e on a Serial Device Connect the xPico Wi-Fi serial port to a serial device, then que ry and capture desir ed information periodically, presenting this informat ion on a We b page. Sample Configuration  Connect to the Command Line Interface (CLI) on the EDS210[...]

11: Monitor xPico® Wi-Fi® Embedded Device Server User Guide 61 Polling Periodically your xPico Wi-Fi w ill send commands to query information from yo ur serial device. STEP 1 - STRATEGY Explore your serial device and determin e your strategy for eliciting all of the desired data with the fewest message Commands. STEP 2 - SETUP Use Monitor Explore[...]

11: Monitor xPico® Wi-Fi® Embedded Device Server User Guide 62 Filtering The response to each po ll will be sliced up according to your filter rules. The obj ective is to simply slice enough so you can subsequently point to th e data fields you want to mine. Note the raw data in the grey box above; it reflects what was receiv ed from th e serial [...]

11: Monitor xPico® Wi-Fi® Embedded Device Server User Guide 63 Note: Some devices might use a variable number of lines to display sta tus depending on the device state. If so, slicing first by lin es will not consistently point to the desired data. Instead, consider a d ifferent strategy:  Rule 1 can use Mode = Delim iters, but set the Delimit[...]

11: Monitor xPico® Wi-Fi® Embedded Device Server User Guide 64 Presenting STEP 1 - STRATEGY Here you cons ider your options for sharing the data you have mined. For human users, a Web page presentation is simplest. For machine- to-machine communication, XML might be best. Command Line could be us ed for eith er. STEP 2 - SETUP Automatically your [...]

11: Monitor xPico® Wi-Fi® Embedded Device Server User Guide 65 Figure 11-16 Monitor XML Co mmands  For XML we start at the root Command Line In terface, type "xml", then "xsr dump mon itor". We see a statusitem name = "data", instance = "Up time", with value containing th e present data. DA T A CAPTURE O[...]

xPico® Wi-Fi® Embedded Device Server User Guide 66 12: Branding the xPico Wi -Fi Unit This chapter descr ibes how to brand the Web Manager user interface of your xPico Wi-Fi embedded device server. We b Manager Customization Changing the Presentation You can customize the Web M anager's appearance by modifying index.html and style.css . The [...]

12: Branding the xPico Wi-Fi Unit xPico® Wi-Fi® Embedded Device Server User Guide 67 Note: This path schema is subject to change in the future. Other Overridable Files In addition to index.htm l, and sty le.css, a few other pr esentation- related f iles can be o verridden. The complete list is as follows:  /resource/main/web_manager/w eb/index[...]

xPico® Wi-Fi® Embedded Device Server User Guide 68 13: Updating Firmware Obt aining Firmware Obtain the most up-to-date firmware and release notes for the unit from the Lantr onix Web site ( www.lantronix.com/ supp ort/downloads/ ) or by using anonym ous FTP ( ftp://ftp.lantronix.com/ ). Loading New Firmware through Web Manager Upload the firmwar[...]

13: Updating Firmware xPico® Wi-Fi® Embedded Device Server User Guide 69 5. Select the file and click Open . 6. Click Upgrade to install the firmware on the xPico Wi-Fi embedded device server. 7. Click OK in the confirmation pop-up which appears. The firmware will be installed and the device will automatically reboot afterwards. 8. Close and reop[...]

xPico® Wi-Fi® Embedded Device Server User Guide 70 Appendix A: Command Reference The xPico Wi-Fi embe dded device ser ver supports thr ee convenient config uration methods: Web Manager, Command Line Inte rface (CLI) and Ext ensible Markup La nguage (XML). This appendix describes how to configure the xPico Wi-Fi embedded device ser ver using the C[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 71 Configuration Using Serial Port Serial Command Mode The serial p ort can be configured t o operate in command mode per manently o r to be trig gered under specified conditions. See the line <line> Level command descrip tion for more informati on. Boot to CLI Re[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 72 Navigating the CLI Hierarchy The CLI is organized into a hie rarchy of levels. Each level has a group of comma nds for a specific purpose. For example, to view diagno stic or device stat us, one would navigate to the status level where they could then navigate to dia[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 73 Underst anding the CLI Level Hierarchy The CLI hierarchy is a serie s of levels. Arranging commands in a hierarchy of levels provi des a way to organize and group similar comm ands, provid e different levels of security, and reduce the complexity and number command s[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 74 parameters for a xPico Wi-Fi embedd ed device server, or it ma y only change the baud rate for a single serial line. Using XCRs is a straightforwar d and flexible way to manage the configuratio n of multiple XPico Wi-Fi embedded device servers. Note: For directions o[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 75  An empty or missing <value > element in each present <configgroup> clear s the setting to its default. Quick T our of XML Synt ax Declaration The first line, <?xml version="1.0" standalone="yes"?> , is called the XM L declara[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 76 Record, Group, Item, and V alue T ags A <configgroup> is a logical grouping of configu ration parameters and must contain one or more <configitem> elements. It must have a na me attribute and may have an instance attribute. A <configitem> is a speci[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 77 XML for xPicoWi-Fi Embedded Device Server configgroup Access Point These settings pertain to the Access Point in the device. Changes will take effect after reboot. configitem SSID value The default value of SSID is XpicoWiFi_hhhhhh, where hhhhhh are the last 6 hex di[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 78 value CP This is the number of the Configurable Pin ( CP ) assigned to the role. Enter blank or 0 to revert to <No CP Selected>. Blank the value for "< No CP Selected>". value State The Enabled State allows the application to use the desi gnated[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 79 configitem Access Control value URI The URI must begin with / to refer to the file system. URI may contain up to 255 characters. value AuthType The different AuthType values offer various levels of secu rity. From the least to most secure: None no authentication nece[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 80 configitem IP Address value IP Address may be entered alone, in CIDR form, or with an explicit mask: 192.168.1.1 (default mask) 192.168.1.1/ 24 (CIDR) 192.168.1.1 255.255.255.0 (exp licit mask) The IP Address will be displayed al ways in CIDR, the canonical form. IP [...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 81 configitem Name value The Name is fo r display purposes onl y. Name may contain up to 25 characters. configitem State value Enable the State to allow the Serial Line to operate. State may be "Enabled" or " Disabled". configitem Protocol value Prot[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 82 configitem Stop Bits value Stop Bits may be "1" or "2". configitem Flow Control value Flow Control may be "None", "Hardware" or "Software". configitem Xon Char value When specifying Xon Char , prefix decimal with or[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 83 Instance may contain up to 32 characters. value State Enable the State to allow the named Appli cation to hold power on. State may be "Enabled" or " Disabled". configitem Maximum Time Powered Down value Maximum Time Powered Down has units of sec o[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 84 configitem Target Speed value Target Speed selects the target clock speed of the SPI. The Target Speed may be lowered to the closest Operating Speed capability of the device. If so, a warning will be noted. 0 or clearing the selection selects the minimum speed. Targe[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 85 configitem Instance value Instance may contain up to 16 characters. configitem Password value Password may contain up to 32 characters. The value is HIDDEN. configgroup WLAN Profile These settings pertain to a WLAN Profile on the device. In the Security section, choi[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 86 The value is HIDDEN. value WPAx Key Type Key Type may be "Passphrase" or "Hex". value WPAx Passphrase Passphrase may contain up to 63 characters. The value is HIDDEN. value WPAx Key Key may contain up to 32 bytes. The value is HIDDEN. value WPAx E[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 87 configitem WLAN Profile delete value name name may contain up to 35 ch aracters. configgroup Modem Emulation Connections can be initiated and accepted using Modem "AT" commands incoming from the Serial Line. configitem Listen Port value Specify a Listen Por[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 88 configitem Incoming Connection value Incoming Connection requests may be disable d (ATS0=0), answered automatically (ATS0=1), or answered manually via the ATA comman d afte r an incoming RING (ATS0=2 or higher). Incoming Connection may be "Disabled", "[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 89 10 (decimal) End Character may contain one character, where <control>J, for example, counts as one. value Length Sets the Length of response. Response is ended by any config ured End Character , Length OR Timeout . Length has units of bytes. value Timeout Sets[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 90 value Timeout Sets the Timeout to receive response. Minimu m timeout is 100 milliseconds. Response is ended by any config ured End Character , Length OR Timeout . Timeout has units of milliseconds. Blank the value for "<Minimum>". configgroup Monitor [...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 91 only once. Delay has units of seconds. configgroup Monitor Filter These settings pertain to Monitor Filter in the device. Filter settings will be applied to all received response. Filter results can be used to feed another filter or use as Data Reference. configitem [...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 92 configgroup Monitor Data These settings pertain to Monitor Data in the device. Data configured here will be accessible through the status of Monitor . configitem Selector value Name Sets Name to enable the data selector. Name may contain up to 16 characters. value Re[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 93 configitem Protocol value The Protocol used on the connection can be TCP. Protocol may be "TCP". configitem Start Character value When the Start Character is received on the Serial Line, it en ables the tunnel to listen for a network connection. The Start C[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 94 configitem Block Network value Block Network may be enabled for debu gging purposes . If Enabled , incoming characters from the network will NOT be forwarded to the Serial Line. Instead, they will be buffered and will eventually flow off the network side. If Disabled[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 95 configgroup Tunnel Connect Tunnel Connect controls how a tunnel behaves when a connection attempt originates locally. configitem Mode value A Connect Tunnel can be started in a number of ways, acco rding to its Mode : Disabled: never started. Always: always started. [...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 96 value Port The Host Port is required to enab le a Connect Tunnel. It designates the TCP port on th e remote host to connect to. Blank the value for "<Non e>". value Protocol The Protocol used on the connection can be TCP. Protocol may be "TCP&quo[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 97 configitem Block Network value Block Network may be enabled for debu gging purposes . If Enabled , incoming characters from the network will NOT be forwarded to the Serial Line. Instead, they will be buffered and will eventually flow off the network side. If Disabled[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 98 configitem Flush Line value Flush Lin e enabled will flush the Serial Line when the Tunnel is disconnected . Flush Lin e may be "Enabled" or "Disab led". configgroup Tunnel Packing When Tunneling, instead of sending data on the network immediately[...]

Appendix A: Command Reference xPico® Wi-Fi® Embedded Device Server User Guide 99 configitem Trailing Character value The Trailing Character is an optional single printable character or control character that is injected into the outgoing data st ream right after the Send Character . Control characters may be input in any of the following forms: &[...]

xPico® Wi-Fi® Embedded Device Server User Guide 100 Appendix B: W ebAPI WebAPI is a cloud function API allowing access to configuration and status information of xPico Wi-Fi embedded device server thr ough standard HTTP req uest. Export S t atus Group An HTTP POST request can be sent to th e device to retrieve status infor mation. Protocol: HTTP [...]

Appendix B: WebAPI xPico® Wi-Fi® Embedded Device Server User Guide 101 optionalBoolNeedSec ret: To retrieve the or iginal value for hidden co nfiguration, set this to "true". CURL exampl e: curl -u admin:PASSWORD http://172.19.100.125/export/config -X POST curl -u admin:PASSWORD http://172.19.100.125/export/config -X POST -d "optio[...]

Appendix B: WebAPI xPico® Wi-Fi® Embedded Device Server User Guide 102 Import Configuration Group An HTTP POST request can be sent to the device to se t configuration. Protocol: HTTP Method: Post Content-Type: mu ltipart/form-data URL: http://<hostname> /import/config Parameters: configrecord: Content of config uration grou p in XML format.[...]

xPico® Wi-Fi® Embedded Device Server User Guide 103 Appendix C: T echnical Support If you are unable to r esolve an iss ue using the informatio n in this doc umentation , please c ontact Technical Support. North America Hours: 6:00am - 5:00pm Pacific Time Mon. - Fri. (excluding holid ays) www.lantronix.com/support/ FTP: ftp.lantronix.com Tel: (80[...]

Appendix C: Technical Suppo rt xPico® Wi-Fi® Embedded Device Server User Guide 104 Latin America & Caribbean la_sales@lantronix.com Tel: +1 949 453 3990 Online Support options listed below are available 2 4 hour s a day, 7 days a week at the Lantro nix support page at http://www.lantro nix.com/support  Download firmware  Search and revi[...]

xPico® Wi-Fi® Embedded Device Server User Guide 105 Appendix D: Compliance (According to ISO/IEC Guide and EN 45014) Manufacturer's Name & Address: Lantronix, Inc. 167 Technology Drive, Irvine, CA 92618 USA Declares that the following product: Product Name Model: xPico® Wi-Fi® Embedded Device Server Conforms to the following standards [...]

Appendix D: Compliance xPico® Wi-Fi® Embedded Device Server User Guide 106 Table D-3 Safety Hereby, Lantronix, decla res that this xPico Wi-F i is in compliance with th e essential requirements and other relevant provisions of Directive 1999/5/EC. Country Specification World Wide CB EN 60950-1:2006 + A11:2009 + A1:2010 + A12 :2011 In accordance w[...]

Appendix D: Compliance xPico® Wi-Fi® Embedded Device Server User Guide 107 Federal Communication Commissi on Interference St atement This device complies with Part 15 of the FCC Ru les. Operation is subject to the following two conditions: ( 1) This devi ce may not cause harm ful interfer ence, and (2) this dev ice must acce pt any interference r[...]

Appendix D: Compliance xPico® Wi-Fi® Embedded Device Server User Guide 108 IMPORTANT NOTE: In the even t that thes e conditio ns can not be met (fo r example certain laptop configurations or co-locat ion with another transmitter) , then the FCC authorization is no longer considered valid and the FCC ID can not be used on the final product. In the[...]

Appendix D: Compliance xPico® Wi-Fi® Embedded Device Server User Guide 109 As long as 2 conditions above are met, further trans mit ter test will not be re quired. However, the OEM integrator is still responsible for testing their end-product for any additional compliance requirements requ ired with this module installed. Cet appareil est conçu [...]

Appendix D: Compliance xPico® Wi-Fi® Embedded Device Server User Guide 110 Manuel d'information à l'utilisateur final L'intégrateur OEM doit être consci ent de ne pas fournir des informations à l'utilisateur final quant à la façon d'installer ou de suppri mer ce module RF dans le manuel de l'utilis ateur du pro[...]

Appendix D: Compliance xPico® Wi-Fi® Embedded Device Server User Guide 111 Manufacturer's Contact: Lantronix, Inc. 167 Technology Drive, Irvine, CA 92618 USA Tel: 949-453-3 990 Fax: 949-453-3 995 RoHS Notice All Lantronix products in the following famili es are Chin a RoHS-compliant a nd free of the foll owing hazardous substances and elemen[...]

xPico® Wi-Fi® Embedded Device Server User Guide 112 Appendix E: Binary to Hexadecimal Conversions Many unit configuration pr ocedures require you to assemble a series of options (re presented as bits) into a complete command (represented as a byte). The resulting binary value must be conv erted to a hexadecimal rep resentation. Use this chapter t[...]

Appendix E: Binary to Hexade cimal Conversio ns xPico® Wi-Fi® Embedded Device Server User Guide 113 Figure E-2 Wind ows Scientif ic Calculato r 4. Click Hex . The hexadecimal value appears. Figure E-3 Hexadecimal Values in th e Scientific Calculator[...]