# Configuring devices
In the LINE Platform, you'll first register product information. You'll then use this product information to configure devices.
Term | Description |
---|---|
Product | A combination of hardware and software features you want to bring to users. |
Device | A piece of Bluetooth® Low Energy-compatible hardware configured to be able to link with LINE. See also Configure the device. |
Product information | A database entry that represents a product in the LINE database. See also Registering product information. |
Device information | A database entry that represents a device in the LINE database. Whenever a user links a new device with LINE, new device information is automatically created in the LINE Platform. |
# IDs
Product information, device information, and devices can be identified by the following IDs.
Term | Description | Writing to the device |
---|---|---|
PSDI (Product Specific Device ID) | Identifies a device in the real world. As the developer, you can set a unique optional value for each product. For example, you can include the manufacturing number or date in the PSDI, or use the PSDI for various other purposes. | Required Write it in the characteristics for identification of a device. |
Product ID | Identifies an instance of product information in the LINE database. Issued when the product information is created. | Not required |
Device ID | Identifies an instance of device information in the LINE database. Issued when the user links a device. | Not required |
# Register product information
When using the LINE Things Developer Trial, you'll work with a special type of product information called trial product information. Learn more from Creating trial product information in the LINE Things API reference.
While creating a trial product, you'll receive a service UUID for service search (serviceUuid
), service UUID for device identification (psdiServiceUuid
), and the characteristic UUID for device identification (psdiCharacteristicUuid
).
# Configure the device
Configure your devices using the information you get when you create trial product information. Your devices must have the following information defined:
Item | Description |
---|---|
Information for service search | In the packet advertised by the device for pairing with your smartphone, include the service UUID for service search (serviceUuid ). |
Information for device identification | In the characteristics that can be identified by the service UUID for device identification (psdiServiceUuid ) and the characteristic UUID for device identification (psdiCharacteristicUuid ), include the PSDI. |
Learn more about creating devices from these pages:
- Article on the LINE Engineering Blog (opens new window)
- line-things-starter repository on GitHub (opens new window)
# System requirements for devices
To use a Bluetooth® Low Energy-compatible device with LINE Things, the device must meet these requirements:
- The product has a unique GATT Service UUID (*) for product identification
- Before bonding, the unique GATT Service UUID (*) of the product can be advertised
- Bonding is enabled
- The communication after bonding is encrypted
- The PSDI can be read from the characteristics for device identification
- In the characteristics for device identification, the attribute permission is set to Encryption.
*In LINE Things, we call this the service UUID for service search.
# LINE Things Developer Trial restrictions
The LINE Things Developer Trial has some restrictions. For more information, see About LINE Things Developer Trial.