Skip to content

Commit

Permalink
Update README.md for release v6.6.16
Browse files Browse the repository at this point in the history
  • Loading branch information
devmfc committed Feb 12, 2024
1 parent 1c1e08e commit cabf6d8
Showing 1 changed file with 31 additions and 9 deletions.
40 changes: 31 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,18 @@
Minimal Debian and Ubuntu Linux images for Amlogic based OTT TV-boxes with mainline Linux LTS kernel. Boots the kernel with vendor u-boot, so without the use of a chain loaded u-boot.

## Current images:
- Debian Bookworm (v12) with Linux kernel 6.6.8
- Ubuntu Mantic (v23.10) with Linux kernel 6.6.8
- Debian Bookworm (v12) with Linux kernel 6.6.16
- Ubuntu Mantic (v23.10) with Linux kernel 6.6.16

## New boxes since this release:
- Vontar X4 (S905X4, thus experimental)
- X96 Max Plus 2101W
- X96 Max (S905X2 1000M)
- H96 Max W2 (S905W2, thus **experimental**)

## Tested TV-boxes with box specific DTB (bluetooth / leds / vfd display)
- A95X (S905)
- A95X F2 (S905X2)
- Beelink GT King (S922X)
- H96 Max W2 (**EXPERIMENTAL** S905W2, 100M ethernet)
- H96 Max X3 (S905X3, 1000M ethernet)
- H96 Pro Plus (S912, 1000M ethernet)
- HK1 X3 (S905X3, 1000M ethernet)
Expand All @@ -26,6 +27,7 @@ Minimal Debian and Ubuntu Linux images for Amlogic based OTT TV-boxes with mainl
- X96 Air A100 (S905X3, 100M ethernet)
- X96 Air P2 (S905X3, 1000M ethernet)
- X96 Air P3 (S905X3, 1000M ethernet)
- X96 Max (S905X2, 1000M ethernet)
- X96 Max Plus 2 (S905X3, 1000M ethernet)
- X96 Max Plus 2101W (S905X3, 1000M ethernet)
- X96 Max Plus 2T (S905X3, 1000M ethernet)
Expand All @@ -46,7 +48,7 @@ Minimal Debian and Ubuntu Linux images for Amlogic based OTT TV-boxes with mainl
- Experimental: S905W2 (Meson S4)

## Install
1. Burn the image to a USB flash disk (or sdcard) with some image burner like Balena Etcher, Win32Diskimager, dd or something
1. Burn the image to a USB flash disk (or sdcard, but USB is more reliable) with some image burner like Balena Etcher, Win32Diskimager, dd or something
2. Open **boot.config** on the first FAT-partition with an editor
3. Uncomment the **box=** line for your box.
5. Save the config file.
Expand All @@ -57,8 +59,11 @@ Minimal Debian and Ubuntu Linux images for Amlogic based OTT TV-boxes with mainl
5. power on the box
6. hold the reset/update button for about 7 seconds (longer does not hurt)
7. it should now boot to Debian / Ubuntu
8. you can login with user **root**, password: **tvbox**
12. Have fun

## login
1. Login via console or SSH (at first boot it can take a bit more time before SSH is available, because all encryption keys are regenerated)
1. you can login with user **root**, password: **tvbox**
2. Have fun

## Boot process
- The boot script uses the vendor bootloader on the box, so there is no bootloader in the image
Expand All @@ -83,7 +88,9 @@ In most cases:
**X96 Max Plus 2101W:** Wifi does not work (aml_w1)
**X96 Mini** Wifi does not work
**X96 X4:** HDMI does not really work, but with the use of simpleframebuffer there is a console.
**Tanxix W2:** HDMI does not work, but it is usable as a headless server, wifi does not work
**Tanxix W2:** HDMI does not really work, but with the use of simpleframebuffer there is a console, wifi does not work
**H96 Max W2:** HDMI does not really work, but with the use of simpleframebuffer there is a console, wifi does not work


### Not tested but will probably work
- cec
Expand All @@ -93,5 +100,20 @@ In most cases:
- S/PDiff port
- av-port

## What is the purpose of these images
These images are the images I use myself for various projects and small server tasks like email, pi-hole, nextcloud, NAS, webserver etc.
For these tasks I want to run a mainline LTS kernel (so not an older and sometimes buggy/insecure vendor kernel). The downside of this is that not all hardware is fully supported. If you are looking for better hardware support, take a look at the Coreelec images or Khadas Fenix images. I want a standard and clean Debian or Ubuntu distribution without unknown/untrusted APT repositories.
It is just a hobby to tinker with some of these cheap Android TVBoxes for fun when I have some time to spare, not for any serious purpose.
I just publish them here in case someone wants to do the same and is looking for a basic image. You might get lucky and it just boots on your TVBox as well. If not... sorry, don't expect support from me. And how much I would like to do so, I simply don't have the time to be someones Linux teacher...

## What are these images NOT
- Not suitable for media players like Kodi (Use Coreelec or Libreelec for that)
- Athough once in a while I test Linux desktop installation and there is a simple install script, these TVBoxes are (without hardware accelaration present in vendor kernels) IMHO waay to slow for desktop usage.
- This is not an attempt to become some kind of Linux distribution. it is just Debian / Ubuntu. So no support other than the gazillion support sources for Debian / Ubuntu already on the internet.
- They are NOT Armbian and are NOT Armbian based

## Sources
Sorry no sources at this moment. Not that I don't want to share, but because they are messy and I don't have the time to clean them up. However, most of the sources for the images are just shell scripts, so feel free to reuse them. Also the bootscripts, box configs and DTB's are all there. When I have some time to spare I will try to upload the sources.
Sorry no sources at this moment. Not that I don't want to share, but because they are messy and I don't have the time to clean them up. However, most of the sources for the images are just Bash scripts, so feel free to reuse them. Also the bootscripts, box configs and DTB's are all there. When I have some time to spare I will try to upload the sources.
- The kernel is just based on the mainline kernel source (kernel.org), only SC2 and S4 support needs some extra patches.
- Some work for S4 is already in my Linux repository
- Wifi MT7688 modifications for mainline Linux and for G12a boxes are in my repo

0 comments on commit cabf6d8

Please sign in to comment.