1. Download and extract libplctag package that is available at https://github.com/libplctag/libplctag/releases. For example, libplctag_2.6.4_windows_x64.zip.
2. Execute Allen-Bradley Server simulator, creating some tags:

   1. cd \libplctag_2.6.4_windows_x64\ 
      
      .\ab_server --plc=ControlLogix --path=1,0 --port=4400 --tag=MESSAGE:STRING[10] --tag=SCADA:dint[10] --tag=TEMPERATURE:real[1]  --tag=OUT_TEMP:real[1]

   2. This instruction executes the Allen-Bradley server simulator of type Control Logix, on Port 4400, creating 4 tags: SCADA, MESSAGE, TEMPERATURE and OUT_TEMP—the first two with ten elements each, the last two with only one element each.
   3. Leave it running.
3. Execute tag_rw2 to write some data to the Allen-Bradley Server simulator.

   1. cd \libplctag_2.6.4_windows_x64\
      
      .\tag_rw2 --type="sint32" --tag="protocol=ab-eip&gateway=localhost:4400&path=1,0&plc=controllogix&elem_count=10&name=SCADA" --debug=1 --write=10,20,30,40,50,60,70,80,90,100 --timeout=1000
      
      .\tag_rw2 --type="real32" --tag="protocol=ab-eip&gateway=localhost:4400&path=1,0&plc=controllogix&elem_count=1&name=TEMPERATURE" --write=35.3 --timeout=1000
      
      .\tag_rw2 --type="string" --tag="protocol=ab-eip&gateway=127.0.0.1:4400&path=1,0&plc=controllogix&elem_count=5&name=MESSAGE" --debug=1 --write="check temperature","a1","a2","a3","a4" --timeout=1000

Note There is also a Linux version of this simulator.

1. Start the FairCom browser-based tools.
   1. The tools icons appear.
2. Select and log into Data Explorer.
   1. The Data Explorer interface window appears.
3. Click the API Explorer tab.
   1. The API Explorer interface opens and the Server navigation window shows that you are connected to the "faircom" database and the FairCom server. Use the "faircom" database or another database you create to store the "customer tables".

1. Select Hub API from the Select API dropdown menu.
2. Select createInput from the JSON Actions dropdown menu.
3. Replace the JSON in the API Request editor with the following JSON:

   1. {
         "api":"hub",
         "action":"createInput",
         "params":{
            "inputName":"abTest1",
            "serviceName":"ab",
            "tableName":"abTable1",
            "dataCollectionIntervalMilliseconds":5000,
            "settings":{
               "dataReadingTimeoutMilliseconds":4000,
               "dataCollectionBufferCount":1,
               "plcAddress":"localhost:4400",
               "plcType":"controllogix",
               "propertyMapList":[
                  {
                     "eipTagPath":"1,0",
                     "eipTagName":"SCADA",
                     "eipTagElementCount":5,
                     "eipTagType":"int32",
                     "propertyPath":"scada"
                  },
                  {
                     "eipTagPath":"1,0",
                     "eipTagName":"TEMPERATURE",
                     "eipTagType":"float32",
                     "propertyPath":"temperature"
                  },
                  {
                     "eipTagPath":"1,0",
                     "eipTagName":"MESSAGE",
                     "eipTagType":"string",
                     "eipTagSize":20,
                     "propertyPath":"message"
                  }
               ]
            }
         },
         "authToken": "replaceWithAuthTokenFromCreateSession"
      }

4. This request reads 5 elements from the tag "scada", and 1 element from the other tags.
5. Click Apply defaults to JSON request to replace the "authToken" value with the valid one from your session.
6. Click Send request to issue the JSON-based request.
7. Observe the response and ensure the action is completed successfully.

Note An "errorCode" with a value of 0 indicates success. An "errorCode" with a non-zero value indicates a failure. See Errors and contact FairCom for more information about an error.

1. Start the FairCom Data Explorer
2. Navigate to and select abTest1 in the Server navigation window through faircom>admin>Tables.
3. Click the Table Records tab.
4. Select a record and click the source_payload field.
5. Observe the JSON contents of the field. Click the "edit" icon of the source_payload field to see the content formatted as JSON.

Note If the table has no records, look at <faircom>/data/CTSTATUS.FCS to see errors related to the connector.

1. Select MQ API from the Select API dropdown menu.
2. Select configureTopic from the JSON Actions dropdown menu.
3. Replace the JSON in the API Request editor with the following JSON:

   1. {
        "api": "mq",
        "action": "configureTopic",
        "params":
        {
          "topic": "abTopic",
          "databaseName": "faircom",
          "tableName": "abTable1"
        },
        "authToken": "replaceWithAuthTokenFromCreateSession"
      }

4. Click Send request.
5. Observe the response and ensure the action is completed successfully.

1. Start the FairCom Browser-Based tools.
2. Select and connect to MQ Explorer.
3. Select MQTT Management from the Control menu.
4. Click Subscribe to open the Manage Subscriptions window.
5. Select the topic you subscribed to from the Topic dropdown menu.
6. Click + Subscribe.
7. Close the Manage Subscriptions window.
8. Observe your message, displayed under Incoming Messages every 10 seconds.
9. Click Subscribe.
10. Delete your subscription from the list.

1. Select DB API from the Select API dropdown menu.
2. Select the getRecordsByIndex from the JSON Actions dropdown menu.
3. Replace the JSON in the API Request editor with the following JSON:

   1. {
        "api": "db",
        "action": "getRecordsByIndex",
        "params": {
          "databaseName": "faircom",
          "tableName": "abTable1",
          "indexName": "ts_index"
        },
        "authToken": "replaceWithAuthTokenFromCreateSession"
      }

4. Click Send request.
5. Observe the API Response response and ensure the action is completed successfully.
    

Send data to the Allen-Bradley simulator

It is also possible to send data back to the Allen-Bradley server simulator. For instance, you can copy the value from the temperature field in the abTable1 integration table to the OUT_TEMP tag created earlier when server was initialized. 

Create an output with the following JSON action:

{
 "action": "createOutput",
 "params": {
   "outputName": "abOutput",
   "serviceName": "ab",
   "databaseName": "faircom",
   "tableName": "abTable1",
   "settings": {
     "plcAddress": "localhost:4400",
     "plcType": "controllogix",
     "propertyMapList": [
       {
         "eipTagPath": "1,0",
         "eipTagName": "OUT_TEMP",
         "eipTagType": "float32",
         "propertyPath": "temperature"
       }
     ]
   }
 },
 "authToken": "replaceWithAuthTokenFromCreateSession"
}

You can verify that the value of temperature has been written in the OUT_TEMP tag using the command

.\tag_rw2 --type="real32" --tag="protocol=ab-eip&gateway=localhost:4400&path=1,0&plc=controllogix&elem_count=1&name=OUT_TEMP" --timeout=1000 

The output of the previous command should contain this line, which confirms that the value has been written correctly.

data[0]=35.299999