Build docs

README.md

@@ -25,10 +25,24 @@ git submodule update --init agnos-kernel-sdm845
 ```
 
 Building
-```
-./build_kernel.sh
-./build_system.sh
-```
+
+1. (Optional) Because AGNOS currently packages dependencies that [openpilot](https://github.com/commaai/openpilot) uses, run `./sync_openpilot_dependencies.sh` to update them.
+
+2. (Optional) The setup, reset, and updater UIs are Python [zipapps](https://docs.python.org/3/library/zipapp.html) built from openpilot using `release/pack.py`. To rebuild them, run from the openpilot repo:
+
+    ```
+    cd /path/to/openpilot
+    python release/pack.py -o /path/to/agnos-builder/userspace/usr/comma/setup openpilot.system.ui.mici_setup
+    python release/pack.py -o /path/to/agnos-builder/userspace/usr/comma/reset openpilot.system.ui.reset
+    python release/pack.py -o /path/to/agnos-builder/userspace/usr/comma/updater openpilot.system.ui.updater
+    ```
+
+3. Build the kernel and system images:
+
+    ```
+    ./build_kernel.sh
+    ./build_system.sh
+    ```
 
 Flashing to a comma 3/3X (Be sure to set your device in QDL mode before flashing. Refer to [QDL MODE Section](https://flash.comma.ai/) for more information.):
 ```
@@ -38,6 +52,21 @@ Flashing to a comma 3/3X (Be sure to set your device in QDL mode before flashing
 ./flash_all.sh 
 ```
 
+### Troubleshooting
+
+**GPT headers corrupted after flash.comma.ai**: If `tools/edl setactiveslot` fails with "both gpt headers are corrupted", flash directly to slot a:
+```
+tools/edl w boot_a output/boot.img
+tools/edl w system_a output/system.img
+tools/edl reset
+```
+
+**Namespace runners**: To build using [namespace.so](https://namespace.so) remote ARM64 builders, prefix with `NS=1`:
+```
+NS=1 ./build_system.sh
+NS=1 ./build_kernel.sh
+```
+
 In the event that flashing from building doesn't work, `scripts/download-from-manifest.py` allows you to download the latest AGNOS version for flashing.
 
 > [!NOTE]