User Defined I/O Board

SimWB has a mechanism to allow the user to integrate 3rd party boards natively supported by SimWB into the general SimWB I/O framework.
When integrating a non native SimWB board, the user is responsible for writing their own I/O tasks following the general SimWB guidelines.
Both synchronous and asynchronous User I/O tasks can be integrated in SimWB. You can request source code for SimWB skeleton I/O tasks from support@ccur.com

The SimWB GUI Control Center provides a panel for mapping user defined hardware records to RTDB items. The hardware records can be created independently by editing the hardwarerecord.db file in the RTDB folder but can also be created/edited through the SimWB GUI.

Reference Information

I/O Card Model Number

N/A

I/O Driver Model Number

N/A

I/O Module License:

N/A

User Defined Mapping

Mapping Record Format

The user defined mapping records defined through the GUI are formatted similarly to hardware records associated with native SimWB I/O boards.

I.e they are defined as a list of comma separated keyword=value fields. The record prefix is common for all SimWB mapping records and does not need to be specified in the list of keywords. The common prefix is :

mappingrecord=UNIQUE_KEY,boardid=MYBOARDID,boardnum=x,type=[IN|OUT]

The keywords can be any user defined string but should consist of alphanumeric characters (except space) only. No special characters like =,;/, etc.

The value can be any character strings. Be aware that no validation is provided by the GUI as to the expected data type of the value associated to the keyword.
I.e. if your I/O task expect an integer value for the keyword called 'param1' in the mapping record and you defined the value as 'ABCDEF in the GUI, the I/O task must be able to handle to erroneous value.

Mapping Definition

Before mapping a RTDB item to the user I/O board, you must create a mapping record.
A SimWB mapping is uniquely associated with a I/O direction. Either input or output.

Create a new mapping record by clicking on the 'New mapping' Button. The record will be create with a default keyword. You can edit the keyword and value by clicking on them in the table and editing in place. Add or remove keywords to/from the mapping using the / buttons to the right of the keyword table.

For your convenience, after creating a mapping record, you can duplicate it by using the 'Duplicate mapping' button.

Delete a mapping record by clicking on the Delete mapping' button.

After create a mapping record, you can associate it to a RTDB item by selecting the record and clicking on the item checkbox in the item list in the right panel.

Board Settings

Generic Settings

The Control Center also provides a generic mechanism to associate parameters with a user defined board.

Up to 4 integer, 4 float and 4 string parameters can be set. Data entry validation is provided according to parameter data type.

The parameters will be saved in the RTDB folder on the SimWB real-time host in the file named 'MYBORADID.x' where x is the board instance number.

I/O Task

The user is responsible for writing the I/O tasks associated with user defined boards. Please follow the guidelines from the reference skeleton code provided to you.