How to check device history in OnBoard™ IoT Security

This article will guide you on how to check the device history records within the tenant in OnBoard™ IoT Security (OBIS), including the device profile and logs.

Prerequisites

Before getting started, please ensure that:

• The device has already been programmed.
• You have either the product role permissions for the relevant product, or the Factory Manager role permission for the corresponding factory.

Instructions

1. Sign in to OBIS.

2. In the left menu, click Records > Device History, and then you can check the device history on the Device History page.

3. After setting the search conditions, click Search. The device history list will return all device history records that match the search conditions.

   tip

   Currently, device history records can be searched using the following conditions:

   • System fields: Device ID, Env, Manufacture Time, Last Update Time, Product, Version, Batch, Factory, Station, and Programming Status
   • Extend fields: VID, PID, Chip UID, QR Code, Pairing Code

   
   

   You can click the Search icon to hide or display the search conditions. The number to the right of the icon indicates how many search conditions are currently set.

   Meanwhile, you can click the Column Options icon to customize which columns are shown and how they are ordered.

   

   Description of device history information:

   Information	Description
   Device ID	Device identifier.
   Env	The environment corresponding to the version, such as TEST and PROD.
   Manufacture Time	The date and time when the device started programming, in the format YYYY-MM-DD HH:MM:SS.
   Last Update Time	The latest synchronized date and time of the device profile, in the format YYYY-MM-DD HH:MM:SS.
   Product	The product name of the corresponding device.
   Version	The version name of the corresponding device.
   Batch	The batch name of the corresponding device.
   Factory	The factory name of the corresponding device.
   Station	The station name of the corresponding device.
   Programming Status	The device result status, such as Unreported, Complete, and Fail.
   VID	Vendor identifier.
   PID	Product identifier.
   Chip UID	The Unique Identifier of the chip inside the device.
   QR Code	The device's QR code, used for secure and fast commissioning.
   Pairing Code	A temporary verification code manually entered by the user to complete device pairing.

4. Select the corresponding Device ID to navigate to the device page, where you can check the device-related information.

   • The Profile tab displays the device profile, which can be used to check the complete information of each device.

     tip

     Hover the mouse over the QR code icon to display the device QR code, which is used for secure and fast commissioning.

     • The Matter Detail area displays the DAC information (such as DAC Serial No., Not Before, and Not After). The DAC Serial No. can be used to revoke the certification of the corresponding device.
     • The DAC Certificate area displays the encoding of the CA certificate. By parsing the encoding of the CA certificate, key certificate attributes such as the issuer information, validity period, and public key can be extracted.
     • System and Extend fields
     • Chip Config
     • Matter Config (Matter Detail, DAC Certificate, and Configuration)
     • Firmware
     • Factory Data
     • Programming Station File

     

   • The Logs tab displays the device programming logs (logs from each programming operation are saved), which can be used for troubleshooting and identifying programming issues.