Echelon SLTA-10 Guia do Utilizador

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