F.A.Q. | Frequently Asked Questions

Q: Which Allwinner H3 Boards it works on?
A: It should work on all H2+/H3 boards when set with proper script.bin(fex)/uboot.

Q: Which Allwinner H2+/H3 Boards are currently supported?
A: It has been tested by us on the following boards:

  • Xunlong Orange Pi PC
  • Xunlong Orange Pi Plus 2E
  • Xunlong Orange Pi PC Plus
  • Xunlong Orange Pi Lite / One
  • Xunlong Orange Pi Zero Plus 2
  • SinoVoip BananaPi M2+ H2+ and H3 variants*
  • FriendlyArm NanoPi M1* (as of 1.3.3 please use uboot for M1+)
  • FriendlyArm NanoPi M1 Plus* (built-in bluetooth not supported)
  • Libre Computer Board ALL-H3-CC (Tritium) H2+ and H3 variants
  • Beelink X2*
  • Sunvell R69* (Blog post, MUST HAVE FAN!)
    (Does not support 2GB Sunvell R69 version)
    '*' means we suggest the use of a 5v fan and heatsink while running H3Droid

Notes:

  • For best experience use a high quality class 10 or A1 rated SDcard (iops is more important than sequential speeds)
  • Low ram means more swap
  • All H2+/H3 devices should be supported with minor tweaks to the fex file!
  • When using dd to write an image be sure to use 'conv=fdatasync' at the end of the line or run 'sync' before removing SDcard

We have included with the installer many of the common H3 fex files, however, you can put in place any fex you like fairly easy. Eventually we will try to document this in more detail for novice users. The image uses mainline u-boot which has a lot more functionality than stock, it allows you to mount the first parition and update the fex/kernel/ramdisk as needed instead of having to recompile everything. This means it should support almost any Allwinner H3 device with little to very little effort.

Q: What makes H3Droid different from the images provided by the vendor?
A: This image includes / supports:

  • Universal installer (h3ii) that works on all systems
  • Updated u-boot (mainline)
  • Custom resolutions (PAL_tv NTSC_tv 480p 720p 1080p 1080i 800x480 1024x600 1024x768 1280x1024 1360x768)
  • Touchscreen support (usbtouchscreen.ko, hid-multitouch.ko for generic touch)
  • Configs (fex) with correct DRAM and CPU settings (Xunlong's images known to cause overheating or excessive throttling)
  • Google Play Store integrated (Xunlong doesn't provide Google Services at all with their images)
  • YouTube
  • Kodi (Compatible)
  • Root access to the system by SSH, UART and/or ADB shell (As part of the installation process you will be asked to place your SSH key in the installation directory as h3droid.pub)
  • Powermenu with reboot/poweroff
  • Navbar and sysbar
  • Lots of development tools and devices preinstalled
  • Using UsbModeSwitch.apk app which is provided, you can toggle OTG Gadget mode
  • English language set by default
  • Plenty of network chips supported (usb and sdio)
  • Custom recovery system (H3resc). It can be used for installation of H3Droid onto eMMC.
  • Armbian dual boot (with assisted installer in H3resc)
  • LibreElec dual boot (with assisted installer in H3resc)
  • Plenty of bugs fixed
  • Active development and support from H3Droid team

Q: What hardware is supported by your Android image?
A: This image supports:

  • Common WiFi adapters - including:
    -- built-on the boards and USB dongles:
    -- realtek: 8188cu, 8188eu, 8192cu, 8723, 8812au/8821au
    -- atheros: ath9k, ath6k
    -- ralink: rt2800usb compatibles (5370 tested, should work on: rt27xx/rt28xx/rt30xx/rt33xx/rt35xx/rt53xx/rt55xx)
    -- mediatek: mt7601u
  • Common Bluetooth adapters - Most CSR conforming dongles work (please report issues)
  • 100Mbit and Gigabit Network Adapaters found on H3 boards
  • HDMI and CVBS Displays
  • HDMI and Analog Audio Playback
  • common USB devices (kb/mouse/flash etc., if you have something that doesn't work, join us on IRC and report/ask)
  • touchscreens

Q: What is currently not supported by your Android image?
A: Some Bluetooth devices are not supported, while most dongles should work, some may still have problems (please report any issues).
A: Screen rotation

Q: I have installed Armbian or LibreELEC H3 and want to know how I can boot back to H3Resc or H3Droid on the next boot, how is this done?
A: When booting we have restored the uboot funtions for switching operating system, however, you will not see the options displayed on screen.

When the board first starts, you can press one of the following to choose what to boot:
s -> u-boot prompt
d -> H3droid
a -> Armbian
l -> LibreELEC H3
space -> H3resc

Q: Am I going crazy or does the resolution seem to reset to 720p when I reboot?
A: Breathe easy friend, you are not crazy! This seems to be a bug which we have not yet figured out how to resolve.
(Please note: as of 1.2.9+, you can now set the resolution permenently in H3resc)

Q: What is the UsbModeSwitch app used for?
A: This app is used to toggle the USB OTG mode on the micro usb port found on H3 devices. This allows the board to be connected to your computer and used as a mass storage device and provides access to Android via ABD shell.

Q: Is this Android image 'rootable' ?
A: As of 1.3.4+ app root is added
A: Answer for older versions: Yes and no. Like ALL KitKat and later android releases, root access is complicated. Unfortunately the SDK used happens to use a secure setup preventing remounting of /system as read/write to the Android interface (so root is not available/possible from Android interface). That said, root access via UART, SSH and ABD shell which can be used for most things that would really require root (installing apps, remounting/modifying fs). We have already taken the liberty of installing Google Play Services for you to make use of the image easier. You can try rooting apps, but be aware that while some may work, they are controversial and might do more than you think (trojans/spyware). For most tasks requiring root, ssh or adb is sufficient.

Q: I am trying to use Netflix, Youtube or another streaming app and for some reason the video freezes up a few seconds in, whats up with that?
A: It appears this is a bug with the app when it detects a change in stream quality, usually in apps like Netflix rewinding the video 30 seconds should resolve this ( This was originally reported on OrangePi Forum ).

Q: Does H3Droid support DRM or Widvine?
A: Yes, it supports up to Widevine 3

Q: I can not download Kodi from the Google Play store, it says it is incompatible, why?
A: Versions of Kodi after 16.4.82 require Android 5 and up and no longer support KitKat which we use for this image. Instead we recommend to install SPMC 16.4.82, download here.
A: Since 1.3.4 you can use h3resc and add it via ADDONS menu (requires network connectivity)
A: As of H3Droid 1.3.5 you can now install LibreElec-H3 to be dual booted and run latest Kodi

Q: I am using H3 board with low memory (512MB RAM or smaller) and having issues playing 1080p videos, what's wrong?
A: For 1.2.9+ please use h3resc and set 720p mode. While this should generally be fixed in new versions (1.3.5), lower memory systems may still have issues with full resolution playback in some cases.

Q: For some reason when I attach miniterm to the UART on a board running H3Droid it doesn't work, why?
A: We've noticed that input doesn't work when using miniterm. Please use different terminal program instead, such as putty or 'screen /dev/ttyUSB0 115200' for example.

Q: I installed Armbian from H3resc but when I boot Armbian the screen is green, how can I fix this?
A: This is caused by us enabling DVI compatibility in our fexes and in Armbian this casues black to appear green, you can fix this by toggling option in H3resc (in display submenu, for 1.3.3 and older it's named hdcp toggle, for 1.3.4+ it's named dvi-fix).

Q: How to configure IR remote?
A: Follow the steps below:

  1. Load module: modprobe sunxi-ir-rx; rmmod sunxi-ir-rx; modprobe sunxi-ir-rx;
  2. Generate keys by running 'getevent' (note the codes and pressed keys, if no keys are generated, try different remote)
  3. Create keymap file in /system/usr/keylayout/sunxi-ir.kl
  4. Reload the module
    Additional References: H3Droid Blog and Orange Pi Forum

Q: How to configure touchscreen?
A: You need to load the proper module, either manually or by adding proper command to /data/rc.local. For more information please see touchscreen info.

Q: Can I use the camera provided by Xunlong on my Orange Pi board in H3Droid?
A: Yes, you can! To activate the modules needed for the camera you will want to login to the board as root via SSH/UART/ADB and you will want to run the following command:

echo "/sbin/busybox modprobe gc2035 ; /sbin/busybox modprobe vfe_v4l2" >> /data/rc.local
Once done, reboot to implement the drivers!

Q: What is a 'serial UART' connectior cable and how do I use it with H3Droid?
A: A serial UART cable can be attached to the UART connector on your H3 board to provide access to the boards serial console, which will provide you a root access to your device, the adapters are usually very cheap ($0.50-$2.00) and will allow you to connect to your board via a USB-to-serial interface.

You can read more about how to use a UART cable on our Blog!.
Just remember, it's an extremely cheap but very helpful tool!

Q: How do I use the H3Droid power menu?
A: The power button and menu have several functions, some which are hidden:

  1. Long click of power button will put board to sleep (press for 3-5 seconds)
  2. Short click of power button will bring up the power menu (click here to see an image)
  3. Long click of 'Restart' on power menu will cause the board to restart to H3Resc instead of H3droid on next boot (press for 3-5 seconds then click 'OK' to reboot into H3Resc)
  4. 'Silent mode' can be toggled in power button menu

Q: I have found a bug or security issue in H3Droid, how should I get in touch with you?
A: Remember, this is work in progress, so there may be occasional issues! You can help by reporting bugs and concerns using our Feedback page.

Q: Do you have an IRC channel?
A: Yes, we do! You can come meet us in #H3droid on Freenode irc network ( chat.freenode.net:6697 / non-SSL: 6667 ) you can also Click Here

Home | H3ii | H3resc | How it Looks | Download | Project | Feedback