This project provides an extensible PLC simulation environment. The MemoryManager provides a configurable linear memory space that is independent of any particular model of PLC. The IoManager supports a number of simulation functions that can be specified to update memory locations in the MemoryManager's memory space. The FieldbusManager instantiates configured fieldbus-specific objects that simulate the request/response protocols of PLCs. The fieldbus-specific object to handle incoming requests is mapped by TCP listening port. The Listener provides a TCP/IP interface with which clients, such as the plc-data-server (PDS), can connect and query simulated PLCs.
The command line invocation is simple, requiring only the configuration file:
python plc-simulator.py plc-simulator-conf.jsonThis is an example configuration:
{
"listener": {
"host": "localhost",
"port": 5555,
"backlog": 10
},
"fieldbus_manager": {
"modules": [
{
"module": "plcsimulator.ModbusModule",
"class": "ModbusModule",
"id": "modbus",
"port": 5555,
"conf": {}
}
]
},
"memory_manager": {
"memspace": {
"blen": 0,
"w16len": 800,
"w32len": 0,
"w64len": 0
}
},
"io_manager": {
"simulations": [
{
"memspace": {"section": "words16", "addr": 0, "nwords": 1},
"function": {"type": "counter"},
"pause": 0.001
},
{
"memspace": {"section": "words16", "addr": 1, "nwords": 1},
"function": {"type": "binary"},
"pause": 5
},
{
"memspace": {"section": "words16", "addr": 2, "nwords": 1},
"function": {"type": "static", "value": 321},
"pause": 60
},
{
"memspace": {"section": "words16", "addr": 3, "nwords": 1},
"function": {"type": "sine"},
"pause": 0.001
},
{
"memspace": {"section": "words16", "addr": 4, "nwords": 1},
"function": {"type": "cosine"},
"pause": 0.001
},
{
"memspace": {"section": "words16", "addr": 5, "nwords": 1},
"function": {"type": "sawtooth"},
"pause": 0.001
},
{
"memspace": {"section": "words16", "addr": 6, "nwords": 1},
"function": {"type": "square"},
"pause": 0.001
},
{
"id": "range_counter",
"memspace": {"section": "words16", "addr": 7, "nwords": 1},
"function": {"type": "counter", "range": [10]},
"pause": 0.1
},
{
"id": "dec_range_counter",
"memspace": {"section": "words16", "addr": 8, "nwords": 1},
"function": {"type": "counter", "range": [10, 0]},
"pause": 0.1
},
{
"id": "step_range_counter",
"memspace": {"section": "words16", "addr": 9, "nwords": 1},
"function": {"type": "counter", "range": [0, 10, 2]},
"pause": 0.1
},
{
"id": "randrange",
"memspace": {"section": "words16", "addr": 10, "nwords": 1},
"function": {"type": "randrange", "range": [50, 61]},
"pause": 1
},
{
"id": "lognormal",
"memspace": {"section": "words16", "addr": 11, "nwords": 1},
"function": {"type": "lognormal"},
"pause": 1
},
{
"id": "uniform",
"memspace": {"section": "words16", "addr": 12, "nwords": 1},
"function": {"type": "uniform"},
"pause": 1
},
{
"id": "copy_source_0",
"memspace": {"section": "words16", "addr": 13, "nwords": 1},
"function": {"type": "binary"},
"pause": 15
},
{
"id": "copy_source_1",
"memspace": {"section": "words16", "addr": 14, "nwords": 1},
"function": {"type": "binary"},
"pause": 60
},
{
"id": "copy_source_2",
"memspace": {"section": "words16", "addr": 15, "nwords": 1},
"function": {"type": "binary"},
"pause": 20
},
{
"id": "copy_source_3",
"memspace": {"section": "words16", "addr": 16, "nwords": 1},
"function": {"type": "counter", "range": [80, 0]},
"pause": 1
},
{
"id": "copy_dest",
"memspace": {"section": "words16", "addr": 20, "nwords": 4},
"source": {
"memspace": {"section": "words16", "addr": 13, "nwords": 4}
},
"function": {"type": "copy"},
"pause": 1
},
{
"id": "transform_on",
"memspace": {"section": "words16", "addr": 24, "nwords": 1},
"source": {
"memspace": {"section": "words16", "addr": 16, "nwords": 1}
},
"function": {"type": "transform",
"transform": {"in": [0, 10], "out": 1}
},
"pause": 1
},
{
"id": "transform_off",
"memspace": {"section": "words16", "addr": 24, "nwords": 1},
"source": {
"memspace": {"section": "words16", "addr": 16, "nwords": 1}
},
"function": {"type": "transform",
"transform": {"in": [11, 80], "out": 0}
},
"pause": 1
}
]
},
"logging": {
"version": 1,
"handlers": {
"file": {
"class": "logging.FileHandler",
"filename": "/dev/null",
"mode": "a",
"formatter": "default"
},
"console": {
"class": "logging.StreamHandler",
"formatter": "brief"
}
},
"root": {
"level": "INFO",
"handlers": ["console", "file"]
},
"formatters": {
"default": {
"format": "%(asctime)s %(levelname)s %(threadName)s %(message)s",
"datefmt": "%Y-%m-%dT%H:%M:%S"
},
"brief": {
"format": "%(levelname)s %(threadName)s %(message)s"
}
}
}
}