Changes or modifications to this device not explicitly approved by Lantronix will void the user's authority to operate this device. WiPort™ User Guide...
Contents Copyright and Trademark ________________________________________________ 2 Contacts______________________________________________________________ 2 Disclaimer and Revisions_________________________________________________ 3 1: Using This Guide Purpose and Audience___________________________________________________ 7 Chapter Summary ______________________________________________________ 7 Additional Documentation ________________________________________________ 8 2: Introduction Capabilities ___________________________________________________________ 9 Applications ___________________________________________________________ 9 Protocol Support ______________________________________________________ 10 Configuration Methods__________________________________________________ 10 Addresses and Port Numbers ____________________________________________ 10 Hardware Address __________________________________________________________ 10...
Page 5
Contents 5: Configuration via Serial Mode or Telnet Port Accessing Setup Mode __________________________________________________37 Telnet Access ______________________________________________________________37 Serial Port Access___________________________________________________________38 Server Configuration ____________________________________________________39 Set the IP Address __________________________________________________________39 Set the Gateway IP Address___________________________________________________39 Set the Netmask ____________________________________________________________39 Change Telnet Configuration Password __________________________________________40 DHCP Name _______________________________________________________________40 Channel 1 and Channel 2 Configuration _____________________________________40 Baudrate __________________________________________________________________41...
Page 6
Contents SNMP Community Name _____________________________________________________ 57 Disable Telnet Setup ________________________________________________________ 57 Disable TFTP Firmware Upgrade ______________________________________________ 58 Disable Port 77FE (Hex) _____________________________________________________ 58 Disable Web Server _________________________________________________________ 58 Disable Web Setup__________________________________________________________ 58 Disable ECHO Ports_________________________________________________________ 58 Enable Enhanced Password __________________________________________________ 58 Disable Port 77F0 (Hex)______________________________________________________ 59 Factory Defaults_______________________________________________________ 59 Channel 1 Configuration _____________________________________________________ 59...
WiPort and is intended for software developers and system integrators who are embedding the WiPort in their designs. This User Guide covers WiPort Device Server versions WP2001000-01, WP2002000-01, and WP2004000-01 (WiPort-485). Chapter Summary The remaining chapters in this guide include:...
Using This Guide Additional Documentation The following guides are available on the product CD and the Lantronix web site (www.lantronix.com) Briefly explains the basics to get the WiPort up WiPort Development Kit Quick and running. Start Guide Provides information about the WiPort...
WiPort is a wireless embedded device server that provides a network-enabling solution based on the IEEE 802.11b wireless standard. WiPort allows Original Equipment Manufacturers (OEMs) to add wireless connectivity to their products by incorporating it onto a circuit board. The WiPort functions independently of a PC, providing a fully integrated solution that combines a processor, memory, 802.11b transceiver, and dual high-speed serial ports into a single compact module.
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.
Introduction Port Numbers Every TCP connection and every UDP datagram is defined by a destination IP address and a port number. For example, a Telnet application commonly uses port number 23. A port number is similar to an extension on a phone system. The unit's serial channel (port) can be associated with a specific TCP/UDP port number.
PC has more than one network adapter, a message displays requesting the selection of a network adapter. Select an adapter and click OK. 2. Click the Search icon and select the WiPort unit from the list of Lantronix device servers on the local network.
Configuration Using DeviceInstaller Note: If you do not receive “Reply” messages, make sure the unit is properly attached to the network and that the IP address assigned is valid for the particular network segment you are working with. If you are not sure, check with your systems administrator.
Configuration Using DeviceInstaller Host List Configuration If this option is set to True, the device server scrolls through the host list until it connects to the first available device listed in the host list table. Once it connects, the unit stops further attempts. If this connection fails, the unit continues to scroll through the table until it is able to connect to the next available IP address in the host list.
Configuration Using DeviceInstaller Select whether the pin receives input or transmits output. This Config Pin Direction field is modifiable only when Config Pin Function is set to GPIO. Select the signal active level (Low or High). The default is Config Pin Active Level Low.
Page 16
Configuration Using DeviceInstaller 5. Click on a port number and click Edit Settings. The Port Properties window opens. 6. Click the Advanced tab. In the available fields, change the following pull down menu options as necessary: Serial Settings The unit and attached serial device, such as a modem, must Baud Rate agree on a speed or baud rate to use for the serial connection.
Page 17
Configuration Using DeviceInstaller the EOR (end of record) and binary options, which can be used for applications such as terminal emulation to UNIX hosts. This field is available for configuration only when Active Remote Port Connection is not set to None. Set the remote TCP port number for the unit to make outgoing connections.
Page 18
Configuration Using DeviceInstaller for Disconnect with EOT to function properly. Ctrl D is only detected going from the serial port to the network. Use this parameter to set an inactivity timeout. The unit drops Inactivity Timeout the connection if there is no activity on the serial line before the set time expires.
Configuration Using DeviceInstaller Used with Match Byte 1 and Match Byte 2 to indicate the Match 2 Byte Sequence end of a series of data to be sent as one group. The sequence must occur sequentially to indicate to the WiPort end of the data packet.
PC has more than one network adapter, a message displays requesting the selection of a network adapter. Select an adapter and click OK. 2. Click the Search icon and select the WiPort unit from the list of Lantronix device servers on the local network.
Configuration using Web-Manager Figure 4-1. Web-Manager The main menu is displayed 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.
Configuration using Web-Manager Figure 4-2. Network Settings Automatic IP Address Configuration To automatically assign an IP address and its network configuration: 1. Click Network from the main menu. 2. Select Obtain IP address automatically. 3. Enter the following (as necessary): Select Enable to permit the Bootstrap Protocol (BOOTP).
Configuration using Web-Manager Static IP Address Configuration To manually assign an IP address and its network configuration: 1. Click Network from the main menu. 2. Select Use the following IP configuration. 3. Enter the following (as necessary): If DHCP is not used to assign IP addresses, enter it manually. IP Address The IP address must be set to a unique value in the network.
Configuration using Web-Manager To configure the WiPort’s device server settings: 1. Click Server from the main menu. 2. Configure or modify the following fields: Server Configuration Enter the password required for Telnet access. Telnet Password Re-enter the password required for Telnet access. Retype Password Advanced When the unit communicates with another device on the...
Configuration using Web-Manager Figure 4-4. Hostlist Settings 2. Enter or modify the following fields from the Hostlist Settings window: Retry Settings Enter the value for the number of times the WiPort should Retry Counter attempt to retry connecting to the host list. Enter the duration (in seconds) the WiPort should abandon Retry Timeout attempting a connection to the host list.
Page 26
Configuration using Web-Manager Figure 4-5. Channel Serial Settings 2. In the available fields, enter the following information: Channel 1 Available on Channel 1 settings only. When selected, Disable Serial Port disables communication through the serial port. Port Settings Select the protocol type from the pull down menu for the Protocol selected channel.
Configuration using Web-Manager Pack Control Select the checkbox to enable packing on the WiPort. Enable Packing 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.
Page 28
Configuration using Web-Manager Connect Protocol Select TCP from the pull down menu. Protocol Figure 4-6. TCP Connection Settings Connect Mode: Passive Connection Select Yes to accept incoming connections. Accept Incoming Determines whether a password is required for an incoming Password Required passive connection.
Page 29
Configuration using Web-Manager Endpoint Configuration Enter the local port number. Local Port Select to auto-increment the local port number for new Auto increment local outgoing connections. The range of auto-incremented port port number numbers is 50,000 to 59,999 and loops back to the beginning when the maximum range is reached.
Configuration using Web-Manager Use this parameter to set an inactivity timeout. The unit drops Inactivity Timeout the connection if there is no activity on the serial line before the set time expires. Enter time in the format mm:ss, where m is the number of minutes and s is the number of seconds.
Configuration using Web-Manager Enter the port number of the remote device. Remote Port Enter the IP address of the remote device. Remote Host Field enabled when Datagram Type is set to FD. Enter values Change Address Table between 1-255 to identify units on the local network of device servers.
Configuration using Web-Manager Recipients Enter the email address designated to receive email Recipient 1: Email notifications. Address Enter an additional email address designated to receive email Recipient 2: Email notifications. Address Trigger Configuration A trigger event occurs when the unit receives the specified trigger input as a result of a specified combination of conditions on the configurable pins.
Configuration using Web-Manager Select the channel prompting the trigger. Channel Select the data size prompting the trigger. Data Size Enter the data which, when appears in the communication Match Data stream, prompts a trigger. Note: All of the conditions must match for an email notification to be sent. Message Properties The subject line of the trigger event email to the specified Message...
Page 34
Configuration using Web-Manager Figure 4-10. WLAN Settings 2. Enter or modify the following fields: Use the pull down menu to select a WLAN interface or an Network Interface Ethernet interface. Enter the name of the network where the WiPort is located. Network Name Wireless Network Configuration Select the checkbox when using a client (such as a wireless...
Configuration using Web-Manager Field is enabled when WEP is selected as the Security type. Encryption Key Enter the Encryption Key in hexadecimal value Advanced Settings WiPort permits the control of the transmission rate. Select the Data Rate data rate (in Mbps) from the pull down menu. Power management reduces the overall power consumption Radio Power of the WiPort unit.
Configuration using Web-Manager Select whether the pin inputs or outputs. Direction Configurable Pin Functions Monitors input via the 77F0 port or controls output by the 77F0 General Purpose I/O port. Allows for control of the connection (and disconnection) of Modem Ctrl in, chan 1 channel 1.
Configure the unit so that it can communicate on a network with your serial device. As an alternative to DeviceInstaller and 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.
Configuration via Serial Mode or Telnet Port Figure 5-2. Setup Menu Options Change Setup: 0 Server 1 Channel 1 2 Channel 2 3 Email 4 WLAN 5 Expert 6 Security 7 Factory defaults 8 Exit without save 9 Save and exit Your choice ? 5.
Configuration via Serial Mode or Telnet Port 4 WLAN 5 Expert 6 Security 7 Factory defaults 8 Exit without save 9 Save and exit Your choice ? 5. Select an option on the menu by entering the number of the option in the Your choice ? field and pressing Enter.
Configuration via Serial Mode or Telnet Port Table 5-1. Standard IP Network Netmasks Representing Host Bits Network Class Host Bits Netmask 255.0.0.0 255.255.0.0 255.255.255.0 Change Telnet Configuration Password Setting the Telnet configuration password prevents unauthorized access to the setup menu via a Telnet connection to port 9999 or via web pages. The password must have 4 characters.
Configuration via Serial Mode or Telnet Port Figure 5-5. Serial and Telnet Port Parameters Baudrate The unit and attached serial device, such as a modem, must agree on a speed or baud rate to use for the serial connection. Valid baud rates are 300, 600, 1200, 2400, 4800, 9600 (default), 19200, 38400, 57600, 115200, 230400, 460800, or 921600.
Configuration via Serial Mode or Telnet Port (1) 2 stop bits are implemented by the software. This might influence performance. (2) On WP2004000-01 (WiPort-485) only. 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”...
Configuration via Serial Mode or Telnet Port Table 5-5. Reserved Port Numbers Port Numbers Reserved for 1 – 1024 Reserved 9999 Telnet setup 14000-14009 Reserved for Redirector 30704 Reserved (77F0h) 30718 Reserved (77FEh) Note: It is recommended to not use the reserved port numbers for this setting as incorrect operation may result.
Page 44
Configuration via Serial Mode or Telnet Port Connect Mode Option Manual connection Autostart Hostlist Datagram Type Directed UDP Modem Mode Full Verbose Without Echo Numeric modem result codes a) Incoming Connection Rejects all external connection attempts. Never Accept Incoming Accepts external connection requests only when the Accept with modem_control_in input is asserted.
Page 45
Configuration via Serial Mode or Telnet Port Attempts to connect when directed by a command string Manual Connection received from the serial port. The first character of the command string must be a C (ASCII 0x43), and the last character must be either a carriage return (ASCII 0x0D) or a line feed (0x0A).
Page 46
Configuration via Serial Mode or Telnet Port If this option is set to True, the device server scrolls through the Hostlist host list until it connects to the first available device listed in the host list table. Once it connects, the unit stops further attempts. If this connection fails, the unit continues to scroll through the table until it is able to connect to the next available IP address in the host list.
Page 47
Configuration via Serial Mode or Telnet Port 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. The range is 1-15, with the default set to 3.
Page 48
Configuration via Serial Mode or Telnet Port Message Meaning CONNECT A network connection has been established. NO CARRIER A network connection has been closed. A remote device, having IP address n.n.n.n, is connecting to this RING n.n.n.n. device. 1-Character Response Connected Ring No Carrier...
Configuration via Serial Mode or Telnet Port Modem Mode Function Command Makes a connection to an IP address (x.x.x.x) and the remote port ATDTx.x.x.x number defined within the unit. Forces the unit into Monitor Mode. Uses remote IP address and ATD0.0.0.0 port settings to initiate a connection.
Configuration via Serial Mode or Telnet Port DisConnMode Disconnect Mode (DisConnMode) determines the conditions under which the unit will cause a network connection to terminate. The current value is displayed in parentheses. DisConnMode ( 0) ? _ In DisConnMode, modem_control_in either drops the connection or is ignored. The following table displays the available input options: Table 5-10.
Page 51
Configuration via Serial Mode or Telnet Port Function to the device Clear when the network connection to or from the device is disconnected Output Buffer (Network to Serial) Clear with a connection that is initiated from the device to the network Clear with a connection initiated from the network to the device Clear when the network connection to or from the...
Configuration via Serial Mode or Telnet Port Packing Interval defines how long the unit should wait before Packing Interval: sending accumulated characters. This wait period is between successive network segments containing data. For alternate packing, the default interval is 12 ms. In some applications, CRC, Checksum, or other trailing Trailing Characters: characters follow the end-of-sequence character;...
Configuration via Serial Mode or Telnet Port Email Configuration Note: Change these settings via Telnet or serial connections only, not on the Web-Manager. These settings are also configurable through DeviceInstaller. The unit sends an Email to multiple recipients when a specific trigger event occurs. There are three separate triggers, based on any combination of the configurable pins (PIO) when selected as user I/O functions.
Configuration via Serial Mode or Telnet Port Unit Name Enter the username used by the WiPort to send Email messages. The current value is displayed in parentheses. Unit name () ? _ Domain Name Enter the Email server’s domain name. The current value is displayed in parentheses.
Configuration via Serial Mode or Telnet Port The Re-notification interval indicates the time interval in which a new Email message is sent to the recipient(s) when a single trigger event remains active. Trigger 2 Refer to for details on completing these fields. Trigger 1 Note: Each trigger is independent of the others.
Configuration via Serial Mode or Telnet Port Security Displays when WLAN is enabled. As an additional security measure, enable WEP on the WiPort. The current value is displayed in parentheses. By default, WEP is disabled on WiPort. Security 0=none, 1=WEP (0) ? _ Data Rate Displays when WLAN is enabled.
Configuration via Serial Mode or Telnet Port Enable High Performance (N) ? _ Disable Monitor Mode Disables entry into Monitor Mode via the 'yyy' or 'xx1' key sequence at startup. This command prevents the unit from entering Monitor Mode by interpreting the stream of characters that are received during the device server's initialization at startup.
Configuration via Serial Mode or Telnet Port This setting defaults to the N (No) option. The Y (Yes) option disables access to Setup Mode by Telnet (port 9999). It only allows access locally via the web pages and the serial port of the unit. Disable Telnet Setup (N) ? _ Disable TFTP Firmware Upgrade This setting defaults to the N (No) option.
Configuration via Serial Mode or Telnet Port Enable Enhanced Password (Y) ? _ The Y (Yes) option allows an extended security password of 16-characters for protecting Telnet access. Disable Port 77F0 (Hex) Port 77F0 is a setting that allows a custom application to query or set the eleven WiPort configurable pins when they are functioning as general purpose I/O (GPIO).
Configuration via Serial Mode or Telnet Port 250 (msec) Hostlist Retry Timeout 0x0D (CR) Send Character All other parameters WLAN Settings (Y) Yes Enable WLAN LTRX_IBSS Find Network Name (Y) Yes Enable Ad Hoc Network Creation LTRX_IBSS Name (0) United States Country Channel (0) None...
Configuration via Serial Mode or Telnet Port Email Settings Trigger Priority 1 second Min. notification interval 0 (e.g. Email notification and triggers are disabled) All other parameters Exit Configuration Mode To exit setup mode: Select option 9 Save and exit from the Change Setup menu to save all changes and reboot the device.
The WiPort has eleven pins configurable for General Purpose I/O (GPIO). Note: In addition, configure these pins for serial port control lines, such as modem control in, DCD, and diagnostic outputs to LED, using DeviceInstaller. Use these GPIO pins to control devices such as relays, servers, lights, monitor switches, sensors, and even processes such as data transfer.
Configurable Pins The parameters are four bytes long and represent GPIOs 0-31, with GPIO0 in bit 0 of the first byte (Little Endian). Parameter bits for configurable pins not configured as GPIOs are undefined for Get commands and ignored on Set commands. Every command consists of nine bytes: one command type of one byte and two parameters of four bytes each.
Page 64
Configurable Pins Command 11h, Get Directions Send: No parameters Response: 1 parameter Bytes 1-4: Directions Bit X 1 means GPIO X is an output. 0 means it is an input. Command 12h, Get Active Levels Send: No parameters Response: 1 parameter Bytes 1-4: Active levels Bit X 1 means GPIO X is active low (0V when active, 3.3V when inactive).
Configurable Pins Command 1Ah, Set Active Levels Send: 2 parameters Bytes 1-4: Mask Bit X 1 means the direction for GPIO X will be updated with the value in the second parameter. 0 means the active type for that GPIO will not change. Bytes 5-8: New Active Levels Bit X 1 means GPIO X will become active low.
Page 66
Configurable Pins 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, 00h, 02h, 00h, 01h, 00h, 00h, 00h WiPort -> PC: 1Bh, 03h, 00h, 00h, 00h Command details: 1Bh = command 1Bh 01h, 00h, 00h, 00h = the mask that determines which GPIOs will be changed.
Monitor Mode is a command-line interface used for diagnostic purposes. There are two ways to enter Monitor Mode: locally via the serial port or remotely via the network. Entering Monitor Mode via the Serial Port To enter Monitor Mode locally: 1.
Page 68
Monitor Mode Command Command Name Function Ping Pings unit with IP address x.x.x.x to check device PI x.x.x.x status. ARP Table Shows the unit’s ARP table entries. TCP Connection Shows all incoming and outgoing TCP connections. Table Network Connection Shows the unit’s current IP address. Reset Resets the unit.
*.FWX): via 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.
Updating Firmware Using TFTP: Command Line Interface To download new firmware from a computer, enter the following from a TFTP command line interface: tftp –i <ip address> put <local filename> <destination file name> The following examples demonstrate the TFTP command sequence to download the .rom file, the .fwx file, and the .cob file: tftp –i 192.168.1.111 put wpt540.rom W1 tftp –i 192.168.1.111 put H2_FW_200.fwx FWX1...
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.
Troubleshooting Problems and Error Messages Problem/Message Reason Solution When you issue the ARP –S Your currently logged-in user Have someone from your IT command in Windows, The does not have the right to use department log you in with this command on this PC. sufficient rights.
Page 73
Troubleshooting Problem/Message Reason Solution You did not choose the correct subnet mask. The device server is not The most likely reason is the The serial settings for the serial communicating with the serial wrong serial settings were device and the device server must device it is attached to.
Page 74
Troubleshooting Problem/Message Reason Solution When connecting to the Web- Your computer is not able to Make sure that port 30718 Manager within the device connect to port 30718 (77FEh) (77FEh) is not blocked with any server, the No Connection With on the device server.
If you are experiencing an error that is not described in this chapter, or if you are unable to fix the error, you may: To check our online knowledge base or send a question to Technical Support, go to http://www.lantronix.com/support. Email us at support@lantronix.com.
Need help?
Do you have a question about the WP2002000-01 and is the answer not in the manual?
Questions and answers