Porovnávané verzie

Stará verzia 4

changes.mady.by.user D2000 Dev Team

Uložené

porovnané s

Nová verzia 5

changes.mady.by.user D2000 Dev Team

Uložené

Kľúč

  • Tento riadok sa pridal
  • Riadok je odstránený.
  • Formátovanie sa zmenilo.

...

The protocol supports data acquisition using device devices from the AMiT company (ADiS modular control system and ART267, ART4000, AMiRiS, and AMAP compatible control systems and others) via a DB-Net communication network. Communication requires the installation of the ATOUCH32 driver to communicate in a DB-Net ATOUCH32 network (you can download it at http://www.amit.cz). Communication was tested and tuned for the ATOUCH32 driver of V2.10, V2.30, V2.40, V2.60, V2.90, and V3.30 versions.

Limitations: The protocol does not support database variables of "own self station", i.e. on the computer with ATOUCH32 driver running but allows to read/write variables on process stations. The DB-Net driver can be used by just one application (in our case the process D2000 KOM process) at the same time.

When using the older versions of ATOUCH32 V2.x, there must be configured just one communication line for DB-Net communication must be configured. ATOUCH32 V3.x versions enable so-called multithreading. It means, you may connect more lines, which will communicate in parallel, to ATOUCH32 and speed up the communication. The driver must be initialized only by one line (see "Init File" parameter, note 2). There is still However, the rule that all lines must be configured within one KOM process in on one computer still applies. This feature may be used in D2000 V9.00.021 rel.021 and higher.

...

Communication line - configuration dialog box - the Protocol parameter tab.
Parameters defined in the field have an effect on some optional protocol parameters. There can be defined the The following line protocol parameters can be defined:

Kotva
line_prot_par
line_prot_par
Table 1

Full nameDescriptionUnits / sizeDefault value
Kotva
if
if
HW Init File
Full path to the file containing the DB-Net configuration.

Note 1: If the line protocol parameter INIFILE is not specified (an empty string), then the station protocol parameters described below must be configured correctly for all stations. The parameters of DB-Net IP can be configured only by "Init File".

Note 2: If you do not want so that the line initialized ATOUCH32 in the multithread mode, use "---", i.e. 3x "minus" character. One line within the D2000 KOM process must contain the path to the existing init file. It, then, executes the initialization for all other lines.		-

Kotva
komunikacna_stanica0
komunikacna_stanica0
Communication station configuration

...

  • communication Communication protocol: AMiT ATOUCH32 DB-Net.
  • Station The station address is the device address in the DB-Net network (value of the “Station” item “Station” in the initialization string/file). Neither the configuration nor the network can contain two stations with the same address including the address of "own self station".


Communication station parameters

Communication station - configuration dialog box - tab Protocol parameter.
Parameters defined in the field have effect on influence some optional protocol parameters. There can be defined the The following station protocol parameters can be defined:

Table 2

Full nameMeaningUnit/ sizeDefault value
Kotva
myst
myst
My Station
Address of "own self station" (PC with ATOUCH32 driver running)-31
Kotva
com
com
COM Port
COM port used for the communication-1
Kotva
speed
speed
COM Speed
Communication baud rate.-19200
Kotva
met
met
Max. Transactions Error
Maximum The maximum number of consecutive read commands that failed to label which have to fail for the communication with the station to be marked as failed . The and the status of the station is to be set on to StCOMERR. If the number of failed readings of I/O tags exceeds the double of this value, the reading of the next I/O tags will be stopped. The purpose is to make fast the communication avoid communication delays due to non-working stations (the station is considered to be completely inaccessible).-10
Kotva
fd
fd
Full Debug
High level of line debug messages - trace messages contain details about received values of I/O tags.-False
Kotva
emr
emr
Enable Matrix Read
Reading The reading of matrix variables will be optimised optimized for slow networks (e.g. GPRS). Reading of variables with matrix types (INT MATRIX, LONG MATRIX, FLOAT MATRIX a DBNETTIME MATRIX) will be optimisedoptimized. If multiple I/O tags share the same WID and type, only a single read request is generated and it incorporates a range of rows and columns of all these I/O tags.-False

...

When starting, the DB-Net driver requires to get the configuration file or string containing the DB-Net network configuration in for a particular application. If you use the communication via standard COM port, it is possible to avoid creating the configuration file on disk using the My Station, COM Port, and COM Speed station protocol parameters which must be configured for one of the stations.

If the Init File line protocol parameter is specified for a line (at least one), then the My Station, COM Port, and COM Speed the protocol parameters will be ignored on all the stations. There will be used the configuration file on the disk which path is defined by the Init File line protocol parameter.
For further information on the file contents, see the ATOUCH32 online help.

Example: configuration file contents:

...

  • Kotva
    wid
    wid
    WID - the numerical name of the variable - it is unique within the DB-Net network. Permitted The permitted range is 0..65500, the value is allocated assigned by the PSP3 tool or DetStudio.
  • Kotva
    typ
    typ
    Type - value type of the variable - it can be the INT, LONG, FLOAT types and the INT MATRIX, LONG MATRIX or FLOAT MATRIX types. The INT and INT MATRIX types are 16 bit wide; and if they are configured as Ai, /Ao value types, they are interpreted as signed numbers; and if they are configured as Ci, /Co value types, they are interpreted as unsigned numbers.
    LONG and LONG MATRIX types (32 bit wide) configured as Ai, /Ao value types are interpreted as signed numbers and if they are configured as Ci, /Co value types, they are interpreted as unsigned numbers. The FLOAT and FLOAT MATRIX types are 32-bit float numbers within the range from ±10-36 to ±1038. DBNETTIME is LONG type interpreted as absolute time in DBNet format (number of seconds from 1-1-1980 0:0:0). INT MATRIX value type can be set for value types of TxtI and TxtO. The Then the row from the INT matrix INT is interpreted as text, each INT element of the matrix represents one symbolcharacter. INT and LONG types can be represented as relative time - i.e. a number of seconds.
  • Row, Column - value position in matrix types, the first row or column has zero valuerows and columns are indexed from zero.
  • Row count, Column count - In the case of value types TxtI and TxtO, only the column count can be specified, which is the text length. For other value types, the implicit value of row count and column count is 1. If the configured row count/column count is above 1, the values of the whole matrix or part of the matrix are read into the target column of a structure. A part of matrix [Row, Column .. Row+ Row count -1, Column+ Column count - 1] will be read.
    Example: Row=1, Column=2, Row count=20, Column count=30. Rows 1 to 20, columns 2 to 31 are read, i.e. part of matrix [1,2 .. 20, 31].
  • Bit - bit number for the Di and Dout value types. It can be within the range of 0 - 15 for the INT and INT MATRIX types or within the range of 0 - 31 for the LONG and LONG MATRIX types.

Kotva
chyby
chyby
Errors and problems

...

When starting or during the communication, there could be occurred the following error reportsmessages can occur. To make the problem identification easier, set the communication tracking at least to the level Monitor (the best is to temporarily set it to Monitor & Disk). When you set the option Monitor & Disk, there will create the a file "line_name.LOG" will be created in the application subdirectory TRACE, which will contain all debug and error logs. If you are unable to correct the error and the problems still persist, please contact the contact  IPESOFT's technical support.

Error:DB-Net Station Address Error - 'StationName', Address : 'StationAddress'
Solution:Invalid station address - check the Address tab in the communication station configuration dialog box (in the process D2000 CNF process) and eventually save the station configuration and restart the process D2000 KOM process.
Error:DB-Net Point Address Error - 'PointName', Address : 'PointAddress'
Solution:Invalid I/O tag address - check the Address tab in the I/O tag configuration dialog box (in the process D2000 CNF) and eventually save the I/O tag configuration.
Error:DB-Net ATOUCH32 ERROR - 0xXY - AtchInitFromStringA
Solution:Error when calling the ATOUCH32 function AtchInitFromStringA - check the station configuration and protocol parameters. During the start, the process D2000 KOM shows the configuration string pattern (the communication tracing level at least Monitor must be enabled) and check if meet required state.
Error:DB-Net ERROR - CreateSemaphore - ErrNr - Error description
Solution:System error of Windows API call. Restart the operating system.
Error:DB-Net ATOUCH32 ERROR - 0xXY - AtchReqGetVariable
DB-Net ATOUCH32 ERROR - 0xXY - AtchReqPutVariable
Solution:Error when calling the ATOUCH32 functions AtchReqGetVariable or AtchReqGetVariable for reading /writing a DB-Net database variable value. Previous communication tracing logs allow us to detect which I/O tag is in troubles and then check its configuration.
Error:DB-Net ERROR - Reading 'PointName' - TNRES=0 !
DB-Net ERROR - Reading 'PointName' - TNRES=1 (reading on progress) !
DB-Net ERROR - Reading 'PointName' - TNRES=Invalid !
DB-Net ERROR - Writing 'PointName' - TNRES=0 !
DB-Net ERROR - Writing 'PointName' - TNRES=1 (reading on progress) !
DB-Net ERROR - Writing 'PointName' - TNRES=Invalid !
Solution:Transaction errors of reading/writing the DB-Net database variable. They couldn't occur.
Error:DB-Net ERROR - Reading 'PointName' - TNRES=4 (station not responded) !
DB-Net ERROR - Writing 'PointName' - TNRES=4 (station not responded) !
Solution:Transaction errors of reading/writing the DB-Net database variable. The station doesn't respond because it is switched off, a problem with the communication wire or a configuration error (e.g. wrong baud rate, address or port). The error could occur sporadically, especially at reading.
Error:DB-Net ERROR - Reading 'PointName' - TNRES=4 (station responded) !
DB-Net ERROR - Writing 'PointName' - TNRES=4 (station responded) !
Solution:Transaction errors of reading/writing the DB-Net database variable. The station responded with an error. Probably it is an attempt to read or write the variable, which has no mirror in a given device. Check the configuration of the corresponding I/O tag and compare it with the log from the AMiT PSP3 software tool.
Error:DB-Net ATOUCH32 ERROR - 0xXY - AtchInitFromFileA
Solution:Error when calling the ATOUCH32 function AtchInitFromFileA. Check if the protocol parameter INIFILE is configured just for one station and is pointed to an existing file on disk.

...