--- a/modbus/mb_runtime.c Fri Dec 25 17:11:38 2020 +0000
+++ b/modbus/mb_runtime.c Thu Jan 28 14:17:40 2021 +0000
@@ -200,12 +200,36 @@
-static int __read_inbits (void *mem_map, u16 start_addr, u16 bit_count, u8 *data_bytes)
- {return __pack_bits(((server_mem_t *)mem_map)->ro_bits, start_addr, bit_count, data_bytes);}
-static int __read_outbits (void *mem_map, u16 start_addr, u16 bit_count, u8 *data_bytes)
- {return __pack_bits(((server_mem_t *)mem_map)->rw_bits, start_addr, bit_count, data_bytes);}
-static int __write_outbits (void *mem_map, u16 start_addr, u16 bit_count, u8 *data_bytes)
- {return __unpack_bits(((server_mem_t *)mem_map)->rw_bits, start_addr, bit_count, data_bytes); }
+static int __read_inbits (void *mem_map, u16 start_addr, u16 bit_count, u8 *data_bytes) { + int res = __pack_bits(((server_mem_t *)mem_map)->ro_bits, start_addr, bit_count, data_bytes); + /* update the counter of Modbus requests we have processed. */ + ((server_mem_t *)mem_map)->flag_read_req_counter++; +static int __read_outbits (void *mem_map, u16 start_addr, u16 bit_count, u8 *data_bytes) { + int res = __pack_bits(((server_mem_t *)mem_map)->rw_bits, start_addr, bit_count, data_bytes); + /* update the counter of Modbus requests we have processed. */ + ((server_mem_t *)mem_map)->flag_read_req_counter++; +static int __write_outbits (void *mem_map, u16 start_addr, u16 bit_count, u8 *data_bytes) { + int res = __unpack_bits(((server_mem_t *)mem_map)->rw_bits, start_addr, bit_count, data_bytes); + /* update the counter of Modbus requests we have processed. */ + ((server_mem_t *)mem_map)->flag_write_req_counter++; @@ -214,6 +238,9 @@
if ((start_addr + word_count) > MEM_AREA_SIZE)
return -ERR_ILLEGAL_DATA_ADDRESS; /* ERR_ILLEGAL_DATA_ADDRESS defined in mb_util.h */
+ /* update the counter of Modbus requests we have processed. */ + ((server_mem_t *)mem_map)->flag_read_req_counter++; /* use memcpy() because loop with pointers (u16 *) caused alignment problems */
memcpy(/* dest */ (void *)data_words,
/* src */ (void *)&(((server_mem_t *)mem_map)->ro_words[start_addr]),
@@ -228,6 +255,9 @@
if ((start_addr + word_count) > MEM_AREA_SIZE)
return -ERR_ILLEGAL_DATA_ADDRESS; /* ERR_ILLEGAL_DATA_ADDRESS defined in mb_util.h */
+ /* update the counter of Modbus requests we have processed. */ + ((server_mem_t *)mem_map)->flag_read_req_counter++; /* use memcpy() because loop with pointers (u16 *) caused alignment problems */
memcpy(/* dest */ (void *)data_words,
/* src */ (void *)&(((server_mem_t *)mem_map)->rw_words[start_addr]),
@@ -243,6 +273,9 @@
if ((start_addr + word_count) > MEM_AREA_SIZE)
return -ERR_ILLEGAL_DATA_ADDRESS; /* ERR_ILLEGAL_DATA_ADDRESS defined in mb_util.h */
+ /* update the counter of Modbus requests we have processed. */ + ((server_mem_t *)mem_map)->flag_write_req_counter++; /* WARNING: The data returned in the data_words[] array is not guaranteed to be 16 bit aligned.
* It is not therefore safe to cast it to an u16 data type.
* The following code cannot be used. memcpy() is used instead.
@@ -545,6 +578,8 @@
// -1 --> modbus node created!; no thread created
// >=0 --> modbus node created!; thread created!
server_nodes[index].mb_nd = -2;
+ server_nodes[index].mem_area.flag_write_req_counter = 0; + server_nodes[index].mem_area.flag_read_req_counter = 0; /* see comment in mb_runtime.h to understad why we need to initialize these entries */
switch (server_nodes[index].node_address.naf) {
--- a/modbus/mb_runtime.h Fri Dec 25 17:11:38 2020 +0000
+++ b/modbus/mb_runtime.h Thu Jan 28 14:17:40 2021 +0000
@@ -41,6 +41,15 @@
u16 rw_bits [MEM_AREA_SIZE];
u16 ro_words[MEM_AREA_SIZE];
u16 rw_words[MEM_AREA_SIZE];
+ /* Two flags to count the number of Modbus requests (read and write) we have + * successfully received from any remote Modbus master + * These two flags will be mapped onto located variables + * so the user's IEC 61131-3 code can check whether we are being + * polled by a Modbus master. + * The counters will roll over to 0 upon reaching maximum value. + u32 flag_write_req_counter; + u32 flag_read_req_counter; @@ -89,6 +98,8 @@
node_addr_t node_address;
int mb_nd; // modbus library node used for this server
int init_state; // store how far along the server's initialization has progressed
+ /* entries from this point forward are not statically initialized when the variable is declared */ + /* they will be initialized by the code itself in the init() function */ pthread_t thread_id; // thread handling this server
--- a/modbus/modbus.py Fri Dec 25 17:11:38 2020 +0000
+++ b/modbus/modbus.py Thu Jan 28 14:17:40 2021 +0000
@@ -447,6 +447,62 @@
""" Return the node's Configuration_Name """
return self.ModbusServerNode.getConfiguration_Name()
+ def GetVariableLocationTree(self): + current_location = self.GetCurrentLocation() + name = self.BaseParams.getName() + # start off with flags that count the number of Modbus requests/transactions + # handled by this Modbus server/slave. + # These flags are mapped onto located variables and therefore available to the user programs + # May be used to detect communication errors. + # execute the Modbus request. + # NOTE: If the Modbus slave has a 'current_location' of + # then the "Modbus Read Request Counter" will be + # then the "Modbus Write Request Counter" will be + # Note that any MemoryArea contained under this server/slave + # will ocupy the locations of type + # which will never clash with the %MD used here. + # Additionaly, any MemoryArea contained under this server/slave + # will ocupy locations with + # %M1.2.a.b (with a and b being numbers in range 0, 1, ...) + # and therefore never ocupy the locations + # used by the following flags/counters. + "name": "Modbus Read Request Counter", + "type": LOCATION_VAR_MEMORY, + "size": 32, # UDINT flag + "IEC_type": "UDINT", # UDINT flag + "var_name": "var_name", + "location": "D" + ".".join([str(i) for i in current_location]) + ".0", + "description": "Modbus read request counter", + "name": "Modbus Write Request Counter", + "type": LOCATION_VAR_MEMORY, + "size": 32, # UDINT flag + "IEC_type": "UDINT", # UDINT flag + "var_name": "var_name", + "location": "D" + ".".join([str(i) for i in current_location]) + ".1", + "description": "Modbus write request counter", + # recursively call all the Memory Areas under this Modbus server/save + # i.e., all the children objects which will be of class _MemoryAreaPlug + for child in self.IECSortedChildren(): + entries.append(child.GetVariableLocationTree()) + "type": LOCATION_CONFNODE, + "location": ".".join([str(i) for i in current_location]) + ".x", def CTNGenerate_C(self, buildpath, locations):
@@ -631,6 +687,62 @@
""" Return the node's Configuration_Name """
return self.ModbusRTUslave.getConfiguration_Name()
+ def GetVariableLocationTree(self): + current_location = self.GetCurrentLocation() + name = self.BaseParams.getName() + # start off with flags that count the number of Modbus requests/transactions + # handled by this Modbus server/slave. + # These flags are mapped onto located variables and therefore available to the user programs + # May be used to detect communication errors. + # execute the Modbus request. + # NOTE: If the Modbus slave has a 'current_location' of + # then the "Modbus Read Request Counter" will be + # then the "Modbus Write Request Counter" will be + # Note that any MemoryArea contained under this server/slave + # will ocupy the locations of type + # which will never clash with the %MD used here. + # Additionaly, any MemoryArea contained under this server/slave + # will ocupy locations with + # %M1.2.a.b (with a and b being numbers in range 0, 1, ...) + # and therefore never ocupy the locations + # used by the following flags/counters. + "name": "Modbus Read Request Counter", + "type": LOCATION_VAR_MEMORY, + "size": 32, # UDINT flag + "IEC_type": "UDINT", # UDINT flag + "var_name": "var_name", + "location": "D" + ".".join([str(i) for i in current_location]) + ".0", + "description": "Modbus read request counter", + "name": "Modbus Write Request Counter", + "type": LOCATION_VAR_MEMORY, + "size": 32, # UDINT flag + "IEC_type": "UDINT", # UDINT flag + "var_name": "var_name", + "location": "D" + ".".join([str(i) for i in current_location]) + ".1", + "description": "Modbus write request counter", + # recursively call all the Memory Areas under this Modbus server/save + # i.e., all the children objects which will be of class _MemoryAreaPlug + for child in self.IECSortedChildren(): + entries.append(child.GetVariableLocationTree()) + "type": LOCATION_CONFNODE, + "location": ".".join([str(i) for i in current_location]) + ".x", def CTNGenerate_C(self, buildpath, locations):
@@ -819,29 +931,50 @@
new_node = GetTCPServerNodePrinted(self, child)
- server_node_list.append(new_node)
+ server_node_list.append(new_node) + # We currently add 2 flags/counters to each Modbus server/slave + # We add the "Execution Control Flag" to each client request (one flag per request) + # to allow the user program to control when to execute the request (if not executed periodically) + # While all Modbus registers/coils are mapped onto a location + # with 4 numbers (e.g. %QX0.1.2.55), this control flag is mapped + # onto a location with 4 numbers (e.g. %QX0.1.2.0.0), where the last + # two numbers are always '0.0', and the first two identify the request. + # In the following if, we check for this condition by checking + # if there are at least 4 or more number in the location's address. + for iecvar in child.GetLocations(): + #print "child" + repr(iecvar) + if (len(iecvar["LOC"]) == 3) and (str(iecvar["NAME"]) not in loc_vars_list): + # Add if it is a "Modbus Read Request Counter" (mapped onto %MDa.b.0), so last number is a '0' + if iecvar["LOC"][2] == 0: + loc_vars.append("u32 *" + str(iecvar["NAME"]) + " = &server_nodes[%d].mem_area.flag_read_req_counter;" % (server_id)) + loc_vars_list.append(str(iecvar["NAME"])) + # Add if it is a "Modbus Write Request Counter" (mapped onto %MDa.b.1), so last number is a '1' + if iecvar["LOC"][2] == 1: + loc_vars.append("u32 *" + str(iecvar["NAME"]) + " = &server_nodes[%d].mem_area.flag_write_req_counter;" % (server_id)) + loc_vars_list.append(str(iecvar["NAME"])) for subchild in child.IECSortedChildren():
- new_memarea = GetTCPServerMemAreaPrinted(
- self, subchild, nodeid)
+ new_memarea = GetTCPServerMemAreaPrinted(self, subchild, nodeid) server_memarea_list.append(new_memarea)
- function = subchild.GetParamsAttributes()[
- 0]["children"][0]["value"]
+ function = subchild.GetParamsAttributes()[0]["children"][0]["value"] # 'ro_bits', 'rw_bits', 'ro_words' or 'rw_words'
memarea = modbus_memtype_dict[function][1]
for iecvar in subchild.GetLocations():
- absloute_address = iecvar["LOC"][3]
- start_address = int(GetCTVal(subchild, 2))
- relative_addr = absloute_address - start_address
- # test if relative address in request specified range
- if relative_addr in xrange(int(GetCTVal(subchild, 1))):
- if str(iecvar["NAME"]) not in loc_vars_list:
- loc_vars.append("u16 *" + str(iecvar["NAME"]) + " = &server_nodes[%d].mem_area.%s[%d];" % (
- server_id, memarea, absloute_address))
- loc_vars_list.append(str(iecvar["NAME"]))
+ if len(iecvar["LOC"]) == 4: + #print "subchild" + repr(iecvar) + absloute_address = iecvar["LOC"][3] + start_address = int(GetCTVal(subchild, 2)) + relative_addr = absloute_address - start_address + # test if relative address in request specified range + if relative_addr in xrange(int(GetCTVal(subchild, 1))): + if str(iecvar["NAME"]) not in loc_vars_list: + loc_vars.append("u16 *" + str(iecvar["NAME"]) + " = &server_nodes[%d].mem_area.%s[%d];" % ( + server_id, memarea, absloute_address)) + loc_vars_list.append(str(iecvar["NAME"])) if child.PlugType == "ModbusRTUslave":
@@ -857,21 +990,21 @@
server_memarea_list.append(new_memarea)
- function = subchild.GetParamsAttributes()[
- 0]["children"][0]["value"]
+ function = subchild.GetParamsAttributes()[0]["children"][0]["value"] # 'ro_bits', 'rw_bits', 'ro_words' or 'rw_words'
memarea = modbus_memtype_dict[function][1]
for iecvar in subchild.GetLocations():
- absloute_address = iecvar["LOC"][3]
- start_address = int(GetCTVal(subchild, 2))
- relative_addr = absloute_address - start_address
- # test if relative address in request specified range
- if relative_addr in xrange(int(GetCTVal(subchild, 1))):
- if str(iecvar["NAME"]) not in loc_vars_list:
- loc_vars.append("u16 *" + str(iecvar["NAME"]) + " = &server_nodes[%d].mem_area.%s[%d];" % (
- server_id, memarea, absloute_address))
- loc_vars_list.append(str(iecvar["NAME"]))
+ if len(iecvar["LOC"]) == 4: + absloute_address = iecvar["LOC"][3] + start_address = int(GetCTVal(subchild, 2)) + relative_addr = absloute_address - start_address + # test if relative address in request specified range + if relative_addr in xrange(int(GetCTVal(subchild, 1))): + if str(iecvar["NAME"]) not in loc_vars_list: + loc_vars.append("u16 *" + str(iecvar["NAME"]) + " = &server_nodes[%d].mem_area.%s[%d];" % ( + server_id, memarea, absloute_address)) + loc_vars_list.append(str(iecvar["NAME"])) if child.PlugType == "ModbusTCPclient":