1. DL manuals
  2. Echelon
  3. Adapter
  4. SLTA-10
  5. User Manual

Echelon SLTA-10 User Manual

Summary of SLTA-10

  • Page 1

    Slta-10 adapter user’s guide revision 1 ® c o r p o r a t i o n 078-0160-01b.

  • Page 2

    Slta-10 adapter user’s guide 2 echelon, lon, l on w orks , l on m ark , neuron, 3120, 3150, lonbuilder, nodebuilder, lontalk, and lonmanager are trademarks of echelon corporation registered in the united states and other countries. Lonmaker and lonsupport are trademarks of echelon. Other brand and p...

  • Page 3

    Slta-10 adapter user’s guide 3 preface this document describes how to use the slta-10 serial lontalk ® adapter to connect a host processor, with an eia-232 (formerly rs-232) serial interface, to a l on w orks ® network..

  • Page 4

    Slta-10 adapter user’s guide 4 content this manual provides detailed information about the hardware and software for the slta-10 adapter. • chapter 1 introduces the slta-10 adapter and provides a quick overview. • chapter 2 describes the slta-10 adapter hardware. • chapter 3 describes how to attach ...

  • Page 5

    Slta-10 adapter user’s guide 5 related manuals the following echelon documents are suggested reading for more information: • the lc a object and data server programmer’s guide describes how to write a 32-bit windows host application and installation tool that can be used with the slta-10 nsi mode. •...

  • Page 6

    Slta-10 adapter user’s guide 6.

  • Page 7

    Slta-10 adapter user’s guide 7 contents preface content 4 related manuals 5 web access 5 1 slta-10 adapter overview 11 introduction 12 two modes of operation: slta-10 nsi and mip modes 13 slta-10 nsi mode features 14 slta-10 mip mode versus the slta/2 14 the slta-10 adapter configurations 14 softwar...

  • Page 8

    Slta-10 adapter user’s guide 8 6 the slta-10 mip mode software 43 slta-10 mip mode software overview 44 installing the slta-10 mip mode adapter software 44 installing the windows 3.1x dll software 47 other drivers 48 7 using the windows nt driver and sltalink manager with slta-10 nsi mode 49 softwar...

  • Page 9

    Slta-10 adapter user’s guide 9 9 creating an slta-10 mip mode driver 77 purpose of the network driver 78 example network drivers 78 implementing an slta-10 mip mode network driver 78 network interface protocol 81 link layer protocol 81 alert/ack link protocol 81 buffered link protocol 83 transport l...

  • Page 10

    Slta-10 adapter user’s guide 10 clear eeprom pool 109 install nvconnect (nsi mode only) 109 install nsiconnect (nsi mode only) 110 install callbackenable (nsi mode only) 110 report sltaee (nsi mode only) 110 modem compatibility 111 12 using the dos host connect utility with the slta-10 mip mode 113 ...

  • Page 11

    Slta-10 adapter user’s guide 11 chapter 1 slta-10 adapter overview the slta-10 serial lontalk adapter (models 73351, 73352, and 73353) is a network interface that enables any host processor with an eia-232 serial interface to connect to a l on w orks network. The slta-10 adapter extends the reach of...

  • Page 12

    Slta-10 adapter user’s guide 12 introduction the slta-10 adapter is the latest addition to the slta product family. It is an eia-232 (formerly rs-232) compatible serial device that allows any host with an eia-232 interface and proper software to communicate with a l on w orks network. An slta-10 ada...

  • Page 13

    Slta-10 adapter user’s guide 13 two modes of operation: slta-10 nsi and mip modes the slta-10 adapter provides both the network services interface (nsi mode) functionality for use with lns-compliant applications, and network interface functionality (mip mode) for use with lonmanager api-based applic...

  • Page 14

    Slta-10 adapter user’s guide 14 slta-10 nsi mode features the most important new feature of the slta-10 nsi mode is the nsi functionality for use with lns-compliant applications. Other important features available only in the slta-10 nsi mode include: slta-10 initiated dial-out, a windows nt driver,...

  • Page 15

    Slta-10 adapter user’s guide 15 lns 1.0, 1.01, and 1.5 compatibility when the slta-10 adapter is connected directly to the pc host (i.E., no modems), the slta-10 adapter uses a direct connection. For a direct connection, the slta-10 adapter behaves like any other nsi, such as the pclta-10 adapter or...

  • Page 16

    Slta-10 adapter user’s guide 16 tapi compatibility the sltalink manager software uses tapi release 1.3 or higher. This is supported in windows nt 4.0, but not in windows nt 3.51. Thus, windows nt 3.51 does not support the use of the slta-10 adapter with modems, however, windows nt 3.51 does support ...

  • Page 17

    Slta-10 adapter user’s guide 17 chapter 2 slta-10 adapter hardware this chapter provides a physical description of the slta-10 adapter..

  • Page 18

    Slta-10 adapter user’s guide 18 mechanical description figures 2 and 3 show the slta-10 adapter in its enclosure. Figure 4 shows the slta-10 adapter board without an enclosure. Figure 2 slta-10 adapter enclosure.

  • Page 19

    Slta-10 adapter user’s guide 19 figure 3 shows a 1:1 view of the enclosure and may be used as a mounting template. Figure 3 slta-10 adapter enclosure keyhole view mounting slots.

  • Page 20

    Slta-10 adapter user’s guide 20 slta-1Ø © echelon 1996 transceiver section (j5) eia-232 data port (j3) power input (j2) power input (ds2) power indicator led (s1 ) config. Switch block (s2) service button (ds1) service led (j1) network connector component side view neuron 3150 chip ® ® figure 4 slta...

  • Page 21

    Slta-10 adapter user’s guide 21 table 2 describes the external connections and switches/leds on the slta-10 adapter. Table 2 slta-10 adapter interfaces interface function service button s2 pressing this switch grounds the service request pin on the neuron chip within the slta-10 adapter. While this ...

  • Page 22

    Slta-10 adapter user’s guide 22 interface function unregulated ac/dc power input two-position j3 black connector for the power input. The mating plug (provided) is weidmüller pn 125911. Unregulated ac/dc power input barrel connector j2 female 2.1 mm inside diameter and 5.5 mm outside diameter barrel...

  • Page 23

    Slta-10 adapter user’s guide 23 table 4 provides the specifications for power inputs to the slta-10 adapter. The barrel connector input, j2, is a standard female power plug with a 2.1 mm inside diameter and 5.5 mm outside diameter, (lzr electronics part number hp-114a, radio shack catalog number 274...

  • Page 24

    Slta-10 adapter user’s guide 24.

  • Page 25

    Slta-10 adapter user’s guide 25 chapter 3 cabling and connections this chapter demonstrates how to attach the slta-10 adapter to a l on w orks network, a pc, and a modem..

  • Page 26

    Slta-10 adapter user’s guide 26 attaching the slta-10 adapter eia-232 devices are configured as either data circuit-terminating equipment (dce) or as data terminal equipment (dte). A dce device connects to a dte device, unless a null modem cable is used. Using a null modem cable, a dce device connec...

  • Page 27

    Slta-10 adapter user’s guide 27 if using a pc or modem equipped with a db-25 connector, then use a cable equipped on one end with a db-25 female connector and a db-9 male connector on the other end. Plug the male db-9 connector into the slta-10 adapter and the female db-25 connector into the pc. Tab...

  • Page 28

    Slta-10 adapter user’s guide 28 table 8 dce modem to slta-10 adapter connection (db-25 to db-9) modem signal name cable db-25 male cable db9 male slta-10 (dce) db-9 female rxd—pin 3 pin 3 pin 3 txd—pin 3 txd—pin 2 pin 2 pin 2 rxd—pin 2 dcd—pin8 pin 8 pin 4 dtr—pin 4 dtr—pin 20 rts—pin 4 pins 20 & 4 ...

  • Page 29

    Slta-10 adapter user’s guide 29 chapter 4 hardware configuration this chapter describes how to install and configure an slta-10 adapter..

  • Page 30

    Slta-10 adapter user’s guide 30 configuring the slta-10 adapter hardware there are eight configuration switches on the slta-10 adapter's switch block (s1). These inputs are read by the slta-10 firmware to configure or enable features. Figure 10 shows the factory default settings for the slta-10 adap...

  • Page 31

    Slta-10 adapter user’s guide 31 cannot guarantee receipt of all characters in an input stream appearing back-to-back on a com port . Alert/ack link protocol (down position) is the default setting for the slta-10 adapter. When the slta-10 adapter uses the alert/ack protocol and it wishes to send data...

  • Page 32

    Slta-10 adapter user’s guide 32 network disable (switch3 / cfg1) 3 network disable on network enable (default) (disable off) figure 13 slta-10 adapter network switch 3 / cfg1 switch 3 / cfg1 enables (down position) or disables (up position) network communications after reset. If disabled, the slta-1...

  • Page 33

    Slta-10 adapter user’s guide 33 if the slta-10 adapter is used with a modem, and the application requires the slta-10 adapter to dial out to a host in response to a message from the network, then cfg1 must be set to network enabled. If the modem is set to receive incoming calls only, then the host c...

  • Page 34

    Slta-10 adapter user’s guide 34 autobaud (ab) the switch (5) labeled ab on the slta-10 adapter is used to select automatic baud rate detection—the autobaud feature. Autobaud must not be used when the slta-10 adapter is used with a modem. When autobaud is enabled, the slta-10 adapter matches the seri...

  • Page 35

    Slta-10 adapter user’s guide 35 6 7 8 115, 200 bps 6 7 8 57,6 00 bps 6 7 8 9 600 bps 6 7 8 2 400 bps 6 7 8 1 200 bps 6 7 8 19,2 00 bps 6 7 8 300 bps 6 7 8 38,4 00 bps (d efault ) figure 16 slta-10 adapter serial baud rate switches 6, 7, and 8 / baud[2..0] table 10 slta-10 adapter autobaud switch con...

  • Page 36

    Slta-10 adapter user’s guide 36 configuring the slta-10 adapter software the types of messages passed between the host and the slta-10 adapter are determined by eeprom configuration options. These options are described under network interface configuration options in chapter 3 of the l on w orks hos...

  • Page 37

    Slta-10 adapter user’s guide 37 the nodeutil node utility application, available on echelon’s web site, can be used to modify the mip mode buffer configuration from a pc host. See the readme.Txt file included with nodeutil for details. By default, the slta-10 nsi-mode program id consists of 8 bytes ...

  • Page 38

    Slta-10 adapter user’s guide 38.

  • Page 39

    Slta-10 adapter user’s guide 39 chapter 5 the slta-10 nsi mode software this chapter describes the windows nt software used with the slta-10 nsi mode. This software is available in the connectivity starter kit (model 58030-01) as part of the lns developer’s kit for windows (model 34303), versions 1....

  • Page 40

    Slta-10 adapter user’s guide 40 slta-10 nsi mode software overview the slta-10 adapter is not shipped with any software. The windows nt driver and sltalink manager software are supplied in the connectivity starter kit and as part of the lns developer’s kit for windows. The slta-10 nsi mode set-up in...

  • Page 41

    Slta-10 adapter user’s guide 41 7. When prompted for a destination directory, enter the desired installation directory. By default this directory is c:\lonworks , unless previous l on w orks products have been installed and have registered a different path in the windows registry. The path may be mo...

  • Page 42

    Slta-10 adapter user’s guide 42.

  • Page 43

    Slta-10 adapter user’s guide 43 chapter 6 the slta-10 mip mode software this chapter describes the slta-10 mip mode software shipped with the connectivity starter kit (model 58030-01) and on the echelon web site at www.Echelon.Com. This software is basically an updated version of the slta/2 adapter ...

  • Page 44

    Slta-10 adapter user’s guide 44 slta-10 mip mode software overview the slta-10 adapter is not shipped with any software. The slta-10 mip mode software and drivers are supplied in the connectivity starter kit and must be ordered separately. The software includes ansi c source code for ha, a sample ho...

  • Page 45

    Slta-10 adapter user’s guide 45 the slta directory will contain the following files: • read-me file. The readme.Txt file includes a list of all the files on the distribution disk, and also includes any updates to the documentation that occurred since the slta-10 adapter documentation was printed. • ...

  • Page 46

    Slta-10 adapter user’s guide 46 and message tags. These interface files are provided in version 3 formats. External interface files in version 3 format are contained in the slta2\xif_v3 directory. The slta directories contain at least the following files: nslta125.Xif for slta-10 adapter with a tp/x...

  • Page 47

    Slta-10 adapter user’s guide 47 hauif.H definitions for the host application example user interface. Makefile a make file script for borland c. Msoft.Mak a make file script for microsoft c. Ha_v3.Xif an external interface file which may be used to bind the example with lonbuilder. Ha_test.Nc a neuro...

  • Page 48

    Slta-10 adapter user’s guide 48 should be copied to a directory in the include file search path of your c compiler. The file wldv.Lib should be copied to a directory in the library search path of your application linker. See appendix a for information on using the windows dll. Other drivers a unix n...

  • Page 49

    Slta-10 adapter user’s guide 49 chapter 7 using the windows nt driver and sltalink manager with slta-10 nsi mode this chapter describes the sltalink manager software, which establishes and configures local and remote links from the host pc to the slta-10 adapter in nsi mode. A remote link requires a...

  • Page 50

    Slta-10 adapter user’s guide 50 software overview the sltalink manager is sophisticated software that compliments the slta-10 adapter nsi mode firmware in many various ways. The sltalink manager is a standalone application that can monitor a modem line, answer an incoming phone call, associate the i...

  • Page 51

    Slta-10 adapter user’s guide 51 figure 18 sltalink manager main screen establishing a communicat ions line for dialing in to a network e s t a b l i s h i n g a communications line is the first task to be completed. Figure 19 displays the message that appears when dialing preferences is chosen from ...

  • Page 52

    Slta-10 adapter user’s guide 52 this message in figure 19 may not be visible due to being covered by the sltalink manager dialing preferences window. Moving the dialing preferences window should reveal the message—if it exists. This leftmost window, shown in figure 20, will display “???” for the “di...

  • Page 53

    Slta-10 adapter user’s guide 53 figure 22 windows dialing properties window establishing a communications line for calls dialed out to the pc the next step is to select a line/modem to monitor for incoming calls. Figure 23 shows the monitor line window that is displayed when “monitor for slta dial-i...

  • Page 54

    Slta-10 adapter user’s guide 54 figure 23 sltalink manager monitor line window the option list box will display the list of modems which have been set-up for use on this computer. The list can be created/modified by using the windows modem control panel. Select the line/modem to be used for incoming...

  • Page 55

    Slta-10 adapter user’s guide 55 select “local slta-10” and click edit. This action will present a window allowing the ability to customize the connection—including changing it from local to remote, or modifying the name. Name of link the name of the link should be fairly verbose, and/or something ea...

  • Page 56

    Slta-10 adapter user’s guide 56 slta password the password box allows the user to enter the password for a remote slta-10 adapter. Up to eight characters may be entered. If entered, the password will be sent to the remote slta-10 adapter when a connection is made. The password is not encrypted when ...

  • Page 57

    Slta-10 adapter user’s guide 57 diagnostics a number of diagnostic and testing services are provided via the diagnostic screen, accessed through the devices menu (see figure 26). The test button retrieves status and error counts from the slta-10 adapter. The service button will cause the slta-10 ada...

  • Page 58

    Slta-10 adapter user’s guide 58 the /p and /# options may be combined. Note that the phone number is in the form of a canonical number. This is defined as a country code followed by a space, followed by an area code or city code enclosed in parenthesis, followed by a space and the rest of the phone ...

  • Page 59

    Slta-10 adapter user’s guide 59 monitoring application that programmatically interacts with the sltalink manager to send down the appropriate phone number, perhaps to a generic out-going link. Dial-out to the remote pc only the three common approaches for initiating a dial-out are: sending a network...

  • Page 60

    Slta-10 adapter user’s guide 60 callback the slta-10 adapter callback functionality works as follows: a call is initiated from some remote pc to an slta-10 adapter on a network, which must have its nsi mode eeprom configured to require callback. See chapter 11 for more information on configuring the...

  • Page 61

    Slta-10 adapter user’s guide 61 10 adapter. Note: this assumes that the nss engine exists somewhere on the network and is not located on one of the remote pcs sharing the single slta-10 adapter. Both an application controlled hang-up (using the sltalink.Exe programmatic interface) and a manual disco...

  • Page 62

    Slta-10 adapter user’s guide 62 sltalink manager then reads the remote identifier in the slta-10 adapter and searches through all the .S10 files for a match. The sltalink manager application then typically launches the application listed in the link with optional command line arguments available, fo...

  • Page 63

    Slta-10 adapter user’s guide 63 several pcs can share one slta-10 adapter as long as the calls are all initiated on the remote pc hosts (i.E., dial-in only) and each remote lns application removes the bound connections to its host before terminating. See figure 29. Figure 27 dedicated slta-10 adapte...

  • Page 64

    Slta-10 adapter user’s guide 64 figure 28 dedicated slta-10 adapter hosting the nss monitoring application lns server sltalink manager and network driver host m o d e m m o d e m null modem cable slta-10 adapter transceiver interface dial-in and dial-out to the lns server driver interface lonworks d...

  • Page 65

    Slta-10 adapter user’s guide 65 figure 29 shared slta-10 adapter using dial-in monitoring application r e m o t e l c a sltalink manager and network driver host m o d e m m o d e m null modem cable slta-10 adapter transceiver interface driver interface lonworks devices lns server monitoring applicat...

  • Page 66

    Slta-10 adapter user’s guide 66.

  • Page 67

    Slta-10 adapter user’s guide 67 chapter 8 using the dos driver with slta-10 mip mode this chapter describes the dos network driver supplied with the connectivity starter kit. The dos network driver provides a device- independent interface between a dos or windows 3.1x host application and the slta-1...

  • Page 68

    Slta-10 adapter user’s guide 68 installing the slta-10 mip mode driver for dos the dos driver is supplied on the floppy diskette included with the connectivity starter kit. The latest version of this driver may be obtained from the echelon web site. The slta-10 mip mode network driver for dos is ins...

  • Page 69

    Slta-10 adapter user’s guide 69 traffic fast enough, the input buffer pool will fill up with unprocessed packets. In that case, the slta-10 adapter will not be able to pass any new data to the host, and the input application buffers in the slta-10 adapter will start to fill up. Once that occurs, mes...

  • Page 70

    Slta-10 adapter user’s guide 70 lxt_open() when using the lonmanager api. When invoking the sample host application ha, the device may be specified with the -d option, for example: ha -dlon2 /un sets the serial port interrupt request number (irq) to a non-standard value n >, where n > is between 1 a...

  • Page 71

    Slta-10 adapter user’s guide 71 the pacing delay will have no effect unless it is greater than the actual period it takes to transmit a single byte at the given serial bit rate. The time taken to transmit a byte is 173 µs at 57,600 bps, and 86 µs at 115,200 bps. This option should be used at 115,200...

  • Page 72

    Slta-10 adapter user’s guide 72 switch2/cfg2 input in the remote host setting (up position). When connected, the selected slta-10 adapter and host network interface link protocol is in effect. When disconnected the only allowable link layer traffic is of the ‘modem direct’ type, where ascii strings ...

  • Page 73

    Slta-10 adapter user’s guide 73 table 15 configuration switches and dos driver options input input state driver option switch2/cfg 2 local host; no transport protocol /m not specified switch2/cfg 2 remote host; reliable transport protocol /m specified switch1/cfg 3 alert/ack link protocol /n not spe...

  • Page 74

    Slta-10 adapter user’s guide 74 • argdx is a pointer to a caller-declared structure that will contain the direct entry points into the driver. See the structure direct_calls in the file ni_msg.C in the supplied example host application for usage. • argcx is the size of the structure. Function code 2...

  • Page 75

    Slta-10 adapter user’s guide 75 0x0004 forces direct modem mode. In this mode, the network driver is communicating directly with the modem. 0x0010 enables the buffered link protocol and disables the alert/ack link protocol - same as the /n option. 0x0020 enables the reliable transport protocol. The ...

  • Page 76

    Slta-10 adapter user’s guide 76.

  • Page 77

    Slta-10 adapter user’s guide 77 chapter 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 connected to an slta-10 adapter in mip mode. This chapter also includes a description of the network interface protocol for the slta-...

  • Page 78

    Slta-10 adapter user’s guide 78 purpose of the network driver the network driver provides a hardware-independent interface between the host application and the network interface. By using network drivers with consistent calling conventions, host applications can be transparently moved between differ...

  • Page 79

    Slta-10 adapter user’s guide 79 host application lonmanager api host application application layer interface driver services: open/close/ioctl/read/write output buffers downlink flow control buffer request protocol input buffers uplink flow control xon/xoff protocol interface link protocol (alert/ac...

  • Page 80

    Slta-10 adapter user’s guide 80 the unix network driver includes a ldv_post_events() function that should be called periodically from the client application in order to assure that the slta-10 adapter traffic is being processed. The dos network driver serial i/o functions are implemented by msd_sio....

  • Page 81

    Slta-10 adapter user’s guide 81 network interface protocol the network driver implements the host side of the network interface protocol, providing an easy- to-use and interface-independent read/write interface to the host application. The network interface protocol is a layered protocol that includ...

  • Page 82

    Slta-10 adapter user’s guide 82 alert (01) length not_length network interface [ data ] checksum alert ack (fe) command sender receiver link-layer header figure 31 slta-10 adapter alert/ack link protocol the link-layer header contains a length byte followed by a one’s complement of the length byte. ...

  • Page 83

    Slta-10 adapter user’s guide 83 buffered link protocol the dos network driver uses the buffered link protocol when the /n option is specified. See chapter 8 for a description of this option. The unix network driver uses the buffered link protocol if the alert_ack_prtcl variable is set to false in th...

  • Page 84

    Slta-10 adapter user’s guide 84 the buffered link protocol should not be used when the slta-10 adapter is attached to a modem. The buffered link protocol can only be used on multitasking operating systems such as unix if the host application executes often enough to empty any incoming buffers. For e...

  • Page 85

    Slta-10 adapter user’s guide 85 sequence number length alert (01) not_length network interface command [data] checksum ack (or nack) link-layer header sender receiver ack: 0x06, nack: 0x15 alert ack (fe)* *only transmitted with alert/ack link protocol figure 33 slta-10 adapter reliable transport pro...

  • Page 86

    Slta-10 adapter user’s guide 86 uplink message life the uplink message life is the maximum allowable period between the slta-10 adapter sending an alert byte to the host and the host responding with an alert ack byte. This period is 100ms in local host mode and 1 second in remote host mode. When thi...

  • Page 87

    Slta-10 adapter user’s guide 87 management messages addressed to other nodes). For these two commands, a buffer request protocol is used to ensure that the slta-10 adapter has a free application buffer for the data. The network driver must first request an output buffer before sending the interface ...

  • Page 88

    Slta-10 adapter user’s guide 88 other network interface commands sent downlink will be ignored, and will return the slta-10 adapter to the normal state. 5 upon receiving the niack acknowledgment, the network driver transfers the entire interface buffer to the slta-10 adapter. This buffer has the sam...

  • Page 89

    Slta-10 adapter user’s guide 89 presentation layer protocol the network driver exchanges lontalk packets with the host application at the presentation layer. The lontalk packet enclosed in a command of type nicomm or ninetmgmt is described in detail in the host application programmer's guide. It is ...

  • Page 90

    Slta-10 adapter user’s guide 90

  • Page 91

    Slta-10 adapter user’s guide 91 chapter 10 initialization and installation this chapter describes initializing, communicating with, and installing the slta-10 adapter as a network node..

  • Page 92

    Slta-10 adapter user’s guide 92 initializing an slta-10 adapter after an slta-10 adapter and its host processor are powered, the host application must initialize the slta-10 adapter. When an slta-10 adapter is initially powered-up or reset, it disables network communications by entering the flush , ...

  • Page 93

    Slta-10 adapter user’s guide 93 canceled by sending the niflush_cancel message. The flush state can also be disabled by a configuration switch on the slta-10 adapter as described earlier in this chapter. 3 install the network interface in one or two domains using the update domain network management...

  • Page 94

    Slta-10 adapter user’s guide 94 when creating a hardware properties definition for a custom node to represent the slta-10 adapter node, set the input clock rate to 10mhz. Then create a hardware definition for the custom node specifying these hardware properties. The slta-10 adapter will not accept a...

  • Page 95

    Slta-10 adapter user’s guide 95 chapter 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 connected via a pair of modems to the slta-10 adapter. In this set-up, any node on the network may request the slta-10 adapter ...

  • Page 96

    Slta-10 adapter user’s guide 96 overview the slta-10 adapter network interface may be attached to the host processor using modems and the switched telephone network. Figure 37 illustrates this option. Host application lns software (optional) host network driver driver interface eia-232 interface slt...

  • Page 97

    Slta-10 adapter user’s guide 97 in nsi mode, the slta-10 adapter can be configured to initiate the connection with the host pc when lns network management messages and/or network variable updates are addressed to the slta-10 adapter. Alternatively, another node on the local network can command the s...

  • Page 98

    Slta-10 adapter user’s guide 98 command set assumptions the slta-10 adapter uses the following strings received from the modem to interpret the connection state. These strings are consistent with all hayes at compatible modems operating in the word response mode (alphabetic responses). [cr] is the h...

  • Page 99

    Slta-10 adapter user’s guide 99 network management messages network management messages are used to configure the operation of the network, as opposed to delivering application data during operation of the network. All l on w orks nodes respond to the standard network management messages as describe...

  • Page 100

    Slta-10 adapter user’s guide 100 request/response service, and the message code for modem control messages is always 7d hex. The data portion of the message always begins with a sub-code value of 1, indicating that the message is addressed to an slta-10 adapter, followed by an application command by...

  • Page 101

    Slta-10 adapter user’s guide 101 when (msg_fails(slta_tag)) { // slta-10 adapter did not respond to the message ... } when (msg_succeeds) { ... } when (resp_arrives(slta_tag) { // slta-10 adapter did respond to the message if (resp_in.Code == 0x3d) // command executed successfully ... Certain slta-1...

  • Page 102

    Slta-10 adapter user’s guide 102 an 8-byte dial-in password string. Eeprom storage and allocation for these strings is managed by the mip mode eeprom pool. This allows flexible utilization of the slta-10 adapter’s mip mode eeprom space. The mip mode pool consists of 21 blocks, each with 9 bytes of d...

  • Page 103

    Slta-10 adapter user’s guide 103 this message may be used to check the type of interface product that the node is running. The value returned for the slta-10 adapter is a '1'. Application nodes will respond with a failed code of 0x1d returned for this or any message where the request message code is...

  • Page 104

    Slta-10 adapter user’s guide 104 from idle to call_in_process , unless the connection is already made, in which case the state stays at connected . The dial-out prefix is sent first. 2 same as '1', but disconnect (hang-up) if currently connected before initiating the new connection. Modem response q...

  • Page 105

    Slta-10 adapter user’s guide 105 in the slta-10 mip mode eeprom pool. The entries are numbered 0 to 4 (or 0 to 7) as specified by the dir_num field. Typedef struct { byte sub_code; // always #1 byte app_command; // value = 6 byte dir_num; // value = 0-7 for mip; 0-4 for nsi byte total_size; // of th...

  • Page 106

    Slta-10 adapter user’s guide 106 will send the hangup string (see below) if it is not a null string. This will terminate the connection, and the slta-10 adapter enters the idle state. The response will not be sent until this process is complete. Therefore the transaction timer for this message shoul...

  • Page 107

    Slta-10 adapter user’s guide 107 configuration string to the modem. This string is stored in eeprom, and may be changed by this message. The default setting for this string is " ate0&c1&d2s0=1! ". The commands specified in this string are: • e0 is the at command to disable local echo of characters r...

  • Page 108

    Slta-10 adapter user’s guide 108 install dial prefix the default setting for this string is " atdt ". This string is sent as a prefix for any dial-out operations. This particular sequence instructs the modem to dial using touch-tone (dtmf) signaling. If pulse dialing is required, the prefix should b...

  • Page 109

    Slta-10 adapter user’s guide 109 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 a design where there may be more than one network node that wishes to control the slta-10 adapter's connection states, request/release ...

  • Page 110

    Slta-10 adapter user’s guide 110 install nsiconnect (nsi mode only) this message writes the nsiconnect byte. A value of 0xff (the default) will disable this feature. When this feature is enabled, the slta-10 adapter initiates a dial-out when it receives an addmynsi message. Typedef struct { byte sub...

  • Page 111

    Slta-10 adapter user’s guide 111 modem compatibility the slta-10 adapter has been tested with the following modems: best data smart one external modem 33,600 bps data/fax modem diamond supraexpress 336e external faxmodem hayes accura 336 external fax modem us robotics sportster voice external 28.8 f...

  • Page 112

    Slta-10 adapter user’s guide 112.

  • Page 113

    Slta-10 adapter user’s guide 113 chapter 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 dial out and make a connection to a remote slta-10 adapter in mip mode. This utility may be used prior to executing an applic...

  • Page 115

    Slta-10 adapter user’s guide 115 escaped with a leading backslash, “ \! ” or “ \~ ”. Hcu does not send implied carriage returns at the end of each string. Spaces may be included in the string arguments. If you are including space in an argument you must enclose the string in double quotes or else th...

  • Page 116

    Slta-10 adapter user’s guide 116 if operating under microsoft windows 3.1x, dialing out to a remote slta-10 adapter requires running the dos program hcu.Exe in a session prior to running the windows api application. The hcu source code is available from echelon for integration into a dos application...

  • Page 117

    Slta-10 adapter user’s guide 117 • send modem responses: enabled (" q0 "). This causes the modem to respond to commands sent to it with a result code. • word responses (" v1 "). The modem result codes will be expressed as full word codes (alphabetical) rather than as numerical codes. • full response...

  • Page 118

    Slta-10 adapter user’s guide 118 table 17 hcu progress strings devname: no such file or directory or not ready reading device devname indicates that hcu could not open the device devname. Dialing or hanging up indicates the hcu operation. Device initialization error, devname indicates a problem with...

  • Page 119

    Slta-10 adapter user’s guide 119 chapter 13 modem troubleshooting this chapter provides solutions to problems that may arise with a modem attached to an slta-10 adapter..

  • Page 120

    Slta-10 adapter user’s guide 120 troubleshooting a modem link a host/modem - modem/slta-10 adapter configuration has many user-selected options including the choice of modems, configuration of the modems, the operating system of the host, the network interface link protocol, and the serial bit rates...

  • Page 121

    Slta-10 adapter user’s guide 121 • use with microsoft windows 3.1x, particularly at higher serial bit rates (9600 or greater). This is always a problematic case. The priority of the serial i/o interrupts for pc/ats is always lower than the dos tick interrupt, which is used by windows to perform many...

  • Page 122

    Slta-10 adapter user’s guide 122.

  • Page 123

    Slta-10 adapter user’s guide 123 appendix a this appendix describes the function and use of the l on w orks dll interface software provided with echelon's connectivity starter kit. Microsoft windows 3.1x supports access to dos drivers through an interface layer called dos protected mode interface (d...

  • Page 124

    Slta-10 adapter user’s guide 124 ldv_close purpose terminates access to the network interface hardware. Syntax #include short ldv_close(short handle); see also ldv_open() returns ldv_ok (0) device closed successfully. Ldv_not_open (3) invalid handle or device not open. Parameters handle short device...

  • Page 125

    Slta-10 adapter user’s guide 125 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]" where m is the major release number, mm is the minor release number, and [.Sss] is an option sub-release number. All numbers are decim...

  • Page 126

    Slta-10 adapter user’s guide 126 ldv_open purpose initializes the network interface hardware for access by a windows application. A windows application can open multiple network interfaces. In the case of dos drivers, this is done by loading multiple drivers in config.Sys . Initialization required t...

  • Page 127

    Slta-10 adapter user’s guide 127 ldv_read purpose retrieves an available message from the network interface hardware. The function returns immediately when no messages are available. An error is returned when the next available message is longer than the specified buffer length. Syntax #include shor...

  • Page 128

    Slta-10 adapter user’s guide 128 ldv_write purpose delivers a message to the network interface hardware. Syntax #include short ldv_write(short handle, void far *msg_p, short len); see also ldv_read() returns ldv_ok (0) message written successfully. Ldv_not_open (3) invalid handle or device not open....