Provision ACK Modules for Production

​

Prerequisites

​

Steps to provision and lock modules

1. Provision test modules.
2. Provision production modules.
3. Lock the module.
4. Generate barcodes.

​

Step 1: Provision test modules

1. Connect your client machine to the module by using PuTTY.
   Connect module over serial port

   To connect your Windows host machine to the module

   1. Connect a USB cable from your host machine to the debug port on the module.
   2. To identify the port on your host machine to which the module connects, from the Start menu, search for and open Device Manager.
   3. In Device Manager, expand Ports (COM & LPT), and then find the USB serial connection. For example, the connection might be Silicon Labs CP210x USB to UART Bridge.
   4. In a convenient place, such as Notepad, paste the port number.
   5. Install PuTTY on your Windows machine.
   6. From the Windows start menu, open PuTTY, and then under Category, select Session.
   7. Under Connection type, select Serial, and then for Serial line, enter the port number you saved in Step 4. For Speed, enter 115200.
   8. To save the configuration, in Saved Sessions, enter Module, and then choose Save.
      Next time, to select the saved configuration, next to Module, choose Load. (Or, double-click Module.)
   9. To connect to the module with a baud rate of 115200, select Open.
      A PuTTY terminal window opens. To see the command prompt, press the Enter key.
   10. To verify your host machine connects to the module, enter ? in the terminal window.
       The command displays the list of available commands on the module.
2. Create an environment variable called ACKSDKTOOLS_TEST_MODE with a value of 1.
3. To apply the new variable, restart your machine.
4. In a PuTTY terminal window on the client machine, enter the following command.
   • Set <port> to the serial port, such as COM9 on Windows.

provision -p /dev/<module_port> -x <path/to/ProvisioningInfo_<device_type>.conf> -g <DSN prefix> -s <server-ip-address/hostname> -sp 5000 -cd <path/to/CertificationDeclaration> --ca <certificate used by server> --token <path to token file> -l DEBUG --test

5. If provisioning succeeds, the command displays the following response on the terminal.
   Logging into provision.log with logging level DEBUG
   Writing certificate to the module
   Provisioning successful!
   
6. If provisioning fails, review the client and server logs to determine the error. You see the log filenames in the command response.

​

Step 2: Provision production modules

1. Connect your client machine to the module by using PuTTY.
   Connect module over serial port

   To connect your Windows host machine to the module

   1. Connect a USB cable from your host machine to the debug port on the module.
   2. To identify the port on your host machine to which the module connects, from the Start menu, search for and open Device Manager.
   3. In Device Manager, expand Ports (COM & LPT), and then find the USB serial connection. For example, the connection might be Silicon Labs CP210x USB to UART Bridge.
   4. In a convenient place, such as Notepad, paste the port number.
   5. Install PuTTY on your Windows machine.
   6. From the Windows start menu, open PuTTY, and then under Category, select Session.
   7. Under Connection type, select Serial, and then for Serial line, enter the port number you saved in Step 4. For Speed, enter 115200.
   8. To save the configuration, in Saved Sessions, enter Module, and then choose Save.
      Next time, to select the saved configuration, next to Module, choose Load. (Or, double-click Module.)
   9. To connect to the module with a baud rate of 115200, select Open.
      A PuTTY terminal window opens. To see the command prompt, press the Enter key.
   10. To verify your host machine connects to the module, enter ? in the terminal window.
       The command displays the list of available commands on the module.
2. In a Windows terminal window on the client machine, enter the following command.
   • Set <port> to the serial port, such as COM9 on Windows.

provision -p /dev/<module_port> -x <path/to/ProvisioningInfo_<device_type>.conf> -g <DSN prefix> -s <server-ip-address/hostname> -sp 5000 -cd <path/to/CertificationDeclaration> --ca <certificate used by server> --token <path to token file> -l DEBUG

3. If provisioning succeeds, the command displays the following response on the terminal.
   Logging into provision.log with logging level DEBUG
   Writing certificate to the module
   Provisioning successful!
   
4. If provisioning fails, review the client and server logs to determine the error. You see the log filenames in the command response.
5. On success, the command generates an audit log file in the audit_logs_upload folder under the data folder on the server. Keep this file to upload to Amazon in a later step.

​

Step 3: Lock the module

modulelock -p /dev/<module_port> -s <server-ip-address/hostname> -sp 5000 --ca <certificate used by server> --token <path to token file>

​

Step 4: Generate barcodes

• DVC_<DSN>.png – The Matter QR code or device barcode. You print or stick this code on the device to allow customers to scan and register the device. The barcode serves as a unique identifier for the device during manufacturing.
• DVC_<DSN>_qr_code_content.txt – The text content of the QR code.
• PKG_<DSN>.png – The FFS barcode. You print this barcode on the product package to enable Matter Simple Setup (MSS).
  For more details, see Provisionee Barcode Specification / 1D Barcode requirements.
• PKG_<DSN>_barcode_content.txt – The text content of the package barcode.

1. Connect your client machine to the module by using PuTTY.
   Connect module over serial port

   To connect your Windows host machine to the module

   1. Connect a USB cable from your host machine to the debug port on the module.
   2. To identify the port on your host machine to which the module connects, from the Start menu, search for and open Device Manager.
   3. In Device Manager, expand Ports (COM & LPT), and then find the USB serial connection. For example, the connection might be Silicon Labs CP210x USB to UART Bridge.
   4. In a convenient place, such as Notepad, paste the port number.
   5. Install PuTTY on your Windows machine.
   6. From the Windows start menu, open PuTTY, and then under Category, select Session.
   7. Under Connection type, select Serial, and then for Serial line, enter the port number you saved in Step 4. For Speed, enter 115200.
   8. To save the configuration, in Saved Sessions, enter Module, and then choose Save.
      Next time, to select the saved configuration, next to Module, choose Load. (Or, double-click Module.)
   9. To connect to the module with a baud rate of 115200, select Open.
      A PuTTY terminal window opens. To see the command prompt, press the Enter key.
   10. To verify your host machine connects to the module, enter ? in the terminal window.
       The command displays the list of available commands on the module.
2. On the client machine, in a Windows terminal window, enter the following command.

barcode -p /dev/<device_port>

3. If the command succeeds, the following response displays on the terminal.
   Barcode files successfully created in C:\Users\... directory.
   
4. Store the QR code and barcode in your database with the device information.

​

Next steps

​

Related topics

• Manufacture your ACK-based Matter Device
• Set Up Client - Server Machines for Production
• Provision ACK-based Matter Prototype Devices