The Data Aire Driver is capable of direct connection to a network of Data Aire DAP devices.
The FieldServer is connected in a RS-485 loop topology. Two FieldServer ports are required
per loop. The driver is an active client. All data is obtained by poll & response.
Connection to a DART is not supported by this driver.
The driver may be configured very simply (See Section 4.4). A number of advanced
configurations are also available and are described in Appendix B. The driver supports the
common message formats for common Data Aire DAP devices. A list of the supported
messages is provided in the manual.
The information that follows describes how to expand upon the factory defaults provided in the
configuration files included with the FieldServer.
1.1. Performance Issues - DARTIII only
Data Aire communication is based on a very low baud rate. In addition inter-message timing
constraints and overhead requirements for active messages in a Dart configuration add
significant time to each transaction. It is not possible to write a setpoint to a device until the
device has been successfully read, and the result of the write will not be seen until the next
read is complete. The result of a write may not be seen for some time due to slow
communications and significant inter poll delays.
1.2. Data Alarm Network Module Network LED Operation
DAP-II units communicate with a DART unit by using a Data Alarm Network Module. This
module provides a RS-485 communications link. Installed on the card are several LEDS.
The table below explains how the LEDS appear under normal (correctly functioning)
operation.
LED LED Appearance
The Network Module has a blown fuse detection circuit. If one (or more) of
FUSE
DS1 &
DS3
NETWORK
the fuses has an open circuit, then the FUSE LED will be lit. Normally, this
LED is dark.
Communications signals enter and leave the Network Module. These LEDS
reflect the communications activity. When first powered up, both LED's will
be lit and the illumination will be steady. As the DART communicates with
the network, both LED’s will begin to flicker in unison. All of the Network
Module LED’s will flicker at the same time.
At some point the DART will send a communication message to a specific
network-connected DAP-II that requires a reply to the DART. If the message
is received without error, the DAP-II will reply by engaging a relay on the
Network Module and transmitting a message. When this happens the
NETWORK LED will come on. Whenever a NETWORK LED is seen to
come on it means that the communications into the Network Module is
satisfactory. It is still possible to have a wiring problem downstream of the
module that prevents the message from being received by the DART
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
4. Configuring the FieldServer as a Data Aire Client
For a detailed discussion on FieldServer configuration, please refer to the FieldServer
instruction manual. The information that follows describes how to expand upon the factory
defaults provided in the configuration files included with the FieldServer (See “.csv” sample files
provided with the FieldServer).
This section documents and describes the parameters necessary for configuring the FieldServer
to communicate with a Data Aire Server
4.1. Data Arrays/Descriptors
The configuration file tells the FieldServer about its interfaces, and the routing of data
required. In order to enable the FieldServer for Data Aire communications, the driver
independent FieldServer buffers need to be declared in the “Data Arrays” section, the
destination device addresses need to be declared in the “Client Side Nodes” section, and
the data required from the servers needs to be mapped in the “Client Side Map Descriptors”
section. Details on how to do this can be found below.
Note that in the tables, * indicates an optional parameter, with the bold legal value being the
default.
Section Title
Data_Arrays
Column Title Function Legal Values
Data_Array_Name Provide name for Data Array
Up to 15 alphanumeric
characters
Float, Bit, UInt16, SInt16,
Data_Array_Format
Provide data format. Each Data
Array can only take on one format.
Packed_Bit, Byte,
Packed_Byte,
Swapped_Byte
Number of Data Objects. Must be
Data_Array_Length
larger than the data storage area
required by the Map Descriptors for
Specify which port the device is
connected to the FieldServer
1-259
P1-P8, R1-R23
This is the connection to the primary port identified with the
'Port' keyword in the connection configuration described in
Section 4.2
4.4. Client Side Map Descriptors
4.4.1. FieldServer Related Map Descriptor Parameters
Column Title Function Legal Values
Map_Descriptor_Name
Data_Array_Name
Data_Array_Offset
Function
Name of this Map
Descriptor
Name of Data Array
where data is to be
stored in the
FieldServer
Starting location in Data
Array
Function of Client Map
Descriptor
Up to 32 alphanumeric
characters
One of the Data Array
names from “Data Array”
section above
0 to maximum specified in
“Data Array” section above
RDBC, WRBC, WRBX
3
Not all ports shown are necessarily supported by the hardware. Consult the appropriate Instruction
manual for details of the ports available on specific hardware.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
Only required when the function
is a Read (rdbc).
Tells the driver to poll the
DA_Func*
device for all the data that is
available. The data is device
specific.
Other uses of this parameter
are discussed in Appendix B .
Required when the function is a
write (wrbc) or when the Map
Descriptor is associated with a
write by means of the
DA_Field
DA_Assoc parameter value.
This is the name of the data
field whose value you wish to
set in the device.
Other uses of this parameter
are discussed in Appendix B.
Use to associate passive Map
Descriptors with an active Map
Descriptor. Multiple fields can
DA_Assoc
be associated with one WRBC
Map Descriptor, thus writing
multiple values to one device
using just one message.
One of the node names
specified in “Client Node
Descriptor” above
Not required for client
configuration - used in
simulation configuration only.
Everything – See Appendix A
See Appendix A.2 for a list of
permitted values.
Any positive integer. See
Appendix E
4.4.3. Timing Parameters
Column Title Function Legal Values
Scan_Interval Rate at which data is polled ≥0.1s
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
Appendix A.1. Data Table 1: Array Locations of ‘Everything’
In the following table the array location indicates the offset in the Data Array at which a data
field can be found. (This offset is relative to the offset specified in the Map Descriptor) The
columns headed 2, 3 … indicate the unit types for which the data fields are available. For
example: The field ‘d_temp’ can be read from unit types 2, 5,6,7,9 but not from any of the
other unit types. It is beyond the scope of this manual to describe each field and to indicate
valid ranges. Such information should be obtained from the Data Aire Corporation.
‘x’ Indicates Read only
‘X’ Indicates a point that can be read & written.
‘w’ Indicates a write only point.
Array
Location
1 1 1 Zone w w w w w w w w w
2 1 1 Inhibit w w w w w w w w w
3 4 1 unitType x x x x x x x x x x
4 2 1 temp x x x x x Dap-Stat
5 2 1 hum x x x x x Dap-Stat
6 2 1 d_temp x x x x x Dap-Stat
7 3 8 mode x x x x x Dap-Stat
23 3 8 hold x x x x x Dap-Stat
39 1 1 cs_on x x x x x Dap-Stat
40 1 1 hs_on x x x x x Dap-Stat
41 1 1 valvePCT x x x x x Dap-Stat
42 1 1 hVlvPCT x x x x x Dap-Stat
43 4 14
57 2 1 hiTemp x x x x x Dap-Stat
58 2 1 loTemp x x x x x Dap-Stat
59 2 1 hiHum x x x x x Dap-Stat
60 2 1 loHum x x x x x Dap-Stat
61 1 1 chilled_water x x x x x Dap-Stat
62 1 1 compressor_config x x x x x Dap-Stat
63 1 1 heat_strip_config x x x x x Dap-Stat
64 1 1 hum_config x x x x x Dap-Stat
65 1 1 csUtilPct x x x x x Dap-Stat
66 1 1 hsUtilPct x x x x x Dap-Stat
67 1 1 valveUtilPct x x x x x Dap-Stat
68 1 1 humUtilPCT x x x x x Dap-Stat
69 1 1 alrm_select_1 x x x x x Dap-Stat
70 1 1 alrm_select_2 x x x x x Dap-Stat
71 1 1 alrm_select_3 x x x x x Dap-Stat
72 1 1 alrm_select_4 x x x x x Dap-Stat
Method
Num
Elements
Data Field 2 3 4 5 6 7 8 9 14 15 Message Type
Errors - see Appendix E.4
for more information
x x x x x Dap-Stat
Dap-Config
Dap-Config
Dap-Unit
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
Note 1:mode: 2' bit definitions: Note 2: hold: 2' bit definitions:
0X01 Unit is in centigrade mode 0X01 needed cooling is inhibited
0X02 RFU , always 1 0X02 needed heatingg is inhibited
0X04 RFU , always 1 0X04 needed humidification is inhibited
0X08 Unit is dehumidifying 0X08 needed dehumidification is inhibited
0X10 Unit is humidifying 0X10 not used
0X20 Energy save is active 0X20 not used
0X40 not used 0X40 Network"standby" inhibit is active
0X80 not used 0X80 Network"off" inhibit is active
Note 2: errors: 7*2' bit definitions:
00 Manual override:check bypass switches errors[0], bit 0x01
01 water detected under floor errors[0], bit 0x02
02 No air flow, check belt and motor errors[0], bit 0x04
03 dirty filter: check filter errors[0], bit 0x08
04 Humidifier problem: check water pressure errors[0], bit 0x10
05 Low voltage warning errors[0], bit 0x20
06 Firestat alarm, unit shutdown errors[0], bit 0x40
07 compressor short cycle errors[0], bit 0x80
08 power problem or unit restart errors[1], bit 0x01
09 humidity sensor problem errors[1], bit 0x02
10 temperature sensor problem errors[1], bit 0x04
11 schedule maintenance due errors[1], bit 0x08
12 high presure C1: manual reset errors[1], bit 0x10
13 low presure C1: auto reset errors[1], bit 0x20
14 high presure C2: manual reset errors[1], bit 0x40
15 low presure C2: auto reset errors[1], bit 0x80
16 smoke detector: unit shutdown errors[2], bit 0x01
17 No water flow :check pump errors[2], bit 0x02
18 Discharge temperature sensor problem errors[2], bit 0x04
19 High Temperature warning errors[2], bit 0x08
20 Low temperature warning errors[2], bit 0x10
21 High humidity warning errors[2], bit 0x20
22 low humidity warning errors[2], bit 0x40
23 Fan motor overload: check motor amperage errors[2], bit 0x80
24 Local alarm 1: see tag inside door errors[3], bit 0x01
25 Local alarm 2: see tag inside door errors[3], bit 0x02
26 Local alarm 3: see tag inside door errors[3], bit 0x04
27 Local alarm 4: see tag inside door errors[3], bit 0x08
28 Standby Pump on: check primary pump errors[3], bit 0x10
29 UPS power on: check primary power errors[3], bit 0x20
30 Custom message on optional input 1 errors[3], bit 0x40
31 Custom message on optional input 2 errors[3], bit 0x80
32 Custom message on optional input 3 errors[4], bit 0x01
33 Custom message on optional input 4 errors[4], bit 0x02
34 Humidification inhibited errors[4], bit 0x04
35 Reheat inhibited
36 Reheat and humidification inhibited errors[4], bit 0x10
37 Discharge air temperature limit errors[4], bit 0x20
38 Reheat mode during dehumidication errors[4], bit 0x40
39 Manual override:check bypass switches errors[4], bit 0x80
40 High condensate water level errors[5], bit 0x01
errors[4], bit 0x08
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
When the driver reads everything from a device it must first obtain the device’s unit type so
that it can determine what other data is available. Once the unit type is obtained then the
driver updates the ‘Unit-Type’ field visible on the node screen of the RUIDebug program.
The unit type is also available in the Data Array defined in table 4.4.5.1.
The following table lists the unit types that can be processed by this driver.
Unit Type Numeric Unit Type Description
"-" 0
"1" 1
"2" 2
"3" 3
"4' 4
"5" 5
"6" 6
"7" 7
"8" 8
"9" 9
"10" 10
"11" 11
"12" 12
"13" 13
"E" 14
"F" 15
Unknown/unavailable/un-initialized
044 data logger
046 expanded DAP
046 2 mod chiller
046 3 mod chiller
048 DAP, 80-character display
049 DAP, 16-character display
080 DAP II, no relay expansion
080 Chiller II
080 DAP II, with relay expansion
Not Defined
Not Defined
Not Defined
Not Defined
080 DAP II, with analog module
080 DAP II, with relay and analog
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
Appendix B.1. Additional Driver Specific Map Descriptor Parameters
The driver offers advanced configuration by adding to and extending the Map Descriptors
specific to the Dart Serial Driver.
Column Title Function Legal Values
Specifies the Data Aire Command/Query
DA_Func*
DA_Field*
DA_Assoc*
Da_Freq
DA_Methodψ
DA_Bytcntψ
DA_Offset
DA_Elecntψ
ψ
function to be used. Use a function
appropriate to the type of Server
(DAP/Chiller/DAP80) and the type of data
required.
Specifies the data field to be retrieved from
the Server device. Servers are only
capable of responding with a data
composite consisting of many data fields.
This parameter is used to specify the
parameters to be extracted from the data
composite.
Note1.
This field is used to make the association
between passive and active (rdbc/wrbc)
Map Descriptors addressing the same
node. Give the rdbc and its associated
passive Map Descriptors the same value
(any number) and give the wrbc and its
passive Map Descriptors another value for
DA_Assoc.
Used only for connection to DART’s.
Specifies in milliseconds the intervals
between wrbc/rdbc Map Descriptor
execution.
Specifies the extraction method. Such as
Hex-ASCII to decimal number in 10's of a
degree,
Specifies the number of bytes that are to
be processed by the method specified
above. For method#6 which processes an
array of elements the DA_Bytcnt specifies
the number of bytes that constitute each
element of the array.
An offset into the data composite that is
returned when the Server is polled. The
offset is the number of bytes from the first
data byte.
Number of elements that are produced by
the extraction method.
Numeric/Text. See Appendix B.2
for a list of possible values.
Text. See Appendix B.3 for a list
of possible values as well as Table
4.4.5.1
Any positive integer.
> 18000 (3 minutes)
30000 (5 minutes) recommended
See Appendix B.4 for a list of
possible values.
>= 1
0 to the length of the data
composite. No validation is
performed.
>= 1
ψ
These parameters are only required for custom data extractions not provided for with DA_Field
parameter.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
The driver supports a limited subset of the Dart Poll & Response Functions. The selection
of the sub-set is based on the identification of useful & practical functions.
In addition to the ‘Everything’ keyword indicated in chapter 4 the following specific query
functions are implemented.
Each of the above queries returns a complex set of data consisting of many sub-fields.
Contact Data-Aire for a complete listing of the data composite returned.
The following special / diagnostic functions are also implemented.
With the exception of the Unit-Talk transmission of this command, these are nodeless
commands to allow the units time to switch their mechanical command. When using any of
these special commands no other DA_* fields need be specified.
All-Listen instructs the all units in the network to switch their relays to the listen position.
Those units already in the listen position will do nothing. Those in the talk position will first
echo the all-listen command and then switch their relays to the listen position. A pause of
0.15 seconds is required after the relays.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
The whole data record
returned by the Server
is stored in the Data
All
Special
Array byte for byte.
The number of bytes
written is dependent on
the DA_Func.
Indicates that a user defined extraction is specified in the Map Descriptor.
When this value is specified as the DA_Field value then DA_Method,
DA_Bytcnt, DA_Offset, DA_Elecnt must also be specfied.
Appendix B.4. DA_Method Parameter Values and Notes
The DA_Method specifies a method for interpreting a range of bytes when the DA_Field=special.
Method # Description
Each byte is valid when it contains only one of the following ASCII characters.
{ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, F }
Method 1:
Method 2
Method 3
Method 4
Method 5 There is no translation - the raw bytes are written to the data array.
Method 6
Each byte being parsed is considered to be a hexadecimal digit with the most
significant digit being the left-most byte.
The four bytes 30 31 32 33 (hex) are therefore interpreted as the hexadecimal
number 0123 and the decimal value is equal to 291.
As method 1, but used for humidity's and temperatures which are transmitted as the
number of tenths of a unit – Thus the 4 bytes yield the decimal number 29.1 °F/%.
Each byte is regarded as containing a hexadecimal digit in ASCII format.
Example: incoming byte contains 41(hex). -> regarded as the hexadecimal digit 'A' in
ASCII format.
The hex digit is converted to a series of 8 bits. In this example the bits are 00001010
with the msb being the left-most.
As Method 3 except that the decimal value of this digit is written to the Data Array. In
this example the number 10 would be written to the Data Array.
Processes an array of elements using method 1 translation. The raw data being
parsed is considered to consist of DA_elecnt elements each consisting of DA_bytecnt
bytes.
4
See Section Appendix A for all other keywords.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
In the event that the driver cannot correctly decode the raw bytes it will generally write a
value which indicates bad data. In most cases the indicating value is -1 or 65535
(depending on data type). When setting bits for status fields the driver will not write new
data to the array if the incoming byte is invalid. Consult the error log for indication of this
type of problem.
Example: Valid ASCII digits are 0...9, A...F. If a byte is being parsed and a hex digit is
expected but not found then the driver considers this an error and writes the bad value
indication OR produces an error message when the bad value indication cannot be used.
Appendix C.2. Dead Nodes
When a node is absent or dies, the driver may go idle and stop communicating with all other
nodes. This problem is specific to the Data Aire devices.
Appendix C.3. Noise
A high percentage of responses on the secondary port are preceded with noise. The driver
is generally able to filter this noise because legitimate characters in a response are limited to
the ASCII character set and a few control characters. The driver does not filter noise in the
middle of a message. Thus the message will fail (generally as a checksum failure) when
there is noise in the middle of a message. This is normal for most drivers.
Appendix C.4. Ignored Messages
Ignored messages which are messages sent by a DAP/DART for which the driver cannot
find an appropriate Map Descriptor are reported by the driver. This simply indicates that a
message containing information that is not required is being discarded. The current version
of the driver ignores a few messages relating to the status of the DART device. Later
versions of the driver will be capable of storing these messages and the number of ignored
messages will decrease.
Appendix C.5. Driver limitation
Unable to reset run times.
Appendix C.6. Baud Rate.
Rev 9.5 of the DAP firmware changed the baud rate from 2400 to 9600. All units must have
the same baud rate on the network. The customer should check the firmware version of
each unit and record these in a table. FieldServer recommends that all units have the same
version due to the fact that instability between different versions has been experienced.
Appendix C.7. Wiring.
This must be completed exactly as specified by Data Aire. Variations in the wiring invariably
causes problems. The wit=ring/installation guide is available from Data Aire.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
Communications on the DAP units requires the operation of a mechanical relay. This can
get stuck. The Front Panel menu of each DAP unit allows a user to execute a diagnostic
test of the comms board. The customer should execute this test and use the Data Aire
installation guide to resolve any issues. Typically a failed unit requires replacement. A
single failed card will fail the whole network. The FieldServer sends polls on the primary
port and expects responses on the secondary port. The fact that we get back a copy of the
poll message on the secondary port does not mean that the units are operating correctly
since this is possible when the units are stuck in pass thru mode.
Appendix C.9. Number of Units
Up to 250 DAP devices can be connected to a FieldServer using the DAP driver.
Normal RS485 network considerations apply - these limit the number of units based on the
load of each node.
• For unit loads only 32 devices per network can be used.
• For .25 unit loads 128 devices can be used on one network segment. If more than 32
full unit loads are required then the network must be segmented and connected via a
repeater
• It may be necessary to use a repeater if total RS-485 length exceeds 1000ft.
It is recommended that tests are performed with a single or few units.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
FYI. The Map
Descriptor called
<%s> is too short.
FYI. You could have
used a Map Descriptor
called <%s> to expose
diagnostic info.
Err. Method3 requires
even number of bytes.
nb= %d Map
Descriptor= <%s>
Err. Method3 is
translating invalid
bytes. ch1= %d( dec )
%d( dec )
Err: Method2 is
translating invalid
bytes. ch= %d( dec )
%d( dec)
Err: Method1 is
translating invalid
bytes. ch= %d( dec )
%d( dec)
Err. Method3 is
translating invalid
bytes. ch2= %d( dec )
%d( dec )
Err. Invalid Station
(Dec ) %d-%d-%d
Err: Station= %d illegal
- forcing to 1
Err. secondary_port
must be defined.
FYI. Driver on port=
%d suitable for NONDart applications only.
Err. Invalid
Station#(%d) . (1-260)
The Map Descriptor used to expose driver stats must be
500 elements long. Change the length parameter and
ensure that the Data Array is long enough too5
This message is for information only and may be
ignored. The driver is capable of exposing performance
and communication statistics. See Appendix D.1 for
more information
May be a corrupted message. If frequently occurring,
take a log and report to FieldServer Technical Services.
The protocol only allows certain characters to be
transmitted. If an unexpected character is encountered
then the error message is printed. If the error occurs
frequently the make a log file and report the error to
FST. The error may arise from a corrupted message.
Only certain station numbers are legal. (1-260). If the
error occurs frequently then make a log file and report
the error to FST. The error may arise from a corrupted
message.
The CSV file contains a DAP node with an illegal station
number. The driver has changed the illegal node
number to 1. It is important that this error is corrected or
data will be collected from node1.5
The DAP driver sends polls on one port and expects
responses on a second port, therefore 2 ports must be
defined for each DAP network – see Section 4.25
This message is for information only and may be
ignored. The message indicates that the configuration
is suitable for connection to a DAP only network. No
DART device may be present in the network.
The CSV file contains a DAP node with an illegal station
number. Only station numbers between 1 & 260 are
5
Edit the CSV file and reset the FieldServer for the changes to take effect.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
Err. Unknown
Command
Err. Unknown Msg
Type
Writing before Unit
Type is known.
Err. Cant write this
DAP:#21
function= %c. Map
Descriptor= <%s>
The value of the DA_Method parameter specified in the
CSV file cannot be recognized by the driver. Read
Appendix B.4 for more information.6
The value of the DA_Function parameter specified in
the CSV file cannot be recognized by the driver. Read
Appendix B.2 for more information.6
The value of the DA_Field parameter specified in the
CSV file cannot be recognized by the driver. Read
Appendix B.3 for more information. 6
A message has been received that cannot be
recognized. If this error occurs repeatedly, make a log
file and report the error to FST. If the error occurs
occasionally it may be indicating an occasional corrupt
message and may be ignored.
If you see this message printed report the fact to FST
immediately.
Only certain data is writable. See Section Appendix A.2
for more information.5
It is not possible to write to a DAP device before it has
been read successfully. This message arises if the
device has been read but some data contained in the
read is invalid. The driver is preventing the invalid data
being written back to the device. If this message only
occurs once or twice after the FieldServer is restarted, it
may be ignored. If the message occurs repeatedly then
take a log file and report the error to FST
It isn’t possible to write to a DAP device before it has
DAP:#23
DAP:#23a
FYI. Write abandoned.
Read incomplete. Will
retry. Map Descriptor=
<%s>
been read successfully. If this message only occurs
once or twice after the FieldServer is restarted, it may
safely be treated as for information only. If the message
occurs repeatedly then the configuration may need
changing.
DAP:#24
Err. Rev-Translate:
Unknown Method.
Report this error to FST providing a copy of your CSV
file.
6
Edit the CSV file and reset the FieldServer for the changes to take effect.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
This error arises when (1) a Map Descriptor refers to a
field that is not unique but the function has not been
specified or (2) when a non-writeable field has been
specified. See section 4.4.5 for additional information.
DAP:#25
Err. Field= <%s>
cannot be used for
write. Map Descriptor=
<%s>
This error could also be produced if there are two (or
more) write Map Descriptors each having a different
DA_Func but with the DA_Assoc values of each Map
Descriptor set equal (or implied equal when not set in
the csv file). Specify the DA_Assoc parameter for the
write Map Descriptor’s, ensuring that non-associated
Map Descriptor’s have different values for this
parameter.7
You are trying to a read/write data from a DAP device
and the driver cannot process the specified
DA_Function for reading. 7
Descriptor= <%s>
DAP:#28!
Err. No Map
Descriptor’s
Report this error to FST providing a copy of your CSV
file.
Err. Map Descriptor=
DAP:#29
DAP:#30
<%s> Special
specified with invalid
method.
Err. Map Descriptor=
<%s> Unknown
translation Method=
Read Appendix B.4 and review the CSV file. When you
have corrected the CSV file reset the FieldServer for the
changes to take effect.
%d
DAP:#31
DAP:#32
DAP:#33
DAP:#35
Err. Cant translate
map desc. Data not
stored
Err. Driver does not
support unit type='%c'
( node= %d)
Err. Conflicting unit
types='%c' vs '%c' (
node= %d)
Err. Cant write to a
data logger Map
Descriptor= <%s>
Make a log file and report the problem to FST providing
a copy of your CSV file.
The driver found a device whose type is not supported.
Remove this node from your CSV file and reset the
FieldServer
The expected and discovered unit type are different.
The driver will always work with the discovered unit
type.
Correct the problem by removing the offending map
desc and reset the FieldServer for the change to take
effect
This message is printed when you have specified a
DAP:#36
FYI. Can’t write until
unit type is known. Will
retry. Map Descriptor=
<%s>
write with a DA_Field but no DA_Function. Under these
circumstances the driver cannot write until it knows the
Unit Type of the device. If you are polling using the
‘Everything’ function then the driver will obtain the unit
type in time and the error will not be reproduced.
7
Edit the CSV file and reset the FieldServer for the changes to take effect.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
Err. Map Descriptor=
<%s> Cant write '%s'
(%d:%d) to a unit= %d
FYI.
Configured/Reported
Unit Types don’t
match. Node= <%s>
The DA_Field and DA_Function type specified are not
suitable for the Unit_Type found
This message may be safely ignored. If the discovered
type is what you expect then change the CSV file and
reset the FieldServer for you changes to have effect.
You may safely ignore this message. If is for your
information only. If you set the poll delay too short the
driver will overwrite your value. The message reports
the fact and indicates the minimum poll delay. You
DAP:#39
FYI. Poll Delay set to
min of %.1f secs
should note the poll delay as it affects performance.
If you see this message printed report the fact to FST
immediately.
You may safely ignore this message. If is for your
information only. It records the fact that a special poll
has been sent.
From 1.06d some write through capability was provided
when variables in the ‘Everything’ array are updated.
Only those variables which result in a DAP80-MENU
command being sent are supported.
The Write Through Failed because the map entry could
not be found. The map entry index is calculated by
using the cache Map Descriptor normalized address
and subtracting the Data Array offset. If the method is
failing with error adjust your configuration so that the
Data Array Offset is zero. After downloading the
modified config and resetting the FieldServer if the error
DAP:#42
Err. Write abandoned.
Map Descriptor=<%s>
Addr=%d. Map Entry
not found
still occurs then take a log and send the log with the
configuration to FieldServer’s Tech support
Appendix D.1. Exposing Driver Statistics
In addition to the standard FieldServer communication statistics described in the FieldServer
Configuration Manual, the DAP Driver can also expose some driver statistics by writing data
to a Data Array. A special Map Descriptor named "dap-stats" is required.
Nodes
Node_name, Protocol, Station
null_node , DAP , 1
The driver uses the Data Array DA_DAP _STATS (in this example) to store driver specific
statistics in the dap-stats Map Descriptor. Only one of these Map Descriptors may be
specified per FieldServer.
The variables in a DAP device are not individually addressable. When a DAP device is read
a data composite is returned and the driver extracts the required data. When data is written
to a DAP device it is not possible to write a value to one individual data element such as a
temperature setpoint. Rather, the DAP devices requires the complete data composite (all its
variables, states, settings) be written at once. This makes the setting of a setpoint a
complex operation for the driver.
It involves the following steps
a. Read the device, obtain a complete set of data and store (internally in the driver.).
b. Use this stored data to form the basis for a write. Modify the data with the data the
user wishes to set.
c. Write the modified data composite back to the DAP device.
Thus to complete a 'write' operation successfully, the device must be read successfully. If
the read has not been completed then the write operation will be abandoned. The driver
prints messages to the error logs and records a NODE_OFFLINE stat under these
circumstances.
Appendix E.2. Associated Map Descriptors
When writing to a DAP device it is possible to associate Map Descriptors using the
DA_Assoc parameter. T his is straightforward using WRBC or RDBC. When using WRBX
to trigger the writes on change, however, the function of the associated Map Descriptors
must be passive if the upstream device block writes the data. The following diagram
outlines the required strategy.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
The DAP-Config command is an exception to the above notes. A read is not required.
The DAP Config command is used to turn off/on DAP units. The Command uses two
consecutive array elements. The first is the zone, the second is the inhibit command. Valid
zones are 0-63.
If any inhibit bit (bits 0-5) is set then the unit will not run. If bits 0 to 5 are off then the unit
will run. Bits 6& 7 are used for display only on the DAP panel.
0x01 - Inhibit Cooling
0x02 - Inhibit Heating
0x04 - Inhibit Humid
0x08 - Inhibit Dehumidification
0x10 - Inhibit fan
0x20 - Reserved
0x40 - Network Standby - Display on panel (only has no effect on unit)
0x80 - Network off inhibit is active - display only - no effect on operation
This function should be used as a wrbc/x. When the driver encounters this command it
reads the associated Data Array, loads the two elements found at the array offset into the
message and transmits the message. The driver does not set any Data Array elements to
confirm that the command concluded successfully.
Additional information is provided in Appendix B.10
Appendix E.4. DAP Unit Errors
Dap-Stat Query
The following table provides information on the storage of errors obtained in response to the
Dap-Stat Query. Note that the errors are stored two ways – One storage method stores 8
alarm bits at a time in a single array element (stored as byte values) – The other method
stores each alarm at a different location in the Data Array.
Byte Bit
0 0
0 1
0 2
0 3
Location in
Data Array
(Absolute
Offset
0 73 44:00 N/A
1 74 44:01
2 75 44:02
3 76 44:03
Offset) Each
a separate bit
Location in
Array
Offs
of 8 alarms
stored as a
byte*
046, 048 and 049 Units DAP 80 Units
Manual Override:
check bypass switch
( DapII ver 5.0 or
later)
High Pressure Failure
Compressor No. 1
High Pressure Failure
Compressor No. 2
High Pressure Failure
Compressor No. 3
Water detected
under floor: check
probe
No air flow: check
belt and motor
Dirty filter: check
filters
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
Discharge air temperature
limit (just a condition)
Reheat mode during
dehumidification (just a
condition)
43:00 Indicates array
element zero. Individual
alarm can be found by
masking and looking at
the zero'th bit of this
element.
N/A
N/A
N/A
N/A
N/A
Chiller Stat Query
Unlike the Dap-Stat errors, these are stored in the Data Array using only one method –
each error is stored at a separate location in the Data Array.
Location in Data Array
(Absolute Offset) Each alarm
stored as a separate bit
536 Auxiliary cooling available 0 0
537 Auxiliary cooling locked out 0 1
538 Unit on backup module standby 0 2
539 Custom message on optional input #1 0 3
540 Custom message on optional input #2 0 4
541 Evaporator freeze stat module #1 0 5
542 Evaporator freeze stat module #2 0 6
543 Evaporator freeze stat module #3 0 7
544 High pressure problem module #1 1 0
545 High pressure problem module #2 1 1
546 High pressure problem module #3 1 2
547 High return temperature warning 1 3
548 High supply temperature warning 1 4
549 Local alarm #1: See tag inside door 1 5
Alarm / Bit Descriptions Byte Bit
Relative
Offset
0
1
2
3
4
5
6
7
8
9
10
11
12
13
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
Appendix E.5. Using DA_Assoc correctly with Writes/Toggling Values
Association of Map Descriptors can result in zero’s being written to the DAP device. The
following information can help to prevent this problem. When Map Descriptors are
associated using the same value for the DA_Assoc parameter then the associated Map
Descriptors are all processed before a write is sent to the DAP unit. A write to a DAP unit
writes a complex set of data – it is not possible to write a single variable’s value to a DAP
device. Each associated Map Descriptor is used to update the complex set of data that will
be written.
If an upstream device writes a value to DA_SETPOINTS Offset 0, when the write is done the
values of DA_SETPOINTS Offset 0 AND Offset 1 are both used to build the complex data
set since the Map Descriptors are associated. If the upstream device has never set the
value of DA_SETPOINTS offset 1, the value will be zero and hence a value of zero would
be written to the DAP’s Temperature Setpoint.
This could be avoided by not associating the Map Descriptors. This will, however, result in
extra write messages being sent to the DAP device. The extra messages could be avoided
by changing the wrbc to a wrbx. If you do this you must still consider the effects of
association and in this case it may be best to have each Map Descriptor defined as a wrbx
with a different value for DA_Assoc.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
This driver provides very limited Write Through Support.
It is possible to generate a Write Through by writing to the Data Array used in a read Map
Descriptor where the DA_Func keyword is ‘Everything’ provided that the write through results in
Dap80-Menu command being sent to the DAP device. This is true for variables whose offsets
are between 899 and 1086 in Section Appendix A.3
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com