Configuration management. A configuration consists of a group of devices, the protocol they use to communicate, and the safety parameters describing their communication. A device's configuration file can be generated after 2 conditions are satisfied. 1). A configuration must be created and configured. 2). The device as well as all other devices that will belong to the configuration have been added to it.
Search an organization's configurations
path Parameters
orgIdstring · requiredThe id of the organization.
query Parameters
SearchstringSearch text to filter the configurations by name
SortOptionsstring · enumHow to sort the list
Enum values:LastEditedASCLastEditedDESCConfigNameASCConfigNameDESCLimitinteger · int32The number of records to return. Max 30.
Pageinteger · int32The page offset when fetching the records
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Responses
Success
dataobjectsuccessbooleanerrorsarray | null
Create a device configuration
path Parameters
orgIdstring · requiredThe id of the organization.
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Request Body
namestring · minLength: 1 · requiredThe name of the configuration
startingIpAddressstring | nullThe starting ip that will be used when assigning IP network capable devices.
ismTxPowerstring · enumEnum values:MediumHighLowismTxChannelinteger | null · int32The channel number that the ISM radio will use. North America should be between(inclusive) 1 and 21. EU must be set to 1.
canModestring · enumThe CAN mode
Enum values:canopenj1939nonecanKBitratestring · enumCan bitrate options. EPC and NSCP devices can only be BITRATE_250000 and BITRATE_500000.
Enum values:BITRATE_10000BITRATE_20000BITRATE_50000BITRATE_125000BITRATE_250000BITRATE_500000BITRATE_800000BITRATE_1000000displayTextPgninteger | null · int32If CAN mode is J1939 then this can be set. If not set, it will be set to a default value of: 65281 (0xFF01). Must have a value between: 0xFF00 and 0xFFFF.
settingsPgninteger | null · int32If CAN mode is J1939 then this can be set. If not set, it will be set to a default value of: 65282 (0xFF02). Must have a value between: 0xFF00 and 0xFFFF.
approvedSourceAddressesarray | nullArray of the node ids of ECUs to listen to. Addresses must be between 0 and 255.
receiverOutputControlinteger | null · int32Which output on the receiver the sender will control. Must be 1 or 2
timeoutConfigurationstring · enumThe safety timeout delay for the configuration.
Enum values:250ms500ms750ms1000ms3000ms5000ms
Responses
Success
dataobjectsuccessbooleanerrorsarray | null
Get a configuration by id
path Parameters
idstring · uuid · requiredThe configuration id to get
The configuration id
orgIdstring · requiredThe id of the organization.
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Responses
Success
dataobjectsuccessbooleanerrorsarray | null
Delete a configuration
path Parameters
idstring · uuid · requiredThe id of the configuration to delete
The configuration id
orgIdstring · requiredThe id of the organization.
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Responses
Success
dataobjectResult returned after attempting to delete a configuration.
successbooleanerrorsarray | null
Update a configuration
path Parameters
idstring · uuid · requiredThe configuration id to update
The configuration id
orgIdstring · requiredThe id of the organization.
query Parameters
dryRunbooleanRun the operation as a dry run. Make no modifications and only return any validation errors that would be caused by the operation.
Default: false
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Request Body
namestring | nullRepresents an optional property in a patch request body
startingIpAddressstring | nullRepresents an optional property in a patch request body
ismTxPowerstring · enumEnum values:MediumHighLowismTxChannelinteger | null · int32Represents an optional property in a patch request body
canModestring · enumThe CAN mode
Enum values:canopenj1939nonecanKBitratestring · enumCan bitrate options. EPC and NSCP devices can only be BITRATE_250000 and BITRATE_500000.
Enum values:BITRATE_10000BITRATE_20000BITRATE_50000BITRATE_125000BITRATE_250000BITRATE_500000BITRATE_800000BITRATE_1000000displayTextPgninteger | null · int32Represents an optional property in a patch request body
settingsPgninteger | null · int32Represents an optional property in a patch request body
approvedSourceAddressesarray | nullRepresents an optional property in a patch request body
receiverOutputControlinteger | null · int32Represents an optional property in a patch request body
timeoutConfigurationstring · enumThe safety timeout delay for the configuration.
Enum values:250ms500ms750ms1000ms3000ms5000ms
Responses
Success
dataobjectsuccessbooleanerrorsarray | null
Get the current status of a configuration, whether it's complete or has any validation errors.
path Parameters
idstring · uuid · requiredThe configuration id to get
The configuration id
orgIdstring · requiredThe id of the organization.
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Responses
Success
dataobjectsuccessbooleanerrorsarray | null
Add a device to a configuration
path Parameters
idstring · uuid · requiredThe configuration id to add the device to
The configuration id
orgIdstring · requiredThe id of the organization.
query Parameters
dryRunbooleanRun the operation as a dry run. Make no modifications and only return any validation errors that would be caused by the operation.
Default: false
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Request Body
serialNumberstring | nullThe serial number identifying the device.
ipAddressstring | nullThe IP address of the device. Only required when configuration uses IP communications.
deviceConfigurationTypestring · enumThe role that the device will be in the configuration. All configurations must have at least one sender and one receiver.
Enum values:SenderReceiverEStopSendercommInterfacestring · enumDevice communication interface flags. Can be used individually or combined. (e.g., "Wifi", "BLE, Ethernet" or "BLE,ISM,Wifi").
Enum values:NoneBLEISMEthernetWifiinputConfiguration1string · enumInput 1's function(pin 3 and 6) on the endpoint controller's J1 connector. Input 1 must be set to NOT_USED on SRCP and WESP devices. Input 2's function(pin 2 and 5) on the endpoint controller's J1 connector. Input 2 is not applicable to NSC Pro devices that use CAT 1 stop category. Input 2 must be set to NOT_USED on SRCP and WESP devices. Must be set to NOT_USED on SRCP and WESP devices.
Enum values:NOT_USEDESTOP_TYPE_SWITCHSOLID_STATE_SAFETY_DEVICEREMOTE_SAFETY_REQUESTREMOTE_SAFETY_REQUEST_WITH_AUTONOMY_SELECTinputConfiguration2string · enumInput 1's function(pin 3 and 6) on the endpoint controller's J1 connector. Input 1 must be set to NOT_USED on SRCP and WESP devices. Input 2's function(pin 2 and 5) on the endpoint controller's J1 connector. Input 2 is not applicable to NSC Pro devices that use CAT 1 stop category. Input 2 must be set to NOT_USED on SRCP and WESP devices. Must be set to NOT_USED on SRCP and WESP devices.
Enum values:NOT_USEDESTOP_TYPE_SWITCHSOLID_STATE_SAFETY_DEVICEREMOTE_SAFETY_REQUESTREMOTE_SAFETY_REQUEST_WITH_AUTONOMY_SELECTinputConfiguration3string · enumInput 1's function(pin 3 and 6) on the endpoint controller's J1 connector. Input 1 must be set to NOT_USED on SRCP and WESP devices. Input 2's function(pin 2 and 5) on the endpoint controller's J1 connector. Input 2 is not applicable to NSC Pro devices that use CAT 1 stop category. Input 2 must be set to NOT_USED on SRCP and WESP devices. Must be set to NOT_USED on SRCP and WESP devices.
Enum values:NOT_USEDESTOP_TYPE_SWITCHSOLID_STATE_SAFETY_DEVICEREMOTE_SAFETY_REQUESTREMOTE_SAFETY_REQUEST_WITH_AUTONOMY_SELECTcan0Idinteger · int32The id of can interface
serial0Usagestring · enumNSC Pro only. The physical output interface between the FORT Pro device and your equipment under control. Can be FORT SDK(comms) or Data Output Control(control). FORT SDK and Data Output Control can each only be set on one serial at a time."
Enum values:commscontrolserial1Usagestring · enumNSC Pro only. The physical output interface between the FORT Pro device and your equipment under control. Can be FORT SDK(comms) or Data Output Control(control). FORT SDK and Data Output Control can each only be set on one serial at a time."
Enum values:commscontrolstopCategorystring · enumNSC Pro only. E-Stop category CAT0: For an EPC Sender - If ESTOP is on input #1 it disables receiver output #1; if ESTOP on input #2 it disables receiver output #2. For an SRCP transmitter - The last output of the receiver (output #2 for NSCP or output #3 for EPC) is turned off. CAT1: Output #1 of the receiver is turned off immediately, and after a user-defined delay (CAT1 Delay), output #2 of the receiver is turned off.
Enum values:CAT0CAT1cat1StopDelaynumber | null · floatDelay for the CAT1 E-Stop.
ethNetmaskstring | nullThe ethernet interface netmask. Only used in configurations that use ethernet communications
ethGatewaystring | nullThe ethernet interface gateway. Only used in configurations that use ethernet communications
ethNameserversarray | nullThe ethernet interface nameservers. Only used in configurations that use ethernet communications
wifiNetmaskstring | nullThe wifi interface netmask. Only used in configurations that use wifi communications
wifiGatewaystring | nullThe wifi interface gateway. Only used in configurations that use wifi communications
wifiNameserversarray | nullThe wifi interface nameservers
wifiSsidstring | nullThe wifi SSID
wifiPasswordstring | nullThe wifi password
networkTemplateIdstring · uuidThe network template id
Responses
Success
dataobjectsuccessbooleanerrorsarray | null
Delete a device from a configuration
path Parameters
idstring · uuid · requiredThe id of the configuration the device is in
The configuration id
serialNumberstring · requiredThe serial number identifying the device.
orgIdstring · requiredThe id of the organization.
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Responses
Success
dataobjectsuccessbooleanerrorsarray | null
Update a device on a configuration
path Parameters
idstring · uuid · requiredThe configuration id that the configuration is in
The configuration id
serialNumberstring · requiredThe serial number identifying the device.
orgIdstring · requiredThe id of the organization.
query Parameters
dryRunbooleanRun the operation as a dry run. Make no modifications and only return any validation errors that would be caused by the operation.
Default: false
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Request Body
ipAddressstring | nullRepresents an optional property in a patch request body
deviceConfigurationTypestring · enumThe role that the device will be in the configuration. All configurations must have at least one sender and one receiver.
Enum values:SenderReceiverEStopSendercommInterfacestring · enumDevice communication interface flags. Can be used individually or combined. (e.g., "Wifi", "BLE, Ethernet" or "BLE,ISM,Wifi").
Enum values:NoneBLEISMEthernetWifiinputConfiguration1string · enumInput 1's function(pin 3 and 6) on the endpoint controller's J1 connector. Input 1 must be set to NOT_USED on SRCP and WESP devices. Input 2's function(pin 2 and 5) on the endpoint controller's J1 connector. Input 2 is not applicable to NSC Pro devices that use CAT 1 stop category. Input 2 must be set to NOT_USED on SRCP and WESP devices. Must be set to NOT_USED on SRCP and WESP devices.
Enum values:NOT_USEDESTOP_TYPE_SWITCHSOLID_STATE_SAFETY_DEVICEREMOTE_SAFETY_REQUESTREMOTE_SAFETY_REQUEST_WITH_AUTONOMY_SELECTinputConfiguration2string · enumInput 1's function(pin 3 and 6) on the endpoint controller's J1 connector. Input 1 must be set to NOT_USED on SRCP and WESP devices. Input 2's function(pin 2 and 5) on the endpoint controller's J1 connector. Input 2 is not applicable to NSC Pro devices that use CAT 1 stop category. Input 2 must be set to NOT_USED on SRCP and WESP devices. Must be set to NOT_USED on SRCP and WESP devices.
Enum values:NOT_USEDESTOP_TYPE_SWITCHSOLID_STATE_SAFETY_DEVICEREMOTE_SAFETY_REQUESTREMOTE_SAFETY_REQUEST_WITH_AUTONOMY_SELECTinputConfiguration3string · enumInput 1's function(pin 3 and 6) on the endpoint controller's J1 connector. Input 1 must be set to NOT_USED on SRCP and WESP devices. Input 2's function(pin 2 and 5) on the endpoint controller's J1 connector. Input 2 is not applicable to NSC Pro devices that use CAT 1 stop category. Input 2 must be set to NOT_USED on SRCP and WESP devices. Must be set to NOT_USED on SRCP and WESP devices.
Enum values:NOT_USEDESTOP_TYPE_SWITCHSOLID_STATE_SAFETY_DEVICEREMOTE_SAFETY_REQUESTREMOTE_SAFETY_REQUEST_WITH_AUTONOMY_SELECTcan0Idinteger · int32The id of can interface
can1Idinteger · int32The id of can interface
voltagestring · enumEnum values:VOLTAGE_12VVOLTAGE_24VVOLTAGE_5Vserial0Usagestring · enumNSC Pro only. The physical output interface between the FORT Pro device and your equipment under control. Can be FORT SDK(comms) or Data Output Control(control). FORT SDK and Data Output Control can each only be set on one serial at a time."
Enum values:commscontrolserial1Usagestring · enumNSC Pro only. The physical output interface between the FORT Pro device and your equipment under control. Can be FORT SDK(comms) or Data Output Control(control). FORT SDK and Data Output Control can each only be set on one serial at a time."
Enum values:commscontrolserial0Baudratestring · enumEnum values:BAUDRATE_115200serial1Baudratestring · enumEnum values:BAUDRATE_115200stopCategorystring · enumNSC Pro only. E-Stop category CAT0: For an EPC Sender - If ESTOP is on input #1 it disables receiver output #1; if ESTOP on input #2 it disables receiver output #2. For an SRCP transmitter - The last output of the receiver (output #2 for NSCP or output #3 for EPC) is turned off. CAT1: Output #1 of the receiver is turned off immediately, and after a user-defined delay (CAT1 Delay), output #2 of the receiver is turned off.
Enum values:CAT0CAT1cat1StopDelaynumber | null · floatRepresents an optional property in a patch request body
ethNetmaskstring | nullRepresents an optional property in a patch request body
ethGatewaystring | nullRepresents an optional property in a patch request body
ethNameserversarray | nullRepresents an optional property in a patch request body
wifiNetmaskstring | nullRepresents an optional property in a patch request body
wifiGatewaystring | nullRepresents an optional property in a patch request body
wifiNameserversarray | nullRepresents an optional property in a patch request body
wifiSsidstring | nullRepresents an optional property in a patch request body
wifiPasswordstring | nullRepresents an optional property in a patch request body
networkTemplateIdstring · uuidThe network template id
Responses
Success
dataobjectsuccessbooleanerrorsarray | null