gx,rk33xx,h6: sync readmes with latest images

systems/allwinner_h6/readme.md

@@ -2,7 +2,7 @@
 
 ## bootable sd card images
 
-- none yet
+- https://github.com/hexdump0815/imagebuilder/releases/tag/210805-03
 
 ## tested systems - working
 
@@ -11,7 +11,7 @@
 
 ## untested systems
 
-- allwinner h6 based tv boxes
+- other allwinner h6 based tv boxes
 
 some more work will be required to make the devices below working
 
@@ -30,3 +30,9 @@ some more work will be required to make the devices below working
 ## special notes
 
 - tv boxes are always hit and miss, so they might work or might not work and are usually of low quality
+  - be happy in case it works for your box
+  - it is impossible to support all tv boxes with their wild mix of hardware or usually quite low quality, so please do not open github issues in case the images do not work for your box
+  - github issues with tested and structured information on how to get the images working on a box where they did not work out of the box are welcome
+  - sound is not working, wifi, bluetooth and sometimes even ethernet might work or might not work depending on the tv box
+- as allwinner socs always boot by default from sd card the emmc can safely be overwritten (but do a backup of the original android system via dd command beforehand - it might be useful later)
+- there are graphics errors due to problems with the self compiled mesa version being used on the image (the lightdm login screen is distorted and the login to the xfce session does not seem to work at all on the focal image) - installing a hopefully more stable newer self compiled version of mesa to /opt/mesa should hopefully fix this

systems/amlogic_gx/readme.md

@@ -2,27 +2,29 @@
 
 ## bootable sd card images
 
-- none yet
+- https://github.com/hexdump0815/imagebuilder/releases/tag/210805-01
 
 ## tested systems - working
 
-- odroid c2
+- odroid c2 (gxbb)
+- a95x f3 tv box (g12a)
 
 ## untested systems
 
-- amlogic s905 based tv boxes
-- amlogic s905x based tv boxes
-- amlogic s905w based tv boxes
+- amlogic s905 based tv boxes (gxbb)
+- amlogic s905x based tv boxes (gxl)
+- amlogic s905w based tv boxes (gxl)
+- amlogic s912 based tv boxes (gxm)
+- amlogic s905x2 based tv boxes (g12a)
+- amlogic s905x3 based tv boxes (sm1)
 
 some more work will be required to make the devices below working
 
-- nanopi k2
-- odroid c4
-- odroid n2
-- odroid n2+
-- amlogic s905x2 based tv boxes
-- amlogic s905x3 based tv boxes
-- amlogic s922x based tv boxes
+- nanopi k2 (gxbb)
+- odroid c4 (sm1)
+- odroid n2 (g12b)
+- odroid n2+ (g12b)
+- amlogic s922x based tv boxes (g12b)
 
 ## kernel build notes
 
@@ -33,9 +35,29 @@ some more work will be required to make the devices below working
 
 - https://github.com/hexdump0815/u-boot-misc/blob/master/readme.gxb
 - https://github.com/hexdump0815/u-boot-misc/blob/master/readme.gxl
-- https://github.com/hexdump0815/u-boot-misc/blob/master/readme.g12
+- https://github.com/hexdump0815/u-boot-misc/blob/master/readme.gxy
 
 ## special notes
 
 - tv boxes are always hit and miss, so they might work or might not work and are usually of low quality
-- for booting amlogic tv boxes some special preparation will be required
+  - be happy in case it works for your box
+  - it is impossible to support all tv boxes with their wild mix of hardware or usually quite low quality, so please do not open github issues in case the images do not work for your box
+  - github issues with tested and structured information on how to get the images working on a box where they did not work out of the box are welcome
+  - sound is not working, wifi, bluetooth and sometimes even ethernet might work or might not work depending on the tv box
+- for booting from sd card on amlogic tv boxes some special preparation will be required
+  - get a tooth pick (or something simlar), try to find the boot switch (usually in the audio out port) and get a feeling for pushing and releasing this button with the tooth pick
+  - put the sd card with the image written to it into the sd card slot of the tv box
+  - press the boot switch button with the tooth pick and keep it pressed
+  - power on the tv box
+  - wait until it seems to have restarted at least two times on the screen
+  - release the boot switch
+  - it should now boot from the sd card or at least not boot the internal android any more as long as the sd card isin the slot
+  - if it does not, try to power off and on the box
+  - if still not, repeat the above steps until it works or you give up at some point
+- before booting the sd card the first time some adjustements are required to configure it for the type of box:
+  - gxbb and gxl: on the root filesystem (2nd partition) copy /etc/X11/xorg.conf.d.samples/13-lima-meson.conf to /etc/X11/xorg.conf.d to make xorg start properly
+  - all tv boxes: adjust the selected dtb in the file extlinux/extlinux.conf on the boot filesystem (1st partition) - see the comments in the file
+  - if for g12a the t95q dtb or for sm1 the h96max-x3 dtb result in a kernel crash on boot or instability, try to use the sei520/sei610 dtbs as they do clock the cpu at lower frequencies
+  - also in general try different dtbs of the proper type in case the box does not boot
+- important: do not touch the emmc on amlogic tv boxes as it contains important information to boot them at well defined places of the emmc - if this gets removed the box will no longer boot at all
+  - if you want to touch your emmc you should really know what you are doing and are on your own (plus risk to brick your box) - you have been warned ...

systems/rockchip_rk33xx/readme.md

@@ -2,14 +2,18 @@
 
 ## bootable sd card images
 
+- https://github.com/hexdump0815/imagebuilder/releases/tag/210805-02
 - https://github.com/hexdump0815/imagebuilder/releases/tag/200702-01
 
 ## tested systems - working
 
 - h96max rk3318 tv box
+- t9 rk3328 tv box
 
 ## untested systems
 
+- other rockchip rk3318 or rk3328 tv boxes
+
 some more work will be required to make the devices below working
 
 - pine64 rock64
@@ -19,8 +23,6 @@ some more work will be required to make the devices below working
 - nanopi m4
 - nanopi m4v2
 - orangepi 4
-- rockchip rk3318 tv boxes
-- rockchip rk3328 tv boxes
 - rockchip rk3399 tv boxes
 
 ## kernel build notes
@@ -35,3 +37,13 @@ some more work will be required to make the devices below working
 ## special notes
 
 - tv boxes are always hit and miss, so they might work or might not work and are usually of low quality
+  - be happy in case it works for your box
+  - it is impossible to support all tv boxes with their wild mix of hardware or usually quite low quality, so please do not open github issues in case the images do not work for your box
+  - github issues with tested and structured information on how to get the images working on a box where they did not work out of the box are welcome
+  - sound is not working, wifi, bluetooth and sometimes even ethernet might work or might not work depending on the tv box
+- before booting the sd card the first time some adjustements are required to configure it for the type of box:
+  - all tv boxes: adjust the selected dtb in the file extlinux/extlinux.conf on the boot filesystem (1st partition) - see the comments in the file
+  - if the selected dtb results in a kernel crash on boot or instability, try to use the h96max-rk3318 dtb as it does clock the cpu at lower frequencies
+  - also in general try different dtbs of the proper type in case the box does not boot
+- important: do not touch the emmc on rockchip tv boxes as it contains important information to boot them at well defined places of the emmc - if this gets removed the box might no longer boot at all
+  - if you want to touch your emmc you should really know what you are doing and are on your own (plus risk to brick your box) - you have been warned ...