SLTA- 10 Adapter and PSG/3 User’s Guide Revision 3 e ECHELON’ Corporation 078-0160-OlE
6 The SLTA-10 MIP Mode Software 6-1 SLTA-10 MIP Mode Software Overview 6-2 Installing the SLTA-10 MIP Mode Adapter Software 6-2 Installi
Initializing an SLTA- 10 Adapter After an SLTA-10 Adapter and its host processor are powered, the host application must initialize the
2 Cancel the FLUSH state in the SLTA-10 Adapter. LNS applications automatically handle this, and it is done automatically by the SLTA
install the SLTA-10 Adapter in a LonBuilder network using the service pin, you must either connect the SLTA-10 Adapter to a host, a
11 Using the SLTA-10 Adapter with a Modem This chapter describes the operation of the SLTA-10 Adapter when a remote host computer is c
Overview The SLTA-10 Adapter network interface may be attached to the host processor using modems and the switched telephone network.
updates are addressed to the SLTA-10 Adapter. Alternatively, another node on the local network can command the SLTA-10 Adapter to i
Command Set Assumptions The SLTA-10 Adapter uses the following strings received from the modem to interpret the connection state. Thes
Network Management Messages Network management messages are used to configure the operation of the network, as opposed to delivering a
11-6 Table 11 .l SLTA-10 Adapter Network Management Messages These network management messages may be sent from any node on the netwo
See the supplied Neuron C program DIALOUT. NC for an example of an application that sends a message to an SLTA-10 Adapter to cause it
SLTA- 10 Adapter User’s Guide ix 8 Using the DOS Driver with SLTA-10 MIP Mode Installing the SLTA-10 MIP Mode Driver for DOS Buffer
when (msg-fails(SLTA-tag)) { // SLTA-10 Adapter did not respond to the message . . . when (msg-succeeds) { . . . } when (resp-arrives(S
l One modem hang-up string. This string is used to hang-up the modem and break the connection when DTR control does not function.
allocated total size for the string, the total size for that string is automatically extended, if space is available. All pieces of
SLTA-10 Adapter User’s Guide 11-11 The length of modem-string is limited to the application and network buffer sizes within the SLTA-10
Connection Status Query The SLTA-10 Adapter’s connection status may be polled with this message. Most modems may be configured with
Connection progress may then be checked periodically by interested nodes using the Connection Status Query message. The mode parameter
If the SLTA-10 Adapter is forced to send the hangup string, and this string does not exist in the EEPROM configuration, the respo
. &D2 is the AT command to enable the Data Terminal Ready (DTR) input of the modem. The modem will hang-up, enter command state
Install Dial Prefix The default setting for this string is "ATDT". This string is sent as a prefix for any dial-out operat
Request/Release SLTA This message may be used to grant ownership access of the SLTA-10 Adapter to any node on the local network. In
11 Using the SLTA-10 Adapter with a Modem Overview SLTA-10 Adapter Connection States Command Set Assumptions Translated Characters DTE Co
Install NSlConnecf (NSI mode only) This message writes the NSIConnect byte. A value of OxFF (the default) will disable this feature.
Modem Compatibility The SLTA-10 Adapter has been tested with the following modems: Best Data Smart One external modem 33,600 bps Data
In all cases both the host side and the SLTA-10 side were set to 115200 baud. Since 56K V.90 or V.FAST modulation is asymmetrica
Figure 11.3 DOS Virtual Device Driver Configuration Screen Reboot the PC after installing the SLTA-10 driver software. SLTALin k Manag
3. 4. Figure 11.5 SLTALink Manager Application Screen Confirm that the left panel of the SLTALink status bar shows the ‘Local SLTA-10’
AT!-ATE WOK1 &D2SO=l MOLO Figure 11 .l SLTA-10 Configuration Dialog Setup for Remote Dial-ins 5. The SLTA-10 can now be tested by r
Figure 11.7 Link Description Wizard 8. Provide the dialing information as shown in figure 11-8. Figure 11.8 Dialing Information for
Figure 11.9 Setting the Password for the Remote Link Description 12. Attach the remote SLTA-10 modem to the telephone network. The
Figure 11 .lO Results of a Proper Connection to a Remote SLTA-10 11-26 Using the SLTA-10 Adapter with a Modem
12 Using the Host Connect Utility with the SLTA- 10 MIP Mode The Host Connect Utility, or HCU, is a standalone DOS utility designed to
13 Using a Programmable Serial Gateway Creating a Serial Gateway SLTA/PSG History Programmable Serial Gateway Hardware Resources Developin
HCU Usage The command line arguments for HCU are: HCU [options] [string1 . . string(n)] 1 [@filename] The optional [options] arguments
response from the modem before sending the next string. This requires that word (alphabetic) modem responses are enabled in the mod
is a connection operation, the selected network interface protocol is enabled. If the -X option is specified, modem support is disable
hcu -b9600 -pSLTA-2.0 Qdial.cmd if not errorlevel 1 hostapp.exe hcu -h n ---+++---athO ! fl If using a Windows-based network management
12-6 Using the DOS Host Connect Utility with SLTA-10 MIP Mode Table 12.1 HCU Progress Strings deuname: No such file or Indicates tha
13 Using a Programmable Serial Gateway This chapter describes how to develop a gateway for a user-defined EIA-232 serial protocol. The
Creating a Serial Gateway For applications of the SLTA hardware platform, which cannot use the LonTalk network interface protocol on
Each of the serial adapters listed above may also be ordered without firmware. The hardware is identical, but no firmware is shippe
Developing a PSG Application with the NodeBuilder Development Tool Developing an application for the PSG/3 serial gateway is similar t
PSG2OR. DTM PSG/3’s are modified to ignore DIP switch #4. The NSI memory map is the only available memory map. Firm ware Library Sup
xii Preface
Usage A single programmable serial gateway library (PSG . LIB) is included with the PSG software. Depending on the hardware you intend
Code Development and Debugging The PSG applications can be debugged only with the NodeBuilder Development Tool. The LonBuilder Develop
PSG.LlB Functions void slta-init(slta-format, slta-baud, slta-intfc); This function initializes the UART. It sets up the frame format, th
unsigned slta-configlvoid); This function reads the configuration inputs. Each input corresponds to a bit in the value returned by sl
boolean slta-rxrdy(void); This function returns TRUE if the UART has one or more characters in its input FIFO buffer and FALSE other
UART Registers The UART registers are located at address OxE780 - OxE787. See the UART datasheet for register usage information. PROM /
Porting PSGl2 Code to the PSGl3 Use the following steps to port an existing application from a PSG/2 to a PSG/3. 1. Use the device
14 Modem Troubleshooting This chapter provides solutions to problems that may arise with a modem attached to an SLTA-10 Adapter. SLTA-1
Troubleshooting A Host/Modem - ModemISLTA-10 Adapter configuration has many user-selected options including the choice of modems, configur
SLTA- 70 Adapter to Host Link Fails Partially This can be observed as retries at the link layer when certain downlink or uplink transf
1 SLTA- 10 Adapter Overview The SLTA-10 Serial LonTalk Adapter (Models 73351, 73352, 73353, and 73354) is a network interface that enab
14-4 Modem Troubleshooting
Appendix A LONWORKS DLL Interface Software This appendix describes the function and use of the LONWORKS DLL interface software provided wit
Introduction Microsoft Windows 3.1x supports access to DOS drivers through an interface layer called DOS Protected Mode Interface (DPM
ldv-close Purpose Terminates access to the network interface hardware. Syntax #include <ldv.h> short ldv-close(short handle); See Also
ldv-get-version Purpose Returns the current version of the driver DLL as a text string. Format of the version string is “M.mm[.sss]” whe
ldvjoctl Purpose Ldv-octl error codes are the same as for ioctl(); the number of bytes actually transferred. -1 implies invalid handle
ldv-open Purpose Initializes the network interface hardware for access by a Windows application. A Windows application can open multiple
ldv-read Purpose Retrieves an available message from the network interface hardware. The function returns immediately when no messages
ldv-write Purpose Delivers a message to the network interface hardware. Syntax #include <ldv.h> short ldv-write(short handle, void fa
ECHELON” DECLARATION OF CONFORMITY LonTalk Adapters (SLTA-10, PSG/3, PSG/20) Application of Council Directive: Manufacturer’s Name: Manufactur
Introduction The SLTA-10 Adapter is the latest addition to the SLTA product family. It is an EIA-232 (formerly RS-232) compatible serial
Host Host Application LNS or LonManager Software (optional) Driver Interface Network Driver EIA-232 Interface Network Interface SLTA-10 Network
Feature SLTA-10 SLTA-10 SLTN2 1 Software used to establish connections via modems Who initiates calls from a remote network Input power
depending on transceiver type. In addition, the SLTA-10 configuration DIP switches are externally accessible. The SLTA-10 enclosure has
Echelon, LON, LonTalk, LonBuilder, NodeBuilder, Neuron, LonManager, LONMARK, LonMaker, LONWORKS, 3120 and 3150 are registered trademarks
Applications based on LNS 1.0 or 1.01 do not have full functionality with respect to the SLTA-10 Adapter and modems because LNS 1.0 and
2 SLTA- 10 Adapter Hardware This chapter provides a physical description of the SLTA-10 Adapter. SLTA-10 Adapter User’s Guide 2-l
Mechanical Description Figures 2.1 and 2.2 show the SLTA-10 Adapter in its enclosure. Figure 2.3 shows the SLTA-10 Adapter board wit
Figure 2.2 shows a 1:l view of the enclosure and may be used as a mounting template. 0 0 3.42 - P [86.86] 7 0 0 0 * Figure 2.2 SLTA-10 A
W) Service I Button Wl) ( Service LED w 1 Config. Switch Block (Jl) Network Connector Component Side View 0 n Neuron@ 3150@ Chip F 1 Transceiver
Table 2.1 describes the external connections and switches/LEDs on the SLTA-10 Adapter. Table 2.1 SLTA-10 Adapter Interfaces Interface Serv
In tetface I Function Connecting Power Once the SLTA-10 Adapter is physically attached to the desired channel, power must be supplied via
Table 2.2 provides the specifications for power inputs to the SLTA-10 Adapter. The barrel connector input, 52, is a standard female po
2-8 SLTA-10 Adapter Hardware
3 Cabling and Connections This chapter demonstrates how to attach the SLTA-10 Adapter to a LONWORKS network, a PC, and a modem. To con
FCC NOTICE (for USA only) Federal Communications Commission Radio Frequency Interference Statement Warning: This equipment has been tested
LONWORKS Network Connection The SLTA-10 includes a removable screw terminal connector (Jl) for the twisted pair LONWORKS network connecti
Table 3.1 PC DB-9 to DB-9 Connection Signal Name PC Connector Cable DB-9 Cable DB-9 DB-9 Male Female Male RxD TxD Pin 2 Pin 2 Pin 2
3-4 Table 3.3 DCE Modem to SLTA-10 Adapter Connection (DB-9 to DB-9) Modem Cable DB-9 Null Cable DB9 Male SLTA-10 (DCE) Signal Name
Hardware Configuration This chapter describes how to install and configure an SLTA-10 Adapter. SLTA-10 Adapter User’s Guide 4-l
Configuring the SLTA- 10 Adapter Hardware There are eight configuration switches on the SLTA-10 Adapter’s switch block (Sl). These inputs
running DOS or Windows cannot guarantee receipt of all characters in an input stream appearing back-to-back on a COM port . ALERT/ACK l
4-4 Network Disable (Switch3 / CFG 7) Figure 4.4 SLTA-10 Adapter Network Switch 3 / CFGl Switch 3 / CFGl enables (down position) or d
If CFGl is set to Network Enable (down position), the SLTA-10 Adapter will enable network communications after a reset by going directl
Autobaud (AB) The switch (5) labeled AB on the SLTA-10 Adapter is used to select automatic baud rate detection-the autobaud feature. Aut
For the Windows 95198 or NT network driver, there is no /B option. When using these drivers, the serial bit rate is configured using
SLTA- 10 Adapter Buffers The types of messages passed between the host and the SLTA-10 Adapter are determined by EEPROM configuration opt
The NODEUTIL node utility application, available on Echelon’s web site, can be used to modify the MIP mode buffer configuration from a P
4-10 Configuration
The SLTA- 10 NSI Mode Software This chapter describes the Windows 95/98 or Windows NT software used with the SLTA-10 NSI mode. This s
SLTA- 10 NSI Mode Software Overview The SLTA-10 Adapter is not shipped with any software. The Windows NT driver and SLTALink Manager s
5. When prompted for a program name, enter the following: A:\SETUP.EXE If necessary, replace A : with the drive letter which corresponds
Windows 95/98 and NT Software Installation Results The Windows 95 and NT installation software loads a selection of new files and updat
6 The SLTA- 10 MIP Mode Software This chapter describes the SLTA-10 MIP mode software shipped with the Connectivity Starter Kit (Model
SLTA-10 MIP Mode Software Overview The SLTA-10 Adapter is not shipped with any software. The SLTA-10 MIP mode software and drivers a
The SLTA-10 Adapter software will be installed in the SLTA sub-directory of your LONWORKS directory, with the exception of the DOS networ
Preface This document describes how to use the SLTA-10 Serial LonTalk@ Adapter to connect a host processor, with an EIA-232 (formerly
formats. External interface files in version 3 format are contained in the SLTA2\XIF-V3 directory. The SLTA directories contain at least
HA-TEST.NC A Neuron C program which may be loaded into a Neuron emulator and bound to the sample host application for testing. D1SPLAY
6-6 The SLTA-10 MIP Mode Software
7 Using the Windows 95/98 or NT Driver and SLTALink Manager with SLTA-10 NSI Mode This chapter describes the SLTALink Manager software,
Software Overview The SLTALink Manager is a standalone application that can monitor a modem line, answer an incoming phone call, assoc
Figure 7.1 SLTALink Manager Main Screen Establishing a Communications Line for Dialing in to a Network Establishing a communications li
7-4 This message in figure 7.2 may not be visible due to being covered by the SLTALink Manager Dialing Preferences window. Moving
Figure 7.5 Windows Dialing Properties Window Establishing a Communications Line for Calls Dialed out to the PC The next step is to
Figure 7.6 SLTALink Manager Monitor Line Window The option list box will display the list of modems which have been set-up for us
Select “Local SLTA-10” and click Edit. This action will present a window allowing the ability to customize the connection-including c
Content This manual provides detailed information about the hardware and software for the SLTA-10 Adapter. . . . . . . . . . . . . . . . C
7-8 SLTA-10 NSI Mode Software NSIConnect=two digits NSI Auto-connect: either two digits, or no digits if disabled. The first digit repr
The SLTALink Manager software allows a user to create two links with different names but the same Remote Identifier. However, when
%RESULT% Expands to an unquoted word that represents the success or fail reason of the connection. The startup application will be la
Security Password The SLTA Adapter may be configured to accept incoming calls and connect the network to the host. Incoming callers
! Causes a carriage return to be sent. Causes a 500ms pause. The carriage return is not required at the end of the string. Clear EE
Diagnostics A number of Diagnostic and testing services are provided via the Diagnostic Screen, accessed through the Devices menu (se
/D /# Ymmber” /P “passwdM This causes the specified link to be disconnected. C:\lonworks\bin\sltalink.exe "Remote" /D This overrid
Characteristics of a Well-Designed System Well understood strategies used with the SLTA-10 Adapter and the SLTALink Manager for the f
In the third case, a custom Neuron Chip application must be written. All three cases could be used with the same SLTA-10 Adapter. I
SLTALink Manager on this PC receives the callback just like any other normal dial-out call and launches the application contained i
Related Manuals The following Echelon documents are suggested reading for more information: The LCA Object and Data Server Programmer’s
and the manual disconnect in the SLTALink Manager, this scenario does not result in the application terminating. This scenario there
the second approach places the burden on the host application. The first is more direct and is likely to result in the information
7-20 Host Monitoring Application Remote LCA SLTALink Manager and Network Driver Modem t Dial-out I Modem I I ~~~~ Null Modem Cable SLTA-10 Ada
Host Monitoring Application LNS Server Driver : Interface SLTALink Manager and Network Driver I Modem I Dial-in and Dial-out to the LNS Serve
7-22 Host Monitoring Application Remote LCA SLTALink Manager and Network Driver Host Monitoring Application Remote LCA SLTALink Manager and N
8 Using the DOS Driver with SLTA-10 MIP Mode This chapter describes the DOS network driver supplied with the Connectivity Starter. The
Installing the SLTA-10 MIP Mode Driver for DOS The DOS driver is supplied on the &PPY diskette included with the Con- nectivity Starte
is determined by the expected incoming traffic and the capability of the host application to process it. If the incoming traffic i
DOS Device Options /Pn Sets the serial port to <n> where <n> is l-4 for COMl - COM4. The default is COMl. /Dn Defines the d
Timing Options /Rnn Defines the flush/retry count in 55ms intervals. This value is used in error states for re-transmitting requests
vi Preface
port from the write function call. The host write functions will not return until the message has been sent downlink. When using
/X Disables the buffer request protocol. When this option is enabled, the driver requests the buffer count from the SLTA-10 Adapter
Calling the Network Driver from a Host Application The SLTA-10 MIP mode network driver for DOS supports the open, close, read, writ
Host applications that only communicate to the SLTA-10 Adapter via an already- established telephone connection do not need to conce
Sub-command 2 is used to set the state of the DTR line. In this case, the DTR signal is enabled (on) if the mode field is true.
9 Creating an SLTA- 10 MIP Mode Driver This chapter describes the process of building a network driver for a host that is to be connec
Purpose of the Network Driver The network driver provides a hardware-independent interface between the host application and the network
Host Host Application r-------‘----------‘-r I ------ bWhmw2r_APL _ _ _ _ _ I ---___------------------------------------- Application Layer Interf
2 3 4 5 9-4 from and written to the serial device using the UNIX read ( ) and write ( ) system calls. The UNIX network driver inclu
network driver. The read/write interface is implemented in the ldv-read ( ) and ldv-wr i te ( ) functions for the UNIX network dri
Preface Content Related Manuals Web Access iv V V 1 SLTA-10 Adapter Overview Introduction Two Modes of Operation: SLTA-10 NSI and MIP Modes
device responds by transmitting the ALERT ACK byte (value FE hex). This low level handshaking process prevents the sender from trans
transmitting a message. If the ALERT ACK is not received in time, the SLTA-10 Adapter repeats the process by transmitting another AL
reported to the application, and checksum errors detected by the SLTA-10 Adapter will cause the message to be ignored. This protocol
byte (value FE hex). This low level handshaking process prevents the sender from transmitting the rest of the sequence before the
SLTA- 10 Adapter Timing Data Certain aspects of the SLTA-10 Adapter link and transport layer protocols implement fail-safe timeouts in
Down/ink Buffer Request Protocol The network driver receives application buffers from the host application, translates them to interfac
Node Reset A Flush Receive niFLUSHCANCEL Receive niCOMM or niNETMGMT? Available? output 5 Upon receiving the niACK acknowledgment, the networ
buffer has the same command and queue value sent in step 2, and also contains the data and checksum. Upon completion of this tra
SLTA-10 Adapter. This feature has been added to the DOS driver for the SLTA-10 Adapter. Presentation Layer Protocol The network drive
10 Initialization and Installation This chapter describes initializing, communicating with, and installing the SLTA-10 Adapter as a netwo
Comments to this Manuals