LPS User Manual
Contents
1. msg out Lens len 15 msg out data Lens len 1 if ldv write amp msg out len 17 return 0 while 1 ldv_err ldv read amp msg in 256 if ldv err LDV OK if msg in cmq niRESET return 0 Local reset if msg in cmq niRESPONSE memcpy amp msg_r return 1 a Gesytec 2 msg in len 2 Ok Sp amp msg in 13 18 E V1 3 May 2009 LPS LPS Manual E 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 There is a Linux driver available in source code It implements a device named sita The driver has an interface identical to all other Gesytec Linux drivers 4 3 1 Implementation 4 3 1 1 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 implemented2. sion of the driver For a hardware communication test it will then send a query status message to the local unit read memory command EasyCheck will show if the device is running MIP firmware A correctly installed Easylon Inter face card will send an appropriate response Finally EasyCheck will close the in terface a Gesytec Z zne y 2009 LPS LPS Manual E V1 3 Ma E Socket Interface User Manual Technical Description 3 3 1 3 2 Technical Description Network Interface The Easylon Serial Socket Interface cards is based on a NEURON 3120 Chip Under MIP P20 firmware the NEURON Chip is operated with up to 1096 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 commu nication 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 Ad ditionally 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 Per
3. Gesytec assumes no responsibility or liability for any errors or inaccuracies that may appear in this document 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 P20 program from the Echelon Corporation The aforesaid company holds all rights relating to this software Gesytec 2 T y 2009 LPS LPS Manual E V1 3 Ma EH Socket Interface User Manual Contents Contents 1 Produel E E 4 1 1 Scope of Delivery e TRE Mc E 4 1 2 OVENI EW e cA 4 2 Tc T ias 6 2 1 ISCH On of th Card aes octo Vd eui o sce Obi Vtde lega bere au began 6 2 2 N twork Interface APT iR Yr 6 211 1g E EE 7 3 Technical Description rss een ee 8 3 1 Network Ee 8 3 2 Bt ER seen 8 3 3 Seral Interface essien iirinn E EE EAE EEEE EAEE a 9 3 4 Power E 9 3 5 Connector Pin EIERE 10 3 6 Technical Specifications ee Eege 11 4 Programming Instr ul Chis ceo occseccexa eeu she uE bake rbn ek HE CENEE C V0 U
4. 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 a Gesytec Z2 uns E V1 3 May 2009 LPS LPS Manual E 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 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 t
5. 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 A FTT 10A transceiver option FTX smart transceiver with a NEURON Chip running the MIP P20 firmware connects to the LonWorks network Service but ton and LED are available via the connector and have to be implemented on the carrier board A sample design for a carrier board is available on the Drivers amp Documentation CD delivered with the interface Firmware can be downloaded via the serial connection 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 The 225 Gesytec Z ins E V1 3 May 2009 LPS LPS Manual Es Socket Interface User Manual Product Information actual module may therefore be different from the description in this documenta tion Depending on the firmware of the module there are two basically different us ages The Easylon Serial Socket Interface can be used as a serial LonTalk adapter In this application variant a serial protocol compatible to stan dard applications is implemented allowing for easy integration into exist ing applications nasecond application variant the interface module operates as a serial gateway A host application running on the module allows implementa tion of network variables even more t
6. 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 a Gesytec Z2 vn y 2009 LPS LPS Manual E V1 3 Ma EH Socket Interface Index s Figure 1 1 Figure 3 1 Figure 3 2 6 Table 3 1 Table 4 1 xiffile 6 12 baud rate 9 configured 6 connector 4 6 dimensions 11 List of Figures Easylon Serial Socket Interface ieu p len een Eo cu ee 4 Connector prn dssce TO E 10 Dimensions and E 11 List of Tables Service LED oslo secs ecclesia rine erem eiie 8 OT files and interface card Variants cc ceeeeceeeeececcecsecececssseecenseseeceaaeseecenaes 12 Index network interface API 6 pin assignment 10 programming instructions 12 10 serial gateway 5 serial interface 9 driver 6 service LED 8 EasyCheck 7 technical specification 11 Linux 6 14 unconfigured 6 MIP P20 8 Windows CE 17 network interface 8 WLDV32 DLL 6 17 a Gesytec Z2 e
7. 3 2 Dimensions and connector pins PN Gesytec Z 11 18 y 2009 LPS LPS Manual E V1 3 Ma E 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 P20 firmware using the NEURON 3120 Chip as communication processor The appropriate external interface file xif is on the installation disk Which xif file is describing which interface card variant is explained the table below Network Interface Transmission rate XIF file FTT 78 kbps lolp075f 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 Inter face 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 application 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 define niRESPONSE 0x16 define niLOCAL 0x22 define niRESET 0x50 define LDV_OK 0 typedef struct BYTE cmg cmd 7 4 queue 3 0 BYTE len BYTE svc_tag
8. E RIX AR FEX FO PE UA FEE TV CREE UR Seda denn 12 4 1 LONWORKS Network Node susanne 12 4 2 Device Stats NR T ET TE 12 4 3 LUX TV CE ac mmn 14 A34 Implementation asco datu at ag es shen ca eee Masa M Cava thee ee tieu beta 14 4 3 1 1 Serial Line Discipline es nen 14 4 3 1 2 Reliable Transport e E 15 4 32 E E UE le et Bias ER e ea ee hee idan ie es 15 4 3 2 1 Source Code Compilation for Driver and Unies 15 4 3 2 2 Registering the Module Alias ann To apa Fre vate Ie UE 15 81255 D SCR EE 15 4 3 24 Wisi CNR 16 4 3 2 5 Device Files and Access Authorization ccccccssseccccsssscecessseccesssseeeeceessnees 16 4 4 Windows CE Application Interface 17 List of diuidi e 18 List of Tables c 18 iiio E 18 a Gesytec Z2 sns y 2009 LPS LPS Manual E V1 3 Ma Es Socket Interface User Manual Product Information 1 Product Information This manual describes the Easylon Serial Socket Interface Cie nii apu Figure 1 1 Easylon Serial Socket Interface 1 1 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 This documentation o Sample design for a carrier board Protel DXP 1 2 Overview The Easylon Serial Socket Interface realizes a LON serial connection as a socket module to be integrated
9. Gesytec Gesellschaft f r Systemtechnik und Datenverarbeitung mbH 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 de Doc ID LPS UserDoc LPS_Manual E doc V1 3 May 2009 User Manual 225 Gesytec 2 E V1 3 May 2009 LPS LPS Manual E Socket Interface User Manual Foreword This manual provides you with all the information which you will need to use the Easy lon 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 078 0160 01E SLTA manual starting at page 9 8 Echelon Corp Description of the serial reliable transport protocol used for this device e 078 0016 01B Host Application Programmers Guide Echelon Corp This documentation is subject to changes without notice
10. O 7 Service 6 5 auth 4 tag 3 0 BYTE flags prio path cplcode 5 4 expl altp pool resp BYTE data_len BYTE format rcv domain 7 flex 6 a Gesytec Z2 rane E V1 3 May 2009 LPS LPS Manual E Socket Interface Manual Programming Instructions 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 buffer 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 msg out flags 8
11. ation with the module has to be set to 57600 baud 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 a Linux driver is as well available for the device a Gesytec Z2 sne y 2009 LPS LPS Manual E V1 3 Ma Es Socket Interface User 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 in terface For usage of the Easylon Serial Socket Interface there have to be made some registry settings There is a REG file named LPS reg on the Drivers amp Docu mentation CD which has to be imported into the registry Afterwards the Serial Socket Interface will be available as COM1 115200 for EasyCheck The REG file contains following settings Windows Registry Editor Version 5 00 HKEY LOCAL MACHINENSOFTWARENLonWorksNDeviceDriversNCOM1 115200 devic name PS 1 115200 The EasyCheck utility opens the interface It will then check and display the ver
12. evice file are dynamically started by devfs at system start access au thorization has to be defined in the configuration file etc devfsd conf Gesytec 2 e E V1 3 May 2009 LPS LPS Manual E Socket Interface Manual Programming Instructions c 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 can 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
13. han 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 NOTE This documentation describes just the functionality as standard LonWorks inter face a Gesytec 2 T y 2009 LPS LPS Manual E V1 3 Ma Es Socket Interface User 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 status setting has to be taken care of Chapter 4 gives further hints on this sub ject The external interface files xif can be found in the XIF directory of the instal lation 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 Interface card into an available Conexant socket The serial communic
14. he following line has to be added to the configuration file etc modprobe conf or letc 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 Gesytec 2 iss y 2009 LPS LPS Manual E V1 3 Ma E 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 ttyS0 dev ttyS1 Furthermore the init script starts device files with following names dev lonl dev lon2 usw The increa
15. manently ON Node is applica tionless and unconfig ured Permanently OFF Installation ok Normal operation Table 3 1 Service LED l boards are delivered pd Gesytec 2 T y 2009 LPS LPS Manual E V1 3 Ma E Socket Interface User Manual Technical Description 3 3 3 4 Serial Interface The serial interface is just using TXD and RXD lines The additionally men tioned hardware handshake lines RTS and DTR are used for on board program ming of the host CPU The baud rate is fixed to 115 200 baud There is no autobaud feature imple mented To obtain the maximum possible baud rate of 57 600 baud pleas ask Gesytec for devices with the corresponding firmware 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 Socket interface and serial device must use the same voltage source Both devices must be supplied simultaneously If not a latch up may occur on the interface or device using it inhibiting correct operation a Gesytec 2 T E V1 3 May 2009 LPS LPS Manual E Socket Interface User Manual Technical Description 3 5 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 no
16. sing index of these device files follows the enumeration sequence of the serial ports in the DAEMON_PORTS 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 O 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 Distribution 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 ttySO0 b Using devfs If the d
17. t exist LON LON Serv key LEDI LED2 Earth 5V nnn tA t Rao nanan tA t N LA A O 48 gt be on top Jumper DTR GND DTR TTL Reset GND TxD TTL RxD TTL RTS TTL on top Jumper RTS Figure 3 1 Connector pin assignment a Gesytec z ione y 2009 LPS LPS Manual E V1 3 Ma E Socket Interface User Manual 3 6 Technical Description Technical Specifications Network Interface CPU Transceiver variants Connector Service LED Service push button Compatibility CPU Processor Memory Serial Interface Type Connector Transmission Power supply Voltage Power consumption Neuron 3120E4 10 40 MHz FTT 10A FTX pin connector on board or via Conexant connector via Conexant connector LonTalk EIA 709 1 8031 compatible 11 059 MHz Flash 64 Kbytes RAM 8 Kbytes TTL Conexant standard RxD TxD RTS CTS pin connector 115 2 kbaud 57 6 kbaud optional 5 V DC 5 externally from Conexant socket 100 mA Dimensions amp Environmental Characteristics Temperature extended range Humidity Dimension operating 0 450 C storage 20 70 C operating 40 85 C storage 40 85 C class F accord DIN 40040 no condensation 65 6 x 26 6 mm E 3 eooo 64 1045 945 OOOOOOOO 33 PT doco 0000000684 A EES 3 78 75 1 1000 inch a 2580 Figure
Download Pdf Manuals
Related Search