Add OTP settings JSON schema

README.md

@@ -940,7 +940,7 @@ These commands will set/get specific rows of OTP. By default, they will write/re
 
 ### load
 
-This command allows loading of a range of OTP rows onto the device. The source can be a binary file, or a JSON file such as the one output by `picotool sign`.
+This command allows loading of a range of OTP rows onto the device. The source can be a binary file, or a JSON file such as the one output by `picotool sign`. The schema for this JSON file is [here](json/schemas/otp-schema.json)
 For example, if you wish to sign a binary and then test secure boot with it, you can run the following set of commands:
 ```text
 $ picotool sign hello_world.elf hello_world.signed.elf private.pem otp.json

json/schemas/otp-schema.json

@@ -0,0 +1,50 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "title": "OTP Settings",
+    "description": "OTP Settings",
+    "type": "object",
+    "properties": {"$schema": {}},
+    "patternProperties": {
+        "^\\d{1,2}:\\d{1,2}$": {
+            "description": "Generic OTP Row",
+            "type": "object",
+            "properties": {
+                "ecc": {
+                    "description": "Protect with ECC",
+                    "type": "boolean"
+                },
+                "value": {
+                    "description": "Value to write",
+                    "type": ["array", "string", "integer"],
+                    "pattern": "^0x[0-9a-fA-F]{1,6}$",
+                    "items": {
+                        "description": "Data Byte",
+                        "type": ["string", "integer"],
+                        "pattern": "^0x[0-9a-fA-F]{1,2}$"
+                    }
+                }
+            },
+            "additionalProperties": false,
+            "required": ["ecc", "value"]
+        },
+        "^[\\d\\w_]+$": {
+            "description": "Defined OTP Row",
+            "type": ["object", "array", "string", "integer"],
+            "pattern": "^0x[0-9a-fA-F]{1,6}$",
+            "items": {
+                "description": "Data Byte",
+                "type": ["string", "integer"],
+                "pattern": "^0x[0-9a-fA-F]{1,2}$"
+            },
+            "patternProperties": {
+                "^[\\d\\w_]+$": {
+                    "description": "OTP Field",
+                    "type": ["string", "integer"],
+                    "pattern": "^0x[0-9a-fA-F]{1,6}$"
+                }
+            },
+            "additionalProperties": false
+        }
+    },
+    "additionalProperties": false
+}