A modern Python Framework for microboard automation and control applications development. Github-Rackio Framework
The complete Rackio documentation can be found in Read the Docs Rackio Framework Documentation
- Python 3.6+
- falcon
- pyBigParser
pip install Rackio
from rackio import Rackio, TagEngine
app = Rackio()
tag_engine = TagEngine()
# Tags definitions
tag_engine.set_tag("RAND1", "float")
tag_engine.set_tag("RAND2", "float")
tag_engine.set_tag("T1", "float")
tag_engine.set_tag("T2", "float")
tag_engine.set_tag("T3", "float")
if __name__ == "__main__":
app.run()Rackio comes with some built-in features that let you start creating rapid and fast coding prototypes.
Controls are objects that interact with the tags, changing their values accordingly to a condition
These actions only change tags values with a defined constant value.
from rackio.controls import Condition, ValueAction, Control
# Conditions definitions
cond1 = Condition("T1",">=", "T2")
cond2 = Condition("T1","<", "T2")
# Actions definitions
act1 = ValueAction("T3", 40)
act2 = ValueAction("T3", 80)
# Controls Definitions
control1 = Control("C1", cond1, act1)
control2 = Control("C2", cond2, act2)
app.append_control(control1)
app.append_control(control2)These actions change tags values with a defined mathematical expression, and defined tags can be used inside these expressions.
from rackio.controls import MathAction
# Conditions definitions
cond1 = Condition("T1",">=", "T2")
cond2 = Condition("T1","<", "T2")
# Actions definitions
act1 = MathAction("T3", "T1 + T2")
act2 = MathAction("T3", "T2 - T1")
# Controls Definitions
control1 = Control("C1", cond1, act1)
control2 = Control("C2", cond2, act2)
app.append_control(control1)
app.append_control(control2)Once Rackio is up and running, will trigger some actions if the associated condtions are met, by observing continously all the tags values for changes.
You can define your mathematical expression following the same arithmetic rules that python can handle, but only a set of math functions and constants are supported.
cossinabslog10logexptanpie
Rackio can be extended to add custom continous tasks and operations
@app.rackit(1)
def writer1():
tag_engine.write_tag("T1", 15)
tag_engine.write_tag("T2", 40)
direction = 1
while True:
time.sleep(0.5)
value = 24 + 2 * random()
tag_engine.write_tag("RAND1", value)
T1 = tag_engine.read_tag("T1")
T1 += direction
tag_engine.write_tag("T1", T1)
if T1 >= 60:
direction *= -1
if T1 <= 5:
direction *= -1You can register a defined function as a continous task to be perform by Rackio. You can also provide functions as tasks lists
@app.rackit_on(period=1)
def reader():
rand1 = tag_engine.read_tag("RAND1")
rand2 = tag_engine.read_tag("RAND2")
T1 = tag_engine.read_tag("T1")
T2 = tag_engine.read_tag("T2")
T3 = tag_engine.read_tag("T3")
print("")
print("RAND1: {}".format(rand1))
print("RAND2: {}".format(rand2))
print("T1 : {}".format(T1))
print("T2 : {}".format(T2))
print("T3 : {}".format(T3))By specify its period, you can keep control of the time execution for these tasks.
Once your application is up and running, it will deploy a RESTful API with falcon, and the json format is the standard supported by this API.
Once your application is up and running you can access through the API, if you want to try with httpie, you can install it with the following command:
pip install httpie
Now execute the next command in your terminal
http localhost:8000/api/tags
you will get the following
HTTP/1.0 200 OK
Date: Tue, 11 Jun 2019 23:54:55 GMT
Server: WSGIServer/0.2 CPython/3.7.1
content-length: 177
content-type: application/json[
{
"tag": "RAND1",
"value": 25.597755601381692
},
{
"tag": "RAND2",
"value": 49.12890172456638
},
{
"tag": "T1",
"value": 57
},
{
"tag": "T2",
"value": 40
},
{
"tag": "T3",
"value": 97
}
]if you want to access an specific tag, for example tag T2
http localhost:8000/api/tags/T2
you will get the following
HTTP/1.0 200 OK
Date: Tue, 11 Jun 2019 23:58:40 GMT
Server: WSGIServer/0.2 CPython/3.7.1
content-length: 26
content-type: application/json{
"tag": "T2",
"value": 40
}You can change this tag value by executing
http POST localhost:8000/api/tags/T2 value=50
And you will get the following
HTTP/1.0 200 OK
Date: Wed, 12 Jun 2019 00:01:21 GMT
Server: WSGIServer/0.2 CPython/3.7.1
content-length: 16
content-type: application/json{
"result": true
}You can read tags history using the API also
http localhost:8000/api/tags/history/RAND1
And you will get the following
HTTP/1.0 200 OK
Date: Tue, 18 Jun 2019 02:52:43 GMT
Server: WSGIServer/0.2 CPython/3.7.1
content-length: 4917
content-type: application/json{
"tag": "RAND1",
"value": [
0.0,
24.628376069489793,
25.757258388362462,
25.55412553374292,
24.555658954786043,
25.06933481716872,
25.40130983961439,
25.689521224514724,
25.81125032707667,
25.639558206736673,
25.349485473327377,
24.799801913324295,
25.227466610598572,
25.27254049615728,
25.105421823573916,
24.82832764778826,
24.65831512999663,
25.26014559203846,
25.216187451359872,
25.151243977491735
]
}This way you can create your custom HMTL and Javascript Views to perform AJAX requests on Rackio.
Rackio is work in progress framework, some features are still in development and they will be release soon for better applications, these features are listed below:
- Finish RESTful API
- Capability for users to add custom HTML files for HMI
- Token Based Authentication for API access
- Web Based Monitoring and Admin
- Alarms definitions
- Modbus and MQTT protocols
- Automatic Datalogging
- Trends and Historical data