wiliot-certificate
wiliot-certificate provides tools for testing and certifying gateways and bridges for compatibility with Wiliot's ecosystem.
The package installs the following commands:
- Certification Wizard (
wlt-cert) - Certification CLI (
wlt-cert-cli) - Tester Firmware Upgrade (
wlt-cert-tester-upgrade) - Gateway Registration Certification (
wlt-cert-reg) - Wiliot Board Type Management CLI (
wlt-btm)
Compatibility
wiliot-certificate 4.6.x supports:
- Firmware version 4.4.0 or later
- Bridge API versions 12 or later
- Gateway API versions 203 or later
- Python 3.12 or 3.13
Installation
pip install wiliot-certificate
Commands
Certification Wizard
wlt-cert
This is the recommended way to configure and run a certification. The command opens a local setup wizard that guides you through selecting a device type, validation schema, tester, broker, and tests.
You need a validation schema and a tester device. Run wlt-cert --help to see the available server options.
After setup, selecting Run Certificate opens a terminal and starts testing your device.
Certification CLI
wlt-cert-cli --dut DUT_ID --validation_schema schema.json --custom_broker broker.json
The required arguments are:
--dut: ID of the device under test. For a combo device, useGATEWAY_ID:BLE_MAC.--validation_schema,-vs: Path to the validation schema JSON file.--custom_broker,-cb: Path to the custom MQTT broker configuration JSON file.
The CLI uses a serial tester by default and scans for its port when --port is omitted. Use --tester GATEWAY_ID to run with a remote gateway tester. Run wlt-cert-cli --help for all options.
Tester Firmware Upgrade
wlt-cert-tester-upgrade
Upgrades the tester device to a firmware version supported by this certification package. Use --port PORT, or -p PORT, to select a serial port explicitly; otherwise the tool scans the available ports.
Gateway Registration Certification
wlt-cert-reg --dut GATEWAY_ID --apikey API_KEY
Certifies the gateway registration process on the Wiliot platform. The gateway must use Wiliot's production MQTT broker and must not already be registered to an account. See Wiliot Certification for setup information.
Wiliot Board Type Management
wlt-btm --help
wlt-btm manages gateway and bridge firmware versions in Wiliot's Board Type Management (BTM) system.
This tool allows you to manage firmware versions for gateways and bridges.
List available board types:
wlt-btm --env aws --server prod --token API_TOKEN --get_board_types
Get available versions:
wlt-btm --env aws --server prod --token API_TOKEN --get --ifc wifi
Post a firmware version:
wlt-btm --env aws --server prod --token API_TOKEN --post --ifc wifi --unified UNIFIED_VERSION --wifi WIFI_VERSION --ble BLE_VERSION
Upload firmware or validation-schema files:
wlt-btm --env aws --server prod --token API_TOKEN --ifc wifi --unified UNIFIED_VERSION --put_file VALIDATION_SCHEMA.json
wlt-btm --env aws --server prod --token API_TOKEN --ifc wifi --unified UNIFIED_VERSION --put_file brg_app.bin
Move a version between beta and official status:
wlt-btm --env aws --server prod --token API_TOKEN --ifc wifi --unified UNIFIED_VERSION --beta 0
wlt-btm --env aws --server prod --token API_TOKEN --ifc wifi --unified UNIFIED_VERSION --beta 1
Run wlt-btm --help for the complete list of operations and arguments.
1 maintainer
Metadata
1 maintainer
Release files for wiliot-certificate 4.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| wiliot_certificate-4.6.0.tar.gz | 58.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| wiliot_certificate-4.6.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 116.1 MB
Release files / wiliot_certificate-4.6.0.tar.gz
| Download URL | wiliot_certificate-4.6.0.tar.gz |
|---|---|
| Size | 58.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ff189b0b476c0a8c50bfb6edc65a575c1eef65b38982c506d1dce10caa8fc2e3
|
|
BLAKE2b-256 checksum How to use checksums |
2a7be2b64db04241f222bb473d2687604b6ff36318f738f2d2556db72bed9660
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.14
|
Release files / wiliot_certificate-4.6.0-py3-none-any.whl
| Download URL | wiliot_certificate-4.6.0-py3-none-any.whl |
|---|---|
| Size | 58.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2c6ffe06a98973a25f89546b64c3bdbcdd4db211fe063952e5fe40a0cab6a4ce
|
|
BLAKE2b-256 checksum How to use checksums |
398828f16e449bd90063f5e3bc36c2e948dae3a2774aa03a2d8f06e4297d7d32
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.14
|
