Read and Write Device

Milesight ToolBox App can read the device data and write device configurations via NFC or Bluetooth. This chapter describes the basic steps to read and write a device.

Access a Device via NFC

Prerequisites
  • The device supports NFC configuration.
  • The device is supplied with power.
  • The smartphone supports NFC, and refer to the phone's guide to locate the NFC detection area.
  • The Milesight ToolBox App is upgraded to a version that supports this device model.
Steps
  1. Enable the NFC function on the smartphone.
  2. Launch ToolBox.
  3. Navigate to Device page, tap in the upper right corner, and then select NFC.

  4. (Optional) To locate the NFC detection areas of the phone and the device, click Can't find the NFC location.
  5. Put the NFC detection area of the phone close to the NFC antenna of the device.
    Tip: It is recommended to remove the phone case.
  6. Tap NFC Read in ToolBox. If the device is recognized successfully, the ToolBox homepage is displayed.
    Troubleshooting: If read fails, move the phone away and reposition it close to the device to try again.

Access a Device via Bluetooth

Prerequisites
  • The device supports Bluetooth configuration.
  • The device is turned on using hardware or software.
  • The smartphone supports Bluetooth function.
  • The Milesight ToolBox App is upgraded to a version that supports this device model.
Steps
  1. Enable the Bluetooth and location functions on the smart phone.
  2. Launch ToolBox.
  3. Navigate to Device page, tap in the upper right corner, and then select Bluetooth.

  4. Tap BLE Read to scan for nearby devices, and then select the target device. The default device Bluetooth name is model-xxxxxxx (5th to 11th characters of the device SN).
    Tip: One device can only connect to one smartphone via Bluetooth. If you select a device already connected to another phone, it will disconnect the current connection and connect to your phone.


  5. Enter the device password. The default password is 123456.

  6. After the connection is established, the ToolBox homepage is displayed.
    Tip: The Bluetooth connection is terminated if no data is exchanged for three minutes.

Device Homepage

The same homepage is displayed after a successful NFC read or Bluetooth connection. The following table describes the common homepage options.

Nr Name Description
1 Model Name Display the full model name.
2 Basic Information Check device basic information, sync time or power on/off.
3 Add this device to Milesight LoRaWAN® gateway, this option is only displayed under guest mode. For more details, refer to Batch Join Devices to Gateway.
4 Select device reading mode, upgrade the device, restart or reset the device, export historical data, etc.
5 Add, import, export or delete template files under Guest mode. For more details, refer to Device Template Management.
6 Network Status Display the network connection status.
7 SN Display the device serial number.
8 EUI Display the device EUI. This is only applicable to LoRaWAN® devices.
9 Setting Set the device and network parameters. For parameter details, refer to the corresponding device guide.
10 Detection Status Display the collected sensor data or interface status. If the device is turned off, a power button will be displayed.

Configure the Devices in ToolBox

After accessing the device through NFC or Bluetooth, use the following common procedure to view and configure the device parameters.
  1. On the ToolBox home page, tap Setting.
  2. Follow the ToolBox path shown in the relevant feature section.
  3. Configure the required parameters.
  4. Tap Write in the lower-right corner to apply the configuration. Complete the write operation according to the access method.
    Access Method Write Operation
    NFC After tapping Write, place the NFC detection area of the smartphone near the device's NFC antenna and keep it in position until the write-success page is displayed.

    Tip: A device password is usually required for authentication when writing to the device. If using the app for the first time, it will automatically authenticate using the default password: 123456. If the app-stored password does not match the device, a password prompt will pop up.
    Bluetooth After tapping Write, keep the Bluetooth connection active until a write success prompt pops up.
  5. Read the device again to check if the parameters are written correctly.
    Important: For security, change the default device password after accessing the device for the first time.