This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
![](data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' height='64' class='font-weight-bold' style='font: 600 30.11764705882353px "SegoeUI", Arial' width='64'%3E%3Ccircle fill='hsl(278.4, 5%, 36%)' cx='32' cy='32' r='32' /%3E%3Ctext x='50%25' y='55%25' dominant-baseline='middle' text-anchor='middle' fill='%23FFF' %3EG%3C/text%3E%3C/svg%3E)
Hi,
i'm not sure if i'm following a corret strategy to implement an actutator for my project: this is not very clear in Microsoft documentation:
i defined the following model to command a device (starting from library rfid ontology i defined..)
[
{
"@id": "dtmi:digitaltwins:org:archive:download:rfidsmartlibrary:RfidSmartLibraryowl:RfidTagAlarmCodeOnOffKioskActuator;1",
"@type": "Command",
"contents": [
{
"request": {
"@type": "CommandPayload",
"name": "RequestParam",
"displayName": {
"en": "RequestParam"
},
"schema": {
"@type": "Object",
"fields": [
{
"displayName": {
"en": "CommandAutoReadWriteData"
},
"name": "CommandAutoReadWriteData",
"dtmi:dtdl:property:schema;2": {
"@type": "Enum",
"enumValues": [
{
"enumValue": "AUTO_READ_DATA",
"name": "AUTO_READ_DATA"
},
{
"enumValue": "AUTO_WRITE_DATA",
"name": "AUTO_WRITE_DATA"
}
],
"valueSchema": "string"
}
},
{
"displayName": {
"en": "CmdDeactivateAntenna"
},
"name": "CmdDeactivateAntenna",
"dtmi:dtdl:property:schema;2": {
"@type": "Enum",
"enumValues": [
{
"enumValue": "OFF",
"name": "OFF"
},
{
"enumValue": "On",
"name": "On"
}
],
"valueSchema": "string"
}
},
{
"displayName": {
"en": "CmdStart"
},
"name": "CmdStart",
"dtmi:dtdl:property:schema;2": {
"@type": "Enum",
"enumValues": [
{
"enumValue": "OFF",
"name": "OFF"
},
{
"enumValue": "On",
"name": "On"
}
],
"valueSchema": "string"
}
},
{
"displayName": {
"en": "TagAFICheckActivated"
},
"name": "TagAFICheckActivated",
"dtmi:dtdl:property:schema;2": {
"@type": "Enum",
"enumValues": [
{
"enumValue": "OFF",
"name": "OFF"
},
{
"enumValue": "On",
"name": "On"
}
],
"valueSchema": "string"
}
}
]
}
},
"response": {
"@type": "CommandPayload",
"name": "ResponseParam",
"displayName": {
"en": "ResponseParam"
},
"schema": {
"@type": "Object",
"fields": [
{
"displayName": {
"en": "CommandAutoReadWriteData"
},
"name": "CommandAutoReadWriteData",
"dtmi:dtdl:property:schema;2": {
"@type": "Enum",
"enumValues": [
{
"enumValue": "AUTO_READ_DATA",
"name": "AUTO_READ_DATA"
},
{
"enumValue": "AUTO_WRITE_DATA",
"name": "AUTO_WRITE_DATA"
}
],
"valueSchema": "string"
}
},
{
"displayName": {
"en": "CmdDeactivateAntenna"
},
"name": "CmdDeactivateAntenna",
"dtmi:dtdl:property:schema;2": {
"@type": "Enum",
"enumValues": [
{
"enumValue": "OFF",
"name": "OFF"
},
{
"enumValue": "On",
"name": "On"
}
],
"valueSchema": "string"
}
},
{
"displayName": {
"en": "CmdStart"
},
"name": "CmdStart",
"dtmi:dtdl:property:schema;2": {
"@type": "Enum",
"enumValues": [
{
"enumValue": "OFF",
"name": "OFF"
},
{
"enumValue": "On",
"name": "On"
}
],
"valueSchema": "string"
}
},
{
"displayName": {
"en": "TagAFICheckActivated"
},
"name": "TagAFICheckActivated",
"dtmi:dtdl:property:schema;2": {
"@type": "Enum",
"enumValues": [
{
"enumValue": "OFF",
"name": "OFF"
},
{
"enumValue": "On",
"name": "On"
}
],
"valueSchema": "string"
}
}
]
}
}
}
],
"@context": [
"dtmi:iotcentral:context;2",
"dtmi:dtdl:context;2"
],
"description": {
"en": "Rfid Tag Alarm Code On/Off Kiosk Actuator"
},
"displayName": {
"en": "Rfid Tag Alarm Code On/Off Kiosk Actuator"
},
"extends": "dtmi:digitaltwins:org:w3id:rec:core:OnOffActuator;1"
}
]
so if i try to import it in ADT Model i receive the following output:
*** Uploading selected models
- working on RfidTagAlarmCodeOnOffKioskActuator.json
but i can't find the model after import also there aren't no errors; i don't know if it's correct define an actuator in this way to command my library Rfid Kiosk device.
In case i'm wrong can you suggest a correct way to simulate command to my twins of library rfid device (in this case i need to command a self server kiosk that disables/enbles rfid alarm code if library item have correct borrow/return procedure)? An example of using actuator with Azure Iot Central for my goal is welcome.
Thanks in advance.
Guido
Hi @GuidoL I am following up to see if you got a chance to review the above feedback. Please let us know if you have any additional questions or need further assistance on this. Thank you
Hi @GuidoL We still have not heard back from you. Just wanted to check if the feedback provided below was helpful? If it answers your query, please do click Accept Answer and Yes for the answer, as it might be beneficial to other community members reading this thread. And, if you have any further query do let us know. Thank you
Hi @GuidoL
You can use the Azure IoT Central for creating a DTDL model of the Rfid Kiosk device and then export it.
Thanks
Roman
![](data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' height='64' class='font-weight-bold' style='font: 600 30.11764705882353px "SegoeUI", Arial' width='64'%3E%3Ccircle fill='hsl(19.2, 71%, 11%)' cx='32' cy='32' r='32' /%3E%3Ctext x='50%25' y='55%25' dominant-baseline='middle' text-anchor='middle' fill='%23FFF' %3ED%3C/text%3E%3C/svg%3E)
The IoT Central UI lets you edit the DTDL using the GUI or the JSON source directly:
Use the Edit DTDL link to view the JSON DTDL model.
Hi @GuidoL Greetings! Thank you for posting the question here. To be able to better assist you with the designing the model template, could you please share more details on the functioning of your actuator, different properties/telemetry data it may transmit. Apologies if those does not apply to the actuator model you are trying to implement. My knowledge on the device is limited.
Inspecting the model, you have shared, it implies that the model has a request command which takes in a schema of type object as payload and a response command. The model does not have any telemetry or properties. Does this seem accurate to what you are trying to accomplish?
Looking at the model templates provided in the samples of the GitHub, I would say the template type should be interface and the "type@" : "Command" should be embedded within the contents section of the interface. Kindly refer to the template of TemperatureController-2.json as the sample provides an example of Command with a CommandPayload.
Let us know if the above information is helpful and please reach out with further questions in the comments below.