NetMedia SitePlayer Telnet Series, User Manual

Page 1: ...tocol Converter User s Manual Version 1 11 2 Oct 06 For SitePlayer Telnet Software Version 1 4ahu and above 2004 2006 Netmedia Inc All Rights Reserved 10940 N Stallard Place Tucson AZ 85737 520 544 4567 POE version depicted ...

Page 2: ...unless Buyer has paid for in full the NetMedia products Elec tronic updates to the NetMedia SitePlayer User s Manual and NetMedia SitePlayer software are available free to Registered Buyer upon request for a one 1 year period from the invoice date NOTICE NetMedia Inc reserves the right to make improvements in the software product described in this manual as well as the manual itself at any time an...

Page 3: ...ventions Certain conventions are used throughout this reference document The term Siteplayer and SitePlayer Telnet is used interchangeably Web screen shots may not appear exactly the same between various web browsers and operating systems ...

Page 4: ...eep Alive 16 Set Extra Port 16 Serial Web Page 17 Serial Port Parameters 17 UDP Serial Configuration 18 UDP Remote IP 18 Remote IP is 19 UDP Timeout 19 Buffer Management 19 Buffer Threshold 19 End of Buffer Byte is 19 End of Buffer Byte 19 Bit Stall Delay is 20 Bit Stall Delay 20 Telnet Web page 21 Current Connection State 21 Current Remote IP 22 Current Remote Port 22 SitePlayer Mode 22 Server Connect...

Page 5: ...Link Local LL Address Acquisition 35 Multicast DNS mDNS 35 Bonjour 36 Dynamic Host Configuration Protocol DHCP 36 Transmission Control Protocol Internet Protocol TCP IP 36 User Datagram Protocol UDP 36 Hypertext Transfer Protocol HTTP 36 Telnet 36 Daytime 37 Discard 37 UDP Serial UDPS 37 Informative and Error Messages 38 Factory defaults are being set Please wait 38 Parameters set OK 38 Restarting ...

Page 6: ...nf Bonjour Browser Under Windows 45 Telnet Network Virtual Terminal NVT 46 Adding Route to Windows so Link Local Devices Can be Accessed 47 TCP IP Tuning Considerations 48 Windows 48 Mac OS X or FreeBSD 48 Linux 48 Appendix B 49 DB 9 Null Modem Cable Wiring 49 Telnet Carrier Schematic 50 Telnet Module Pin Out 51 RoHS 51 ...

Page 7: ...There are many devices which can only be controlled via RS232 With SitePlayer you can now control these devices through the internet You can also use two SitePlayer Telnet devices to create an internet bridge between two serial devices This document describes the SitePlayer Telnet product which comes completely assembled including SitePlayer Module Telnet carrier board and case If you have purchas...

Page 8: ...POE Siteplayer Telnet RoHS 5 0VDC optional Power requirements External 100 240VAC 50 60Hz universal power adapter POE compatible RJ 45 with 2 LEDs Distinguishing Various SitePlayer Telnet Models Below you will find several SitePlayer Telnet Systems illustrated so that you can distinguish between them Original Siteplayer Telnet 7 5VDC Power requirements External 110VAC 60hz power adapter ...

Page 9: ...loaded to device using web browser Can be configured as a Server or Client using web page or AT Modem type commands Conforms to various internet standards ARP TCP IP UDP DHCP Link Local Bonjour ICMP Ping HTTP Telnet Daytime protocol Discard protocol TCP IP or UDP ports may be protected using source IP and mask Up to 4 IP addresses configurable DHCP Link Local 2 static IP addresses OEM custom webpage...

Page 10: ...erence to radio or television communications However there is no guarantee that the interference will not occur in a particular installation If this equipment does cause harmful interference to radio or television reception which can be determined by turning the equipment off and on the user is encour aged to try to correct the interference by one or more of the following measures Reorient or reloc...

Page 11: ...s download the Bonjour Browser exe file from the NetMedia web site at http www SitePlayer com telnet See Appendix A for more Bonjour browser options Once you run Bonjour Browser you will see a window similar to the following Each SitePlayer Telnet has a unique name associated with it which you can change later on The factory default name is in the form SitePlayer Telnet XXXXXX where XXXXXX are the ...

Page 12: ...es and pass words are case sensitive You will have an opportunity later on to change these if you wish Once you type the username and password you will see the main SitePlayer Telnet Setup page The following sections describe the main SitePlayer Telnet Setup page and the other web pages which are used to configure SitePlayer ...

Page 13: ... limit access to SitePlayers TCP or UDP ports to certain IP addresses Admin allows you to perform administration functions on SitePlayer such as Link LED control restarting rebooting Siteplayer or setting it back to factory defaults Update allows you to load new Firmware or Web pages into SitePlayer Each SitePlayer web page contains a footer which can be clicked to access the SitePlayer Telnet hom...

Page 14: ...Player automatically generates it s own LL address which is unique on the local network LL addresses are not routable and thus cannot be accessed outside of the local network If you need a routable address you should use a DHCP or Static IP address Static IP 1 2 shows each static IP address that SitePlayer will respond to A value of 0 0 0 0 means that no Static IP address has been configured Any ch...

Page 15: ...e SitePlayer s MAC address in hex You can change the name to anything up to 32 characters You should try to keep names unique on your network if you are using multiple SitePlayers to more easily distinguish among them This web page also displays the Link Local name The link local name is a DNS safe name that is derived from the device name Operating system which support the mDNS protocol allow you...

Page 16: ...Player will maintain the connection to its service for the computer because it has no way of knowing the computer has been shut down Because a connection is still maintained for a particular service SitePlayer will not allow other computers to connect to that service To remedy this problem you can enable TCP Keep Alive You can fine tune the keep alive mechanism by altering various parameters Idle T...

Page 17: ...l port hardware You can also change some parameters which deal with the UDP serial protocol here Serial Port Parameters You can change several serial port parameters These parameters control the serial port hardware Baud Rate You can select from one of the following baud rates 110 134 5 150 300 600 1200 2400 4800 9600 19200 31250 38400 ...

Page 18: ...ata flow XON Q is sent to resume data flow RTS CTS the RTS and CTS hardware lines are used to control data flow In order for flow control to work properly you must also set the device that you are connecting to SitePlayer to the same flow control settings Press the Set Parameters button to have the changes take effect immediately SitePlayer is not restarted when you change serial port parameters UDP Ser...

Page 19: ...not buffer formatting or packetizing parameters SitePlayer takes a best effort approach in sending data when any of the below buffer management conditions are satisfied For example at baud rates greater than about 2400 baud and in UDP mode some extra characters may be sent after an End of Buffer Byte or any other buffer management condition in TCP IP mode the remote end only gets the characters that it ...

Page 20: ...Enables bit stall delay checking default Disabled Disables bit stall delay checking Bit Stall Delay The amount of bit stall delay measured in bits of the current baud rate The default value of 15 corresponds to about 1 5 character times since most characters take 10 bits The bit delay value should be chosen such that it is no larger than about 1 50th of a second since that is the largest value tha...

Page 21: ...ePlayer will initiate connections to other Telnet servers or TCP IP programs There are several parameters which allow you to specify how SitePlayer initiates connections to other Telnet servers or pro grams The current Telnet Connection Status includes Current Connection State The state that the Telnet session is currently in See Appendix A for a list of states and their explanation You can use th...

Page 22: ...onnects Disconnects on This option controls whether SitePlayer can connect or disconnect on various serial port line states In cli ent mode SitePlayer will connect when any of the selected lines are high It will disconnect when all the selected lines are low In Server mode a low line will cause a disconnect You need to be aware that in Server mode whatever control line s you select at least one ne...

Page 23: ...seconds to wait after no characters are received or sent before the TCP IP connection is terminated The idle disconnect timeout may be used in both Client and Server modes An Idle Disconnect Timeout of 0 disables the feature DTR Output State DTR Output State specifies what state the DTR line output will be in and how Telnet will control it This can be useful when you have a microprocessor or other ...

Page 24: ...ayer has Server mode enabled it will continue listening for connections and thus you may get a CONNECT or NO CARRIER message If SitePlayer has Client mode enabled it will continue to attempt to connect to the remote end and you may also get a CONNECT or NO CARRIER message SitePlayer polls every tenth of second 1 10s for force AT mode control lines to change The above input parameters may take up t...

Page 25: ...en acquired The only option you have is to enable or disable DHCP address acquisition Fixed IP Addresses You can specify up to 2 static IP addresses Static IP addresses can be used to give SitePlayer a known un changing IP address You will need to specify the IP address gateway and mask to properly set the static IP address The gateway and mask values are used to initiate communications from SiteP...

Page 26: ...ted Link Local address This may make SitePlayer more difficult to locate on a network if your computer does not support link local addressing See Appendix B Adding Route to Windows so Link Local Devices Can be Accessed if you have Windows and need to only use a link local address In order to have changes to the DHCP configuration or static IP addresses made SitePlayer will automati cally restart ...

Page 27: ...With security enabled all of SitePlayer s web setup pages will be protected with a username and password although you will only need to enter this information once when you access the web page You can change the username and password for web access Both the username and password are case sen sitive Only the username is displayed The default username and password are Default username user Default p...

Page 28: ...has no access restriction IP Address the complete or partial IP address that will have access to the port IP Mask a mask value which allows you to specify a range of IP addresses The mask is ANDed with the IP address which is accessing SitePlayer and compared to the IP Address above Here are some examples Port Number 80 IP Address 192 168 2 0 IP Mask 255 255 255 0 This will grant access to port 80...

Page 29: ...lt value of 40 sets the LED brightness to a medium low level Press Set LED Brightness to change the brightness level The brightness level will change immediately with out SitePlayer restarting Blink LED You can force the Link LED to blink for a period of time and at a certain rate This is useful if you have several SitePlayers and you wish to know which SitePlayer you are controlling via the web i...

Page 30: ...d Both SitePlayers should be power up simultaneously although they wait 15 seconds before they begin the test Each SitePlayer in Active mode initiates the test by sending the characters A through Z to the other SitePlayer Because the SitePlayers are wired in a loop they send characters on the serial port and network continuously Restart SitePlayer Press the Restart SitePlayer button to force Sitep...

Page 31: ...d Before erasing the persistent storage SitePlayer will attempt to save the current configuration parameters so they may be restored after persistent storage is erased This is useful when persistent storage is getting full and you want to reinitialize it but don t want to loose your configuration parameters If power is lost during this operation then it likely that the current configuration parameter...

Page 32: ...te version is displayed for reference purposes The Update web page will appear slightly different depending on which browser you use For example if you are using Internet Explorer the web page will look like this In either case you will need to press the Browse or Choose File button to select the appropriate file ROM files are named as follows SPT_Firmware_Vn_naaa rom SPT_Website_Vn_naaa rom where n_...

Page 33: ...BasicX processor to Wait for a Program Download For these functions to work you will connect the appropriate Tx Rx pins to SitePlayer s Tx Rx lines and also BasicX s ATTN line to SitePlayer s DTR line To begin loading the BasicX custom web page make sure your SitePlayer can display the main SitePlayer Setup Web Page Then in your web browser change the URL of SitePlayer Telnet by replacing the text...

Page 34: ...t BasicX you will get he following web page The commands available on this page are Restart Restarts execution of the BasicX processor Halt Wait for Program Download Halts the BasicX processor You can then send a BasicX pro gram through the network ...

Page 35: ...guration ZeroConf Link Local LL Address Acquisition SitePlayer conforms to RFC 3927 Dynamic Configuration of IPv4 Link Local Addresses with specifies how a host may automatically configure an interface with an IPv4 address within the 169 254 16 prefix This means that SitePlayer can automatically configure itself with a unique IP address This IP address however is only usable on the local link which mea...

Page 36: ...y discover each other without the need to enter IP addresses or configure DNS servers Bonjour is an open protocol which Apple has submitted to the IETF as part of the ongoing standards creation process Dynamic Host Configuration Protocol DHCP SitePlayer uses DHCP in the presence of a DHCP server to configure its IP address gateway and network mask Transmission Control Protocol Internet Protocol TCP I...

Page 37: ...at any time to that ad dress Otherwise SitePlayer will wait to received data so it can determine the response IP address The response IP address can change depending on the last IP address SitePlayer received UDPS data from This allows more than one computer to poll SitePlayer for data If you want to restrict SitePlayer to only communicate with one computer then you can use the Security Web page t...

Page 38: ...may also get this message if your web browser does not correctly upload files You could try switch ing to a different browser Bad request from browser or file not found You have requested a page on the SitePlayer that does not exist or your browser has sent a command that SitePlayer does not recognize Error setting parameters There was an error in setting the parameters Try the command again You may ...

Page 39: ...that the link is active It stays constantly lit on an active link When SitePlayer is being reprogrammed the LED will flash indicate that the internal flash is being erased and reprogrammed This will happen when new Firmware or Website is software is loaded or when the hardware reset button is pressed The Ethernet 10BaseT RJ45 Connector is used to connect to the Ethernet network The POE version conta...

Page 40: ...t a paper clip into the recessed reset hole You will feel the reset button depress With the reset button still depressed plug the power connector back in The blue LED will start blinking for a while you can now remove the paper clip While the LED is blinking do not remove power to SitePlayer The reset process is complete when the LED stops blinking The LED will either be lit constantly if SitePlay...

Page 41: ...n the option off while 1 means turn the option on If the optional numeric argument is not present then the number 0 is assumed which turns the option off The maximum command line that may be issued is 50 characters If you issue more that 50 characters the first 50 will be acted upon as if a carriage return had been issued Commands may be in ei ther upper or lower case A Repeat last command The last i...

Page 42: ... ATDU192 168 2 123 ATDU124 456 12 7 1002 E n Controls whether characters typed in command mode will echo 0 Commands are not echoed 1 Commands are echoed as the are typed default H n Hang up disconnect The current TCP IP connection is terminated I n Display Identifier Displays information of SitePlayer version including the MAC address If argument n is 1 then four IP addresses are displayed Fixed IP...

Page 43: ...er typed is erased Responses to various commands will appear as text in verbose mode ATV1 or as numeric responses when verbose mode is off ATV0 Numeric response codes are listed parenthetically OK 0 The current command has successfully completed CONNECT 1 Currently not returned RING 2 Currently not returned NO CARRIER 3 The remote TCP IP connection was terminated ERROR 4 There was an error in a com...

Page 44: ... a connection SYN_SENT A TCP IP SYN has been sent during connection processing SYN_RECEIVED A TCP IP SYN has been received during connection processing ESTABLISHED A remote connection is established FIN_WAIT_1 Waiting for a FIN FIN_WAIT_2 Waiting for a FIN CLOSE_WAIT A connection has been closed by SitePlayer and SitePlayer is waiting for remote end to close its connection CLOSING A connection clo...

Page 45: ... open source and royalty free and installs a plug in into IE which allows you to browse for Bonjour services via IE See http www porchdogsoft com products howl Howl is available for Windows 2000 XP Linux FreeBSD and Mac OS X Although you will not need to install it under Mac OS X since Bonjour browsing is supported with the Safari web browser A Java product which lets you browse for Bonjour servic...

Page 46: ...on Specification RFC856 Telnet Binary Transmission RFC857 Telnet Echo Option RFC858 Telnet Suppress Go Ahead Option RFC2217 Telnet Com Port Control Option The RFCs are available for viewing at http www ietf org rfc html SitePlayer supports the following NVT options TRANSMIT BINARY 0 ECHO 1 SUPPRESS GO AHEAD 3 COM PORT OPTION 44 The various sub options for the COM PORT OPTION option are listed below...

Page 47: ...ss allocation rules prevent an address from being assigned In these cases SitePlayer can only be ac cessed via it s LL address Unfortunately once Windows obtains a non LL address either manually or through DHCP it removes its route to the LL address subnet This has the effect of not being able to communicate with devices which are addressed only through 169 254 x y The easiest way around this is to...

Page 48: ...re writing your own programs you can turn off ACK delays at the socket level rather than for the whole system Use setsockopt with the TCP_NODELAY option For more information regarding tuning Win dows 2000 XP see http www microsoft com technet itsolutions network deploy depovg tcpip2k mspx Mac OS X or FreeBSD Under Mac OS X or FreeBSD you can modify the delayed ACK time via the sysctl command To see...

Page 49: ... need to connect SitePlayer Telnet to another DTE device such as a PC Serial port you will need to connect it using a null modem cable A null modem cable switches the data lines and other control lines around The following table illustrates how to wire a proper DB 9 Null modem cable ...

Page 50: ...SitePlayer Telnet User s Manual 50 Telnet Carrier Schematic ...

Page 51: ... 5V power 10 RST I Hardware reset 11 RI I Ring indicator 12 DCD I Data Carrier Detect 13 DSR I Data Set Ready 14 RTS O Request to send Used for hardware flow control 15 DTR FDRST O I Data Terminal Ready Factory default reset Resets device to factory defaults Hold pin to ground before applying power or RST Allow to float once power is applied Factory default reset will take approximately 15 seconds t...

Page 52: ......