add mfg tool example for pre-provising in docs

This commit is contained in:
liyashuai
2023-04-04 18:48:56 +08:00
parent 3a65dfc753
commit 8a16428375
+40
View File
@@ -120,6 +120,46 @@ programming the partition into the device at your end.
Please contact your Espressif contact person for more information.
4.3.3 The mfg_tool Example
~~~~~~~~~~~~~~~~~~~~~~~~~~
In Espressif Matter Prep-provisioning modules, the DAC key pair, DAC and PAI certificates are pre-flashed by default.
This section gives some examples on how to generate factory partition binary which includes :
| **Device unique data** (Discriminator, Verifier, Serial Number, etc)
| **Manufacturing information** (Vendor name, Product name, Hardware version, etc)
**Note:** the items listed in the examples are all mandatory, some common manufacturing information could be removed if they are hard coded in the firmware.
This is the example to generate factory images after pre-provisioning:
- **Generate generic factory image**
- ./mfg_tool.py -cd ~/test_cert/CD/Chip-CD-131B-1000.der -v 0x131B --vendor-name ESP -p 0x1000 --product-name light --hw-ver 1 --hw-ver-str v1.0 --mfg-date 2022-10-25 --passcode 19861989 --discriminator 601 --serial-num esp32c_dev3
- **Generate multiple generic factory images**
- ./mfg_tool.py -n 10 -cd ~/test_cert/CD/Chip-CD-131B-1000.der -v 0x131B --vendor-name ESP -p 0x1000 --product-name light --hw-ver 1 --hw-ver-str v1.0 --mfg-date 2022-10-25
- **Generate factory image with rotating device unique identify**
- ./mfg_tool.py -cd ~/test_cert/CD/Chip-CD-131B-1000.der -v 0x131B --vendor-name ESP -p 0x1000 --product-name light --hw-ver 1 --hw-ver-str v1.0 --mfg-date 2022-10-25 --passcode 19861989 --discriminator 601 --serial-num esp32c_dev3 --enable-rotating-device-id --rd-id-uid c0398f4980b07c9460f71c5421e1a3c5
- **Generate multiple factory images with csv and mcsv**
- ./mfg_tool.py -cd ~/test_cert/CD/Chip-CD-131B-1000.der -v 0x131B --vendor-name ESP -p 0x1000 --product-name light --hw-ver 1 --hw-ver-str v1.0 --enable-rotating-device-id --mfg-date 2022-10-25 --csv mfg.csv --mcsv mfg_m.csv
- **The example of csv and mcsv file**
- CSV:
| serial-num,data,string
| rd-id-uid,data,hex2bin
| discriminator,data,u32
- MCSV:
| serial-num,rd-id-uid,discriminator
| esp32c_dev3,c0398f4980b07c9460f71c5421e1a3c5,1234
| esp32c_dev4,c0398f4980b07c9460f71c5421e1a3c6,1235
| esp32c_dev5,c0398f4980b07c9460f71c5421e1a3c7,1236
| esp32c_dev6,c0398f4980b07c9460f71c5421e1a3c8,1237
| esp32c_dev7,c0398f4980b07c9460f71c5421e1a3c9,1238
4.4 Security
------------