Sie müssen PICO_SDK_PATH in der Umgebung festlegen oder es mit -DPICO_SDK_PATH=/path/to/pico-sdk an cmake übergeben. Um Funktionen wie Signieren oder Hashing nutzen zu können, müssen Sie sicherstellen, dass das mbedtls-Submodul im SDK ausgecheckt ist. Dies können Sie erreichen, indem Sie es in Ihrem SDK-Verzeichnis ausführen.
Git-Submodul-Update --init lib/mbedtls
Sie müssen außerdem libusb-1.0 installieren.
Verwenden Sie Ihr bevorzugtes Pakettool, um Abhängigkeiten zu installieren. Zum Beispiel unter Ubuntu:
sudo apt install build-essential pkg-config libusb-1.0-0-dev cmake
Dann einfach wie ein normales CMake-Projekt erstellen:
mkdir buildcd buildcmake ..make
Unter Linux können Sie udev-Regeln hinzufügen, um picotool ohne sudo auszuführen:
sudo cp udev/99-picotool.rules /etc/udev/rules.d/
Laden Sie libUSB hier herunter: https://libusb.info/
Setzen Sie die Umgebungsvariable LIBUSB_ROOT auf das Installationsverzeichnis.
mkdir buildcd buildcmake -G "NMake Makefiles" ..nmake
Laden Sie libUSB hier herunter: https://libusb.info/
Setzen Sie die Umgebungsvariable LIBUSB_ROOT auf das Installationsverzeichnis.
mkdir buildcd buildcmake ..make
Sie müssen libusb nicht separat herunterladen oder LIBUSB_ROOT festlegen.
pacman -S $MINGW_PACKAGE_PREFIX-{toolchain,cmake,libusb}mkdir buildcd buildcmake .. -DCMAKE_INSTALL_PREFIX=$MINGW_PREFIXcmake --build . Das Raspberry Pi Pico SDK (pico-sdk) Version 2.0.0 und höher verwendet picotool um die ELF-zu-UF2-Konvertierung durchzuführen, die zuvor vom elf2uf2 -Tool im SDK durchgeführt wurde. Das SDK verwendet auch picotool zum Hashen und Signieren von Binärdateien.
Während das SDK Picotool einzeln pro Projekt herunterladen kann, ist es bei mehreren Projekten oder Build-Konfigurationen vorzuziehen, eine einzelne Kopie von picotool lokal zu installieren. Dies geht am einfachsten mit make install oder cmake --install . ; Das SDK verwendet standardmäßig diese installierte Version.
Alternativ können Sie die Installation auch in einem benutzerdefinierten Pfad durchführen:
cmake -DCMAKE_INSTALL_PREFIX=$MY_INSTALL_DIR -DPICOTOOL_FLAT_INSTALL=1 ..
Damit das SDK picotool in diesem benutzerdefinierten Pfad findet, müssen Sie die Variable picotool_DIR in Ihrem Projekt festlegen, indem Sie entweder die Umgebungsvariable picotool_DIR festlegen, -Dpicotool_DIR=$MY_INSTALL_DIR/picotool an Ihren cmake -Befehl übergeben oder hinzufügen set(picotool_DIR $MY_INSTALL_DIR/picotool) auf Ihre CMakeLists.txt-Datei.
picotool ist ein Tool zum Arbeiten mit RP2040/RP2350-Binärdateien und zur Interaktion mit RP2040/RP2350-Geräten, wenn diese sich im BOOTSEL-Modus befinden. (Ab Version 1.1 von picotool ist es auch möglich, mit Geräten zu interagieren, die sich nicht im BOOTSEL-Modus befinden, aber USB-Stdio-Unterstützung vom Raspberry Pi Pico SDK verwenden, indem Sie das Argument -f von picotool verwenden.)
Hinweis: Weitere Dokumentation finden Sie unter https://rptl.io/pico-get-started
$ picotool help PICOTOOL: Tool for interacting with RP2040/RP2350 device(s) in BOOTSEL mode, or with an RP2040/RP2350 binary SYNOPSIS: picotool info [-b] [-p] [-d] [--debug] [-l] [-a] [device-selection] picotool info [-b] [-p] [-d] [--debug] [-l] [-a] <filename> [-t <type>] picotool config [-s <key> <value>] [-g <group>] [device-selection] picotool config [-s <key> <value>] [-g <group>] <filename> [-t <type>] picotool load [-p] [-n] [-N] [-u] [-v] [-x] <filename> [-t <type>] [-o <offset>] [device-selection] picotool encrypt [--quiet] [--verbose] [--hash] [--sign] <infile> [-t <type>] [-o <offset>] <outfile> [-t <type>] <aes_key> [-t <type>] [<signing_key>] [-t <type>] picotool seal [--quiet] [--verbose] [--hash] [--sign] [--clear] <infile> [-t <type>] [-o <offset>] <outfile> [-t <type>] [<key>] [-t <type>] [<otp>] [-t <type>] [--major <major>] [--minor <minor>] [--rollback <rollback> [<rows>..]] picotool link [--quiet] [--verbose] <outfile> [-t <type>] <infile1> [-t <type>] <infile2> [-t <type>] [<infile3>] [-t <type>] [-p] <pad> picotool save [-p] [device-selection] picotool save -a [device-selection] picotool save -r <from> <to> [device-selection] picotool verify [device-selection] picotool reboot [-a] [-u] [-g <partition>] [-c <cpu>] [device-selection] picotool otp list|get|set|load|dump|permissions|white-label picotool partition info|create picotool uf2 info|convert picotool version [-s] [<version>] picotool coprodis [--quiet] [--verbose] <infile> [-t <type>] <outfile> [-t <type>] picotool help [<cmd>] COMMANDS: info Display information from the target device(s) or file. Without any arguments, this will display basic information for all connected RP2040 devices in BOOTSEL mode config Display or change program configuration settings from the target device(s) or file. load Load the program / memory range stored in a file onto the device. encrypt Encrypt the program. seal Add final metadata to a binary, optionally including a hash and/or signature. link Link multiple binaries into one block loop. save Save the program / memory stored in flash on the device to a file. verify Check that the device contents match those in the file. reboot Reboot the device otp Commands related to the RP2350 OTP (One-Time-Programmable) Memory partition Commands related to RP2350 Partition Tables uf2 Commands related to UF2 creation and status version Display picotool version coprodis Post-process coprocessor instructions in dissassembly files. help Show general help or help for a specific command Use "picotool help <cmd>" for more info
Beachten Sie, dass Befehle, die sich nicht auf Dateien auswirken, die Verbindung eines Geräts im BOOTSEL-Modus erfordern.
Die Unterstützung für Binärinformationen im SDK ermöglicht das einfache Speichern kompakter Informationen, die picotool finden kann (siehe Abschnitt „Binärinformationen“ unten). Der Befehl info dient zum Auslesen dieser Informationen.
Die Informationen können entweder von einem oder mehreren angeschlossenen Geräten im BOOTSEL-Modus oder aus einer Datei gelesen werden. Diese Datei kann eine ELF-, eine UF2- oder eine BIN-Datei sein.
$ picotool help info INFO: Display information from the target device(s) or file. Without any arguments, this will display basic information for all connected RP2040 devices in BOOTSEL mode SYNOPSIS: picotool info [-b] [-p] [-d] [--debug] [-l] [-a] [device-selection] picotool info [-b] [-p] [-d] [--debug] [-l] [-a] <filename> [-t <type>] OPTIONS: Information to display -b, --basic Include basic information. This is the default -p, --pins Include pin information -d, --device Include device information --debug Include device debug information -l, --build Include build attributes -a, --all Include all information TARGET SELECTION: To target one or more connected RP2040 device(s) in BOOTSEL mode (the default) --bus <bus> Filter devices by USB bus number --address <addr> Filter devices by USB device address --vid <vid> Filter by vendor id --pid <pid> Filter by product id --ser <ser> Filter by serial number -f, --force Force a device not in BOOTSEL mode but running compatible code to reset so the command can be executed. After executing the command (unless the command itself is a 'reboot') the device will be rebooted back to application mode -F, --force-no-reboot Force a device not in BOOTSEL mode but running compatible code to reset so the command can be executed. After executing the command (unless the command itself is a 'reboot') the device will be left connected and accessible to picotool, but without the RPI-RP2 drive mounted To target a file <filename> The file name -t <type> Specify file type (uf2 | elf | bin) explicitly, ignoring file extension
Beachten Sie, dass die -f-Argumente für Windows- und macOS-/Unix-Plattformen leicht variieren.
z.B
$ picotool info Programminformationsname: hello_world Funktionen: stdout zu UART
$ picotool info -a Program Information name: hello_world features: stdout to UART binary start: 0x10000000 binary end: 0x1000606c Fixed Pin Information 20: UART1 TX 21: UART1 RX Build Information build date: Dec 31 2020 build attributes: Debug build Device Information flash size: 2048K ROM version: 2
$ picotool info -bp Programminformationsname: hello_world Funktionen: stdout zu UART
Feste Pin-Informationen 20: UART1 TX 21: UART1 RX
$ picotool info -a lcd_1602_i2c.uf2 File lcd_1602_i2c.uf2: Program Information name: lcd_1602_i2c web site: https://github.com/raspberrypi/pico-examples/tree/HEAD/i2c/lcd_1602_i2c binary start: 0x10000000 binary end: 0x10003c1c Fixed Pin Information 4: I2C0 SDA 5: I2C0 SCL Build Information build date: Dec 31 2020
Mit Config können Sie die Binärinformationen auf einem Gerät konfigurieren, sofern diese konfigurierbar sind. Insbesondere können Sie bi_ptr_int32 und bi_ptr_string konfigurieren.
$ picotool help config
CONFIG:
Display or change program configuration settings from the target device(s) or file.
SYNOPSIS:
picotool config [-s <key> <value>] [-g <group>] [device-selection]
picotool config [-s <key> <value>] [-g <group>] <filename> [-t <type>]
OPTIONS:
<key>
Variable name
<value>
New value
-g <group>
Filter by feature group
TARGET SELECTION:
To target one or more connected RP2040 device(s) in BOOTSEL mode (the default)
--bus <bus>
Filter devices by USB bus number
--address <addr>
Filter devices by USB device address
--vid <vid>
Filter by vendor id
--pid <pid>
Filter by product id
--ser <ser>
Filter by serial number
-f, --force
Force a device not in BOOTSEL mode but running compatible code to reset so the command can be executed. After executing the
command (unless the command itself is a 'reboot') the device will be rebooted back to application mode
-F, --force-no-reboot
Force a device not in BOOTSEL mode but running compatible code to reset so the command can be executed. After executing the
command (unless the command itself is a 'reboot') the device will be left connected and accessible to picotool, but without the
RPI-RP2 drive mounted
To target a file
<filename>
The file name
-t <type>
Specify file type (uf2 | elf | bin) explicitly, ignoring file extension$ picotool config
n = 5
name = "Billy"
nonconst_pins:
default_pin = 3
default_name = "My First Pin"$ picotool config -g nonconst_pins
nonconst_pins:
default_pin = 3
default_name = "My First Pin"$ picotool config -s name Jane
name = "Billy"
setting name -> "Jane"
$ picotool config
n = 5
name = "Jane"
nonconst_pins:
default_pin = 3
default_name = "My First Pin" load können Sie Daten aus einer Datei auf das Gerät schreiben (entweder in den Flash oder in den RAM).
$ picotool help load
LOAD:
Load the program / memory range stored in a file onto the device.
SYNOPSIS:
picotool load [--ignore-partitions] [--family <family_id>] [-p <partition>] [-n] [-N] [-u] [-v] [-x] <filename> [-t <type>] [-o
<offset>] [device-selection]
OPTIONS:
Post load actions
--ignore-partitions
When writing flash data, ignore the partition table and write to absolute space
--family
Specify the family ID of the file to load
<family_id>
family id to use for load
-p, --partition
Specify the partition to load into
<partition>
partition to load into
-n, --no-overwrite
When writing flash data, do not overwrite an existing program in flash. If picotool cannot determine the size/presence of the
program in flash, the command fails
-N, --no-overwrite-unsafe
When writing flash data, do not overwrite an existing program in flash. If picotool cannot determine the size/presence of the
program in flash, the load continues anyway
-u, --update
Skip writing flash sectors that already contain identical data
-v, --verify
Verify the data was written correctly
-x, --execute
Attempt to execute the downloaded file as a program after the load
File to load from
<filename>
The file name
-t <type>
Specify file type (uf2 | elf | bin) explicitly, ignoring file extension
BIN file options
-o, --offset
Specify the load address for a BIN file
<offset>
Load offset (memory address; default 0x10000000)
Target device selection
--bus <bus>
Filter devices by USB bus number
--address <addr>
Filter devices by USB device address
--vid <vid>
Filter by vendor id
--pid <pid>
Filter by product id
--ser <ser>
Filter by serial number
-f, --force
Force a device not in BOOTSEL mode but running compatible code to reset so the command can be executed. After executing the
command (unless the command itself is a 'reboot') the device will be rebooted back to application mode
-F, --force-no-reboot
Force a device not in BOOTSEL mode but running compatible code to reset so the command can be executed. After executing the
command (unless the command itself is a 'reboot') the device will be left connected and accessible to picotool, but without the
RPI-RP2 drive mountedz.B
$ picotool load blink.uf2
Loading into Flash: [==============================] 100% save können Sie einen RAM-Bereich, das Programm im Flash oder einen expliziten Flash-Bereich vom Gerät in einer BIN-Datei oder einer UF2-Datei speichern.
$ picotool help save
SAVE:
Save the program / memory stored in flash on the device to a file.
SYNOPSIS:
picotool save [-p] [device-selection]
picotool save -a [device-selection]
picotool save -r <from> <to> [device-selection]
OPTIONS:
Selection of data to save
-p, --program
Save the installed program only. This is the default
-a, --all
Save all of flash memory
-r, --range
Save a range of memory. Note that UF2s always store complete 256 byte-aligned blocks of 256 bytes, and the range is expanded
accordingly
<from>
The lower address bound in hex
<to>
The upper address bound in hex
Source device selection
--bus <bus>
Filter devices by USB bus number
--address <addr>
Filter devices by USB device address
--vid <vid>
Filter by vendor id
--pid <pid>
Filter by product id
--ser <ser>
Filter by serial number
-f, --force
Force a device not in BOOTSEL mode but running compatible code to reset so the command can be executed. After executing the
command (unless the command itself is a 'reboot') the device will be rebooted back to application mode
-F, --force-no-reboot
Force a device not in BOOTSEL mode but running compatible code to reset so the command can be executed. After executing the
command (unless the command itself is a 'reboot') the device will be left connected and accessible to picotool, but without the
RPI-RP2 drive mounted
File to save to
<filename>
The file name
-t <type>
Specify file type (uf2 | elf | bin) explicitly, ignoring file extensionz.B. zuerst schauen, was auf dem Gerät ist...
$ picotool info
Program Information
name: lcd_1602_i2c
web site: https://github.com/raspberrypi/pico-examples/tree/HEAD/i2c/lcd_1602_i2c... in einer Datei speichern ...
$ picotool save spoon.uf2
Saving file: [==============================] 100%
Wrote 51200 bytes to spoon.uf2... und schaue mir die Datei an:
$ picotool info spoon.uf2
File spoon.uf2:
Program Information
name: lcd_1602_i2c
web site: https://github.com/raspberrypi/pico-examples/tree/HEAD/i2c/lcd_1602_i2c seal können Sie eine Binärdatei signieren und/oder hashen, um sie auf RP2350 auszuführen.
Standardmäßig wird nur die Binärdatei signiert, dies kann jedoch mit den Argumenten --hash und --no-sign konfiguriert werden.
Ihr Signaturschlüssel muss für die Kurve secp256k1 im PEM-Format vorliegen. Sie können eine .PEM-Datei erstellen mit:
openssl ecparam -name secp256k1 -genkey -out private.pem
$ picotool help seal
SEAL:
Add final metadata to a binary, optionally including a hash and/or signature.
SYNOPSIS:
picotool seal [--quiet] [--verbose] [--hash] [--sign] [--clear] <infile> [-t <type>] [-o <offset>] <outfile> [-t <type>] [<key>] [-t
<type>] [<otp>] [-t <type>] [--major <major>] [--minor <minor>] [--rollback <rollback> [<rows>..]]
OPTIONS:
--quiet
Don't print any output
--verbose
Print verbose output
--major <major>
Add Major Version
--minor <minor>
Add Minor Version
--rollback <rollback> [<rows>..]
Add Rollback Version
Configuration
--hash
Hash the file
--sign
Sign the file
--clear
Clear all of SRAM on load
File to load from
<infile>
The file name
-t <type>
Specify file type (uf2 | elf | bin) explicitly, ignoring file extension
BIN file options
-o, --offset
Specify the load address for a BIN file
<offset>
Load offset (memory address; default 0x10000000)
File to save to
<outfile>
The file name
-t <type>
Specify file type (uf2 | elf | bin) explicitly, ignoring file extension
Key file
<key>
The file name
-t <type>
Specify file type (pem) explicitly, ignoring file extension
File to save OTP to (will edit existing file if it exists)
<otp>
The file name
-t <type>
Specify file type (json) explicitly, ignoring file extension encrypt können Sie eine Binärdatei zur Verwendung auf dem RP2350 verschlüsseln und signieren. Standardmäßig wird die verschlüsselte Binärdatei signiert, dies kann jedoch ähnlich wie bei picotool sign konfiguriert werden.
Die verschlüsselte Binärdatei hat die folgende Struktur:
Erster Metadatenblock (5 Wörter)
IV (4 Wörter)
Verschlüsselte Binärdatei
Auffüllen, um sicherzustellen, dass die verschlüsselte Länge ein Vielfaches von 4 Wörtern ist
Signaturmetadatenblock
Der AES-Schlüssel muss als .bin-Datei des 256-Bit-AES-Schlüssels bereitgestellt werden, der für die Verschlüsselung verwendet werden soll.
$ picotool help encrypt
ENCRYPT:
Encrypt the program.
SYNOPSIS:
picotool encrypt [--quiet] [--verbose] [--hash] [--sign] <infile> [-t <type>] [-o <offset>] <outfile> [-t <type>] <aes_key> [-t <type>]
[<signing_key>] [-t <type>]
OPTIONS:
--quiet
Don't print any output
--verbose
Print verbose output
Signing Configuration
--hash
Hash the encrypted file
--sign
Sign the encrypted file
File to load from
<infile>
The file name
-t <type>
Specify file type (uf2 | elf | bin) explicitly, ignoring file extension
BIN file options
-o, --offset
Specify the load address for a BIN file
<offset>
Load offset (memory address; default 0x10000000)
File to save to
<outfile>
The file name
-t <type>
Specify file type (uf2 | elf | bin) explicitly, ignoring file extension
AES Key
<aes_key>
The file name
-t <type>
Specify file type (bin) explicitly, ignoring file extension
Signing Key file
<signing_key>
The file name
-t <type>
Specify file type (pem) explicitly, ignoring file extension Mit den partition können Sie mit den Partitionstabellen auf RP2350-Geräten interagieren und diese auch erstellen.
$ picotool help partition info
PARTITION INFO:
Print the device's partition table.
SYNOPSIS:
picotool partition info -m <family_id> [device-selection]
OPTIONS:
-m <family_id> [device-selection]$ picotool partition info
un-partitioned_space : S(rw) NSBOOT(rw) NS(rw), uf2 { absolute }
partitions:
0(A) 00002000->00201000 S(rw) NSBOOT(rw) NS(rw), id=0000000000000000, "A", uf2 { rp2350-arm-s, rp2350-riscv }, arm_boot 1, riscv_boot 1
1(B w/ 0) 00201000->00400000 S(rw) NSBOOT(rw) NS(rw), id=0000000000000001, "B", uf2 { rp2350-arm-s, rp2350-riscv }, arm_boot 1, riscv_boot 1$ picotool partition info -m rp2350-arm-s
un-partitioned_space : S(rw) NSBOOT(rw) NS(rw), uf2 { absolute }
partitions:
0(A) 00002000->00201000 S(rw) NSBOOT(rw) NS(rw), id=0000000000000000, "A", uf2 { rp2350-arm-s, rp2350-riscv }, arm_boot 1, riscv_boot 1
1(B w/ 0) 00201000->00400000 S(rw) NSBOOT(rw) NS(rw), id=0000000000000001, "B", uf2 { rp2350-arm-s, rp2350-riscv }, arm_boot 1, riscv_boot 1
Family id 'rp2350-arm-s' can be downloaded in partition 0:
00002000->00201000Mit diesem Befehl können Sie Partitionstabellen erstellen und diese zusätzlich in die Blockschleife von ELF-Dateien einbetten (z. B. für Bootloader). Standardmäßig werden alle Partitionstabellen gehasht und Sie können sie auch signieren.
$ picotool help partition create
PARTITION CREATE:
Create a partition table from json
SYNOPSIS:
picotool partition create [--quiet] [--verbose] <infile> [-t <type>] <outfile> [-t <type>] [[-o <offset>] [--family <family_id>]]
[<bootloader>] [-t <type>] [[--sign <keyfile>] [-t <type>] [--no-hash] [--singleton]] [[--abs-block] [<abs_block_loc>]]
OPTIONS:
--quiet
Don't print any output
--verbose
Print verbose output
partition table JSON
<infile>
The file name
-t <type>
Specify file type (json) explicitly, ignoring file extension
output file
<outfile>
The file name
-t <type>
Specify file type (uf2 | elf | bin) explicitly, ignoring file extension
UF2 output options
-o, --offset
Specify the load address for UF2 file output
<offset>
Load offset (memory address; default 0x10000000)
--family
Specify the family if for UF2 file output
<family_id>
family id for UF2 (default absolute)
embed partition table into bootloader ELF
<bootloader>
The file name
-t <type>
Specify file type (elf) explicitly, ignoring file extension
Partition Table Options
--sign <keyfile>
The file name
-t <type>
Specify file type (pem) explicitly, ignoring file extension
--no-hash
Don't hash the partition table
--singleton
Singleton partition table
Errata RP2350-E9 Fix
--abs-block
Enforce support for an absolute block
<abs_block_loc>
absolute block location (default to 0x10ffff00) Die uf2 -Befehle ermöglichen die Erstellung von UF2s und Cam stellt Informationen bereit, wenn ein UF2-Download fehlgeschlagen ist.
Dieser Befehl ersetzt die elf2uf2-Funktionalität, die zuvor im Raspberry Pi Pico SDK enthalten war. Es wird versucht, die Familien-ID automatisch zu erkennen. Wenn dies jedoch fehlschlägt, können Sie eine manuell mit dem Argument --family angeben.
picotool help uf2 convert
UF2 CONVERT:
Convert ELF/BIN to UF2.
SYNOPSIS:
picotool uf2 convert [--quiet] [--verbose] <infile> [-t <type>] <outfile> [-t <type>] [-o <offset>] [--family <family_id>]
[[--abs-block] [<abs_block_loc>]]
OPTIONS:
--quiet
Don't print any output
--verbose
Print verbose output
File to load from
<infile>
The file name
-t <type>
Specify file type (uf2 | elf | bin) explicitly, ignoring file extension
File to save UF2 to
<outfile>
The file name
-t <type>
Specify file type (uf2) explicitly, ignoring file extension
Packaging Options
-o, --offset
Specify the load address
<offset>
Load offset (memory address; default 0x10000000 for BIN file)
UF2 Family options
<family_id>
family id for UF2
Errata RP2350-E9 Fix
--abs-block
Add an absolute block
<abs_block_loc>
absolute block location (default to 0x10ffff00)Dieser Befehl liest die Informationen auf einem Gerät darüber, warum ein UF2-Download fehlgeschlagen ist. Es werden nur Informationen angezeigt, wenn der letzte Download fehlgeschlagen ist.
$ picotool help uf2 info
UF2 INFO:
Print info about UF2 download.
SYNOPSIS:
picotool uf2 info [device-selection]
OPTIONS:
Target device selection
--bus <bus>
Filter devices by USB bus number
--address <addr>
Filter devices by USB device address
--vid <vid>
Filter by vendor id
--pid <pid>
Filter by product id
--ser <ser>
Filter by serial number
-f, --force
Force a device not in BOOTSEL mode but running compatible code to reset so the command can be executed. After executing the
command (unless the command itself is a 'reboot') the device will be rebooted back to application mode
-F, --force-no-reboot
Force a device not in BOOTSEL mode but running compatible code to reset so the command can be executed. After executing the
command (unless the command itself is a 'reboot') the device will be left connected and accessible to picotool, but without the
RPI-RP2 drive mounted Die otp -Befehle dienen der Interaktion mit dem RP2350 OTP-Speicher. Sie sind auf RP2040-Geräten nicht verfügbar, da RP2040 kein OTP hat.
Beachten Sie, dass der OTP-Speicher einmalig programmierbar ist, was bedeutet, dass ein einmal geändertes Bit von 0 auf 1 nicht mehr zurück geändert werden kann. Daher ist bei der Verwendung dieser Befehle Vorsicht geboten, da die Gefahr besteht, dass Ihr RP2350-Gerät beschädigt wird. Wenn Sie beispielsweise SECURE_BOOT_ENABLE festlegen, aber keinen Startschlüssel festlegen und die PICOBOOT-Schnittstelle deaktivieren, ist Ihr Gerät unbrauchbar.
Für die Befehle list , set , get und „ load können Sie Ihr eigenes OTP-Layout in einer JSON-Datei definieren und dieses mit dem Argument -i übergeben. Diese Zeilen werden beim Parsen zu den Standardzeilen hinzugefügt.
$ picotool help otp
OTP:
Commands related to the RP2350 OTP (One-Time-Programmable) Memory
SYNOPSIS:
picotool otp list [-p] [-n] [-i <filename>] [<selector>..]
picotool otp get [-c <copies>] [-r] [-e] [-n] [-i <filename>] [device-selection] [-z] [<selector>..]
picotool otp set [-c <copies>] [-r] [-e] [-i <filename>] [-z] <selector> <value> [device-selection]
picotool otp load [-r] [-e] [-s <row>] [-i <filename>] <filename> [-t <type>] [device-selection]
picotool otp dump [-r] [-e] [device-selection]
picotool otp permissions <filename> [-t <type>] [--led <pin>] [--hash] [--sign] [<key>] [-t <type>] [device-selection]
picotool otp white-label -s <row> <filename> [-t <type>] [device-selection]
SUB COMMANDS:
list List matching known registers/fields
get Get the value of one or more OTP registers/fields (RP2350 only)
set Set the value of an OTP row/field (RP2350 only)
load Load the row range stored in a file into OTP and verify. Data is 2 bytes/row for ECC, 4 bytes/row for raw. (RP2350 only)
dump Dump entire OTP (RP2350 only)
permissions Set the OTP access permissions (RP2350 only)
white-label Set the white labelling values in OTP (RP2350 only) Mit diesen Befehlen werden bestimmte OTP-Zeilen festgelegt/abgerufen. Standardmäßig schreiben/lesen sie alle redundanten Zeilen, dies kann jedoch mit dem Argument -c überschrieben werden
Dieser Befehl ermöglicht das Laden einer Reihe von OTP-Zeilen auf das Gerät. Die Quelle kann eine Binärdatei oder eine JSON-Datei sein, wie sie beispielsweise von picotool sign ausgegeben wird. Wenn Sie beispielsweise eine Binärdatei signieren und dann den sicheren Start damit testen möchten, können Sie den folgenden Befehlssatz ausführen:
$ picotool sign hello_world.elf hello_world.signed.elf private.pem otp.json
$ picotool load hello_world.signed.elf
$ picotool otp load otp.json
$ picotool rebootDieser Befehl ermöglicht OTP-White-Labeling, das die vom Gerät verwendete USB-Konfiguration im BOOTSEL-Modus festlegt. Dies kann über eine JSON-Datei konfiguriert werden, ein Beispiel dafür finden Sie in „sample-wl.json“.
<cod 
