Skip to content

Commit

Permalink
fel: sid: add documentation
Browse files Browse the repository at this point in the history
The new sid-dump command was missing documentation. Add it to the
internal usage() function as well as to the manpage.
Clarify on the existing sid-registers command on the way, and add
a stanza for the wdreset command.

Signed-off-by: Andre Przywara <[email protected]>
  • Loading branch information
apritzel committed Mar 5, 2023
1 parent 536a191 commit ed3039c
Show file tree
Hide file tree
Showing 2 changed files with 20 additions and 2 deletions.
3 changes: 3 additions & 0 deletions fel.c
Original file line number Diff line number Diff line change
Expand Up @@ -1273,6 +1273,9 @@ void usage(const char *cmd) {
" echo-gauge \"some text\" Update prompt/caption for gauge output\n"
" ver[sion] Show BROM version\n"
" sid Retrieve and output 128-bit SID key\n"
" sid-registers Retrieve and output 128-bit SID key,\n"
" using the MMIO register read method\n"
" sid-dump Dump the content of all the SID eFuses\n"
" clear address length Clear memory\n"
" fill address length value Fill memory\n"
, cmd);
Expand Down
19 changes: 17 additions & 2 deletions sunxi-fel.1
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,13 @@ Request a warm reset of the core, starting execution in the 64-bit AArch64
execution state, at <address>.
.RE
.PP
.B wdreset
.RS 4
Reset the device by triggering the watchdog with the shortest possible period.
This will reset the whole SoC, including all on-SoC peripherals, but might not
affect on-board devices like PMICs or PHYs.
.RE
.PP
.B memmove <dest> <source> <size>
.RS 4
Copy <size> bytes within device memory, from <source> to <dest>.
Expand Down Expand Up @@ -203,10 +210,18 @@ number, which should be unique to each chip (although there have been reports
of same SIDs for particular batches of chips).
.RE
.PP
.B sid-register
.B sid-registers
.RS 4
As the "sid" command above, but use the alternative MMIO register access method
on the device. Some SoCs require this method for reliable results.
on the device. There are SoCs that require this method due to bugs in the SID
implementation, those known will automatically choose this workaround when using
the "sid" command. This command here is to test new SoCs for compliance.
.RE
.PP
.B sid-dump
.RS 4
Read the entire SID eFuses array and dump its content. For SoCs with a known
eFuses layout, this will annotate the known regions.
.RE
.PP
.B clear <address> <length>
Expand Down

0 comments on commit ed3039c

Please sign in to comment.