Issue
In firmware 2.19.1, the MPM Modbus Generic Driver feature has been introduced with little to no explanation on how to use it
Product Line
EcoStruxure Building Expert
Environment
Multi Purpose Manager (MPM)
Cause
Sample CSV file not available on MPM
Resolution
In order to establish communication with a modbus device, a CSV (comma separated values) file of a certain format must be uploaded to the GMC1 object. Once uploaded the file will be visible in the drop-down list.
Requirements and Limitations
Only holding registers are supported at this time (Modbus function codes 3 and 16)
The CSV file mast be renamed Modbus_[label].csv where label is the name of the device or a label to help identification (e.g. Modbus_SE8000.csv)
Write only registers are not supported
It is not possible to use a more than 32 bits variable in write mode
It is not possible to leave a blank column in CSV register configuration file except the last column
It is not possible to create a continuous register table using different variable types
The CSV file must have the following format:
modbus_addr,register_type,label,access,factor,unit
Download example here (The text file can be viewed in a text editor but its extension must renamed to csv before uploading it to the MPM) modbus_addr:
modbus register address (Decimal number between 1 and 65535) register_type:
"uint" (UI16)
"int" (SI16)
"float" (F32)
"ulong" (UI32)
"int64" (SI64)
"uint64" (UI64)
label: name for this register, this will also be used to populate the associated object in the MPM Alphanumeric value between 1 and 32 characters. No special characters (comma, simple quotes, double quotes,%,&,@,#, etc.) access: read or read_write. read will only poll register based on driver availability (30 seconds typical) read_write will monitor for a change of value of the associated point, which will then generate a write event to the device with this new value factor: multiplier / gain Float number, typical between 0.001 and 65535. Typical use are factors of 10: (1,10,100, etc) This factor is multiplied when reading and is divided when writing. unit: BACnet unit, used for the object units in the MPM. Number from the following list:
169
ampere square meters
3
Amperes
167
amperes per meter
168
amperes per square meter
55
bars
20
BTUs
50
btus per hour
117
btus per pound
24
btus per pound dry air
179
candelas
180
candelas per square meter
118
centimeters
60
centimeters of mercury
57
centimeters of water
79
cubic feet
84
cubic feet per minute
142
cubic feet per second
80
cubic meters
135
cubic meters per hour
165
cubic meters per minute
85
cubic meters per second
105
currency1
114
currency10
106
currency2
107
currency3
108
currency4
109
currency5
110
currency6
111
currency7
112
currency8
113
currency9
25
cycles per hour
26
cycles per minute
70
days
65
degree days celsius
66
degree days fahrenheit
90
degrees angular
62
degrees celsius
91
degrees celsius per hour
92
degrees celsius per minute
64
degrees fahrenheit
93
degrees fahrenheit per hour
94
degrees fahrenheit per minute
63
degrees kelvin
181
degrees kelvin per hour
182
degrees kelvin per minute
14
Degrees Phase
120
delta degrees fahrenheit
121
delta degrees kelvin
170
farads
33
feet
77
feet per minute
76
feet per second
38
foot candles
28
grams of water per kilogram dry air
155
grams per minute
154
grams per second
133
hectopascals
171
henrys
27
hertz
51
horsepower
71
hours
158
hundredths seconds
81
imperial gallons
86
imperial gallons per minute
32
inches
61
inches of mercury
58
inches of water
183
joule seconds
16
Joules
127
joules per degree kelvin
128
joules per kilogram degree kelvin
23
Joules/Kilogram Dry Air
147
kilo btus
157
kilo btus per hour
39
kilograms
186
kilograms per cubic meter
44
kilograms per hour
43
kilograms per minute
42
kilograms per second
129
kilohertz
122
kiloohms
17
Kilojoules
151
kilojoules per degree kelvin
125
kilojoules per kilogram
149
kilojoules per kilogram dry air
75
kilometers per hour
54
kilopascals
9
Kilovolt Amperes
12
Kilovolt Amperes Reactive
19
Kilowatt Hours
48
kilowatts
6
KVs
138
kw hours per square foot
137
kw hours per square meter
82
liters
136
liters per hour
88
liters per minute
87
liters per second
36
lumens
37
luxes
148
mega btus
130
megahertz
126
megajoules
152
megajoules per degree kelvin
150
megajoules per kilogram dry air
140
megajoules per square foot
139
megajoules per square meter
10
Megavolt Amperes
13
Megavolt Amperes Reactive
146
megawatt hours
49
megawatts
123
megohms
31
meters
164
meters per hour
163
meters per minute
74
meters per second
166
meters per second per second
78
miles per hour
2
Milliamperes
134
millibars
30
millimeters
59
millimeters of mercury
162
millimeters per minute
161
millimeters per second
145
milliohms
159
milliseconds
124
millivolts
132
milliwatts
72
minutes
68
months
7
MVs
153
newton
160
newton meters
187
newton seconds
188
newtons per meter
95
no units
172
ohm meters
4
Ohms
97
parts per billion
96
parts per million
53
pascals
131
per hour
100
per minute
101
per second
98
percent
143
percent obscuration per foot
144
percent obscuration per meter
99
percent per second
29
percent relative humidity
56
pounds force per square inch
40
pounds mass
46
pounds mass per hour
45
pounds mass per minute
119
pounds mass per second
15
Power Factor
102
psi per degree fahrenheit
103
radians
184
radians per second
104
revolutions per minute
73
seconds
173
siemens
174
siemens per meter
116
square centimeters
1
Square Feet
115
square inches
0
Square Meters
185
square meters per newton
175
teslas
21
Therms
22
Ton Hours
41
tons
156
tons per hour
52
tons refrigeration
83
us gallons
89
us gallons per minute
8
Volt Amperes
11
Volt Amperes Reactive
5
Volts
176
volts per degree kelvin
177
volts per meter
18
Watt Hours
47
watts
189
watts per meter per degree kelvin
34
watts per square foot
35
watts per square meter
141
watts per square meter degree kelvin
178
webers
69
weeks
67
years
View full article