Generating a QR Code

The Things Stack can generate QR codes for your devices, which helps identifying the devices and allows for claiming the device.

This guide shows how to list QR code formats and generate QR codes with the CLI.

List QR Code Formats

To show supported QR code formats for end devices:

$ ttn-lw-cli end-devices list-qr-formats

{
  "formats": {
    "tr005draft3": {
      "name": "LoRa Alliance TR005 Draft 3",
      "description": "Standard QR code format defined by LoRa Alliance.",
      "field_mask": {
        "paths": [
          "claim_authentication_code.value",
          "ids.dev_eui",
          "ids.join_eui"
        ]
      }
    }
  }
}

The formats show the fields of the end device that are used in the QR code.

Generate QR Code for Identification

To generate a QR code for identification:

$ ttn-lw-cli end-devices generate-qr app1 dev1 --format-id tr005draft3

This saves the QR code to the current directory with the device ID as file name, in PNG format with a default size of 300 pixels. Use --folder and --size to change the save location and image size.

Generate QR Code for Claiming

Device claiming is a mechanism to transfer devices securely from one application to another. For example, from a device maker to a device owner, or transferring ownership to new device owner.

When you create a device, you can generate a claim authentication code by specifying the --with-claim-authentication-code flag. You can also set a claim authentication code via CLI:

$ ttn-lw-cli end-devices set app1 dev1 --claim-authentication-code.value=ABCD

To generate a QR code for claiming:

$ ttn-lw-cli end-devices generate-qr app1 dev1 --format-id tr005draft3