OpenFMB Adapter Configuration Tool (OACT) is a desktop application used to generate adapter configuration files (in YAML format), which direct how the adapter behaves at runtime and detail the mappings between legacy protocols to OpenFMB profile messages.

Each instance of OpenFMB Adapter requires an Adapter Configuration file (aka Main Configuration file) that specify:

• What plug-ins (aka software modules) would be activated at runtime

• How the plug-in would behave at runtime

• How to translate data points from a device to OpenFMB profile messages

• How to update device data points from a OpenFMB control message

The OpenFMB Adapter Configuration Tool (OACT) which has two main functionalities:

• Create main Adapter Configuration file

• Create template file detailing the mappings between legacy protocols and OpenFMB messages

A main Adapter Configuration file consists of two sections:

Logging Section: specify application level logging parameters

Plugins Section: specify plugins and plug-in specific configurations. There are different plug-ins supported by the Adapter:

• Capture: captures and saves OpenFMB messages to local files
• Replay: reads and replays OpenFMB messages from local files
• Dnp3-master: protocol plug-in that acquires measurement/status data from a DNP3 outstation and sends control data to DNP3 outstation
• Dnp3-outstation: exposes OpenFMB reading and status profiles as DNP3 outstation and translate DNP3 commands to OpenFMB control messages
• Modbus-master: protocol plug-in that acquires measurement/status data from a MODBUS server and sends control data to MODBUS server
• Modbus-outstation: exposes OpenFMB reading and status profiles as MODBUS server and translate MODBUS write commands to OpenFMB control messages
• Goose-pub: protocol plug-in that subscribe to GOOSE events and publish OpenFMB message
• Goose-sub: protocol plug-in that subscribe to OpenFMB message and publish GOOSE events
• MQTT: pub/sub transport protocol used to publish and subscribe OpenFMB messages
• NATS: pub/sub transport protocol used to publish and subscribe OpenFMB messages
• TimescaleDB: time series database to store basic electrical measurements and/or to persist OpenFMB messages

A protocol plug-in (DNP3 master/outstation, MODBUS master/outstation, GOOSE pub/sub) can have one or more sessions associated with it. A session represents an interactive data interchange between the Adapter and the connecting device.

A session configuration is usually referenced to a profile mapping file. The profile mapping files are also known as the template files. A template file intends to be re-used and shared among sessions that speaks the same protocol to the same device types. In YAML file, it is depicted as below: