diff --git a/docs/en/production.rst b/docs/en/production.rst index c45cc9ed8..c8824e09b 100644 --- a/docs/en/production.rst +++ b/docs/en/production.rst @@ -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 ------------