wiliot-certificate 4.6.0a3

A library for certifying Wiliot-compliant boards

wiliot-certificate

wiliot-certificate is a Python library that provides tools for testing and certifying boards for compatibility with Wiliot’s ecosystem. This python package includes the following tools:

• Certification Wizard (wlt-cert)
• Certificate CLI (wlt-cert-cli)
• Tester Upgrade (wlt-cert-tester-upgrade)
• Registration Certificate Test (wlt-cert-reg)
• Wiliot Board Type Management CLI (wlt-btm)

Versioning:

wiliot-certificate versions 4.5.x are compatible with firmware version >=4.4.0.

• Bridge API version >= 12
• Gateway API version >= 203

Installing wiliot-certificate

pip install wiliot-certificate

Using wiliot-certificate

Certification

wlt-cert

This tool is the default to test and certify your device. It runs a setup wizard that walks you through the initialization steps before running the tests. You'll need a validation schema and a tester device. Once set up it opens a terminal and tests your device.

Certificate CLI

wlt-cert-cli -h

CLI version of the certificate. Use -h for details on the different arguments.

Tester Upgrade

wlt-cert-tester-upgrade

Upgrades the firmware of the tester device to the version required for certification.

Registration Certificate

wlt-cert-reg

Certify the gateway registration process to Wiliot platform. The gateway must use Wiliot production MQTT broker, and mustn't be registered to any account on Wiliot platform. Use -h for details on the arguments (see Registration for more info).

Wiliot Board Type Management

wlt-btm

CLI tool for managing board type versions in Wiliot's Board Type Management (BTM) system. This tool allows you to manage firmware versions for gateways and bridges.

Key Features:

• Board Types: List available board types

  wlt-btm --env aws --server prod --token AAbbCC11... --get_board_types
  

• Get Versions: Retrieve available versions for board types

  wlt-btm --env aws --server prod --token AAbbCC11... --get --ifc wifi
  

• Post New Versions: Set new firmware versions for gateways or bridges

  wlt-btm --env aws --server prod --token AAbbCC11... --post --ifc wifi --unified 4.5.0 --wifi 4.5.0 --ble 4.5.0
  

• File Management: Upload/download firmware files and validation schemas

  wlt-btm --env aws --server prod --token AAbbCC11... --ifc wifi --unified 4.5.0 --put_file X.Y.Z.json
  wlt-btm --env aws --server prod --token AAbbCC11... --ifc wifi --unified 4.5.0 --put_file brg_app.bin
  

• Beta/Official Status: Move versions between beta and official

  wlt-btm --env aws --server prod --token AAbbCC11... --ifc wifi --unified 4.5.0 --beta 0  # Move to official
  wlt-btm --env aws --server prod --token AAbbCC11... --ifc wifi --unified 4.5.0 --beta 1  # Move to beta
  

Use wlt-btm -h for complete list of arguments and options.

The following capabilities are not tested in this version

Cloud Connectivity & Misc

• Board type registered within the Board Type Management system

Module Energy 2400

• Functionality of energy pattern, output power and duty cycle

Module Energy SUB1G

• Functionality of energy pattern and duty cycle

Module Datapath

• RSSI edge cases: -127 and 0
• Functionality of transmission pattern, output power

Calibration

• Functionality of output power and interval calibration
• Functionality of calibration transmission patterns for the configuration STANDARD & EU & DISABLE