From ed3039cdbeeb28fc0011c3585d8f7dfb91038292 Mon Sep 17 00:00:00 2001 From: Andre Przywara Date: Wed, 22 Feb 2023 21:50:59 +0000 Subject: [PATCH] fel: sid: add documentation 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 --- fel.c | 3 +++ sunxi-fel.1 | 19 +++++++++++++++++-- 2 files changed, 20 insertions(+), 2 deletions(-) diff --git a/fel.c b/fel.c index 576b0d67c..c15033156 100644 --- a/fel.c +++ b/fel.c @@ -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); diff --git a/sunxi-fel.1 b/sunxi-fel.1 index 35b781c61..42aed744c 100644 --- a/sunxi-fel.1 +++ b/sunxi-fel.1 @@ -116,6 +116,13 @@ Request a warm reset of the core, starting execution in the 64-bit AArch64 execution state, at
. .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 .RS 4 Copy bytes within device memory, from to . @@ -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