Ugoos AM3 (ugoos-am3)

Features
Flashing Whether it is possible to flash the device with pmbootstrap flasher.	Broken
USB Networking After connecting the device with USB to your PC, you can connect to it via telnet (initramfs) or SSH (booted system).	Broken
Internal storage eMMC, SD cards, UFS...	Works
SD card Also includes other external storage cards.	Works
Multimedia
3D Acceleration	Works
Audio Audio playback, microphone, headset and buttons.	Works
IR TX	Untested
IR RX	Works
Connectivity
WiFi	Works
Ethernet	Works
Miscellaneous
FDE Full disk encryption and unlocking with unl0kr.	Untested
USB-A Whether the full-sized USB-A port works.	Works
USB OTG USB On-The-Go or USB-C Role switching.	Untested
HDMI/DP Video and audio output with HDMI or DisplayPort.	Works
Sensors
Ambient Light Measures the light level; used for automatic screen dimming in many interfaces.	Untested

Ugoos AM3
	; Ugoos AM3 android TV box
Manufacturer	Ugoos
Name	AM3
Codename	ugoos-am3
Model	AM3
Released	2018
Type	set-top box
Hardware
Chipset	Amlogic S912
CPU	Octa-Core (4x 1.512 GHz Cortex-A53; 4x 1.0 GHz Cortex-A53)
GPU	Mali-450 MP3
Display	HDMI
Storage	16 GB
Memory	2 GB
Architecture	aarch64
Software
Original software The software and version the device was shipped with.	Android 7.1
Extended version The most recent supported version from the manufacturer.	Android
FOSS bootloader	no
postmarketOS
Category	testing
Mainline Instead of a Linux kernel fork, it is possible to run (Close to) Mainline.	yes
pmOS kernel The kernel version that runs on the device's port.	none
Unixbench score Unixbench Whetstone/Dhrystone score. See Unixbench.	2532.5
Generic port	Amlogic Generic TV Box (amlogic-tvbox)
Device package	device-amlogic-tvbox out-of-tree
Kernel package	linux-postmarketos-amlogic

This device is supported as part of a generic port. Refer to Amlogic Generic TV Box (amlogic-tvbox) for installation instructions and more information.

Contributors

jn

Users owning this device

Jn (Notes: with UART cable)

U-Boot

Vendor U-Boot can read FAT and EXT4 filesystems from USB storage:

usb start
fatls usb 0
fatload usb 0 ${loadaddr} boot
fatload usb 0 ${dtb_mem_addr} am3.dtb
bootm

However, it can't boot FIT images produced by the Linux Kernel build system, and Ethernet doesn't seem to work.

Fastboot mode is available in Vendor U-Boot. You need a USB-A (plug) to USB-A (plug) cable to use it (plugged into the "OTG" port).

fastboot boot is implemented but always results in a crash.
Vendor U-Boot might not like your gzip-compressed kernel. Try uncompressed.

U-Boot environment:

1080p60hz_deepcolor=444,10bit
EnableSelinux=permissive
active_slot=_a
baudrate=115200
bcb_cmd=get_valid_slot;
boot_part=boot
bootargs=rootfstype=ramfs init=/init console=ttyS0,115200 no_console_suspend earlyprintk=aml-uart,0xc81004c0 ramoops.pstore_en=1 ramoops.record_size=0x8000 ramoops.console_size=0x4000 androidboot.selinux=permissive logo=osd1,loaded,0x3d800000,576cvbs maxcpus=8 vout=576cvbs,enable hdmimode=1080p60hz cvbsmode=576cvbs hdmitx= cvbsdrv=0 pq= androidboot.firstboot=0 jtag=apao androidboot.hardware=amlogic mac=20:18:0e:e7:67:47 androidboot.mac=20:18:0e:e7:67:47 androidboot.slot_suffix=_a
bootcmd=run storeboot
bootdelay=1
bootup_offset=0x10d8120
bootup_size=0x3f4c8
cmdline_keys=if keyman init 0x1234; then if keyman read usid ${loadaddr} str; then setenv bootargs ${bootargs} androidboot.serialno=${usid};setenv serial ${usid};fi;if keyman read mac ${loadaddr} str; then setenv bootargs ${bootargs} mac=${mac} androidboot.mac=${mac};fi;if keyman read deviceid ${loadaddr} str; then setenv bootargs ${bootargs} androidboot.deviceid=${deviceid};fi;fi;
cvbs_drv=0
cvbsmode=576cvbs
display_bpp=16
display_color_bg=0
display_color_fg=0xffff
display_color_index=16
display_height=576
display_layer=osd1
display_width=720
dtb_mem_addr=0x1000000
ethact=dwmac.c9410000
ethaddr=20:18:0e:e7:67:47
factory_reset_poweroff_protect=echo wipe_data=${wipe_data}; echo wipe_cache=${wipe_cache};if test ${wipe_data} = failed; then run init_display; run storeargs;if mmcinfo; then run recovery_from_sdcard;fi;if usb start 0; then run recovery_from_udisk;fi;run recovery_from_flash;fi; if test ${wipe_cache} = failed; then run init_display; run storeargs;if mmcinfo; then run recovery_from_sdcard;fi;if usb start 0; then run recovery_from_udisk;fi;run recovery_from_flash;fi; 
fb_addr=0x3d800000
fb_height=1080
fb_width=1920
fdt_high=0x20000000
firstboot=0
gatewayip=10.18.9.1
hdmimode=1080p60hz
hostname=arm_gxbb
init_display=osd open;osd clear;imgread pic logo bootup $loadaddr;bmp display $bootup_offset;bmp scale
initargs=rootfstype=ramfs init=/init console=ttyS0,115200 no_console_suspend earlyprintk=aml-uart,0xc81004c0 ramoops.pstore_en=1 ramoops.record_size=0x8000 ramoops.console_size=0x4000 
ipaddr=10.18.9.97
jtag=apao
loadaddr=1080000
mac=20:18:0e:e7:67:47
maxcpus=8
netmask=255.255.255.0
outputmode=576cvbs
preboot=run bcb_cmd; run factory_reset_poweroff_protect;run upgrade_check;run init_display;run storeargs;run upgrade_key;forceupdate;run switch_bootmode;
reboot_mode=normal
recovery_from_flash=setenv bootargs ${bootargs} aml_dt=${aml_dt} recovery_part={recovery_part} recovery_offset={recovery_offset};if itest ${upgrade_step} == 3; then if ext4load mmc 1:2 ${dtb_mem_addr} /recovery/dtb.img; then echo cache dtb.img loaded; fi;if ext4load mmc 1:2 ${loadaddr} /recovery/recovery.img; then echo cache recovery.img loaded; wipeisb; bootm ${loadaddr}; fi;else fi;if imgread kernel ${recovery_part} ${loadaddr} ${recovery_offset}; then wipeisb; bootm ${loadaddr}; fi;
recovery_from_sdcard=setenv bootargs ${bootargs} aml_dt=${aml_dt} recovery_part={recovery_part} recovery_offset={recovery_offset};if fatload mmc 0 ${loadaddr} aml_autoscript; then autoscr ${loadaddr}; fi;if fatload mmc 0 ${loadaddr} recovery.img; then if fatload mmc 0 ${dtb_mem_addr} dtb.img; then echo sd dtb.img loaded; fi;wipeisb; bootm ${loadaddr};fi;
recovery_from_udisk=setenv bootargs ${bootargs} aml_dt=${aml_dt} recovery_part={recovery_part} recovery_offset={recovery_offset};if fatload usb 0 ${loadaddr} aml_autoscript; then autoscr ${loadaddr}; fi;if fatload usb 0 ${loadaddr} recovery.img; then if fatload usb 0 ${dtb_mem_addr} dtb.img; then echo udisk dtb.img loaded; fi;wipeisb; bootm ${loadaddr};fi;
recovery_offset=0
recovery_part=recovery
sdc_burning=sdc_burn ${sdcburncfg}
sdcburncfg=aml_sdc_burn.ini
serverip=10.18.9.113
stderr=serial
stdin=serial
stdout=serial
storeargs=setenv bootargs ${initargs} androidboot.selinux=${EnableSelinux} logo=${display_layer},loaded,${fb_addr},${outputmode} maxcpus=${maxcpus} vout=${outputmode},enable hdmimode=${hdmimode} cvbsmode=${cvbsmode} hdmitx=${cecconfig} cvbsdrv=${cvbs_drv} pq=${pq} androidboot.firstboot=${firstboot} jtag=${jtag}; setenv bootargs ${bootargs} androidboot.hardware=amlogic;run cmdline_keys;setenv bootargs ${bootargs} androidboot.slot_suffix=${active_slot};
storeboot=if imgread kernel ${boot_part} ${loadaddr}; then bootm ${loadaddr}; fi;run update;
switch_bootmode=get_rebootmode;if test ${reboot_mode} = factory_reset; then run recovery_from_flash;else if test ${reboot_mode} = update; then run update;else if test ${reboot_mode} = cold_boot; then run try_auto_burn;else if test ${reboot_mode} = fastboot; then fastboot;fi;fi;fi;fi;
try_auto_burn=update 700 750;
update=run usb_burning; run sdc_burning; if mmcinfo; then run recovery_from_sdcard;fi;if usb start 0; then run recovery_from_udisk;fi;run recovery_from_flash;
upgrade_check=echo upgrade_step=${upgrade_step}; if itest ${upgrade_step} == 3; then run init_display; run storeargs; run update;else fi;
upgrade_key=saradc open 0; if saradc get_in_range 0 0x50; then msleep 50; if saradc get_in_range 0 0x50; then echo update by key...; run update; fi;fi
upgrade_step=2
usb_burning=update 1000
wipe_cache=successful
wipe_data=successful

Environment size: 5395/65532 bytes

$ unpack_bootimg --boot_img boot --format mkbootimg
--header_version 0 --os_version 7.1.2 --os_patch_level 2017-12 --kernel out/kernel --ramdisk out/ramdisk --pagesize 0x00000800 --base 0x00000000 --kernel_offset 0x01080000 --ramdisk_offset 0x01000000 --second_offset 0x00f00000 --tags_offset 0x00000100 --board '' --cmdline buildvariant=userdebug

UART

UART @ 3.3V, 115200 baud:

(4) (3) (2) [1]
Vcc RXD TXD GND

U-Boot shell and userspace shell on UART
su without password

External links

Product page