From: Harsha Vardhan V M <h-vm@ti.com>
Date: Wed, 19 Mar 2025 08:47:14 +0000 (+0530)
Subject: doc: cmd: Add fuse writebuff cmd documentation
X-Git-Tag: v2025.07-rc1~119^2~6^2
X-Git-Url: http://git.openpandora.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9f6b1ff8d08a92bbddf3c6226b8c2fdaf8df9515;p=pandora-u-boot.git

doc: cmd: Add fuse writebuff cmd documentation

Add fuse writebuff sub-system command documentation.

Signed-off-by: Harsha Vardhan V M <h-vm@ti.com>
---

diff --git a/doc/usage/cmd/fuse.rst b/doc/usage/cmd/fuse.rst
index 6e330eddfea..42c6e209f99 100644
--- a/doc/usage/cmd/fuse.rst
+++ b/doc/usage/cmd/fuse.rst
@@ -17,6 +17,7 @@ Synopsis
     fuse sense <bank> <word> [<cnt>]
     fuse prog [-y] <bank> <word> <hexval> [<hexval>...]
     fuse override <bank> <word> <hexval> [<hexval>...]
+    fuse writebuff [-y] <addr>
 
 Description
 -----------
@@ -79,6 +80,16 @@ Commands
   fuses have already been programmed or are locked (if the SoC allows to
   override a locked fuse).
 
+- **fuse writebuff [-y] <addr>**
+  Programs fuse data using a structured buffer in memory starting at 'addr'.
+  This operation directly affects the fusebox and is irreversible.
+
+  The structure of the buffer should contain all necessary details for
+  programming fuses, such as the values to be written to the fuse, optional
+  metadata for validation or programming constraints and any configuration
+  data required for the operation. Define CONFIG_CMD_FUSE_WRITEBUFF to
+  enable the fuse writebuff command.
+
 Examples
 --------
 
@@ -144,10 +155,19 @@ fuse override
     u-boot=> fuse override 0 1 0x00000003
       Overriding bank 0 word 0x00000001 with 0x00000003...
 
+fuse writebuff
+~~~~~~~~~~~~~~
+
+::
+
+    u-boot=> fuse writebuff -y 0x84000000
+      Programming fuses with buffer at addr 0x84000000
+
 Configuration
 -------------
 
 The fuse commands are available if CONFIG_CMD_FUSE=y.
+The fuse writebuff command is available if CONFIG_CMD_FUSE_WRITEBUFF=y.
 
 Return code
 -----------