From 051c76890abf2002a736c7b2d4af9b2f86c3ecd3 Mon Sep 17 00:00:00 2001
From: Dany LE <xsang.le@gmail.com>
Date: Sun, 23 Nov 2025 15:19:30 +0100
Subject: [PATCH] doc: add instruction on boot & rootfs

---
 README.md                   | 52 +++++++++++++++++++++++++++++++++++++
 mkboot/u4go-ufi003/img_info | 12 +++++++++
 mkboot/u4go-uz801/img_info  | 12 +++++++++
 3 files changed, 76 insertions(+)
 create mode 100644 README.md
 create mode 100644 mkboot/u4go-ufi003/img_info
 create mode 100644 mkboot/u4go-uz801/img_info

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..094e4ce
--- /dev/null
+++ b/README.md
@@ -0,0 +1,52 @@
+# flash openstick base-generic images
+
+To activate ADB, insert the stick and allow it to fully boot up. Then establish a WiFi connection with the stick using the credentials specified on its back. After successfully logging in, launch a webbrowser and navigate to the stick’s management page at http://192.168.100.1. Log in with the username/password combination “admin.”
+
+Once logged in, visit http://192.168.100.1/usbdebug.html to enable ADB. Reboot the stick (by reinserting the stick into the PC) and verify that ADB is active post-reboot.
+
+```sh
+adb devices
+List of devices attached
+0123456789ABCDEF	device
+```
+
+Boot to EDL
+
+```sh
+adb reboot edl
+```
+
+Next, retrieve the EDL tool from Bjoern Kerler’s GitHub page: https://github.com/bkerler/edl.git and follow the provided instructions to install the necessary dependencies. Once installed, proceed to generate various backups.
+
+```sh
+python3 edl.py rf usb4g-stock.bin
+python3 edl.py rl uz801_stock --genxml
+```
+
+Reboot to fastboot
+
+```sh
+adb reboot bootloader
+```
+
+
+Download and extract the  `base-generic.zip` from https://github.com/OpenStick/OpenStick/releases/download/v1/base-generic.zip, and run the `base/flash.sh` script
+
+# Make boot image from yocto generated files
+
+```sh
+# example for for ufi003
+cd mkboot/
+cat u4go-ufi003/zImage u4go-ufi003/ufi003x.dtb > kernel
+# mkboot tools from https://git.iohub.dev/dany/mkbootimg_tools
+mkboot u4go-ufi003 boot-ufi003.img
+fastboot flash boot boot-ufi003.img
+```
+
+# Make roofs sparse image from yocto generate .ext4 file
+
+```sh
+# img2simg shall be installed
+img2simg rootfs.ext4 rootfs.img
+fastboot -S 200M flash rootfs rootfs.img
+```
\ No newline at end of file
diff --git a/mkboot/u4go-ufi003/img_info b/mkboot/u4go-ufi003/img_info
new file mode 100644
index 0000000..e302690
--- /dev/null
+++ b/mkboot/u4go-ufi003/img_info
@@ -0,0 +1,12 @@
+kernel=kernel
+ramdisk=ramdisk
+page_size=2048
+kernel_size=6957457
+ramdisk_size=6627049
+base_addr=0x80078000
+kernel_offset=0x00008000
+ramdisk_offset=0x01f88000
+tags_offset=0x01d88000
+cmd_line='earlycon root=PARTUUID=a7ab80e8-e9d1-e8cd-f157-93f69b1d141e console=ttyMSM0,115200 no_framebuffer=true rw'
+board=""
+format=gzip
\ No newline at end of file
diff --git a/mkboot/u4go-uz801/img_info b/mkboot/u4go-uz801/img_info
new file mode 100644
index 0000000..625ca0a
--- /dev/null
+++ b/mkboot/u4go-uz801/img_info
@@ -0,0 +1,12 @@
+kernel=kernel
+ramdisk=ramdisk
+page_size=2048
+kernel_size=6957145
+ramdisk_size=6627049
+base_addr=0x80078000
+kernel_offset=0x00008000
+ramdisk_offset=0x01f88000
+tags_offset=0x01d88000
+cmd_line='earlycon root=PARTUUID=a7ab80e8-e9d1-e8cd-f157-93f69b1d141e console=ttyMSM0,115200 no_framebuffer=true rw'
+board=""
+format=gzip
\ No newline at end of file