Buildroot release + sample images

Author: alexcaoys

BUILDING.md

@@ -5,6 +5,8 @@ Please check the commits in the [kernel repo](https://github.com/alexcaoys/linux
 
 My dts for superbird: `arch/arm64/boot/dts/amlogic/meson-g12a-superbird.dts`
 
+`make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- LOCALVERSION= Image dtbs`
+
 Porting from old dts to new, watch out for field changes, \
 eg. GPIO pinctrl: pins -> groups
 

README.md

@@ -4,30 +4,48 @@
 
 Anyway, if you still think this will become e-waste for you, **you can for sure support this project by sending it to me :)**
 
-**TRY EVERYTHING BELOW AT YOUR OWN RISK!!!**
-
-**EXPERT USERS ONLY. If you don't know what you are doing, STOP**.
+**TRY EVERYTHING BELOW AT YOUR OWN RISK!!! If you don't know what you are doing, STOP**.
 
 **Kernel repo**: https://github.com/alexcaoys/linux-superbird-6.6.y
 
-For notes on my kernel tweaks as well as support matrix, please refer to [BUILDING.md](https://github.com/alexcaoys/notes-superbird/blob/main/BUILDING.md).
+For notes on my kernel tweaks as well as support matrix, please refer to [`BUILDING.md`](BUILDING.md).
 
-## Release
+# Release
 
-**[RELEASE_NOTES.md](https://github.com/alexcaoys/notes-superbird/blob/main/RELEASE_NOTES.md)**
+[`RELEASE_NOTES.md`](RELEASE_NOTES.md)
 
 Compiled Kernel will be available on Kernel Repo [release](https://github.com/alexcaoys/linux-superbird-6.6.y/releases) section.
 
-Since display is only working partially, I don't consider this as good for all users. But you are welcome to try. Hopefully we can get this fix ASAP.
+The only major issue now is the display refresh rate is not considered as 60Hz within the system, not sure what is the actual refresh rate though. Please refer to this [issue](https://github.com/alexcaoys/notes-superbird/issues/3) for details.
+
+My Buildroot rootfs is available on this release page. But Buildroot is pretty much a customizable system so do try it out on your own. **It's amazing!**
+
+# TL;DR
+
+**Beaware of all the consequences and you can get started.**
+
+![foot](buildroot/images/sway_foot.jpg | width=100) \
+![overskride](buildroot/images/overskride.jpg | width=100) \
+![youtube](buildroot/images/youtube.jpg | width=100)
+
+## Dualboot (Just to try it out)
+
+Please follow the section **Boot using stock partition table** below. 
+
+## Use the whole eMMC
+
+1. Please follow the steps in [`PARTITIONING.md`](partitioning/PARTITIONING.md) to repartition and restore the system image.
+2. send `env/env_full_custom.txt` to the device. Please refer to the section **Boot using custom partition table** below for details.
+3. after login using `ssh`, `/root/first_login.sh` to run some additional touchups.
 
-I will consider uploading my Buildroot rootfs to this release page. But Buildroot is pretty much a customizable system so do try it out on your own. **It's amazing!**
+Please read [`BUILDROOT.md`](buildroot/BUILDROOT.md) for additional tips/details, etc.
 
 # Boot
 
 - pyamlboot: https://github.com/superna9999/pyamlboot (For `pyusb` to work, [please check](https://github.com/pyusb/pyusb/issues/237))
 - Restore partitions using superbird-tool: 
   - https://github.com/Car-Thing-Hax-Community/superbird-tool
-  - https://github.com/bishopdynamics/superbird-tool ([maintainer seems MIA, not updating](https://github.com/alexcaoys/notes-superbird/issues/6))
+  - https://github.com/bishopdynamics/superbird-tool ([maintainer seems MIA](https://github.com/alexcaoys/notes-superbird/issues/6))
 - kernel params: https://www.kernel.org/doc/html/v6.6/admin-guide/kernel-parameters.html
 
 **In order for the display color to work properly, we need to bypass `init_display` within u-boot, you can either**
@@ -48,32 +66,31 @@ I created an Buildroot uInitrd image in case anything need an in-RAM system (rep
 
 Please use `python amlogic_device.py -i ENV_FILE KERNEL_FILE INITRD_FILE DTB_FILE` to boot kernel + dtb + uInitrd from host. Please check `initrd` folder.
 
-## Boot into stock partitions
+## Boot using stock partition table
 
 set `active_slot=_b` and **clear dtbo_b partition**. Otherwise custom dtb won't be loaded.
 
 1. Create empty `dtbo_b` and `boot_b` partitions by `dd` and restore to device.
 2. Restore new buildroot partition to `system_b`.
 3. Use `uboot_envs/env_b.txt` in this repo to boot. (`python amlogic_device.py -c ENV_FILE KERNEL_FILE DTB_FILE` to boot kernel + dtb from host)
 
-## Boot into custom partitions
+## Boot using custom partition table
 
-After **repartitioning** and restoring the rootfs as [`PARTITIONING.md`](https://github.com/alexcaoys/notes-superbird/blob/main/partitioning/PARTITIONING.md).
+After **repartitioning** and restoring the rootfs as [`PARTITIONING.md`](partitioning/PARTITIONING.md).
 
 Use `uboot_envs/env_p2.txt` in this repo to boot. 
 
 - `python amlogic_device.py -c ENV_FILE KERNEL_FILE DTB_FILE` to boot kernel + dtb from host, **OR**
-- Using `fatload` to load kernel and dtb from `mmcblk2p1` and `python amlogic_device.py -m ENV_FILE` to boot. **OR**
-- Send `env/env_full_custom.txt` to the device. Button 4 for burn mode, Normally it will load envs from `bootargs.txt` within `mmcblk2p1` and then boot into `mmcblk2p2` using `Image` and `superbird.dtb` from `mmcblk2p1`.
+- Send `env/env_full_custom.txt` to the device. **Button 4 for burn mode**, Normally it will load envs from `bootargs.txt` within `mmcblk2p1` and then boot into `mmcblk2p2` using `Image` and `superbird.dtb` from `mmcblk2p1`.
 
 # Partitioning
-[`PARTITIONING.md`](https://github.com/alexcaoys/notes-superbird/blob/main/partitioning/PARTITIONING.md)
+[`PARTITIONING.md`](partitioning/PARTITIONING.md)
 
 # Buildroot
 
-[`BUILDROOT.md`](https://github.com/alexcaoys/notes-superbird/blob/main/buildroot/BUILDROOT.md)
+[`BUILDROOT.md`](buildroot/BUILDROOT.md)
 
 # EXTRA
 
-- [u-Boot](https://github.com/alexcaoys/notes-superbird/blob/main/BUILDING.md#u-boot)
-- [Armbian](https://github.com/alexcaoys/notes-superbird/blob/main/BUILDING.md#armbian)
+- [u-Boot](BUILDING.md#u-boot)
+- [Armbian](BUILDING.md#armbian)

RELEASE_NOTES.md

@@ -2,6 +2,15 @@
 
 ## Latest
 
+- Buildroot: [buildroot_20240804](https://github.com/alexcaoys/notes-superbird/releases/tag/20240804)
+
+    First release of Buildroot. Please check `README.md` for details.
+
+    - Using `initrd/config_buildroot_sway_overskride`. 
+    - Based on Buildroot 2024.02.4, but there are some tweaks (Sway + Overskride).
+    - Both `g_ether` and USB `eth` is available, please read `BUILDROOT.md` for details.
+    - Sway key mapping, Bluetooth, Browser examples included. 
+
 - Linux & modules: [6.6.43_20240801](https://github.com/alexcaoys/linux-superbird-6.6.y/releases/tag/6.6.43_20240801)
 
     Using `config_linux_20240729`.
@@ -11,7 +20,7 @@
 
     Working `panel-sitronix-st7701.c` config: The same as 6.6.32_20240618 below.
 
-- uInitrd: [20240724](https://github.com/alexcaoys/notes-superbird/releases/tag/20240724)
+- uInitrd: [initrd_20240724](https://github.com/alexcaoys/notes-superbird/releases/tag/20240724)
 
     Since this should contain all the features needed for **repartitioning and rescue rootfs**, in the future there won't be regular release of initrd. This release will be **all in one**, you still need to install `pyamlboot`, and then, `bash initrd.sh` should help you enter the initramfs.
 
@@ -21,8 +30,6 @@
     - `g_ether` will be enabled at boot. `ssh` is available. 
     - For partitioning only.
 
-- Buildroot: W.I.P
-
 ## Kernel
 
 - Linux: [6.6.41_20240724](https://github.com/alexcaoys/linux-superbird-6.6.y/releases/tag/6.6.41_20240724)

buildroot/BUILDROOT.md

@@ -24,6 +24,7 @@ rootfs_overlay/
 │   │   └── S89bluetooth    # using btattach to bring up UART Bluetooth
 │   ├── inittab             # auto login
 │   ├── pulse
+│   │   ├── daemon.conf     # define default configs for microphone
 │   │   └── system.pa       # pulseaudio enable bluetooth for root
 │   ├── resolv.conf         # nameserver
 │   └── ssh
@@ -56,8 +57,6 @@ rootfs_overlay/
     └── share
         └── overskride      # gresource for overskride
             └── overskride.gresource
-
-23 directories, 21 files
 ```
 
 ## GUI Applications
@@ -66,6 +65,11 @@ rootfs_overlay/
 https://lore.kernel.org/buildroot/?q=package%2Fsway:+make+systemd+optional&x=t) for Buildroot. \
 autologin + autolaunch `sway` is included. Please check `buildroot/rootfs_overlay/root/.config/sway/config` for some handy sway setup.
 
+1. Button 1 (Leftmost button) for `overskride` bluetooth settings.
+2. Button 2 for a Youtube embed demo (720p is doable).
+3. Button m (Rightmost button) for power on/off screen.
+4. After connect to a bluetooth keyboard, `Windows+Enter` for Terminal
+
 ### cog
 I include `cog` Browser on Buildroot. It can work on `sway`. \
 Standalone `cog -O renderer=gles` should also work with display & touchscreen. [Cog Docs](https://igalia.github.io/cog/platform-drm.html): not the best docs but works. For touch screen, please check [libinput transformation](https://wiki.archlinux.org/title/libinput#Via_Udev_Rule).

buildroot/images/overskride.jpg

@@ -21,7 +21,6 @@ case "$1" in
     else
       echo "FAIL"
     fi
-    return "$status"
     ;;
   stop)
     printf 'Stopping %s: ' "$DAEMON"
@@ -34,7 +33,6 @@ case "$1" in
     else
       echo "FAIL"
     fi
-    return "$status"
     ;;
   restart|reload)
     "$0" stop

buildroot/images/sway_foot.jpg

@@ -0,0 +1,92 @@
+# This file is part of PulseAudio.
+#
+# PulseAudio is free software; you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# PulseAudio is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with PulseAudio; if not, see <http://www.gnu.org/licenses/>.
+
+## Configuration file for the PulseAudio daemon. See pulse-daemon.conf(5) for
+## more information. Default values are commented out.  Use either ; or # for
+## commenting.
+
+; daemonize = no
+; fail = yes
+; allow-module-loading = yes
+; allow-exit = yes
+; use-pid-file = yes
+; system-instance = no
+; local-server-type = user
+; enable-shm = yes
+; enable-memfd = yes
+; shm-size-bytes = 0 # setting this 0 will use the system-default, usually 64 MiB
+; lock-memory = no
+; cpu-limit = no
+
+; high-priority = yes
+; nice-level = -11
+
+; realtime-scheduling = yes
+; realtime-priority = 5
+
+; exit-idle-time = 20
+; scache-idle-time = 20
+
+; dl-search-path = (depends on architecture)
+
+; load-default-script-file = yes
+; default-script-file = /etc/pulse/default.pa
+
+; log-target = auto
+; log-level = notice
+; log-meta = no
+; log-time = no
+; log-backtrace = 0
+
+resample-method = auto
+; avoid-resampling = false
+; enable-remixing = yes
+; remixing-use-all-sink-channels = yes
+; remixing-produce-lfe = no
+; remixing-consume-lfe = no
+; lfe-crossover-freq = 0
+
+; flat-volumes = no
+
+; rescue-streams = yes
+
+; rlimit-fsize = -1
+; rlimit-data = -1
+; rlimit-stack = -1
+; rlimit-core = -1
+; rlimit-as = -1
+; rlimit-rss = -1
+; rlimit-nproc = -1
+; rlimit-nofile = 256
+; rlimit-memlock = -1
+; rlimit-locks = -1
+; rlimit-sigpending = -1
+; rlimit-msgqueue = -1
+; rlimit-nice = 31
+; rlimit-rtprio = 9
+; rlimit-rttime = 200000
+
+default-sample-format = s32le
+; default-sample-rate = 44100
+; alternate-sample-rate = 48000
+; default-sample-channels = 2
+; default-channel-map = front-left,front-right
+
+; default-fragments = 4
+; default-fragment-size-msec = 25
+
+; enable-deferred-volume = yes
+; deferred-volume-safety-margin-usec = 8000
+; deferred-volume-extra-delay-usec = 0

buildroot/images/youtube.jpg

@@ -54,12 +54,11 @@ My backup `ampart` partitions output is in `ampart_partitions.txt`.
     ```
 10. reboot into `burn_mode`.
 11. Restore rootfs using `python amlogic_devices.py -r 319488 rootfs.ext2`. You may also use nfs and `dd` to do it within the initrd system.
-12. Reboot into uInitrd, check the partitions, copy the Image, dtb and `bootargs.txt`(`uboot_envs/env_p2.txt`), which is for loading bootargs dynamically) to the boot partition.
+12. Reboot into uInitrd, check the partitions, copy the Image, dtb and `bootargs.txt`(`uboot_envs/env_p2.txt`), which is for loading bootargs dynamically to the boot partition.
     ```
-    resize2fs /dev/mmcblk2p2
-    e2fsck /dev/mmcblk2p2
-    mkdir /root/mntpoint
-    mount /dev/mmcblk2p1 /root/mntpoint
-    scp user@172.16.42.1:/home/user/Image /root/mntpoint
-    scp user@172.16.42.1:/home/user/superbird.dtb /root/mntpoint
+    /root/init_resize2fs.sh
+    mount /dev/mmcblk2p1 /boot
+    scp user@172.16.42.1:/home/user/Image /boot
+    scp user@172.16.42.1:/home/user/superbird.dtb /boot
+    scp user@172.16.42.1:/home/user/env_p2.txt /boot/bootargs.txt
     ```