diff --git a/protocol.py b/protocol.py
new file mode 100644
--- /dev/null
+++ b/protocol.py
@@ -0,0 +1,73 @@
+import json
+
+_protocol_def = None
+
+with open('hydrobot_def.json') as def_file:
+    _protocol_def = json.load(def_file)
+
+def lookup_device_name_by_id(id):
+    devices = _protocol_def['devices']
+    for device in devices:
+        if device.get('id') == "{0:#0{1}x}".format(id, 4):
+            return device.get('name')
+
+def lookup_device_id_by_name(name):
+    devices = _protocol_def['devices']
+    for device in devices:
+        if device.get('name') == name:
+            return int(device.get('id'), 16)
+        
+def lookup_device_display_by_id(id):
+    devices = _protocol_def['devices']
+    for device in devices:
+        if device.get('id') == "{0:#0{1}x}".format(id, 4):
+            return device.get('display')
+        
+def lookup_device_class_by_id(id):
+    devices = _protocol_def['devices']
+    for device in devices:
+        if device.get('id') == "{0:#0{1}x}".format(id, 4):
+            return device.get('class')
+        
+def lookup_device_display_by_name(name):
+    devices = _protocol_def['devices']
+    for device in devices:
+        if device.get('name') == name:
+            return device.get('display')
+
+def lookup_data_name_by_key(key):
+    data_keys = _protocol_def['data_keys']
+    for data_key in data_keys:
+        if data_key.get('key') == "{0:#0{1}x}".format(key, 6):
+            return data_key.get('name')
+
+def lookup_data_key_by_name(name):
+    data_keys = _protocol_def['data_keys']
+    for data_key in data_keys:
+        if data_key.get('name') == name:
+            return int(data_key.get('key'), 16)
+
+def lookup_data_display_by_key(key):
+    data_keys = _protocol_def['data_keys']
+    for data_key in data_keys:
+        if data_key.get('key') == "{0:#0{1}x}".format(key, 6):
+            return data_key.get('display')
+
+def lookup_command_name_by_key(key):
+    commands = _protocol_def['command_keys']
+    for command in commands:
+        if command.get('key') == "{0:#0{1}x}".format(key, 6):
+            return command.get('name')
+
+def lookup_command_key_by_name(name):
+    commands = _protocol_def['command_keys']
+    for command in commands:
+        if command.get('name') == name:
+            return int(command.get('key'), 16)
+
+def lookup_command_display_by_key(key):
+    commands = _protocol_def['command_keys']
+    for command in commands:
+        if command.get('key') == "{0:#0{1}x}".format(key, 6):
+            return command.get('display')
+