This article pertains to:

Status
colour Green title Inform (v2)

...

Connecting a Smart Meter device via the Validic Marketplace is easy. Instead of the typical cloud account linking workflow, users simply enter their Smart Meter device’s unique IMEI number and they’re done.

...

This page details how the Direct Connection APIs work for Smart Meter. To learn more about the Inform integration to Smart Meter, please submit a request to your Validic Customer Success Executive or contact our support team at support@validic.com.

...

User Authorization for Smart Meter Cellular Devices

Overview

End users cannot purchase Smart Meter cellular devices directly from Smart Meter. These devices must be acquired through a client who has signed a contract with Smart Meter. Validic Inform does not have access to the PHI necessary to ship devices, therefore Inform clients using Smart Meter cellular devices are responsible for acquiring the devices and distributing them to patients/users.

...

Let’s get into the individual steps.

Provision User in Validic Inform

Sample Request

Content-Type: application/x-www-form-urlencoded

...

    "updated_at": "2023-07-06T21:19:08Z"

}

Establish User Device Connection via Direct Connection API

Sample Request

Content-Type: application/json

...

   "device_type": "blood_glucose"

}

Sample Response202 Accepted

{
"credentials": {
"device_id": "123453782873223",
"device_type": "blood_glucose",
"device_name": null
},
"type": "smart_meter",
"created_at": "2023-10-01T15:53:41Z"
}

Disconnect User via Direct Connection API

Disconnecting the user from Smart Meter can be done in two ways:

1. Disconnect a single device IMEI from the user - this leaves any other Smart Meter device IMEIs connected to the user and only removes the IMEI indicated.

2. Disconnect all device IMEIs from the user - this disconnects all Smart Meter device IMEIs from the user at once.

Disconnect a single device

Sample Request

POST https://syncmydevice.com/direct/auth/smart_meter/disconnect/:IMEI?token=:token

...

POST 'https://syncmydevice.com/direct/auth/smart_meter/disconnect/123453782873223?token=02f0c59b63310f7cec951aSAMPLEdd15481ec1dfd5f7e1f6927'

Sample Response202 Accepted

{
"credentials": {
"device_id": "123453782873223",
"device_type": "blood_glucose",
"device_name": null
},
"type": "smart_meter",
"created_at": "2023-10-01T15:53:41Z",
"deleted_at": "2023-10-10T17:47:15Z",
"deleted_reason": "User disconnected from Direct Endpoint"
}

Disconnect all devices

Sample Request

POST https://syncmydevice.com/direct/auth/smart_meter/disconnect_all?token=:token

...

POST 'https://syncmydevice.com/direct/auth/smart_meter/disconnect_all?token=02f0c59b63310f7cec951aSAMPLEdd15481ec1dfd5f7e1f6927'

Sample Response202 Accepted

{
"meta": {
"total": 2
},
"connections": [
{
"credentials": {
"device_id": "111111111111111",
"device_type": "blood_pressure",
"device_name": ""
},
"type": "smart_meter",
"created_at": "2023-10-01T15:46:15Z",
"deleted_at": "2023-10-10T17:49:21Z",
"deleted_reason": "User disconnected from Direct Endpoint"
},
{
"credentials": {
"device_id": "222222222222222",
"device_type": "weight_scale",
"device_name": ""
},
"type": "smart_meter",
"created_at": "2023-10-01T15:46:26Z",
"deleted_at": "2023-10-10T17:49:21Z",
"deleted_reason": "User disconnected from Direct Endpoint"
}
]
}

Smart Meter Data

The Smart Meter Inform integration has the source ‘type’: smart_meter

The Smart Meter Inform integration supports the data metrics defined on the Standard Metrics Used Per App page (see “Smart Meter” app).

Sample Data

The below example illustrates a single weight measurement using the Smart Meter iPulseOx pulse oximeter. This sample shows how these readings appear in the Validic Inform Streaming API and REST API.

{
    "checksum": "b0a2547d56SAMPLE5d57437a90b",
    "created_at": "2023-10-10T17:20:04.858Z",
    "deleted_at": null,
    "end_time": "2023-10-10T15:58:56Z",
    "id": "3de314260ccSAMPLE69c5bae6547f1",
    "log_id": "500000046950878",
    "metrics": [
        {
            "type": "spo2",
            "origin": "device",
            "unit": "percent",
            "value": 99.0
        },
        {
            "type": "pulse",
            "origin": "device",
            "unit": "bpm",
            "value": 82
        }
    ],
    "offset_origin": "source",
    "source": {
        "type": "smart_meter",
        "device": {
            "id": "111111111111111",
            "model": "smc-ox",
            "manufacturer": "smart meter",
            "diagnostics": []
        }
    },
    "start_time": "2023-10-10T15:58:56Z",
    "tags": [],
    "type": "measurement",
    "user": {
        "organization_id": "5ef0ef69SAMPLEba562",
        "user_id": "652572SAMPLEe18b8b8",
        "uid": "123456"
    },
    "user_notes": [],
    "utc_offset": -14400,
    "version": "1.0"
}

Details on using the Inform Streaming API and REST APIs can be found in our online technical documentation.