(for example, digital device emission, PC peripheral requirements, etc.) Note: In the event that these conditions cannot be met (for example certain laptop configurations, general purpose PCMCIA or similar cards, or co- WiPort Embedded Wireless Device Server User Guide...
FCC ID cannot be used on the final product (including the transmitter) and obtaining a separate FCC authorization. Note: Changes or modifications to this device not explicitly approved by Lantronix will void the user's authority to operate this device. Note: This product is only applicable for indoor use.
3: Using DeviceInstaller Installing DeviceInstaller __________________________________________________ 14 Assigning an IP Address _________________________________________________ 14 Accessing WiPort Using DeviceInstaller _____________________________________ 15 Viewing the WiPort Device Server’s Current Configuration _______________________ 15 4: Using DeviceInstaller Installing DeviceInstaller __________________________________________________ 18 Assigning an IP Address _________________________________________________ 18...
Page 6
Email Configuration _____________________________________________________ 62 Mail Server _______________________________________________________________ 63 Unit Name _______________________________________________________________ 63 Domain Name ____________________________________________________________ 63 Recipient 1 _______________________________________________________________ 63 Recipient 2 _______________________________________________________________ 64 Trigger 1 _________________________________________________________________ 64 Trigger 2 _________________________________________________________________ 64 Trigger 3 _________________________________________________________________ 64 WiPort Embedded Wireless Device Server User Guide...
1: Using This Guide Purpose and Audience This guide provides the information needed to configure, use and update the WiPort and is intended for software developers and system integrators who are embedding the WiPort in their designs. Note: For the WiPort model WP2001000M-02, additional information is in the Modbus Protocol User Guide located at www.lantronix.com/support/documentation.html.
Visit the Lantronix web site at http://www.lantronix.com/support/documentation.html for the latest documentation and the following additional documentation: WiPort Development Kit Quick Start Guide - Briefly explains the basics to get the WiPort up and running. WiPort Integration Guide - Provides information about the WiPort hardware ...
It includes an operating system, an embedded Web server, and a full TCP/IP protocol stack. In addition, the WiPort sends email alerts and supports numerous other network communication protocols, including ARP, UDP, TCP, ICMP, Telnet, AutoIP, DHCP, HTTP, SNMP, and SMTP.
WiPort-G models are configurable for wireless bridging (see on 8: Wireless Bridging). This allows a host connected to the WiPort over a wired Ethernet interface to be accessible over a wireless network. SmartRoam (patent pending) feature transfers connectivity from one AP to ...
The hardware address is also referred to as the Ethernet address or the MAC address. The first three bytes of the Ethernet address are fixed and read 00-20-4A, identifying the unit as a Lantronix product. The fourth, fifth, and sixth bytes are unique numbers assigned to each unit.
Note: If the unit already has an IP address (e.g., DHCP has assigned an IP address), click the Search icon and select the unit from the list of Lantronix device servers on the local network. 5. Click the Assign IP icon 6.
3. Expand the list of WiPort embedded wireless device servers by clicking the + symbol next to the WiPort icon. Select the WiPort unit by clicking on its IP address to view its configuration. Viewing the WiPort Device Server’s Current Configuration...
Page 16
Displays the firmware currently installed on the WiPort. Version Online Status Non-configurable field. Displays the WiPort’s status as online, offline, unreachable (the WiPort is on a different subnet), or busy (the WiPort is currently performing a task). IP Address Non-configurable field. Displays the WiPort’s current IP address.
Page 17
Maximum Baud Rate Non-configurable field. Displays the WiPort’s maximum baud Supported rate. Note: the WiPort may not currently be running at this rate. Firmware Upgradable Non-configurable field. Displays True, indicating the WiPort’s firmware is upgradeable as newer version become available. Supports Configurable Non-configurable field.
4: Using DeviceInstaller This chapter covers the steps for getting the WiPort device server online and viewing its current configuration. Note: DeviceInstaller is a free utility program provided by Lantronix that discovers, configures, upgrades, and manages Lantronix Device Servers. It can be downloaded from the Lantronix website at www.lantronix.com/support/downloads.
2. Click the WiPort folder. The list of available Lantronix WiPort device servers display. 3. Expand the list of WiPort device servers by clicking the + symbol next to the WiPort icon. Select the WiPort by clicking on its IP address to view its configuration.
Page 20
Online Status Non-configurable field. Displays the WiPort embedded wireless device server’s status as online, offline, unreachable (the WiPort unit is on a different subnet), or busy (the WiPort embedded wireless device server is currently performing a task). IP Address Non-configurable field.
Page 21
Non-configurable field. Displays True. WiPort embedded wireless device server supports baud rates up to 921600 bits per second (bps). Supports Wired Ethernet Non-configurable field. WiPort sup ports baud rates up to 920k. Supports HTTP Server Non-configurable field. Displays True. Supports HTTP Setup Non-configurable field.
2. Select the WiPort unit by clicking its IP address. 3. In the right window, click the Web Configuration tab. 4. To view the WiPort’s Web Manager in the current DeviceInstaller window, click Go. To open the Web Manager in a web browser, click Use External Browser.
Figure 4-1. Web Manager The main menu is in the left side of the Web Manager window. Note: Alternatively, access the WiPort’s Web Manager if it is connected to the network by entering its IP address in a web browser. Network Configuration The unit’s network values display upon selecting Network from the main menu.
2. Modify the following: Network Mode Select Wireless Only to enable only the wireless network connectivity for the WiPort. Select Wired Only to enable only the Ethernet network connectivity. Select Bridging to enable bridging on the WiPort (for more information on bridging, see 8: Wireless Bridging).
Select Enable to permit Dynamic Host Configuration Protocol (DHCP). DHCP automatically assigns a leased IP address to the WiPort unit. Auto-IP The WiPort generates an IP in the 169.254.x.x address range with a Class B subnet. Select the Enable checkbox to enable this feature. DHCP Host Name Enter the name of the host on the network providing the IP address.
Speed: The speed of data transmission. The default setting is 100 Mbps. Duplex: The direction of data transmission. The default setting is Full. 2. When you are finished, click the OK button. 3. On the main menu, click Apply Settings. WiPort Embedded Wireless Device Server User Guide...
Server configuration menu. Figure 4-4. Server Settings To configure the WiPort’s device server settings: 1. Click Server from the main menu. 2. Configure or modify the following fields: WiPort Embedded Wireless Device Server User Guide...
Page 28
Allows for the configuration of the 0x77FE server port number. Enter a number between 1 and 65535. The configuration is available only in bridging mode for the discovery of Lantronix device servers behind the bridge. The default 0x77FE server port number is 30718.
4. On the main menu, click Apply Settings. Host List Configuration The WiPort scrolls through the host list until it connects to a device listed in the host list table. After a successful connection, the unit stops trying to connect to any others.
For Channel 1 this option will be in disabled mode. Note: Using a telnet session (see Baudrate) you may enter a baud rate of 00 in channel settings to disable the serial port. . WiPort Embedded Wireless Device Server User Guide...
It indicates the end of transmission. Pack Control Enable Packing Select the checkbox to enable packing on the WiPort. Two firmware-selectable packing algorithms define how and when packets are sent to the network. The standard algorithm is optimized for applications in which the unit is used in a local environment, allowing for very small delays for single characters, while keeping the packet count low.
1. From the main menu, click Connection for either Channel 1 or Channel 2 to display the Connection Settings page for the selected channel. 2. In the available fields, enter the following information: Connect Protocol Protocol Select TCP from the pull down menu. WiPort Embedded Wireless Device Server User Guide...
Page 33
With Active Mdm Ctrl In: Accepts external connection requests only when the modem_control_in input is asserted. With Start Character: Attempts to connect when it receives a specific start character from the serial port. The default start WiPort Embedded Wireless Device Server User Guide...
If this connection fails, the unit continues to scroll through the table until it is able to connect to another IP in the host list. The host list is disabled for Manual Mode and for Modem WiPort Embedded Wireless Device Server User Guide...
1. From the main menu, click Connection for either Channel 1 or Channel 2 to display the Connection Settings page for the selected channel. 2. In the available fields, enter the following information: Connect Protocol Protocol Select UDP from the pull down menu. WiPort Embedded Wireless Device Server User Guide...
Page 36
Note: Lantronix Tech Support supports Datagram type 01. Datagram Type FD is for OEM use. 3. When you are finished, click the OK button. 4. On the main menu, click Apply Settings. WiPort Embedded Wireless Device Server User Guide...
Enter the port number on the email server. Domain Name Enter the email server’s domain name. Unit Name Enter the username used by the WiPort to send email messages. Note: Do not use spaces in the name. Recipients Recipient 1: Enter the email address designated to receive email notifications.
None. If both the serial sequence and the configurable pins are disabled, the trigger is disabled. To configure the WiPort’s email trigger settings: 1. From the main menu, select Trigger 1, Trigger 2, or Trigger 3 to configure the desired Trigger settings.
Due to regulations, the country-specific setting has been removed from the setup menu and Web Manager. However, we provide a separate utility for changing the Country/Zone setting. The utility is called SetZone and is included in the WiPort package. It is also available for download from the Lantronix web site.
Page 40
4: Configuration Using Web Manager Figure 4-11. WLAN Settings 2. Enter or modify the following fields: Wireless Network Configuration Network Name (SSID) Enter the name of the wireless network (SSID). The WiPort connects to this wireless network. Network Type Select Infrastructure or Ad-Hoc. Channel Configurable only when Network Type is set to Ad-Hoc.
TX Data Rate WiPort permits the control of the transmission data rate. Click the Auto check box to allow the WiPort to automatically set the data rate (or leave unchecked to set the transmission rate manually). The default rate is 54 Mbps.
3. When you are finished, click the OK button. 4. On the main menu, click Apply Settings. Configurable Pin Settings There are 11 configurable hardware pins on the WiPort unit. For each pin, configure the pin function, communication direction, and its activity level. For more information, Configurable Pins on page 77.
Page 43
Allows for control of the connection (and disconnection) on channel 2. Modem Ctrl Channel 2 Indicates a connection is established on channel 2. Serial Channel 1 Status Indicates channel 1 status and extended diagnostics when the Diagnostics LED is lit. WiPort Embedded Wireless Device Server User Guide...
1. Click the Apply Defaults button to set the devic server back to the default settings. For details, see Default Settings on page 74. 2. Click Yes to set factory settings, or click No to cancel. WiPort Embedded Wireless Device Server User Guide...
Configure the unit so that it can communicate on a network with your serial device. As an alternative to Web Manager, the WiPort unit is configurable using a terminal program to access the serial port locally. Using this terminal program to respond to prompts is referred to as the Setup Mode.
The default serial port settings are 9600 baud, 8 bits, no parity, 1 stop bit, no flow control. 2. Reset the WiPort unit by cycling the unit's power (turning the power off and back on). Immediately upon resetting the device, enter three lowercase x characters (xxx).
Change Setup menu). The following sections describe the configurable parameters within the Server configuration menu. Network Mode Select the network mode for the WiPort. Options available are Wired Only, Wireless Only, and Bridging. For more information on Bridging, see 8: Wireless Bridging page 85.
Default DHCP Name: If the DHCP name is not changed and the IP is 0.0.0.0, then the DHCP name defaults to XXXXXX (XXXXXX is the last 6 digits of the MAC address shown on the label on the bottom/side of the unit). WiPort Embedded Wireless Device Server User Guide...
I/F Mode (4C) ? _ Note: RS-422 and RS-485 are available on Channel 2 only if the WiPort is used with the WiPort evaluation board. Otherwise, RS-422 and RS-485 functions are available on only one channel; depending on which channel the drivers were added, these functions are available on either channel 1 or channel 2.
Note: If attempting to select an I/F Mode bit pertaining to RS-422/485 on a WiPort model WP2001000-01, a “WARNING: RS-422/485 I/F Modes not supported” message displays. RS-422/485 settings are available on the WP2004000-01 (WiPort-485) and all the WiPort b/g models including WP2001000G-02, WP2002000G-02, and WP200200SG-02.
Accept with active Modem Control In Always Accept Response Nothing (quiet) Character response (C=connect, D=disconnect, N=unreachable) Active Startup No active startup With any character With active Modem Control In With a specific start character WiPort Embedded Wireless Device Server User Guide...
Page 53
C (ASCII 0x43), and the last character must be either a carriage return (ASCII 0x0D) or a line feed (0x0A). No blanks or space characters may be in the command string. WiPort Embedded Wireless Device Server User Guide...
Page 54
Connects to 129.1.28.10, port 12 C0.0.0.0/0 Enters Monitor Mode Cwww.lantronix.com/ Tries to connect to the Lantronix web server if the <hostname:domain> (www.lantronix.com) is configured in the DNS server database. Autostart (Automatic The unit automatically attempts a connection to the remote IP Connection) address and port after booting up.
Page 55
3. After completing the hostlist, repeat the previous step if necessary to edit the hostlist again. 4. For Retrycounter, enter the number of times the Lantronix unit should try to make a good network connection to a hostlist entry that it has successfully ARPed.
Page 56
Modem Responses Full Verbose: The unit responds to a command with a message Only string shown in the table below. Numeric Response: The unit responds to a command with a numeric response. WiPort Embedded Wireless Device Server User Guide...
Page 57
The serial interface reverts to accepting command strings. If this sequence is not followed, the unit remains in data transfer mode. WiPort Embedded Wireless Device Server User Guide...
Send the Escape Sequence (+++) in Modem Mode Send ‘+++’ in Modem Mode (Y) ? _ Disable or enable the WiPort’s ability to send the escape sequence. The default is Y (Yes) (send the escape sequence). Show IP addr after 'RING' Show IP addr after ‘RING’...
6: Configuration via Serial Mode or Telnet Port Auto Increment Source Port Auto increment source port (N) ? _ Y (Yes) auto increment the source port. The WiPort increments the port number used with each new connection. Remote IP Address This is the destination IP address used with an outgoing connection.
6: Configuration via Serial Mode or Telnet Port (1) The WiPort sends the "Terminal Type" upon an outgoing connection. (2) A password is required for a connection to the serial port from the network. (3) The TCP connection closes even if the remote site does not acknowledge the disconnection.
Enter time in the format mm:ss, where m is the number of minutes and s is the number of seconds. Note*: The default port number for Port 1 is 10001 and 10002 for Port 2. However, port numbers may be set to a different value. DisConnTime (0: 0) ?: WiPort Embedded Wireless Device Server User Guide...
The current value is displayed in parentheses. Mail Server (0.0.0.0) ? ( 0) _ Unit Name Enter the username used by the WiPort to send email messages. The current value is displayed in parentheses. Note: Do not use spaces in the name.
Refer to Trigger 1 for details on completing these fields. Note: Each trigger is independent of the others. Each condition within an individual trigger must be met before the unit will send the email. WiPort Embedded Wireless Device Server User Guide...
WEP. For example, if the WiPort is configured for WEP and the AP supports TKIP, the negotiation results in the use of TKIP. If the WiPort is configured for TKIP and the AP supports only WEP, the association will fail because the AP does not meet the WiPort’s requirements.
Enter the name of the network to which the WiPort will connect. Network name (LTRX_IBSS) ? _ Adhoc Network Channel When Adhoc is selected in the Topology parameter and the WiPort cannot find the specified network, it creates one with that name by transmitting a beacon on the selected channel.
Enter the new encryption key. The passphrase input is not the same as ASCII input (as used on some products). ASCII is translated directly into hexadecimal bytes according to the ASCII table. The WiPort passphrase is hashed using the Neesus Datacom algorithm (for WEP64) or MD5 (for WEP128).
TX Data rate 0=fixed, 1=auto (1) ? _ Transmission Data Rate If the above TX Data rate is set to fixed, the selected data rate is the WiPort’s fixed transmission rate. If the above TX Data rate is set to auto, the selected data rate is the WiPort’s maximum data rate.
If enabled, SmartRoam (patent pending) manages the dynamic list of APs belonging to the same network as the AP to which the WiPort is currently associated and stores relevant selection criteria for this list. The WiPort uses these criteria to identify a candidate AP.
ARP Cache timeout in s (1s – 65s; 0s=disable): (600)? _ CPU Performance Select the WiPort’s performance mode. Higher performance settings require more energy. Low is 26 Mhz, Regular is 48 Mhz, High is 88 Mhz. The default setting is Regular.
TCP Re-transmission Timeout This feature allows the configuration of the desired TCP re-transmission timeout value. If the ACK is not received for a packet sent from the WiPort device, then the unit will retransmit the data. The valid range is 500-4000 msec.
Enable Encryption (N) ? Enable Enhanced Password (N) ? Disable Port 77F0h (N) ? Disable SNMP For security purposes, disable SNMP (if required) on the WiPort unit. The current setting is displayed in parentheses. Disable SNMP (N) ? _ SNMP Community Name The SNMP Community Name is a required field for NMS to read or write to a device.
Change Key (N) ? _ Enter Key: _ Enable Encryption This option displays only if the WiPort model features AES encryption. It enables AES encryption for tunneling only. Key length in bits Valid options are 128, 192 and 256 bits.
Enable Enhanced Password (Y) ? _ Disable Port 77F0 (Hex) Port 77F0 allows a custom application to query or set the eleven WiPort configurable pins when they are functioning as general purpose I/O (GPIO). Disable this capability, if desired, for security purposes.
This is included in the 7 Defaults menu reset. To reset the other WLAN settings, use one of the “Reset to Defaults” Configurable Pin Settings. For more information on Configurable Pins, see Configurable Pins on page WiPort Embedded Wireless Device Server User Guide...
All values are stored in nonvolatile memory Select option 8 Exit without save from the Change Setup menu to exit the configuration mode without saving any changes or rebooting. WiPort Embedded Wireless Device Server User Guide...
7: Configurable Pins The WiPort has eleven pins configurable for General Purpose I/O (GPIO). Use these GPIO pins to control devices such as relays, servers, lights, monitor switches, sensors, and even processes such as data transfer. Default Settings Function: general purpose input/output ...
There is no Set functions command. Since the pin’s function depends on the hardware in which the WiPort is embedded, that configuration is only allowed via 77FE. Settings changed by any of the Set commands are not stored and are lost when the unit is powered down or rebooted.
Page 79
0 means the direction for that GPIO will not change. Bytes 5-8: New Directions Bit X 1 means GPIO X will become an output. 0 means it will become an input. Response: 1 parameter Bytes 1-4: The updated directions WiPort Embedded Wireless Device Server User Guide...
Examples Example 1: PC sends command 10h to find out which configurable pins are available as GPIO. PC -> WiPort: 10h, 00h, 00h, 00h, 00h, 00h, 00h, 00h, 00h WiPort -> PC: 10h, 03h, 02h, 00h, 00h Command details: 10h = command 10h...
Page 81
Example 2: PC sends command 1Bh to change the current states of GPIO 0 and 1 (assuming they are configured as outputs). PC -> WiPort: 1Bh, 01h, 02h, 00h, 00h, 01h, 00h, 00h, 00h WiPort -> PC: 1Bh, 03h, 00h, 00h, 00h...
All commands are case sensitive . Table 7-1. Monitor Mode Commands Command Command Name Function Version Queries software header record (16 bytes) of unit. Get Configuration Gets configuration of unit as hex records (120 bytes). WiPort Embedded Wireless Device Server User Guide...
Page 83
It sends an X before the reset if the command was OK. Wireless Status Displays wireless device server status that includes packets received, transmitted, and dropped. Responses to some of the commands are given in Intel Hex format. WiPort Embedded Wireless Device Server User Guide...
Page 84
Table 7-2. Command Response Codes Response Meaning 0> OK; no error 1> No answer from remote device 2> Cannot reach remote device or no answer 8> Wrong parameter(s) 9> Invalid command WiPort Embedded Wireless Device Server User Guide...
2. Assign a static auto-IP address to the wired host within the same subnet as the WiPort. 3. Use the WiPort’s Web Manager or Telnet to port 9999 to configure the WiPort as necessary. 4. Configure the wired host’s IP address back to the original IP address configuration.
9: Wireless Bridging 6. Disconnect the wired device and reconnect the original wired host to the WiPort. 7. Reset the WiPort. Method 3 As an alternative to configuring through the wired interface, connect a device through the WiPort’s serial port. For more information on configuration through the serial port, on page 45.
DeviceInstaller (the preferred way), via TFTP, or via the serial port. You can also update the unit's internal Web interface (*.COB) via TFTP or DeviceInstaller. Here are typical names for those files. Check the Lantronix web site for the latest versions and release notes.
2. From the Tools menu, select Advanced/Recover Firmware. The Recover Firmware window displays. 3. Enter the com port on your PC and the location of the firmware file. The Device Model should indicate WiPort. 4. Click OK to download the file. WiPort Embedded Wireless Device Server User Guide...
This chapter discusses how you can diagnose and fix errors quickly without having to contact a dealer or Lantronix. The WiPort’s diagnostic LEDs indicate the unit’s status. It helps to connect a terminal to the serial port while diagnosing an error to view summary messages that may be displayed.
No response from device! specified is incorrect. Verify the IP, Hardware Address and Network Class. The IP address you are trying to assign is not a valid IP for your Please try again. WiPort Embedded Wireless Device Server User Guide...
Page 91
Use Connect Mode option C1 or C5 for a connection to the network from the device server. See the full list of Connect Mode options Connect Mode on page 52. WiPort Embedded Wireless Device Server User Guide...
Page 92
The Device Server message network. Also, make sure that port displays. 77FEh is not disabled within the Security settings of the device server. WiPort Embedded Wireless Device Server User Guide...
12: Technical Support Lantronix offers many resources to support our customers and products at http://www.lantronix.com/support. For instance, ask a question, find firmware downloads, access the FTP site and search through tutorials, FAQs, bulletins, warranty information, extended support services, and product documentation.
Need help?
Do you have a question about the WiPort and is the answer not in the manual?
Questions and answers