Oracle by Example brandingConfiguring an Oracle IoT Asset Monitoring Cloud Service Application

section 0Before You Begin

This 15-minute tutorial shows you how to configure the Oracle Internet of Things (IoT) Asset Monitoring Cloud Service application and get started as an asset manager.

This is the first tutorial in Quick Start Tutorials for the Oracle IoT Asset Monitoring Cloud Service Application. Read the tutorials sequentially.

Background

An airport has implemented an Oracle IoT Asset Monitoring Cloud Service application to monitor and manage its movable and fixed location assets. The tracked assets are rubber cleaning machines, HVAC units, generator units, and runway sweeping machines. The application is configured to locate assets, trigger incidents and alerts, display the historical and current values of the sensor data, and display the status of the incidents.

In this tutorial, you configure the application to track a runway sweeping machine. You use a simulated sensor device that generates data about the machine.

What Do You Need?

section 1Create a Place

In this section, you configure a geo-bounded location for the assets.

  1. Sign in to your instance of the Oracle IoT Asset Monitoring Cloud Service application.
  2. Click Menu main menu icon and then click Places.
  3. Click Create New Place create new place icon.
  4. In the Details section, enter the following values:
    • Name: ACMEInternationalAirport
    • Description: ACME International Airport
  5. To zoom in to a specific location on the map, use the middle mouse button.
  6. To search for a specific location on the map, use Places Search Places Search icon.
  7. To draw a geo-boundary on the location, click Draw draw icon.
  8. To create a starting point, click a location on the map, drag your mouse to define a boundary, and then click to end the boundary.
  9. Drag your mouse to define another boundary and then click to end the boundary.
  10. Drag your mouse to the starting point and click it. A polygon forms to define the geo-boundary of the place.
    geoboundary as a polygon
    Description of the illustration geo_boundary.png.
  11. Click Save and then click Back.

section 2Prepare to Create an Asset Type

In this section, you import a simulation model in the Oracle IoT Device Simulator app, and then associate the Runway Sweeping Machine device model with the Oracle IoT Asset Monitoring Cloud Service application.

  1. Save the airportrunwaysweeper.zip file.
  2. Sign in to the Oracle IoT Digital Twin Simulator application at https://your Oracle IoT Cloud Service instance name/ds.
  3. On the Simulations page, click Create a Simulation Model create new icon.
  4. On the Select an option page, click Import, select airportrunwaysweeper.zip from the folder where you saved it, and click Open.
  5. On the Import Result page, click OK. Verify that AirportRunwaySweeper appears on the Simulations page.
    AirportRunwaySweeper simulator model
    Description of the illustration simulator.png
  6. Sign in to your instance of Oracle IoT Cloud Service.
  7. Click Menu main menu icon and then click Applications.
  8. Select the Oracle IoT Asset Monitoring Cloud Service application.
  9. Click Device Model.
  10. Click Choose Device Model choose device model icon.
  11. Select the Add check box for the Runway Sweeping Machine device model and click Done.

section 3Create an Asset Type

To categorize assets, you define asset types. In this section, you create an asset type and associate it with the Runway Sweeping Machine device model in the Oracle IoT Asset Monitoring Cloud Service application.

  1. Click Menu main menu and then click Assets.
  2. On the Assets page, click Asset Types asset types icon.
  3. On the Asset Types page, click Create New Asset create new icon.
  4. In the Details section, enter the following values:
    • Name: RunwaySweepingAssetType
    • Description: Runway Sweeping Machine Asset Type
  5. Save runway_sweeper_asset_type.jpeg. Click Upload Image, browse to the location where you saved the image, and select it.
  6. In the Device References section, click Create New create new icon.
  7. Enter or select the following values, and click OK:
    • Name: RunwaySweepingAssetTypeDM
    • Required: True
    • Device Model: Runway Sweeping Machine
    • Sensor Attribute and Name
      • engineTemp engineTemperature
      • engineVibration engineVibrations
      • fuelLevel fuelLevels
  8. Click Save.

section 4Prepare to Create an Asset

In this section, you create a simulated device in the AirportRunwaySweeper simulation model.

  1. Access the Oracle IoT Digital Twin Simulator application at https://your Oracle IoT Cloud Service instance name/ds.
  2. On the Simulations page, in AirportRunwaySweeper, click Edit edit icon.
  3. In the Device Model section, scroll to the Attributes sub-section and locate ora_latitude and ora_longitude. View the values in Initial value Expression and Value Expression.
    values of the expression
    Description of the illustration location.png
  4. To customize the location co-ordinates of your simulated device, modify the values in the RandomInRange expression. Ensure that the values are within the geo-location co-ordinates of your place that you created earlier.
  5. Click Save and then click Close close icon.
  6. On the Simulations page, click AirportRunwaySweeper.
  7. Click Create New Device create new icon. In the Create Devices dialog box, click Create.
  8. In the AirportRunwaySweeper simulation model, verify that a device is listed and running.
    device is listed and running
    Description of the illustration device_running.png

section 5Create an Asset

In this section, you create an asset that represents the runway sweeping machine. After you add the asset, you can monitor the machine.

  1. Access the instance of your Oracle IoT Asset Monitoring Cloud Service application.
  2. Click Menu main menu icon and then click Assets.
  3. On the Assets page, click Create New Asset create new icon.
  4. In the Details section, enter or select the following values:
    • Name: Runway Sweeping Machine 1
    • Description: Runway Sweeping machine
    • Assigned Place: ACMEInternationalAirport
    • Type: RunwaySweepingAssetType
  5. In the Devices section, next to RunwaySweepingAssetTypeDM, click Find Device.
  6. In the Find Device dialog box, click the ID value, and then click Select.
    sensor_devices
    Description of the illustration sensor_device.png
  7. Click Save, and then click Back.
  8. Click Menu main menu icon and then click Map.
  9. Notice that the asset icon runway sweeping machine icon appears in the defined geo-boundary of your place on the map.

next stepNext Tutorial

Tracking Assets in an Oracle IoT Asset Monitoring Cloud Service Application

more informationWant to Learn More?