1. Developing Applications with Oracle Internet of Things Cloud Service
  2. Create and Manage Device Models
  3. Create a New Device Model

Create a New Device Model

A device model is an interface that lets any device communicate with Oracle Internet of Things Cloud Service regardless of its manufacturer or operating system.

  1. Open the Oracle Internet of Things Cloud Service Management Console.

    You can access the Oracle Internet of Things Cloud Service Management Console from the following URL:

    https://hostname/ui

    Here, hostname is the host name of your Oracle Internet of Things Cloud Service instance.

  2. Click the Menu (Menu icon) icon.
  3. Select Devices and then select Model.
  4. Select one of these options:
    • If you have not previously created a device model, click Create Device Model.
    • If you have previously created a device model, click the Add (Add icon) icon.
  5. Complete these fields:
    1. Name: Enter a name for the device model.
    2. Description: Enter an optional description for the device model.
    3. URN: Enter a unique identifier for the device model. Use this format: urn:com:<mycompany>:<mydevice>:<what the device model does>.
  6. Select system attributes for the device model.
  7. (Optional) Add custom attributes for the device model:
    1. Expand the Custom Attributes option list.
    2. Click the Add (Add icon) icon.
    3. Enter a name for the custom attribute in the Name field.
    4. Enter an optional description for the custom attribute in the Description field.
    5. Select a data type in the Type list.
    6. Select Writable if you want to make the custom attribute writable.
    7. Click OK.
  8. (Optional) Define the actions that can be invoked on the device:
    1. Expand the Actions option list.
    2. Click the Add (Add icon) icon.
    3. Enter a name for the action in the Name field.
    4. Enter an optional description for the action in the Description field.
    5. Select the data type for the action in the Arguments list.
    6. Enter an optional alternate name for the action in the Alias field.
    7. Click OK.
  9. (Optional) Create alerts and custom message formats for the device model:
    1. Expand the Alerts and Custom Messages option list.
    2. Click the Add (Add icon) icon.
    3. Enter a name for the alert or custom message in the Name field.
    4. Enter an optional description for the alert or custom message in the Description field.
    5. Enter a unique identifier for the alert or custom message in URN field. Use this format:urn:<mycompany>:<department>:<mydevice>:<device model>:<message>.
    6. Select a data type in the Type list.
    7. Click OK.
    8. Select the alert message format and then click the Add (Add icon) icon in the Fields column.
    9. Enter a name for the message type in the Name field.
    10. Select a data type in the Type list.
    11. Select Optional to indicate the field value can be missing in the device model message format.
    12. Click OK.
  10. Click Save.