Point Six OneSix User Manual - Contents

Other manuals for OneSix: User Manual
Manual is about: OPC Server

Summary of OneSix

  • Page 1

    Users guide onesix™ server version 2.2 copyright ©2004, point six, inc. Point six, inc 2333 alumni parkway suite 305 lexington, ky 40517 usa (859) 266-3606 http://www.Pointsix.Com.

  • Page 2: Contents

    Onesix server help contents x i contents overview 1 quick start .................................................................................................................................1 description.................................................................................................

  • Page 3

    Ii x contents onesix server help analog input ............................................................................................................. 23 access/control reader.............................................................................................. 24 repeater ................

  • Page 4

    Onesix server help contents x iii corrections 52 why use corrections ...............................................................................................................52 correction ids..........................................................................................................

  • Page 5: Overview

    Onesix server help overview x 1 overview quick start when onesix is run for the first time it displays this help screen. You may view this help screen again by selecting "help" from onesix's main window. Onesix is designed to gather data from sensors. Onesix makes available the data it receives from...

  • Page 6: Description

    2 x overview onesix server help if there is not an onesix.Ini file or if [server]numberdevices=0 and when onesix™ starts, it will automatically prompt for devices on the network and add them to its list of devices to poll. Description onesix™ is a data acquisition dynamic data exchange (dde) server ...

  • Page 7: Receivers

    Onesix server help overview x 3 you have several options after the device has been displayed. The "clear new" button will clear all the devices that have just been received. The "delete" button will delete a single device. Click on a device to select it and click on "delete" to delete it. To edit a ...

  • Page 8: Polling

    4 x overview onesix server help point sensor dsci point sensor ir counter point sensor thermistor point sensor counter temperature point sensor fast counter temperature point sensor alarm temperature point access/control reader point directional counter point dual discrete output point analog output...

  • Page 9: Identification

    Onesix server help overview x 5 identification onesix™ identifies each device with a unique label name. A client application uses this label (a dde topic) to obtain data from the server. Filtering for both analog and temperature devices, onesix™ allows the user to define a deadband to control the am...

  • Page 11: Data Logging

    Onesix server help overview x 7 visual basic will save the property settings thus the dde link settings are saved with executable. Therefore when the form is created, the executable (or visual basic) will try to reestablish the dde link. Use the method linkpoke (with label, picturebox or textbox) to...

  • Page 12: Onesix Main Window

    8 x onesix main window onesix server help onesix main window main window onesix™ displays the number of devices online and offline. It also lists the devices that are currently offline displaying the name and serial number of the device. If onesix™ is running with tcp/ip receivers, then for each off...

  • Page 13

    Onesix server help onesix main window x 9 add/delete ip connection (tcp/ip receiver only) onesix will display the “add/delete ip connection” screen. Ip addresses already setup will be displayed. The following is a list of the columns: node – node number for the ip address. Onesix uses this number to...

  • Page 14

    10 x onesix main window onesix server help view ip connection status (tcp/ip receiver only) onesix will display the “ip status” screen. Onesix shows the current state of the all the connections. The following describes the columns: node – node number for the ip address. Onesix uses this number to id...

  • Page 15

    Onesix server help onesix main window x 11 outputs onesix can send output packets to output devices. (normally sensors do not receive packets) output devices must be setup manually. Some outputs need to be “trained” to the packets that it will receive for from the server. New and edit create or edit...

  • Page 16

    12 x onesix main window onesix server help search and add devices onesix will display the "add sensors" screen. Devices already in the onesix.Ini file are displayed in the top portion of the screen. Follow the setup procedure to add more devices. The setup screen is the method by which onesix acquir...

  • Page 17: View Dde Variables

    Onesix server help onesix main window x 13 view dde variables clicking this menu option shows the most commonly used dde variables that are online. Clicking the show all check box will display all available dde variables. By selecting a variable and clicking the copy link button, the link is copied ...

  • Page 18: Onesix.Ini

    14 x onesix server .Ini file format onesix server help onesix server .Ini file format onesix.Ini the onesix.Ini file contains the configuration parameters for the server and a list of devices to process. When onesix™ finds a new device it adds the device to the ini file and assigns default initial p...

  • Page 19

    Onesix server help onesix server .Ini file format x 15 configureenable – 0 – disables the setup menu option on the main menu. The user then cannot make any changes to the configuration. 1 – (default) – enable the setup menu option on the main menu. Smallini – suppresses the listing of minor variable...

  • Page 20

    16 x onesix server .Ini file format onesix server help ip addesses [ip addresses] – section name (for tcp/ip receivers) ipwaitport – port number that onesix will wait for connections initiated by an ip receiver. (default is 1060) forwardport – port number that onesix will wait for connections to for...

  • Page 21

    Onesix server help onesix server .Ini file format x 17 temperature setup (point temperature, point thermistor) [devicen] - section name. Address - serial number of the sensor. Devicetype - device type. (devicetype=temp) polltime - the transmit interval of the sensor. (ms) label - name used for the d...

  • Page 22

    18 x onesix server .Ini file format onesix server help humidity [devicen] - section name. Address - serial number of the sensor. Devicetype - device type. (devicetype=humidity) polltime - the transmit interval of the sensor. (ms) label - name used for the device (and topic). Log - enable/disable log...

  • Page 23

    Onesix server help onesix server .Ini file format x 19 digcounter and directional counter [devicen] - section name. Address - serial number of the sensor. Devicetype - device type. (devicetype=digcounter or directcnt) polltime - the transmit interval of the sensor. (ms) label - name used for the dev...

  • Page 24

    20 x onesix server .Ini file format onesix server help cnttemp [devicen] - section name. Address – serial number of the sensor. Devicetype - device type. (devicetype=cnttemp) polltime - the transmit interval of the sensor. (ms) label - name used for the device (and topic) (typically cnttemp1). Log -...

  • Page 25

    Onesix server help onesix server .Ini file format x 21 fastcnttemp [devicen] - section name. Address – serial number of the sensor. Devicetype - device type. (devicetype=fastcnttemp) polltime - the transmit interval of the sensor. (ms) label - name used for the device (and topic) (typically fastcntt...

  • Page 26

    22 x onesix server .Ini file format onesix server help alarmtemp [devicen] - section name. Address - serial number of the sensor. Devicetype - device type. (devicetype=temp) polltime - the transmit interval of the sensor. (ms) label - name used for the device (and topic). Log - enable/disable loggin...

  • Page 27

    Onesix server help onesix server .Ini file format x 23 analog input [devicen] - section name address – serial number of the device devicetype - devicetype=ai polltime - the transmit interval of the sensor. (ms) label - name used for the device (and topic) (typically ai1) log - enable/disable logging...

  • Page 28

    24 x onesix server .Ini file format onesix server help access/control reader [devicen] - section name. Address - serial number of the sensor. Devicetype - device type. (devicetype=idr) polltime - the transmit interval of the sensor. (ms) label - name used for the device (and topic). Log - enable/dis...

  • Page 29

    Onesix server help onesix server .Ini file format x 25 dual discrete output [devicen] - section name. Address - serial number of the sensor. Nodaladdress – node where the output will be sent. Defaults to 0 for point view, point host and tzr transceiver. For tcp/ip receiver the node number represents...

  • Page 30

    26 x onesix server .Ini file format onesix server help cal2engr - two point calibration engineering units for point 2 (default 100). Units - units label (default "%"). Description - generic description field outtries – number of times to send the output packet. (default 10) outinterval – (in millise...

  • Page 31: Onesix Ini Backup

    Onesix server help onesix server .Ini file format x 27 onesix ini backup any time one six server modifies the ini file, one six will create a copy of the previous ini file. Onesix server names this backup file the same file name as the ini file but names the file extension as “.Bnn” where n is from ...

  • Page 32: Using Dde Links

    28 x onesix server dde variables onesix server help onesix server dde variables using dde links application: when you use a microsoft® windows® application to obtain data from another windows® application, you must provide the name of the application you wish to respond to your data requests. Applic...

  • Page 33: Topic Names

    Onesix server help onesix server dde variables x 29 topic names topic names define a device. A device contains a nodal address. When "search and add devices" is selected from setup, onesix™ server will automatically assign label names that will be used as the topic name for each new device found. Th...

  • Page 34: Device Item Names

    30 x onesix server dde variables onesix server help device item names the server uses item names to allow access to the i/o data and specific operational information. Item names are dependent on the type of devices used. Temperature (point temperature and point thermistor): tempn or 't' prefixed top...

  • Page 35

    Onesix server help onesix server dde variables x 31 digital i/o: digitaln online - indicates if the device is communicating (0 or 1) ** polltime – the transmit interval of the sensor (in milliseconds) nodaladdress – (only appears for tcp/ip receiver). The node address starts at 1. For tcp/ip receive...

  • Page 36

    32 x onesix server dde variables onesix server help humidity probe: humidityn online - indicates if the device is communicating (0 or 1) ** polltime – the transmit interval of the sensor (in milliseconds) nodaladdress – (only appears for tcp/ip receiver). The node address starts at 1. For tcp/ip rec...

  • Page 37

    Onesix server help onesix server dde variables x 33 digcounter and directional counter: digcountern and directcntn online - indicates if the device is communicating (0 or 1) ** polltime – the transmit interval of the sensor (in milliseconds) nodaladdress – (only appears for tcp/ip receiver). The nod...

  • Page 38

    34 x onesix server dde variables onesix server help cnttemp: cnttempn online - indicates if the device is communicating (0 or 1) ** polltime – the transmit interval of the sensor (in milliseconds) nodaladdress – (only appears for tcp/ip receiver). The node address starts at 1. For tcp/ip receivers, ...

  • Page 39

    Onesix server help onesix server dde variables x 35 nodaladdress – (only appears for tcp/ip receiver). The node address starts at 1. For tcp/ip receivers, the node address corresponds to the node number for the tcp/ip connection. Repeateraddress – (wireless mode) contains the location identifier of ...

  • Page 40

    36 x onesix server dde variables onesix server help alarmtemp: alarmtempn online - indicates if the device is communicating (0 or 1) ** polltime – the transmit interval of the sensor (in milliseconds) nodaladdress – (only appears for tcp/ip receiver). The node address starts at 1. For tcp/ip receive...

  • Page 41

    Onesix server help onesix server dde variables x 37 analoginput: ain online - indicates if the device is communicating (0 or 1) ** polltime – the transmit interval of the sensor (in milliseconds) nodaladdress – (only appears for tcp/ip receiver). The node address starts at 1. For tcp/ip receivers, t...

  • Page 42

    38 x onesix server dde variables onesix server help access/control reader: idrn online - indicates if the device is communicating (0 or 1) ** polltime – the transmit interval of the sensor (in milliseconds) nodaladdress – (only appears for tcp/ip receiver). The node address starts at 1. For tcp/ip r...

  • Page 43

    Onesix server help onesix server dde variables x 39 operation will be performed. All the variables can be changed by the client, but the server ignores the change..

  • Page 44

    40 x onesix server dde variables onesix server help repeater: repeatern online - indicates if the device is communicating (0 or 1) ** polltime – the transmit interval of the sensor (in milliseconds) nodaladdress – (only appears for tcp/ip receiver). The node address starts at 1. For tcp/ip receivers...

  • Page 45

    Onesix server help onesix server dde variables x 41 dual discrete output: outputdiscn online - indicates if the device is communicating (0 or 1) ** polltime – the transmit interval of the sensor (in milliseconds) nodaladdress – (only appears for tcp/ip receiver). The node address starts at 1. For tc...

  • Page 46

    42 x onesix server dde variables onesix server help wireless analog output: outputanalogn online - indicates if the device is communicating (0 or 1) ** polltime – the transmit interval of the sensor (in milliseconds) nodaladdress – (only appears for tcp/ip receiver). The node address starts at 1. Fo...

  • Page 47: Server Item Names

    Onesix server help onesix server dde variables x 43 server item names server items are made available when the "server" topic is defined. These items give information about the server and the current operational status of the server. Porttype - communication medium: "com", "lpt", etc. Portno - port ...

  • Page 48

    44 x onesix server dde variables onesix server help ** lograte - indicates the rate of logging in seconds. 0 - no logging. Less than 1 is accepted. Less than 5, onesix™ leaves the file open until terminated or set to 0. When 5 or greater, onesix™ opens, then logs, and then closes the file at every l...

  • Page 49: Features

    Onesix server help onesix server data logging x 45 onesix server data logging features onesix™ server can log data to an ascii file at a programmable interval. The default name of the file is onesix.Log. The name can be changed by changing the ini file. The log rate (programmable interval) can be ch...

  • Page 50: File Format - Data Log

    46 x onesix server data logging onesix server help the log file can be viewed while onesix™ is logging. The other program must not write to the file, lock the file, set the file as read only, or set the file's sharing parameters so that onesix™ cannot log. When processing data with another program, ...

  • Page 51: File Format - Error Log

    Onesix server help onesix server data logging x 47 file format - error log the log record format is as follows: hh:mm:ss,mm/dd/yyyy,error number,error msg,online flag,devicelabel where: hh:mm:ss is the time (ex. 23:40:50) mm/dd/yyyy is the date (ex. 02/03/99) error number-- error number as documment...

  • Page 52: Tcp/ip Receivers

    48 x tcp/ip receivers onesix server help tcp/ip receivers overview of tcp/ip receivers onesix can connect to tcp/ip receivers and receive and process sensors packets. As of this writing, the point manager (operating in “pass-thru” mode) is the only supported tcp/ip receiver. Onesix makes a tcp/ip co...

  • Page 53

    Onesix server help tcp/ip receivers x 49 information about the individual tcp/ip connection is made available through the server dde parameters (the “nodex” dde item). See the server dde topic for more information. Onesix can wait for connections initiated by the receiver. Onesix will automatically ...

  • Page 54: Multiple Ports Overview

    50 x using onesix with multiple ports onesix server help using onesix with multiple ports multiple ports overview onesix™ can interface to more than receiver simultaneously. A copy or instance of onesix™ is loaded for each receiver connected to a serial port. The client application communicates to t...

  • Page 55: Error Messages

    Onesix server help error messages x 51 error messages communication errors onesix™ server communication initialization errors will cause the 'onesix initializing error!" window to be displayed to help you determine what the cause of failure may be and to allow you to retry or abort the program. No d...

  • Page 56: Runtime Errors

    52 x corrections onesix server help runtime errors communication error: crc16 or time out sensor transmission was not received within the polltime or the transmission got corrupted. Cannot find receiver. Receiver has become disconnected from the computer. Onesix server internal error. Contact your d...

  • Page 57: How To Use Corrections

    Onesix server help corrections x 53 correction id 128. (in the device section of the onesix.Ini file, write "corrid=128" to use this type.) the parameters for the predefined thermistor are as follows: ntc_divideres = 10000 ntc_normalres = 10000 fitting constants: a = 3.3539264e-3 b = 2.5609446e-4 c ...

  • Page 58

    54 x corrections onesix server help corrtype=1 divideres=10000 normalres=10000 a=3.3539264e-3 b=2.5609446e-4 c=1.9621987e-6 d=4.6045930e-8 predefined corrections the device type "thermistor" will default to a correction id of 128. To override this default you can add a corrid parameter to the device...