From 726b00ad9a2bd76045aa5ee8d1d234ece09ae6a3 Mon Sep 17 00:00:00 2001
From: Patrick McDonagh <pmcdonagh@henry-pump.com>
Date: Thu, 5 Jan 2017 17:20:44 -0600
Subject: [PATCH] Working on POC-108. Reading holding registers confirmed
 working

---
 Modbus Map.xlsx  | Bin 0 -> 67446 bytes
 README.md        |   6 ++
 analog.json      | 149 +++++++++++++++++++++++++++++++++
 arraylist.json   |   4 +
 digital.json     |  31 +++++++
 plc_to_mongo.py  |  90 ++++++++++++++++++++
 poc-to-modbus.py |  85 -------------------
 poc_to_modbus.py | 209 +++++++++++++++++++++++++++++++++++++++++++++++
 test.py          |  79 ++++++++++++++++++
 9 files changed, 568 insertions(+), 85 deletions(-)
 create mode 100644 Modbus Map.xlsx
 create mode 100644 README.md
 create mode 100644 analog.json
 create mode 100644 arraylist.json
 create mode 100644 digital.json
 create mode 100644 plc_to_mongo.py
 delete mode 100644 poc-to-modbus.py
 create mode 100644 poc_to_modbus.py
 create mode 100644 test.py

diff --git a/Modbus Map.xlsx b/Modbus Map.xlsx
new file mode 100644
index 0000000000000000000000000000000000000000..6b20116931317ba94d21428799cb98a29426076b
GIT binary patch
literal 67446
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

literal 0
HcmV?d00001

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3fc29e0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,6 @@
+# Modbus Register Map
+
+## Coils
+
+Reg. #  | Description           | Access    |
+1       | 
diff --git a/analog.json b/analog.json
new file mode 100644
index 0000000..1864a69
--- /dev/null
+++ b/analog.json
@@ -0,0 +1,149 @@
+[
+    {"tag_name": "_Firmware_Rev", "register_type": "ir", "register_number": 1, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "_Program_Firmware", "register_type": "ir", "register_number": 6, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[1].Card_Type", "register_type": "ir", "register_number": 11, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[1].Downhole_AdjustedGrossStroke", "register_type": "ir", "register_number": 16, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[1].Downhole_FluidLoad", "register_type": "ir", "register_number": 21, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[1].Downhole_GrossStroke", "register_type": "ir", "register_number": 26, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[1].Downhole_Max_Load.Load", "register_type": "ir", "register_number": 31, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[1].Downhole_Max_Position.Position", "register_type": "ir", "register_number": 36, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[1].Downhole_Min_Load.Load", "register_type": "ir", "register_number": 41, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[1].Downhole_Min_Position.Position", "register_type": "ir", "register_number": 46, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[1].Downhole_NetStroke", "register_type": "ir", "register_number": 51, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[1].Fillage_Percent", "register_type": "ir", "register_number": 56, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[1].Fluid_Above_Pump", "register_type": "ir", "register_number": 61, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[1].Fluid_Moved", "register_type": "ir", "register_number": 66, "scale_type": 0, "scale_multiplier": 10000},
+    {"tag_name": "Card_Past[1].ID", "register_type": "ir", "register_number": 71, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[1].Num_Points", "register_type": "ir", "register_number": 76, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[1].Polished_Rod_HP", "register_type": "ir", "register_number": 81, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[1].Pump_HP", "register_type": "ir", "register_number": 86, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[1].Pump_Intake_Pressure", "register_type": "ir", "register_number": 91, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[1].SPM", "register_type": "ir", "register_number": 96, "scale_type": 0, "scale_multiplier": 1000},
+    {"tag_name": "Card_Past[1].Surface_Max.Load", "register_type": "ir", "register_number": 101, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[1].Surface_Max.Position", "register_type": "ir", "register_number": 106, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[1].Surface_Min.Load", "register_type": "ir", "register_number": 111, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[1].Surface_Min.Position", "register_type": "ir", "register_number": 116, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[1].Surface_StrokeLength", "register_type": "ir", "register_number": 121, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[1].Tubing_Movement", "register_type": "ir", "register_number": 126, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[2].Card_Type", "register_type": "ir", "register_number": 131, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[2].Downhole_AdjustedGrossStroke", "register_type": "ir", "register_number": 136, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[2].Downhole_FluidLoad", "register_type": "ir", "register_number": 141, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[2].Downhole_GrossStroke", "register_type": "ir", "register_number": 146, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[2].Downhole_Max_Load.Load", "register_type": "ir", "register_number": 151, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[2].Downhole_Max_Position.Position", "register_type": "ir", "register_number": 156, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[2].Downhole_Min_Load.Load", "register_type": "ir", "register_number": 161, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[2].Downhole_Min_Position.Position", "register_type": "ir", "register_number": 166, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[2].Downhole_NetStroke", "register_type": "ir", "register_number": 171, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[2].Fillage_Percent", "register_type": "ir", "register_number": 176, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[2].Fluid_Above_Pump", "register_type": "ir", "register_number": 181, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[2].Fluid_Moved", "register_type": "ir", "register_number": 186, "scale_type": 0, "scale_multiplier": 10000},
+    {"tag_name": "Card_Past[2].ID", "register_type": "ir", "register_number": 191, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[2].Num_Points", "register_type": "ir", "register_number": 196, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[2].Polished_Rod_HP", "register_type": "ir", "register_number": 201, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[2].Pump_HP", "register_type": "ir", "register_number": 206, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[2].Pump_Intake_Pressure", "register_type": "ir", "register_number": 211, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[2].SPM", "register_type": "ir", "register_number": 216, "scale_type": 0, "scale_multiplier": 1000},
+    {"tag_name": "Card_Past[2].Surface_Max.Load", "register_type": "ir", "register_number": 221, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[2].Surface_Max.Position", "register_type": "ir", "register_number": 226, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[2].Surface_Min.Load", "register_type": "ir", "register_number": 231, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[2].Surface_Min.Position", "register_type": "ir", "register_number": 236, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[2].Surface_StrokeLength", "register_type": "ir", "register_number": 241, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[2].Tubing_Movement", "register_type": "ir", "register_number": 246, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[3].Card_Type", "register_type": "ir", "register_number": 251, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[3].Downhole_AdjustedGrossStroke", "register_type": "ir", "register_number": 256, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[3].Downhole_FluidLoad", "register_type": "ir", "register_number": 261, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[3].Downhole_GrossStroke", "register_type": "ir", "register_number": 266, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[3].Downhole_Max_Load.Load", "register_type": "ir", "register_number": 271, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[3].Downhole_Max_Position.Position", "register_type": "ir", "register_number": 276, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[3].Downhole_Min_Load.Load", "register_type": "ir", "register_number": 281, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[3].Downhole_Min_Position.Position", "register_type": "ir", "register_number": 286, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[3].Downhole_NetStroke", "register_type": "ir", "register_number": 291, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[3].Fillage_Percent", "register_type": "ir", "register_number": 296, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[3].Fluid_Above_Pump", "register_type": "ir", "register_number": 301, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[3].Fluid_Moved", "register_type": "ir", "register_number": 306, "scale_type": 0, "scale_multiplier": 10000},
+    {"tag_name": "Card_Past[3].ID", "register_type": "ir", "register_number": 311, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[3].Num_Points", "register_type": "ir", "register_number": 316, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[3].Polished_Rod_HP", "register_type": "ir", "register_number": 321, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[3].Pump_HP", "register_type": "ir", "register_number": 326, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[3].Pump_Intake_Pressure", "register_type": "ir", "register_number": 331, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[3].SPM", "register_type": "ir", "register_number": 336, "scale_type": 0, "scale_multiplier": 1000},
+    {"tag_name": "Card_Past[3].Surface_Max.Load", "register_type": "ir", "register_number": 341, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[3].Surface_Max.Position", "register_type": "ir", "register_number": 346, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[3].Surface_Min.Load", "register_type": "ir", "register_number": 351, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[3].Surface_Min.Position", "register_type": "ir", "register_number": 356, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[3].Surface_StrokeLength", "register_type": "ir", "register_number": 361, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[3].Tubing_Movement", "register_type": "ir", "register_number": 366, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[4].Card_Type", "register_type": "ir", "register_number": 371, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[4].Downhole_AdjustedGrossStroke", "register_type": "ir", "register_number": 376, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[4].Downhole_FluidLoad", "register_type": "ir", "register_number": 381, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[4].Downhole_GrossStroke", "register_type": "ir", "register_number": 386, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[4].Downhole_Max_Load.Load", "register_type": "ir", "register_number": 391, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[4].Downhole_Max_Position.Position", "register_type": "ir", "register_number": 396, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[4].Downhole_Min_Load.Load", "register_type": "ir", "register_number": 401, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[4].Downhole_Min_Position.Position", "register_type": "ir", "register_number": 406, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[4].Downhole_NetStroke", "register_type": "ir", "register_number": 411, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[4].Fillage_Percent", "register_type": "ir", "register_number": 416, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[4].Fluid_Above_Pump", "register_type": "ir", "register_number": 421, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[4].Fluid_Moved", "register_type": "ir", "register_number": 426, "scale_type": 0, "scale_multiplier": 10000},
+    {"tag_name": "Card_Past[4].ID", "register_type": "ir", "register_number": 431, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[4].Num_Points", "register_type": "ir", "register_number": 436, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[4].Polished_Rod_HP", "register_type": "ir", "register_number": 441, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[4].Pump_HP", "register_type": "ir", "register_number": 446, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[4].Pump_Intake_Pressure", "register_type": "ir", "register_number": 451, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[4].SPM", "register_type": "ir", "register_number": 456, "scale_type": 0, "scale_multiplier": 1000},
+    {"tag_name": "Card_Past[4].Surface_Max.Load", "register_type": "ir", "register_number": 461, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[4].Surface_Max.Position", "register_type": "ir", "register_number": 466, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[4].Surface_Min.Load", "register_type": "ir", "register_number": 471, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Card_Past[4].Surface_Min.Position", "register_type": "ir", "register_number": 476, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[4].Surface_StrokeLength", "register_type": "ir", "register_number": 481, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Card_Past[4].Tubing_Movement", "register_type": "ir", "register_number": 486, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Drive_Speed_Reference_SP", "register_type": "ir", "register_number": 491, "scale_type": 0, "scale_multiplier": 10},
+    {"tag_name": "Drive_Torque_Percent", "register_type": "ir", "register_number": 496, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "GAUGEOFF_Average_SPM", "register_type": "ir", "register_number": 501, "scale_type": 0, "scale_multiplier": 1000},
+    {"tag_name": "GAUGEOFF_Downhole_GrossStroke", "register_type": "ir", "register_number": 506, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "GAUGEOFF_Downhole_NetStroke", "register_type": "ir", "register_number": 511, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "GAUGEOFF_Electricity_Cost", "register_type": "ir", "register_number": 516, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "GAUGEOFF_Fluid_Above_Pump", "register_type": "ir", "register_number": 521, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "GAUGEOFF_Inflow_Rate", "register_type": "ir", "register_number": 526, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "GAUGEOFF_kWh", "register_type": "ir", "register_number": 531, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "GAUGEOFF_kWh_Regen", "register_type": "ir", "register_number": 536, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "GAUGEOFF_Lifting_Cost", "register_type": "ir", "register_number": 541, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "GAUGEOFF_Max_Load", "register_type": "ir", "register_number": 546, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "GAUGEOFF_Min_Load", "register_type": "ir", "register_number": 551, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "GAUGEOFF_Percent_Run", "register_type": "ir", "register_number": 556, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "GAUGEOFF_Polished_Rod_HP", "register_type": "ir", "register_number": 561, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "GAUGEOFF_Pump_Intake_Pressure", "register_type": "ir", "register_number": 566, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "GAUGEOFF_Surface_StrokeLength", "register_type": "ir", "register_number": 571, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "GAUGEOFF_Tubing_Movement", "register_type": "ir", "register_number": 576, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Gearbox_Loading", "register_type": "ir", "register_number": 581, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Gearbox_Torque", "register_type": "ir", "register_number": 586, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Input_Analog_1_AIN.Val", "register_type": "ir", "register_number": 591, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Input_Analog_2_AIN.Val", "register_type": "ir", "register_number": 596, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Input_Analog_3_AIN.Val", "register_type": "ir", "register_number": 601, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Instantaneous_SPM", "register_type": "ir", "register_number": 606, "scale_type": 0, "scale_multiplier": 10},
+    {"tag_name": "kWh_Today", "register_type": "ir", "register_number": 611, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Max_Theoretical_Fluid_Load", "register_type": "ir", "register_number": 616, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Motor_Torque", "register_type": "ir", "register_number": 621, "scale_type": 0, "scale_multiplier": 100},
+
+    {"tag_name": "_dt", "register_type": "hr", "register_number": 1, "scale_type": 0, "scale_multiplier": 1000},
+    {"tag_name": "Casing_ID", "register_type": "hr", "register_number": 6, "scale_type": 0, "scale_multiplier": 1000},
+    {"tag_name": "Drive_Start_Speed", "register_type": "hr", "register_number": 11, "scale_type": 0, "scale_multiplier": 10},
+    {"tag_name": "Electricity_Cost", "register_type": "hr", "register_number": 16, "scale_type": 0, "scale_multiplier": 1000},
+    {"tag_name": "Estimated_Tubing_Movement", "register_type": "hr", "register_number": 21, "scale_type": 0, "scale_multiplier": 100},
+    {"tag_name": "Fluid_Gradient", "register_type": "hr", "register_number": 26, "scale_type": 0, "scale_multiplier": 1000},
+    {"tag_name": "Friction", "register_type": "hr", "register_number": 31, "scale_type": 0, "scale_multiplier": 10},
+    {"tag_name": "Gauge_Off_Time.Hour", "register_type": "hr", "register_number": 36, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Gauge_Off_Time.Min", "register_type": "hr", "register_number": 41, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Input_Analog_1_AIN.Cfg_PVEUMax", "register_type": "hr", "register_number": 46, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Input_Analog_1_AIN.Cfg_PVEUMin", "register_type": "hr", "register_number": 51, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Input_Analog_2_AIN.Cfg_PVEUMax", "register_type": "hr", "register_number": 56, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Input_Analog_2_AIN.Cfg_PVEUMin", "register_type": "hr", "register_number": 61, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Input_Analog_3_AIN.Cfg_PVEUMax", "register_type": "hr", "register_number": 66, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Input_Analog_3_AIN.Cfg_PVEUMin", "register_type": "hr", "register_number": 71, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Input_Inclinometer_AIN.Cfg_PVEUMax", "register_type": "hr", "register_number": 76, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Input_Inclinometer_AIN.Cfg_PVEUMin", "register_type": "hr", "register_number": 81, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Input_LoadCell_AIN.Cfg_PVEUMax", "register_type": "hr", "register_number": 86, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "Input_LoadCell_AIN.Cfg_PVEUMin", "register_type": "hr", "register_number": 91, "scale_type": 0, "scale_multiplier": 1},
+    {"tag_name": "K_Factor", "register_type": "hr", "register_number": 96, "scale_type": 0, "scale_multiplier": 1000},
+    {"tag_name": "Min_Fluid_Load_Shutdown_Setpoint", "register_type": "hr", "register_number": 101, "scale_type": 0, "scale_multiplier": 1}
+]
diff --git a/arraylist.json b/arraylist.json
new file mode 100644
index 0000000..221a9a5
--- /dev/null
+++ b/arraylist.json
@@ -0,0 +1,4 @@
+
+[
+
+]
diff --git a/digital.json b/digital.json
new file mode 100644
index 0000000..3d1232d
--- /dev/null
+++ b/digital.json
@@ -0,0 +1,31 @@
+[
+    {"tag_name": "_TOC_ACCEPTED", "register_type": "co", "register_number": 1},
+    {"tag_name": "Autotune_Next_Start", "register_type": "co", "register_number": 2},
+    {"tag_name": "Gas_Interference_Override_Enabled", "register_type": "co", "register_number": 3},
+    {"tag_name": "Gauge_Off_Manual", "register_type": "co", "register_number": 4},
+    {"tag_name": "Initialize", "register_type": "co", "register_number": 5},
+    {"tag_name": "Input_Analog_1.Channel", "register_type": "co", "register_number": 6},
+    {"tag_name": "Input_Analog_1.Enabled", "register_type": "co", "register_number": 7},
+    {"tag_name": "Input_Analog_1.Type", "register_type": "co", "register_number": 8},
+    {"tag_name": "Input_Analog_2.Channel", "register_type": "co", "register_number": 9},
+    {"tag_name": "Input_Analog_2.Enabled", "register_type": "co", "register_number": 10},
+    {"tag_name": "Input_Analog_2.Type", "register_type": "co", "register_number": 11},
+    {"tag_name": "Input_Analog_3.Channel", "register_type": "co", "register_number": 12},
+    {"tag_name": "Input_Analog_3.Enabled", "register_type": "co", "register_number": 13},
+    {"tag_name": "Input_Analog_3.Type", "register_type": "co", "register_number": 14},
+    {"tag_name": "Input_Inclinometer_Calibrate", "register_type": "co", "register_number": 15},
+    {"tag_name": "Input_Inclinometer.Channel", "register_type": "co", "register_number": 16},
+    {"tag_name": "Input_Inclinometer.Enabled", "register_type": "co", "register_number": 17},
+    {"tag_name": "Input_Inclinometer.Type", "register_type": "co", "register_number": 18},
+    {"tag_name": "Input_LoadCell.Channel", "register_type": "co", "register_number": 19},
+    {"tag_name": "Input_LoadCell.Enabled", "register_type": "co", "register_number": 20},
+    {"tag_name": "Input_LoadCell.Type", "register_type": "co", "register_number": 21},
+    {"tag_name": "Min_Fluid_Load_Shutdown_Enabled", "register_type": "co", "register_number": 22},
+    {"tag_name": "Restart_After_Fault_Allowed", "register_type": "co", "register_number": 23},
+    {"tag_name": "Update_Tapers", "register_type": "co", "register_number": 24},
+    {"tag_name": "USE_WIRELESS_LOADCELL", "register_type": "co", "register_number": 25},
+    {"tag_name": "Write_Mode_Data", "register_type": "co", "register_number": 26},
+    {"tag_name": "Write_Setup_Data", "register_type": "co", "register_number": 27},
+    {"tag_name": "Inclinometer_Calibrating", "register_type": "di", "register_number": 1},
+    {"tag_name": "Inclinometer_Stale", "register_type": "di", "register_number": 2}
+]
diff --git a/plc_to_mongo.py b/plc_to_mongo.py
new file mode 100644
index 0000000..8b5ad50
--- /dev/null
+++ b/plc_to_mongo.py
@@ -0,0 +1,90 @@
+import pymongo
+import json
+from time import sleep
+from time import time as now
+from pymongo import MongoClient
+import pycomm_helper.utils as plc
+
+PLC_IP_ADDRESS = '10.20.4.7'
+
+
+def main():
+    client = MongoClient()
+    db = client.tag_data
+
+    tag_vals = db.tag_vals
+    print("THERE ARE ALREADY {} VALUES IN tag_vals".format(tag_vals.count()))
+    with open('analog.json', 'rb') as analogfile:
+        analog_list = json.loads(analogfile.read())
+
+    with open('digital.json', 'rb') as digitalfile:
+        digital_list = json.loads(digitalfile.read())
+
+    with open('arraylist.json', 'rb') as arrayfile:
+        arr_list = []  # json.loads(arrayfile.read())
+
+    for entry in analog_list + digital_list + arr_list:
+        if tag_vals.find({'tag_name': entry['tag_name']}).count() < 1:
+            tag_vals.insert(entry)
+    print("NOW THERE ARE {} VALUES IN tag_vals".format(tag_vals.count()))
+
+    while True:
+        for t in analog_list:
+            try:
+                plc_val = plc.readTag(PLC_IP_ADDRESS, t['tag_name'])
+                if plc_val:
+                    t['tag_type'] = plc_val[1]
+                    t['val_actual'] = plc_val[0]
+                    t['timestamp'] = now()
+                    if int(t['scale_type']) == 0:
+                        t['val'] = int(plc_val[0] * t['scale_multiplier'])
+                    else:
+                        t['val'] = int(plc_val[0] / t['scale_multiplier'])
+                    tag_vals.update({'tag_name': t['tag_name']}, t)
+                    print("Updated: {}".format(tag_vals.find({'tag_name': t['tag_name']})[0]))
+            except Exception as e:
+                print("[ERROR] {} - {}".format(t['tag_name'], e))
+
+        for t in digital_list:
+            try:
+                plc_val = plc.readTag(PLC_IP_ADDRESS, t['tag_name'])
+                if plc_val:
+                    t['tag_type'] = plc_val[1]
+                    t['val'] = plc_val[0]
+                    t['timestamp'] = now()
+                    tag_vals.update({'tag_name': t['tag_name']}, t)
+                    print("Updated: {}".format(tag_vals.find({'tag_name': t['tag_name']})[0]))
+            except Exception as e:
+                print("[ERROR] {} - {}".format(t['tag_name'], e))
+
+        for a in arr_list:
+            try:
+                plc_val = plc.readArray(PLC_IP_ADDRESS, str(a['tag_name']), int(a['length']))
+                if plc_val:
+                    a['val'] = plc_val
+                    a['tag_type'] = 'ARRAY'
+                    t['timestamp'] = now()
+                    tag_vals.update({'tag_name': a['tag_name']}, a)
+                    print("Updated: {}".format(tag_vals.find({'tag_name': a['tag_name']})[0]))
+            except Exception as e:
+                print("[ERROR] {} - {}".format(a['tag_name'], e))
+
+        sleep(5)
+
+
+def purge():
+    client = MongoClient()
+    db = client.tag_data
+
+    tag_vals = db.tag_vals
+    tag_vals.delete_many({})
+    print("THERE ARE {} VALUES IN tag_vals".format(tag_vals.count()))
+
+if __name__ == '__main__':
+    import sys
+    if len(sys.argv) > 1:
+        if sys.argv[1] == 'purge':
+            print("Purging...")
+            purge()
+    else:
+        main()
diff --git a/poc-to-modbus.py b/poc-to-modbus.py
deleted file mode 100644
index 46a35d7..0000000
--- a/poc-to-modbus.py
+++ /dev/null
@@ -1,85 +0,0 @@
-#!/usr/bin/env python3
-'''
-Pymodbus Server With Updating Thread
---------------------------------------------------------------------------
-
-This is an example of having a background thread updating the
-context while the server is operating. This can also be done with
-a python thread::
-
-    from threading import Thread
-
-    thread = Thread(target=updating_writer, args=(context,))
-    thread.start()
-'''
-# ---------------------------------------------------------------------------#
-# import the modbus libraries we need
-# ---------------------------------------------------------------------------#
-from pymodbus.server.async import StartTcpServer
-from pymodbus.device import ModbusDeviceIdentification
-from pymodbus.datastore import ModbusSequentialDataBlock
-from pymodbus.datastore import ModbusSlaveContext, ModbusServerContext
-# from pymodbus.transaction import ModbusRtuFramer, ModbusAsciiFramer
-
-# ---------------------------------------------------------------------------#
-# import the twisted libraries we need
-# ---------------------------------------------------------------------------#
-from twisted.internet.task import LoopingCall
-
-# ---------------------------------------------------------------------------#
-# configure the service logging
-# ---------------------------------------------------------------------------#
-import logging
-logging.basicConfig()
-log = logging.getLogger()
-log.setLevel(logging.DEBUG)
-
-
-# ---------------------------------------------------------------------------#
-# define your callback process
-# ---------------------------------------------------------------------------#
-def updating_writer(a):
-    ''' A worker process that runs every so often and
-    updates live values of the context. It should be noted
-    that there is a race condition for the update.
-
-    :param arguments: The input arguments to the call
-    '''
-    log.debug("updating the context")
-    context = a[0]
-    register = 3
-    slave_id = 0x00
-    address = 0x10
-    values = context[slave_id].getValues(register, address, count=5)
-    values = [v + 1 for v in values]
-    log.debug("new values: " + str(values))
-    context[slave_id].setValues(register, address, values)
-
-# ---------------------------------------------------------------------------#
-# initialize your data store
-# ---------------------------------------------------------------------------#
-store = ModbusSlaveContext(
-    di=ModbusSequentialDataBlock(0, [17]*100),
-    co=ModbusSequentialDataBlock(0, [17]*100),
-    hr=ModbusSequentialDataBlock(0, [17]*100),
-    ir=ModbusSequentialDataBlock(0, [17]*100))
-context = ModbusServerContext(slaves=store, single=True)
-
-# ---------------------------------------------------------------------------#
-# initialize the server information
-# ---------------------------------------------------------------------------#
-identity = ModbusDeviceIdentification()
-identity.VendorName = 'pymodbus'
-identity.ProductCode = 'PM'
-identity.VendorUrl = 'http://github.com/bashwork/pymodbus/'
-identity.ProductName = 'pymodbus Server'
-identity.ModelName = 'pymodbus Server'
-identity.MajorMinorRevision = '1.0'
-
-# ---------------------------------------------------------------------------#
-# run the server you want
-# ---------------------------------------------------------------------------#
-time = 5  # 5 seconds delay
-loop = LoopingCall(f=updating_writer, a=(context,))
-loop.start(time, now=False)  # initially delay by time
-StartTcpServer(context, identity=identity, address=("localhost", 5020))
diff --git a/poc_to_modbus.py b/poc_to_modbus.py
new file mode 100644
index 0000000..a8aff9e
--- /dev/null
+++ b/poc_to_modbus.py
@@ -0,0 +1,209 @@
+#!/usr/bin/env python
+'''
+Pymodbus Server With Callbacks
+--------------------------------------------------------------------------
+
+This is an example of adding callbacks to a running modbus server
+when a value is written to it. In order for this to work, it needs
+a device-mapping file.
+'''
+# ---------------------------------------------------------------------------#
+# import the modbus libraries we need
+# ---------------------------------------------------------------------------#
+from pymodbus.server.async import StartTcpServer
+from pymodbus.device import ModbusDeviceIdentification
+from pymodbus.datastore import ModbusSparseDataBlock
+from pymodbus.datastore import ModbusSlaveContext, ModbusServerContext
+from pymodbus.transaction import ModbusRtuFramer, ModbusAsciiFramer
+
+# ---------------------------------------------------------------------------#
+# import the python libraries we need
+# ---------------------------------------------------------------------------#
+import pymongo
+from pymongo import MongoClient
+from pycomm_helper import utils as plc
+from time import time as now
+# ---------------------------------------------------------------------------#
+# configure the service logging
+# ---------------------------------------------------------------------------#
+import logging
+logging.basicConfig()
+log = logging.getLogger()
+log.setLevel(logging.DEBUG)
+
+PLC_IP_ADDRESS = '10.20.4.7'
+
+
+def getTagsFromDB():
+    client = MongoClient()
+    db = client.tag_data
+    tags = db.tag_vals
+    print("Found {} tags in the database".format(tags.count()))
+    di_tags_cur = tags.find({'register_type': 'di'})
+    di_tags = list(di_tags_cur)
+    di_tags_num = di_tags_cur.count()
+    print("{} Digital Inputs".format(di_tags_num))
+
+    co_tags_cur = tags.find({'register_type': 'co'})
+    co_tags = list(co_tags_cur)
+    co_tags_num = co_tags_cur.count()
+    print("{} Coils".format(co_tags_num))
+
+    ir_tags_cur = tags.find({'register_type': 'ir'})
+    ir_tags = list(ir_tags_cur)
+    ir_tags_num = ir_tags_cur.count()
+    print("{} Input Registers".format(ir_tags_num))
+
+    hr_tags_cur = tags.find({'register_type': 'hr'})
+    hr_tags = list(hr_tags_cur)
+    hr_tags_num = hr_tags_cur.count()
+    print("{} Holding Registers".format(hr_tags_num))
+
+    return {'di': di_tags, 'co': co_tags, 'ir': ir_tags, 'hr': hr_tags}
+
+
+# ---------------------------------------------------------------------------#
+# create your custom data block with callbacks
+# ---------------------------------------------------------------------------#
+class DigitalTagDataBlock(ModbusSparseDataBlock):
+    ''' A datablock that stores the new value in memory
+    and passes the operation to a message queue for further
+    processing.
+    '''
+
+    def __init__(self, register_type, tag_list):
+        '''
+        '''
+        values = {}
+        self.register_type = register_type
+
+        for t in tag_list:
+            try:
+                values[t['register_number']] = t['val']
+            except KeyError:
+                values[t['register_number']] = 911
+        # print("Initialized DigitalTagDataBlock for {} with values {}".format(self.register_type, values))
+        super(DigitalTagDataBlock, self).__init__(values)
+
+    def getValues(self, address, count=1):
+        client = MongoClient()
+        db = client.tag_data
+        tags = db.tag_vals
+
+        if count > 1:
+            for i in range(address, address + count):
+                tag_found = tags.find_one({'register_number': i, 'register_type': self.register_type})
+                print("{} = {}".format(tag_found['tag_name'], tag_found['val']))
+                super(DigitalTagDataBlock, self).setValues(address, tag_found['val'])
+        else:
+            tag_found = tags.find_one({'register_number': address, 'register_type': self.register_type})
+            print("{} = {}".format(tag_found['tag_name'], tag_found['val']))
+            super(DigitalTagDataBlock, self).setValues(address, tag_found['val'])
+
+        return super(DigitalTagDataBlock, self).getValues(address, count=count)
+
+    def setValues(self, address, value):
+        ''' Sets the requested values of the datastore
+
+        :param address: The starting address
+        :param values: The new values to be set
+        '''
+        client = MongoClient()
+        db = client.tag_data
+        tags = db.tag_vals
+        tag_name = tags.find_one({'register_number': address, 'register_type': self.register_type})['tag_name']
+        plc.writeTag(PLC_IP_ADDRESS, tag_name, value)
+
+
+class AnalogTagDataBlock(ModbusSparseDataBlock):
+    ''' A datablock that stores the new value in memory
+    and passes the operation to a message queue for further
+    processing.
+    '''
+
+    def __init__(self, register_type, tag_list):
+        '''
+        '''
+        values = {}
+        self.register_type = register_type
+
+        for t in tag_list:
+            try:
+                values[t['register_number']] = t['val']
+                values[t['register_number'] + 1] = t['scale_type']
+                values[t['register_number'] + 2] = t['scale_multiplier']
+                values[t['register_number'] + 3] = 0
+            except KeyError:
+                values[t['register_number']] = 911
+                values[t['register_number'] + 1] = 2
+                values[t['register_number'] + 2] = 0
+                values[t['register_number'] + 3] = 0
+            values[t['register_number'] + 4] = 123
+
+        # print("Initialized AnalogTagDataBlock for {} with values {}".format(self.register_type, values))
+        super(AnalogTagDataBlock, self).__init__(values)
+
+    def getValues(self, address, count=1):
+        client = MongoClient()
+        db = client.tag_data
+        tags = db.tag_vals
+
+        if count > 1:
+            for i in range(address, address + count):
+                tag_found = tags.find_one({'register_number': i, 'register_type': self.register_type})
+                if tag_found:
+                    print("{} = {}".format(tag_found['tag_name'], tag_found['val']))
+                    super(AnalogTagDataBlock, self).setValues(address, tag_found['val'])
+                    super(AnalogTagDataBlock, self).setValues(address + 3, 0)
+        else:
+            tag_found = tags.find_one({'register_number': address, 'register_type': self.register_type})
+            if tag_found:
+                print("{} = {}".format(tag_found['tag_name'], tag_found['val']))
+                super(AnalogTagDataBlock, self).setValues(address, tag_found['val'])
+                super(AnalogTagDataBlock, self).setValues(address + 3, 0)
+
+        return super(AnalogTagDataBlock, self).getValues(address, count=count)
+
+    def setValues(self, address, value):
+        ''' Sets the requested values of the datastore
+
+        :param address: The starting address
+        :param values: The new values to be set
+        '''
+        client = MongoClient()
+        db = client.tag_data
+        tags = db.tag_vals
+        tag_name = tags.find_one({'register_number': address, 'register_type': self.register_type})['tag_name']
+        plc.writeTag(PLC_IP_ADDRESS, tag_name, value)
+
+
+def main():
+    # ---------------------------------------------------------------------------#
+    # initialize your data store
+    # ---------------------------------------------------------------------------#
+    tags_in_db = getTagsFromDB()
+    di_block = DigitalTagDataBlock('di', tags_in_db['di'])
+    co_block = DigitalTagDataBlock('co', tags_in_db['co'])
+    hr_block = AnalogTagDataBlock('hr', tags_in_db['hr'])
+    ir_block = AnalogTagDataBlock('ir', tags_in_db['ir'])
+    store = ModbusSlaveContext(di=di_block, co=co_block, hr=hr_block, ir=ir_block)
+    context = ModbusServerContext(slaves=store, single=True)
+
+    # ---------------------------------------------------------------------------#
+    # initialize the server information
+    # ---------------------------------------------------------------------------#
+    identity = ModbusDeviceIdentification()
+    identity.VendorName = 'pymodbus'
+    identity.ProductCode = 'PM'
+    identity.VendorUrl = 'http://github.com/bashwork/pymodbus/'
+    identity.ProductName = 'pymodbus Server'
+    identity.ModelName = 'pymodbus Server'
+    identity.MajorMinorRevision = '1.0'
+
+    # ---------------------------------------------------------------------------#
+    # run the server you want
+    # ---------------------------------------------------------------------------#
+    StartTcpServer(context, identity=identity, address=("localhost", 5020))
+
+if __name__ == '__main__':
+    main()
diff --git a/test.py b/test.py
new file mode 100644
index 0000000..ebb85dd
--- /dev/null
+++ b/test.py
@@ -0,0 +1,79 @@
+#!/usr/bin/env python
+'''
+Pymodbus Synchronous Client Examples
+--------------------------------------------------------------------------
+The following is an example of how to use the synchronous modbus client
+implementation from pymodbus.
+It should be noted that the client can also be used with
+the guard construct that is available in python 2.5 and up::
+    with ModbusClient('127.0.0.1') as client:
+        result = client.read_coils(1,10)
+        print result
+'''
+# ---------------------------------------------------------------------------#
+# import the various server implementations
+# ---------------------------------------------------------------------------#
+from pymodbus.client.sync import ModbusTcpClient as ModbusClient
+# from pymodbus.client.sync import ModbusUdpClient as ModbusClient
+# from pymodbus.client.sync import ModbusSerialClient as ModbusClient
+
+# ---------------------------------------------------------------------------#
+# configure the client logging
+# ---------------------------------------------------------------------------#
+import logging
+logging.basicConfig()
+log = logging.getLogger()
+log.setLevel(logging.INFO)
+# ---------------------------------------------------------------------------#
+# choose the client you want
+# ---------------------------------------------------------------------------#
+# make sure to start an implementation to hit against. For this
+# you can use an existing device, the reference implementation in the tools
+# directory, or start a pymodbus server.
+#
+# If you use the UDP or TCP clients, you can override the framer being used
+# to use a custom implementation (say RTU over TCP). By default they use the
+# socket framer::
+#
+#    client = ModbusClient('localhost', port=5020, framer=ModbusRtuFramer)
+#
+# It should be noted that you can supply an ipv4 or an ipv6 host address for
+# both the UDP and TCP clients.
+#
+# There are also other options that can be set on the client that controls
+# how transactions are performed. The current ones are:
+#
+# * retries - Specify how many retries to allow per transaction (default = 3)
+# * retry_on_empty - Is an empty response a retry (default = False)
+# * source_address - Specifies the TCP source address to bind to
+#
+# Here is an example of using these options::
+#
+#    client = ModbusClient('localhost', retries=3, retry_on_empty=True)
+# ---------------------------------------------------------------------------#
+client = ModbusClient('localhost', port=5020)
+# client = ModbusClient(method='ascii', port='/dev/pts/2', timeout=1)
+# client = ModbusClient(method='rtu', port='/dev/pts/2', timeout=1)
+client.connect()
+
+# ---------------------------------------------------------------------------#
+# specify slave to query
+# ---------------------------------------------------------------------------#
+# The slave to query is specified in an optional parameter for each
+# individual request. This can be done by specifying the `unit` parameter
+# which defaults to `0x00`
+# ---------------------------------------------------------------------------#
+print("HOLDING REGISTERS")
+for i in range(0, 21):
+    rd = client.read_holding_registers(i * 5, 5)
+    print rd.registers
+
+print("INPUT REGISTERS")
+for i in range(2, 125):
+    rd = client.read_input_registers(i * 5, 5)
+    print rd.registers
+
+# ---------------------------------------------------------------------------#
+# close the client
+# ---------------------------------------------------------------------------#
+client.close()