From 10573cec081f8a8da1bc64eb08ca3244c4427bc9 Mon Sep 17 00:00:00 2001
From: stefan-b-jakobsson <stefan.b.jakobsson@gmail.com>
Date: Wed, 24 Jul 2024 07:02:11 +0300
Subject: [PATCH] Documentation fixes

---
 bootloader/README.md     |  2 +-
 doc/readme_artifacts.txt | 44 +++++++++++++++++++++++++---------------
 2 files changed, 29 insertions(+), 17 deletions(-)

diff --git a/bootloader/README.md b/bootloader/README.md
index 337867c..b9cff60 100644
--- a/bootloader/README.md
+++ b/bootloader/README.md
@@ -192,7 +192,7 @@ Available since bootloader v3.
 Sets the target address page that is used when reading from or writing
 to the SMC.
 
-The byte address is 64 * the target address.
+The byte address is 64 * page.
 
 Available since bootloader v3.
 
diff --git a/doc/readme_artifacts.txt b/doc/readme_artifacts.txt
index 3287e40..f2eb591 100644
--- a/doc/readme_artifacts.txt
+++ b/doc/readme_artifacts.txt
@@ -12,8 +12,24 @@ IMPORTANT INFORMATION - PLEASE READ BEFORE INSTALLING
     requiring the SMC to be programmed with an external
     programmer.
     
+2. The SMCUPDATE-x.x.x.PRG file
 
-1. The firmware_with_bootloader.hex file
+    This is a program that you can run on the
+    X16 to update the firmware. The firmware is 
+    emedded into the program and you do not need any
+    other files.
+
+
+3. The SMC-x.x.x.BIN file
+
+    This file contains the firmware in binary format plus
+    a header needed if you program the SMC with the
+    following tool:
+
+    https://github.com/FlightControl-User/x16-flash
+
+
+4. The firmware_with_bootloader.hex file
 
     This file contains the firmware and a bootloader
     that makes it possible to update the SMC from the
@@ -23,27 +39,23 @@ IMPORTANT INFORMATION - PLEASE READ BEFORE INSTALLING
     the SMC with an external programmer.
 
 
-2. The x16-smc.ino.hex file
+5. The x16-smc.ino.hex and x16-smc.ino.elf files
 
-    This file contains the firmare in Intel HEX format.
-    It does not contain a bootloader.
+    These files contain the firmare in hex and elf format
+    without a bootloader.
 
-    It is an alternative option if you are programming
+    They are alternative options if you are programming
     the SMC with an external programmer.
 
 
-4. The SMCUPDATE-x.x.x.PRG file
-
-    This file is a program that you can run on the
-    X16 to update the firmware. The firmware is 
-    emedded into the program and you do not need any
-    other files.
+6. The bootloader.bin file
 
+    This is the the bootloader in binary format without
+    firmware. It can be used to update the bootloader
+    with the tool SMCBLW16.PRG that runs on the X16.
 
-5. The SMC-x.x.x.BIN file
 
-    This file contains the firmware in binary format plus
-    a header needed if you program the SMC with the
-    following tool:
+7. The bootloader.hex file
 
-    https://github.com/FlightControl-User/x16-flash
+    This is the bootloader in hex format without
+    firmware.