MULTIPOINT user's guide - ACKSYS Communications & Systems
Contents
1. MULTIPOINT FIRMWARE USER GUIDE FOR ETHERNET AND WI FI PORT SERVERS TABLE OF CONTENTS I WHEN TO USE THE MULTIPOINT FIRMWARE 2 u ccccccosccscscssssessssccsssccssccscssccsssccecsscscsssscsecssssssssscsssssscescecsscsssscssscsesenseees 3 II MAIN CAPABILITIES ccccccccsccecocecccsececececscsececesescccecececescececececescscececesescncacscecescacacscecescacacscecencacacsceceneacacscesencacacscesenencacsees 5 1 SERTIALATO NETW ORK DATA CHANGE n ia 5 2 TB yy 5 3 UNICAST AND BROADCAST NETWORK COMMUNICATION 5 4 5 5 ES bE ees ae eee es es see ra ae eee 5 11 6 PROGRAMMING INTERFACE ese is erence ssid isle recone ne ae 5 HI APPLICATIONS NO ES 7 1 REPLACEMENT FOR MULTIDROP RS485 BUS c ccceccecceccscecceccecescsceccecescescscestecesceecesesceecesceececescesceecesescescesceseucescescuceecs 7 2 REPLACEMENT FOR POINT TO POINT RS232 LINK cccscecceccecceccscescecceccscescsceccecesceecesceceecescescseeecescescssessescescusessescescuceess 8 II 3 REPLACEMENT FOR TWO SEPARATE MULTIDROP RS485 BUSES c ccccecceccsccscecceccsccsceccesc2. serial remoteip 192 168 1 15 default port server3 serial interface rs485 noecho net ip 192 166 Lal serial remoteip 192 168 1 15 default port server4 serial interface rs485 noecho net ip 192 160 1 21 serial port 2301 default port server5 serial interface rs485 serial port 2301 serial remoteip 192 168 1 21 MULTIPOINT USER GUIDE Release A 6 April 23 2009 10 MULTIPOINT USER GUIDE Release A 6 April 23 2009 11 IV TROUBLESHOOTING IV 1 No communication The complete absence of communication is usually caused by IV 2 Data loss The sender not having data to send Check serial data and flow control The sender address not having the same subnet address than the receiver s Check that you can ping both the sender and the receiver from another computer on the LAN Check the netmasks The sender not being on the same LAN as the receiver If this is on purpose check the sender s gateway address and check that the router lets broadcast packets through The sender not having the same UDP port not being in the same group than the receiver Check both UDP ports The sender not sending to the receiver s address or broadcast address Check this Data can possibly be lost at several points during the transfer If serial data fill the serial receive buffer before data can be transmitted gt Use inbound flow control or change packetisati
3. Allowed values range from 0 to 255 The delay can be specified in milliseconds by appending a m to the figure or in character duration by appending a to the figure m is the default if no unit is specified When this parameter is not 0 data received on the asynchronous serial port will not be resent to the client application until the specified delay has elapsed after which all data received in the meantime will be sent Set this parameter to 0 to disable it delay between last char reception and emission to the client application Allowed values range from 0 to 255 The delay can be specified in milliseconds by appending m to the figure or in character duration by appending a to the figure m is the default When this parameter is not 0 data received on the asynchronous serial port will not be resent to the client application until the specified delay has elapsed since the last character was received after which all data received will be sent Setting this parameter to 0 we disable it Set this parameter to 0 to disable it display the condition used to put the data received on the asynchronous serial port in the queue for transmission to the client application delay is a duration in milliseconds available in version 1 6 and up not supported in the Cometh Admin web software When successive UDP frames are received from the network they are sent back to back to the serial port if delay is
4. by all participating devices For example a polling master device communicating with many slaves must broadcast data requests Unicast operation shall be used when the data sent by one device must be received by only one other device For example a slave device answering its master can unicast its data it can also broadcast its data if such use does not disturb other slave devices 4 Serial line interface Data is exchanged through the serial interface at speeds up to the maximum baud rate supported by the port server device It can optionally be subject to flow control either hardware RTS CTS or software XON XOFF DSR DCD and RING input signals are always ignored 5 Virtual buses By setting a specific UDP port into the MULTIPOINT firmware one can set up groups of devices on the same LAN wherein the groups are isolated from each other and simulate as many separate multidrop RS485 buses II 6 Programming interface Using raw UDP data the MULTIPOINT firmware can communicate directly with network aware applications MULTIPOINT USER GUIDE Release A 6 April 23 2009 MULTIPOINT USER GUIDE Release A 6 April 23 2009 APPLICATIONS NOTES 1 Replacement for a multidrop RS485 bus Ethernet subnet 192 168 1 x netmask 255 255 255 0 192 168 1 15 4 5485 Port server 192 168 1 16 192 168 1 17 eo J 1 Ask the network administrator for available IP addresses on th
5. management mode always ignore show serial mode always ignore set serial ring mode ignore RING management show serial ring mode always ignore MULTIPOINT USER GUIDE Release A 6 April 23 2009 _20 Command set serial baudrate speed show _ serial baurate set serial format nbits parity nstops show serial format set serial xonxoff mode show serial xonxoff set sendtrigger charcount count set sendtrigger framedelay delay set sendtrigger idledelay delay show _ sendtrigger set serial interframe delay show serial interframe Default value 9600 8n1 ignore off 0 off 0 2 ms send when timeout after 1 char 2ms or buffer full 0 Notes notes Description speed any baud rate from 229 bauds to 230400 bauds from 10 bauds on Ethernet products nbits is 7 or 8 bits parity is one of e 5 meaning even odd none mark or space nstops is 1 or 2 stop bits software flow control mode is one of use ignore Mixed i e software and hardware flow control can be set number of chars required in the buffer before emission to the client application Allowed values range from 0 to 255 When this parameter is not 0 data received on the asynchronous serial port will not be sent to the client application until there are at least count characters in the buffer Set this parameter to 0 to disable it delay between char reception and emission to the client application
6. server The application software can use standard UDP sockets to send and receive messages Port server not needed Embedded UDP IP stack ame Ethernet Note in the above picture that the computer on the top right 15 directly connected to net MULTIPOINT USER GUIDE Release A 6 April 23 2009 MAIN CAPABILITIES II 1 Serial to network data exchange The MULTIPOINT firmware handles data exchange between a serial RS232 RS422 RS485 link and a network Data received on the serial interface is packetized following user selectable rules then sent to the network interface Data received on the network interface is placed into the serial interface buffer and sent one character at a time respecting flow control and line turnaround protocols if needed II 2 UDP network protocol In order to be as transparent as possible the network interface uses connectionless UDP transfers avoiding connection establishment constraints on the link With such protocol data can be lost corrupted inverted or duplicated the last two cases may occur in rare cases involving several network routers II 3 Unicast and broadcast network communication Network data packets sent by the MULTIPOINT firmware can be broadcast to the LAN or can be addressed to a specific receiver unicast Broadcast operation shall be used when data sent by one device must be received
7. A and AES is used together with WPA2 password str unspecified change the pre shared key to sir ping ip adress Sends ICMP ECHO REQUEST four times to the specified destination The answer or timeout indication will be displayed a few seconds after the prompt stat Displays various indications for technical support purpose rxfifo state on reserved for factory tests DO NOT CHANGE MULTIPOINT USER GUIDE Release A 6 April 23 2009 NOTES 1 This group of commands allows to retrieve or set globally the ACKSYS device server configuration 2 Security note sensitive data like login and password information are conveyed in clear text by the following commands You must take any step to protect these data from disclosure As a basic protective step the commands themselves can only be used by a logged in operator 3 Usage note Some data conveyed by these commands should be kept unique to a device This applies especially to the IP and MAC addresses in the common parameters You should either avoid to change this unique data or to restore them after using the set commands 4 Usage note Some parameters take effect immediately as specified elsewhere Beware that the parameters you change do not affect the device at the moment you set them For example if you change the DHCP Client Id this will take effect at the next lease expiration which could happen soon 5 Use this group of commands to improve buffering of outgoin
8. e LAN and for the NETMASK information 2 Assign IP addresses to the three port servers 3 Use the administration system to set up each port server in turn Device to set up Setup commands set default this implies RS232 at 9600 bauds 8 bits no parity 1 stop UDP port 2300 netmask 255 255 255 0 and a broadcast remote address net ap 192 168115 serial interface rs485 noecho default nee ip 192 serial interface rs485 noecho serial remoteip 192 168 1 15 Setting the remote in this case is optional but reduces network usage default net ip 192 168 1 1 serial interface rs485 noecho serial remoteip 192 168 1 15 Setting the remote in this case is optional but reduces network usage MULTIPOINT USER GUIDE Release A 6 April 23 2009 8 2 Replacement for a point to point RS232 link This advanced example involves the crossing of an IP router 192 168 1 15 Port server 1 Port server2 10 0 0 2 router 19200 bds 1 Ask the network administrator for available IP addresses on the LAN NETMASK information and possibly gateway addresses 2 Assign IP addresses to the two port servers 3 Use the administration system to set up each port server in turn Device to set up port server port server2 Setup commands set default this implies RS232 at 9600 bauds 8 bits no parity 1 stop UDP port 2300 netmask 255 255 255 0 and a b
9. eceecescscecescescescesescescescescscescescuseess 9 FROLES ROON 11 IV 1 Oy MN TU crepes et we sles ss ce sate 11 2 11 IV 3 SPC DATA TRAMES WIZ TION RULE Sposa cette Secs see die ease gate teehee sere dua nase saa soot ie sce eee tee ee 11 COMMANDS REFERENCE LIST ccccccscsccssesecececececesesesscccscccsececscecececesesescssscccscececacscecececesecesesesesencscscacacacscscecenencscacacacecs 13 MULTIPOINT USER GUIDE 121175056 Release A 6 April 23 2009 MULTIPOINT USER GUIDE COPY RIGHT ACKSYS 2009 This document contains information protected by Copyright The present document may not be wholly or partially reproduced transcribed stored in any computer or other system whatsoever or translated into any language or computer language whatsoever without prior written consent from ACKSYS Communications amp Systems ZA Val Joyeux 10 rue des Entrepreneurs 78450 VILLEPREUX FRANCE REGISTERED TRADEMARKS e ACKSYS is a registered trademark of ACKSYS NOTICE ACKSYS gives no guarantee as to the content of the present document and takes no responsibility for the profitability or the suitability of the equipment for the requirements of the user ACKSYS will in no case be held responsible for any errors that may be contained in this document nor for any damage no matt
10. er how substantial occasioned by the provision operation or use of the equipment ACKSYS reserves the right to revise this document periodically or change its contents without notice ACKSYS COMMUNICATIONS amp SYSTEMS ZA Val Joyeux 10 rue des Entrepreneurs 78450 VILLEPREUX FRANCE Telephone 33 0 130 56 46 46 Fax 33 0 1 30 56 12 95 Web www acksys fr Hotline support acksys fr Sales sales acksys fr MULTIPOINT USER GUIDE Release A 6 April 23 2009 I WHEN TO USE THE MULTIPOINT FIRMWARE Network tunnel between several serial buses or single devices Separate multipoint groups on the network Optional hardware and software flow control Master slaves mode Multimaster ability Slaves can be isolated from each other to simulate 4 wires serial bus Local and remote administration via CLI Command Line Interface Connectionless UDP IP transfers Ss Ss A NON NS NON The MULTIPOINT firmware simulates an RS422 RS485 bus with the network With the MULTIPOINT firmware you can set up a group of port servers or WI FI port server that will work together to simulate interconnected asynchronous serial ports Data sent by one port server will be delivered to all other port server in the group or to a designated destination thus giving a feeling of a dedicated link MULTIPOINT USER GUIDE Release A 6 April 23 2009 Also TCP IP aware computers can communicate with group without intermediary port
11. ession TELNET only change display administrator username 8 bytes max Upper and lower cases change display administrator password 8 bytes max Upper and lower cases change display location description of the device server 30 bytes max Upper and lower cases change display the right to display configuration information without entering the administrator password perm one of allow deny change display the right to use the administration system from the network perm one of allow deny change display the right to upgrade the firmware perm of allow deny If this flag is set to allow upgrade is allowed through serial port or Wifi interface else upgrade is not allowed These commands are not available for devices providing several firmwares simultaneously change exploitation password see detailed documentation MULTIPOINT USER GUIDE Release A 6 April 23 2009 The following commands are available only in devices which provide several firmwares simultaneously set show show show show prog enable prog enable prog list prog info prog data Seg seg seg MULTIPOINT firmware located in seg 15 execute after next reset the current firmware located segment seg Display this firmware display information about all 6 firmwares display information about firmware located in segment seg in computer readable format display information about firmware located i
12. g network data 6 Usage note For the purpose of these commands send to the client application means that the data 15 queued for transmission as soon as possible The reception at the client side may be delayed by network contention client not acknowledging data fast enough packet lost etc 7 Usage note When a delay is specified as a number of characters duration 1 is converted at run time into a count of milliseconds based on the character size and baud rate and rounded up to the next millisecond 8 Character strings can be naked or quoted If naked they start at the first non space character they finish at end of line and can include any authorized character If quoted they start at the first character after the opening double quote they finish either at end of line or at the first encountered double quote and MULTIPOINT USER GUIDE Release A 6 April 23 2009
13. gion and the band auto allows to scan all the channels allowed in the region antennas one of diversity main aux If your product has only one antenna choose diversity or main If your product has 2 antennas you can choose diversity to use both antennas or specify which antenna you want to use main or aux you can enforce a specific standard bit rate best selects the best rate available for the given band and reception quality you can change the radio output power tx power one of high medium low set the reception level under the bridge will search another access point The reception level can be specified in units of dBm with negative values or in percentage with positive values example set wlan infra ssid myssid ah low This command will be change to infrastructure mode with ssid myssid and radio protocol 802 11a h and a low transmit power MULTIPOINT USER GUIDE Release A 6 April 23 2009 Default value Notes Description set wkey Run the wizard asking for the WiFi security parameters show wkey Display the WiFi security parameters set wkey option Change specific WiFi security parameters you can specify one or more of the following parameters method off method off no security or WEP key personal uses WPA protocol with pre shared key or enterprise not implemented protocol wpa protocol wpa or wpa2 tkip cioher or aes Usually TKIP is used together with WP
14. he gateway IP address change display the number of gateway hops mmm is 1 to 255 administration port MULTIPOINT USER GUIDE Release A 6 April 23 2009 5 net ssid show net ssid set net mode show mode set net channel show net channel set net wepkey set net wepkey show net wepkey set net usekey show net usekey set net auth ee SETTING OR DISPLAYING THE NETWORK WIRELESS PARAMETERS All commands of the network wireless parameters section are only valid for wifi port servers ssid mode channel keynum key keynum 0 keynum 128 mode Default value acksys infra no default value open Description change display the SSID of the device SSID is a case sensitive characters string 32 characters max Empty character string is not allowed configure display the WIFI mode One of ad hoc or infra ad hoc configure the device in AD HOC mode Infra configure the device in infrastructure mode In ad hoc mode configures the radio channel used for communication with the other device channel is in the range 0 to 13 In infrastructure mode this parameter 15 ignored define up to 4 WEP keys keynum 15 the key number Range 1 to 4 key is the hexadecimal key value 10 digits 64 bits key or 26 digits 128 bits key The last 6 digits are generated by the firmware Example set 64 bits WEP key set net wepkey 1 1F2564AE12 set 128 bits WEP key set net
15. l quality Authentification mode is not displaying for WL COMETH I WLg products also display available access points around MULTIPOINT USER GUIDE Release A 6 April 23 2009 SETTING OR DISPLAYING THE SERIAL PARAMETERS 19 Default value Description set serial port nnann 2300 Change display the TCP port used for data transfer nnnn is 1 to 65534 except 23 show _ serial port set serial remoteip ip remoteport 255 255 255 255 1 destination IP address for incoming serial data Must be reacheable either directly same show _ serial remoteip LAN or through a router check the gateway parameter Use 255 255 255 255 to broadcast the data on the LAN remoteport parameter available on versions 1 4 and up the UDP port where the data will be sent in the device bearing address ip If the remoteport is not given or is zero the remote port will be the same as the local port see command set serial port The changes take effect immediately but in a future release this may require a reset set serial interface mode option 15232 mode one of rs232 rs422 4wires rs485 2wires show serial interface option master or slave for rs422 4wires mode noecho or echo for rs485 2wires mode e Onsome products only rs232 is meaningful Other choices will result in communica tion errors See the serial port specifications of the appropriate port server user manual Keywords rs422 4wires are syn
16. n segment seg in computer readable format MULTIPOINT USER GUIDE Release A 6 April 23 2009 ce Command show net ethernet set net dhcp show net dhcp set net dhcp clientid set net dhcp clientid show net dhcp clientid set net dhcp hname show net dhcp hname set net ip show netip set net mask show net mask set net gateway show gateway set net metric show net metric show net config port state ident hostname aaa bbb ccc ddd aaa bbb ccc ddd aaa bbb ccc ddd mmm SETTING OR DISPLAYING THE NETWORK PARAMETERS Default value device serial number off empty MAC address sent as string empty not sent 192 168 1 253 255 255 255 0 0 0 0 0 10 23 Notes Description display Ethernet MAC address 6 hex digits separated by columns turn on off or display the DHCP client use When dhcp is on the manually specified IP address is not used replace the standard client ID MAC address as a string by the custom string ident 15 bytes max upper and lower cases allowed delete the custom client ID and use the standard client ID display value enforced on DHCP option 61 if any provide the DHCP server with the supplementary Host Name option with value hostname 19 bytes max no spaces allowed upper and lower cases allowed Value assigned to DHCP option 12 if any change display IP address in dotted decimal notation change display local subnet mask change display t
17. on rules use bigger packets at higher loads If UDP packets cannot go on the net or if they are lost by network routers because of a heavy network load gt Use retransmission in your serial device use a dedicated network use switches instead of hubs use bigger packets at higher loads Note UDP makes no attempt to retransmit lost data nor does the MULTIPOINT firmware If an incoming UDP packet cannot be transferred to the serial transmit buffer because it already holds too much data gt Remove outbound flow control speed down the data sender IV 3 Split data frames packetization rules In some cases data 15 sent by a device as frames separated by an idle delay If the receiving device is sensitive to interframe delays it is necessary to insure that each data frame 15 transmitted into its own UDP packet Then it is time to check the sendtrigger port server parameter MULTIPOINT USER GUIDE Release A 6 April 23 2009 MULTIPOINT USER GUIDE Release A 6 April 23 2009 13 COMMANDS REFERENCE LIST Displaying the configuration parameters is allowed if the showperm parameter is set to allow If it is set to deny the configuration parameters can only be displayed by the administrator after logging in Some parameters can only be displayed for your information but cannot be changed Conventions used in these tables bold text must be typed as 15 e italicized text denote
18. onyms Their meaning is identical Keywords rs485 and 2wires are synonyms Their meaning is identical rs232 setting for rs232 serial interface equipment rs422 master or 4wires master setting for master equipment in multidrop configuration or for both equipments in point to point configuration 5422 slave or 4wires slave setting for slave in multidrop configuration rs485 noecho or 2wires setting for all devices in multidrop or point to point rs485 echo or 2wires echo setting for all equipments in multidrop or point to point configuration In this mode transmitted characters on RS485 line are echoed on Lan line set serial dtr mode high DTR management mode is one of high low show serial dtr High and low mean the signal is permanently set in this state set serial rts mode high RTS management mode is one of modem high low flow show serial rts Modem means the signal is used as if a modem was connected to the port DTR the device is on line RTS 5 the device wants to send data Flow means the signal is used for input flow control High and low mean the signal is permanently set in this state set serial dsr mode ignore DSR management mode always ignore show _ serial dsr mode always ignore set serial cts mode ignore CTS management mode is one of ignore flow show serial cts flow means the signal is used for output flow control ignore means that the signal is locally ignored set serial dcd mode ignore DCD
19. roadcast remote address net ip 19261604 net gateway 192 168 1 1 serial remoteip 10 0 0 2 serial baudrate 19200 default net ip 10 0 0 2 net gateway 10 0 0 1 net mask 255 0 0 0 serial remoteip 192 168 1 15 serial baudrate 19200 MULTIPOINT USER GUIDE Release A 6 April 23 2009 3 Replacement for two separate multidrop RS485 buses lt a 7 192 168 1 16 192 168 1 15 Sao gt 7 lt Ethernet subnet 192 168 1 x netmask 255 255 255 0 2 e i RS485 Port server4 192 168 1 20 192 168 1 21 7 lt 7 Ask the network administrator for available IP addresses LAN and for NETMASK information 1 Assign IP addresses to the five port servers 2 Use the administration system to set up each port server in turn Device to set up Setup commands port server oe Soret this implies RS232 at 9600 bauds 8 bits no parity 1 stop UDP port 2300 netmask 255 255 255 0 and a broadcast remote address serial interface rs485 noecho net ip 192 168 1 15 default port server2 serial interface rs485 noecho net ip 192 166 1 16
20. s a parameter which must be replaced by the proper value e italicized bold text denotes warnings or limitations Tables e general parameters e network parameters e wireless parameters e serial parameters net parameters bound to serial port e notes MULTIPOINT USER GUIDE Release A 6 April 23 2009 _14 Command login username set default save reset show version quit set login show login set password show password set location show location set showperm show showperm set show set show set netconfigperm netconfigperm upgradeperm upgradeperm net password username password location perm perm perm password SETTING OR DISPLAYING THE GENERAL PARAMETERS Default value Notes root root Unknown location allow allow allow empty note 9 Description start the administrator identification sequence Ask password restore factory defaults except the MAC address the save count the current firmware and the next firmware to run save the current configuration to the permanent configuration memory which is used after reboot and remains when the device is powered off close the administration session and reboot the device to ignore parameters changed but not saved or to reload saved parameters The following parameters do not need a reset to take effect location showperm netconfigperm serial interface display firmware name and version close administration s
21. set to 0 Otherwise there is a garanteed minimum idle time of delay milliseconds inserted between two frames sent to the serial port If the Ethernet traffic is low the idle time is between delay and delay 1 This feature can be combined with a sendtrigger idledelay on the receiving side to implement a low throughput UDP proxy over a serial link MULTIPOINT USER GUIDE Release A 6 April 23 2009 set wlan show wlan set wlan options 2 SETTING OR DISPLAYING PARAMETERS FOR THE WLG RANGE OF DEVICES state topology ssid string band superag region chan channels antennas tx rate tx power roaming Default value on adhoc acksys bg sagoff eu auto diversity best high off Notes Description Run the wizard asking for the WiFi parameters Display the WiFi parameters Change specific WiFi parameters you can specify one or more of the following parameters state on or off Turns radio card on or off topology one of infra or adhoc change the ssid of the device string is a case sensitive characters string change the radio protocol band one of bonly gonly bg ah standard 802 11 protocols superag one of sagoff sagon sagdyn sagstatic Super AG mode is an atheros card feature region one of il us hk ca au fr eu jp sg kr standardized code of the world region List of channels checked for access points Available values depend on the re
22. wepkey 1 123654875ADFEC236542541A26 Note to enter a 128 bits WEP key you must before enable 128 bits key mode See command usekey 1 128 below delete wepkey keynum display all 4 WEP keys the last 6 digits are displayed as zeroes define the WEP key to use If the parameter is left empty device won t use any WEP key else device uses WEP key keynum Example Activate 64 bits WEP key set net usekey 1 Activate 128 bits WEP key set net usekey 1 128 Disable WEP key using set net usekey set the authentication mode mode is one of open share open the device is authenticated by its MAC address share the device is authenticated by its WEP Key This command is not valid for WL COMETH I MULTIPOINT USER GUIDE Release A 6 April 23 2009 18 Default value Notes Description set net unencrypted mode accept configure if the device accept or ignore the unencrypted WIFI packet mode is one of ignore or accept ignore The device ignores all WIFI packet unencrypted accept The device accepts all WIFI packet unencrypted This command is not valid for WL COMETH I set net txrate txrate automatic set the WIFI transmit rate txrate is one of 1 2 5 5 11 automatic 1 2 5 5 or 11 device will always use the given transmit rate automatic device will automatically choose the appropriate transmit rate show net wlan display WIFI parameters channel txrate authentification mode RF signa
Download Pdf Manuals
Related Search