Easylon Serial Socket Interface User Manual
Contents
1. Permanently OFF Installation ok Normal operation Table 3 1 Service LED DIP Switch An on board DIP switch serves to change between operating and programming mode The programming mode allows to update the device firmware l boards are delivered anconfigured aoe Gesytec 2 1022 LPS2 UserDoc LPS2 Manual EN 2 1 docx Ps Socket Interface Manual Technical Description Attention During normal operation the switch must be in operation mode Otherwise the module may restart due to handshake signals DIP switch in DIP switch in programming mode operating mode 3 4 Serial Interface The serial interface is just using TXD and RXD lines The additionally men tioned hardware handshake lines RTS and DTR cf Figure 3 1 are used for on board programming of the host CPU The baud rate is fixed to 115 200 baud There is no autobaud feature implement ed To operate the module at a different baud rate please ask Gesytec for devices with the corresponding firmware 3 5 Power Supply The serial communication between the Easylon Socket Interface and the PC is running on TTL level Therefore the following requirements with respect to the power supply have to be met e Socket interface and serial device must use the same source of voltage e Both devices must be supplied simultaneously If not a latch up may oc cur on the interface or device using it inhibiting correct operation ath Gesytec z vm L2. 5 2 Connector Pin Assignments The Easylon Serial Socket Interface follows the Conexant Socket Modem pin layout using a part of the 64 connector pins PIN 1 position cf to board dimensions next page grey pin does not exist LON Serv key TTL input output LON LEDI Earth LED2 5V Reset TTL input GND DTR TTL input GND LON RX LED LON TX LED CTS TTL output TxD TTL output RxD TTL input RTS TTL input Figure 5 1 Connector pin assignment 5 V version PA Gesytec 2 2m LPS2 UserDoc LPS2 Manual EN 2 1 docx m Socket Interface Index 6 List of Figures Figure 1 1 Easylon Serial Socket nfetLae8 iui o re rn6 oret rra ia fes ei line tu uias deld 6 Figure 3 1 Connector pin assignment 3 3 V version ous esecti tern itti qon eb ie dis deer inad 12 Figure 3 2 Dimensions and connector pins oio iere reete ped ee ose nio Eten apu EI RU des 13 Figure 5 2 Connector pin assignment 5 V version sssssseseeeeeeeneeneee eene 21 List of Tables Table 3 1 Service LED oae retro ce e bue eere s 10 Table 4 1 Xif files and interface card variants eeesseeeeeeseeeeeeee eene nnne 14 8 Index 5 V version 20 network interface API 8 baud rate 11 pin assignment 12 21 configured 8 programming instructions 14 connector 6 8 12 21 serial gateway 7 dimensions 13 serial interface 11 DIP Switch 10 service LED 10 driver 8 technical specification 13 20 EasyCheck 9 unconfigured 8 Li
3. User Manual This manual applies to the LPS2 board Gesytec GmbH Pascalstr 6 52076 Aachen Germany Tel 49 24 08 9 44 0 Fax 49 24 08 94 4 100 email info gesytec de WWW gesytec com Dok ID LPS2 UserDoc LPS2 Manual EN 2 1 docx Version v2 1 July 4 2014 eph Gesytec 2 LPS2 UserDoc LPS2_Manual EN 2 1 docx mn Socket Interface User Manual This manual provides you with all the information which you will need to use the Easylon Serial Socket Interface However this manual will neither explain aspects of Echelon s LONWoRKS technology nor Echelon s Microprocessor Interface Program MIP used on this network interface card The network interface has been designed in accordance with the driver specifications of the Echelon Corpo ration After a general presentation of the Easylon Interface card in Chapter 1 Chapter 2 describes the necessary steps to install it Chapter 3 contains the technical description Chapter 4 Programming Instructions contains some information which will be helpful if you should wish to develop your own network driver for the card References e WLDV32 Programming API for LonWorks Access Gesytec e LPS Protocol Description Gesytec e 078 0016 01B Host Application Programmers Guide Echelon Corp This documentation is subject to changes without notice Gesytec assumes no responsibility or lia bility for any errors or inaccuracies that may appear in this d
4. mm 26 5 mm 945 78 75 2mm operating 40 85 C storage 40 85 C class F accord DIN 40040 no condensation 64 5 x 26 5 mm 8 4 mm 3 OoooooooQ 1 1000 inch 2441 62 mm 64 5 mm Figure 3 2 LPS2 UserDoc LPS2_Manual EN 2 1 docx PA Gesytec 4 Dimensions and connector pins 13 22 LPS2 UserDoc LPS2_Manual EN 2 1 docx m Socket Interface Manual 4 Programming Instructions Programming Instructions This chapter gives programming instructions to the Easylon Serial Socket Inter face 4 1 LONWORKS Network Node The Easylon Serial Socket Interface card is a network node in the LONWORKS network It is operated under Echelon s Microprocessor Interface Program MIP firmware using the FT 5000 NEURON Chip as communication processor The ap propriate external interface file xif is on the Drivers amp Documentation disk Which xif file is describing which interface card variant is explained the table below Network Interface Transmission rate XIF file TP FT 78 125 kbps P P109x6 xif Table 4 1 xif files and interface card variants 4 2 Device Status Applications have to take care of the status of the Easylon Serial Socket Interface card As an example some parts of code are shown below The structures used are taken from the so called HOST APPLICATION of the Echelon Corp This a
5. the interface to the LonWorks network A host CPU with 8051 kernel is used as protocol and application processor Service button and LED are available via the connector and have to be implemented on the carrier board Signals for LonWorks receive and transmit LEDs are as well available through the connector Two more LEDs are operated by the CPU A sample de sign for a carrier board is available on the Drivers amp Documentation CD deliv ered with the interface Firmware can be downloaded via the serial connection PA Gesytec 22 LPS2 UserDoc LPS2 Manual EN 2 1 docx m Socket Interface Manual Product Information NOTE An Evaluation Kit available to the Easylon Serial Socket Interface allows easy access to connections and signals of the board As an OEM module a certain flexibility with respect to customer specific re quirements is observed e g with respect to the connector types or positions or the form The actual module delivered may therefore be different from the de scription in this documentation which applies to the standard variant Firmware variants Depending on the firmware of the module there are two basically different usag es The Easylon Serial Socket Interface can be used as a serial LonTalk adap ter In Windows and Windows CE systems it is accessed through the WLDV32 DLL A Linux driver is available nasecond application variant the interface module operates as a serial gateway A host applicatio
6. to compile the driver De pending on the distribution this will require the kernel development package to be installed Driver installation requires administrator rights The following commands will compile the driver and the slta attach program make make tools The commands make install make setup will copy the driver and the slta attach program into the system Registering the Module Alias To connect the line discipline used with the correct driver the following line has to be added to the configuration file etc modprobe conf or etc modprobe conf local alias tty ldisc 8 slta This connects index 8 of the serial line discipline to the slta driver module An additional line passes the stated option to the driver at loading time options slta slta debug 1 Init Script The driver has to be loaded and the program slta attach started at system start to activate the slta driver In most Linux distributions this is done by means of a SysV Initscript An example initscript suse for SuSE Linux is provided Copy this script into the SysV Init directory cp initscript suse etc init d slta To activate the slta driver then use the Yast Runlevels editor to make sure that the init script is automatically started at system start There are other setup tools for other distributions Please refer to the system documentation Alternatively the script can be started manually to start the driver etc init d slta start PA Gesytec 2 1
7. 722 LPS2 UserDoc LPS2 Manual EN 2 1 docx P Socket Interface Manual 4 3 2 4 4 3 2 5 Programming Instructions Using the slta Driver The init script has to contain the device files of the serial ports to which sltas are connected This means that the following line of the init script has to be adapted DAEMON PORTS dev ttyS0O dev ttyS1 Furthermore the init script starts device files with following names dev lonl dev lon2 usw The increasing index of these device files follows the enumeration sequence of the serial ports in the DAEMON PORTIS variable Device Files and Access Authorization Serial device are identified by entries in the dev directory Unfortunately there is no naming convention and different naming s exist in different distributions Mostly dev ttySO refers to the first serial port corresponding to COMI in DOS With the device file system devfs the name dev tts 0 was introduced The current development allows a flexible naming But not all distributions go for a standardized naming environment However in most cases dev ttySO is used for COMI also with SuSE 10 x and Fedora Core 3 and later A serial USB port usually is named dev ttyUSBn or dev usb tts 0 respectively if devfs is used Using the slta driver requires the corresponding access authorization to the serial port for the user account Depending on Linux or kernel version different ap proaches can be followed Depending on Dis
8. ACS sssini i eaea EEE EEE EAEE E EEAS 11 3 5 POWEL SUPP Yoeri a a E E O ee eee ee 11 3 6 Connector Pin Assignments i asnnsiccntesesiussaiwsteisanu vsdsoi h sstacnededecmsutdnvecisniodsenenisswones 12 3 7 Technical Specifications osos pr nr D eu eH S eH RR Pen emn ea dex isarisssii rdest ar ni 13 4 Programming Instructions ss s ccssenssesssecesonsssscsnsssunscsessunsdossvoncsouss sndssbessnacsnnasssdusssonstousseedsos 14 4 1 LONWORKS Network Node yisah casei carroeniuceinedrasunnuilSesoiaeuascinnteatnalesseniaeasouvedse 14 4 2 Devic SUAS iss cidarespveansecntuaacesicenasasamncarnprnentpesseunnenndansis EEEE EEr Er aasa 14 4 3 Tom Dri VET ansieae cdenietnadaaientscavnsc ouaanetebpanucetiedanuatsdisewatesanseenetaensatoctancate 16 43 1 Implementation s senis 16 CUM Senal Eime DISCIPhiie s serce eter T T T T 16 4 3 1 2 Reliable Transport Protocol asacassccsszsnscedaconstedsacalwdaaoutdddensveusdncervdesstvenssacmesinntacsvh 17 43 2 AST AN AM Oi ooi tierno uU a E R EEEE E 17 4 3 2 1 Source Code Compilation for Driver and Utilities sess 17 4 3 2 2 Registering the Module Alias nsnneseneeeeeeeeeesseesseeesesrsesessseesstessersseeeseeesssressresse 17 43 23 Imt cun PEE 17 4 3 2 4 Using the slta Driver otic saxcaswssessntossiteecpiaateaaneaeuaeateanearuimnelsaae 18 4 3 2 5 Device Files and Access Authorization essere 18 4 4 Windows CE Application Inter
9. PS2 UserDoc LPS2 Manual EN 2 1 docx P Socket Interface Manual Technical Description 3 6 Connector Pin Assignments The Easylon Serial Socket Interface follows the Conexant Socket Modem pin layout using a part of the 64 connector pins PIN 1 position cf to board dimensions next page grey pin does not exist LON Serv key TTL input output LON LEDI Earth LED2 3 3 V Reset TTL input GND DTR TTL input GND LON RX LED LON TX LED CTS TTL output TxD TTL input RxD TTL output RTS TTL input Figure3 1 Connector pin assignment 3 3 V version PA Gesytec 2 1222 P Socket Interface Manual 3 7 Network Interface CPU Transceiver Connector Service LED Service push button RX TX LEDs Isolation Compatibility Serial Interface CPU Memory Type Connector Transmission Power supply Voltage Power consumption Technical Description Technical Specifications Neuron FT 5000 80 MHz FT X2 pin connector on board or via Conexant connector via Conexant connector via Conexant connector 1000 Vims 60 s LonTalk ISO TEC 14908 AT89C51RE2 18 432 MHz Flash 64 Kbytes RAM 8 Kbytes TTL Conexant standard RxD TxD RTS CTS pin connector 115 2 kBd others on request 230 4 kBd max 3 3 V DC 5 externally from Conexant socket 70 mA typ 95 mA max Dimensions amp Environmental Characteristics Temperature Humidity Dimension max height above board 24
10. an be found the in the etc udev rules d directory usually called 50 udev rules Note You can see if udev is used by the existence of a etc udev directory The line KERNEL ttyS GROUP uucp MODE 0660 defines that all device files for serial ports belong to the user root and the group uucp The user root and all uucp members have read write authoriza tion all other users are denied the port access To grant authorization to all users the rights have to be set to MODE 0666 4 4 Windows CE Application Interface For usage with Windows CE there is a Windows CE version of the WLDV32 DLL which can be found on the Drivers amp Documentation CD ROM Vn Gesytec 4 1922 LPS2 UserDoc LPS2_Manual EN 2 1 docx m Socket Interface Manual 5 Volt Version 5 5 1 5 Volt Version In order to allow users of previous versions of the Easylon Serial Socket Interface a smooth change to an improved hardware there is a version of the module run ning with 5 V supply and using the old pin out This chapter lists the points in which the 5 V version differs from the 3 3 V module described above Differing Technical Specification Only information different from that for the 3 3 V version is listed here Voltage 5 V DC 5 externally from Conexant socket Power consumption 85 mA typ 110 mA max Vn Gesytec 4 LPS2 UserDoc LPS2 Manual EN 2 1 docx P Socket Interface Manual 5 Volt Version
11. ce named Slta The driver interface is identical to that of all other Easylon Interfaces Implementation Serial Line Discipline Using the serial line discipline concept this Linux driver provides a flexible method to realize different protocols for serial transmission The following ad vantages result for the slta driver Maximum compatibility with different kernel versions as only an intermedi ate layer of the serial port has to be implemented This means a minimum of dependencies from kernel specific functions Independence from the serial hardware used The driver can be used with every tty interface In order to make the driver compatible to all systems the ID of a line discipline already known to the Linux kernel was used Usage of a new ID would have re quired a kernel modification Therefore the ID N MASC of a Mobitex Moduls is used which is reserved but not used Note The ID of the Line Discipline are defined in usr include asm termios h ah Gesytec 4 1622 LPS2 UserDoc LPS2 Manual EN 2 1 docx m Socket Interface Manual 4 3 1 2 4 3 2 4 3 2 1 4 3 2 2 4 3 2 3 Programming Instructions Reliable Transport Protocol The driver is based on Echelon s Solaris driver This driver is using a receive and transmit state machine supporting reliable transport protocol Installation Source Code Compilation for Driver and Utilities The kernel source code has to be installed in order
12. ceDrivers COM1 115200 device name LPS 1 115200 The EasyCheck utility opens the interface For a hardware communication test it will send a query status message to the local unit PA Gesytec 2 T LPS2 UserDoc LPS2 Manual EN 2 1 docx m Socket Interface Manual Technical Description 3 3 1 3 2 Co V Technical Description Network Interface The Easylon Serial Socket Interface card is based on a FT 5000 NEURON Chip Under MIP firmware the NEURON Chip is operated with up to 29070 byte RAM for network and application buffers It is connected to an embedded host CPU in slave b mode The host CPU implements the serial protocol for communication with an external host On board there is a service LED for the NEURON Chip A service push button can be realized by connecting a push button to the dedicated pins of the module Fur ther the LonWorks receive and transmit signals are available Additionally two status LEDs can be connected to the module Service LED The service LED signal is available on board and via the socket connector It sig nals the card status Additional to the service LED signals defined by Echelon the following status signals are used Service LED Status Remarks Flash 1 Hz No firmware installed or firmware failure Blink 1 2 Hz Driver installed Configure the node node is unconfigured Permanently ON _ Node is applicationless and un configured
13. erface card into an available Conexant socket The serial communication with the module has to be set to 115200 baud Firmware for different baud rates is available on request e Connect the interface card with an appropriate cable to the LONWORKS net work Network Interface API For usage with Windows and Windows CE there is no special driver for the Easylon Serial Socket Interface Gesytec s WLDV32 DLL is prepared to inter face to the Easylon Serial Socket Interface Please refer to the manual of the WLDV32 DLL To install it start setup exe in the respective directory of the Drivers amp Docu mentation CD Optionally source code of a Linux driver is as well available for the device ah Gesytec 4 s22 LPS2 UserDoc LPS2_Manual EN 2 1 docx P Socket Interface Manual Installation 2 2 1 EasyCheck Separately on the driver CD there is a setup for the utility EasyCheck which can be used to perform basic tests and settings with any Gesytec LonWorks inter face For usage of the Easylon Serial Socket Interface there have to be made some registry settings There is a REG file named LPS 1 115200 reg on the Drivers amp Documentation CD Driver WLDV32 which has to be imported into the registry Afterwards the Serial Socket Interface will be available as COMI 115200 for EasyCheck The REG file contains following settings Windows Registry Editor Version 5 00 HKEY LOCAL MACHINE SOFTWARE LonWorks Devi
14. face aio sica tepido ipa ettet eeepc es 19 5 VOLE V CL SUOM MT M 20 5 1 Differing Technical Specification tenete tret rh tapar terna sa tee euro sG2s 20 5 2 Connector Pin Assignments P 21 LES PC end ib a P E A A E A E 22 JE T MIU c sosio st 22 BR OR E 22 ah Gesytec 4 s22 LPS2 UserDoc LPS2 Manual EN 2 1 docx EF Socket Interface Manual Product Information 1 1 1 2 Product Information This manual describes the Easylon Serial Socket Interface with 3 3 V supply In formation on the 5 V version is given in chapter 5 Figure 1 1 Easylon Serial Socket Interface Scope of Delivery PC plug in card with Echelon s MIP P20 firmware Installation and Documentation CD including o WLDV32 DLL for Windows and Windows CE a driver for Linux is available on request o Easylon RNI software for remote access to LonWorks EasyCheck diagnosis software for Easylon Interfaces o Sample design for a carrier board Gerber and Step files O Overview The Easylon Serial Socket Interface realizes a LON serial connection as a socket module to be integrated into OEM devices The serial connection to the CPU board is made by a connection designed according the Conexant Socket Modem standard Power supply uses this connector as well The module is operated at 3 3 V An FT5000 NEURON Chip together with an FT X2 transceiver realize
15. n running on the module allows implementa tion of network variables even more than the usual 62 Thus more data points than in simply Neuron based solutions can be used The module s processor with large integrated memory enables implementation even of complex protocol Additionally the module can be used for OEM applications Either Gesytec or the customer can implement a dedicated application for the module This documentation describes just the functionality as standard LonWorks inter face Gesytec 2 m LPS2 UserDoc LPS2 Manual EN 2 1 docx m Socket Interface Manual Installation 2 2 1 2 2 Installation The Easylon Interface cards are delivered in status unconfigured Prior to using it as a LONWORKS network interface it has to be set configured Standard ap plications available from the market such as network management tools auto matically set this status or offer an appropriate command For customer specific applications which shall use this Easylon Interface the sta tus setting has to be taken care of Chapter 4 gives further hints on this subject The external interface files xif can be found in the XIF directory of the installa tion CD Insertion of the Card When inserting the Easylon Serial Socket Interface card in your computer please be sure to observe all the computer manufacturer s instructions regarding the in sertion of additional interface cards e Insert the Easylon Serial Socket Int
16. nux 8 16 Windows CE 19 MIP 10 WLDV32 DLL 8 19 network interface 10 xif file 8 14 Gesytec 2
17. ocument Gesytec shall have no liability or responsibility to the original purchaser or any other person or entity with respect to any claim loss liability or damage caused or alleged to be caused directly or indirectly by any Gesytec product or the accompanying documentation Easylon is registered trademark of Gesytec GmbH Echelon LON LONWORKS and NEURON are registered trademarks of Echelon Corporation Win dows is a registered trademark of Microsoft Other names may be trademarks of their respective companies This Easylon Interface incorporates the MIP program from the Echelon Corporation The aforesaid company holds all rights relating to this software Gesytec 2 LPS2 UserDoc LPS2 Manual EN 2 1 docx mn Socket Interface User Manual Contents I Product UFO PATIO uc cesse ceieitti oc bna ki dean b o pPe e edt tae gU CHEN hr FREE CIN HER LUA EL RE RERTEKME CON K ME SERE DAR EUAS 6 1 1 BOOMS of Edita EET 6 1 2 OVENI E Weres iaee a CT E 6 2 CIC Tr 8 2 1 Insertion of th Card adici ber dixisti Unc Deu ia bar De bMca ci da Kuss s add mde 8 2 2 Network Interface JP scusa beata altus pas un tum spe bc duce icd poda lu Dua NEC andes 8 22A IS RS TC ct c 9 3 Technical oui e 10 3 1 Network Inlet JePucedsipe md oup i R aR E ESS 10 3 2 Seftvice LED N 10 3 3 RI WAN NER E T E RU RIEN TETEA 10 3 4 Se al MMS
18. pplication is available from the Echelon web site www echelon com pragma pack 1 define NM update domain 0x63 define NM set node mod 0x6C define SVC request 0x60 fdefine niRESPONSE 0x16 define niLOCAL 0x22 define niRESET 0x50 define LDV OK 0 typedef struct BYTE cmq cmd 7 4 queue 3 0 BYTE len BYTE svc tag O 7 Service 6 5 auth 4 tag 3 0 BYTE flags prio path cplcode 5 4 expl altp pool resp BYTE data_len Gesytec 2 1022 P Socket Interface Manual Programming Instructions BYTE format rcv domain 7 flex 6 union struct BYTE dom node domain 7 node memb 6 0 BYTE rpt retry rpt _ timer 7 4 retry 3 0 BYTE tx timer tx timer 3 0 BYTE dnet grp destination subnet or group BYTE nid 6 NEURON ID send struct BYTE snet source subnet BYTE snode source node BYTE dnet grp destination subnet or group BYTE dnode nid 7 destination node or NEURON ID rcv struct BYTE snet source subnet BYTE snode source node BYTE dnet destination subnet BYTE dnode destination node BYTE group BYTE member BYTE reserved 4 resp adr BYTE code message code or selector MSB BYTE data 239 ExpAppBuf ExpAppBuf msg out Explicit message b
19. tribution a SuSE 10 x SuSE 9 x Fedora Core The serial port can be used by all members of the uucp group Just add the user account under which the application program shall run to this group Depending on System and Kernel Configuration a Using static device files In a static dev directory read write authorization for a serial port can be as signed to all users with the file system rights using the command chmod 0666 dev ttySO ah Gesytec 4 1022 LPS2 UserDoc LPS2_Manual EN 2 1 docx m Socket Interface Manual Programming Instructions b c Using devfs If the device file are dynamically started by devfs at system start access au thorization has to be defined in the configuration file etc devfsd conf Note You can see if devfs is used by the existence of the file dev devfsd The line REGISTER tts PERMISSIONS root dip 0660 defines that all device files for serial ports belong to the user root and the group dip The user root and all dip members have read write authorization all other users are denied the port access To grant authorization to all users the rights have to be set to 0666 Alternatively authorization can be granted to all members of the group us ers This requires the definition root users Using udev From kernel version 2 6 13 onward devfs can not be used any more The us erspace program udev is used instead The corresponding configuration file c
20. uffer for outgoing messages ExpAppBuf msg in Explicit message buffer for incoming messages ExpAppBuf msg rsp Explicit message buffer for response messages int ni handle BYTE my domain 15 0 0 0 0 0 0 0x01 OxCO 0 OxFF OxFF OxFF OxFF OxFF OxFF int send local int len int ldv err msg out cmq niLOCAL msg out svc tag SVC request Z msg out flags 8 msg out len len 15 is msg out data len len 1 m if ldv write amp msg out len 17 return 0 D E while 1 S ldv err ldv read amp msg in 256 N if ldv err LDV OK if msg in cmq niRESET return 0 Local reset E if msg in cmq niRESPONSE 5 memcpy amp msg_rsp amp msg in msg in len 2 E return 1 Ok N A PA Gesytec 2 1522 LPS2 UserDoc LPS2 Manual EN 2 1 docx Fn Socket Interface Manual Programming Instructions return 0 int set config online msg out code NM update domain msg out data 0 0 Domain index 0 memcpy amp msg out data 1 amp my domain 15 Subnet 1 Node 64 if send local 16 return 0 msg out code NM set node mode msg out data 0 3 Change state msg out data 1 4 Configured online if send local 2 return 0 return 1 Success 4 3 Linux Driver 4 3 1 4 3 1 1 There is a Linux driver available in source code It implements a devi
Download Pdf Manuals
Related Search