MangoPi MQ Pro Support

This is the base Nerves System configuration for the MangoPi MQ Pro.

This is a work in progress. It may change in backwards incompatible ways and the documentation might be lacking.

To do:

Bring up WiFi
Verify Blue PWM LED (was working with Linux 5.14, but broke with 5.18)
Fix MicroSD flakiness on boot
Verify USB host-only port (works with USB Flash drive)
Fix USB gadget mode on OTG port
Verify SPI
Verify I2C
Verify all GPIO work
Verify HW watchdog
Check that TARGET_GCC_FLAGS are right
Update Linux kernel to 5.18
Implement A/B firmware updates work
Use SID for serial number
Reduce prints and shorten boot time
Verify HDMI

Feature	Description
CPU	1 GHz 64 bit RISC-V
Memory	512 MB or 1 GB DRAM
Storage	MicroSD
Linux kernel	5.18 w/ patches
IEx terminal	UART `ttyS0`
GPIO, I2C, SPI	Yes - Elixir Circuits
Display	Yes, but not supported yet
ADC	Yes
PWM	Yes, but no Elixir support
UART	ttyS0
Camera	None
Ethernet	No
WiFi	Onboard WiFi
RTC	No
HW Watchdog	Yes

Using

The most common way of using this Nerves System is create a project with mix nerves.new and add mangopi references where needed and in a similar way to the default systems like bbb, etc. Then export MIX_TARGET=mangopi. See the Getting started guide for more information.

If you need custom modifications to this system for your device, clone this repository and update as described in Making custom systems.

Example use

This example assumes some familiarity with Nerves. To use this system, you'll need OTP 25. Follow the Nerves installation instructions for additional system dependencies.

Creating a new hello world application:

mix nerves.new hello_mango
cd hello_mango

Open up your mix.exs and add :mangopi_mq_pro to the @all_targets list at the top. It's ok to delete targets that you don't plan on using.

Then add the :nerves_system_mango_mq_pro dependency to the deps function:

    {:nerves_system_mangopi_mq_pro, "~> 0.1", runtime: false, targets: :mangopi_mq_pro},

This will load the latest released version. To use the latest code on the main branch here, add the following line:

    {:nerves_system_mangopi_mq_pro, runtime: false, targets: :mangopi_mq_pro, nerves: [compile: true], git: "https://github.com/fhunleth/nerves_system_mangopi_mq_pro", branch: "main"}

To build and write to a MicroSD card, run:

export MIX_TARGET=mangopi_mq_pro
mix deps.get
mix firmware
mix burn

Console access

The console is configured to output to the UART on pins 8 and 10 on the 40-pin GPIO connector. This is just like the Raspberry Pi. A 3.3V FTDI cable is needed to access the output.

Networking

The board has two network interfaces, a WiFi module and a virtual Ethernet on the USB C connector marked "OTG".

Thanks

The most helpful Allwinner D1 information comes from linux-sunxi.org/Allwinner_Nezha. All of the work here wouldn't have been possible with out it. Thanks especially to smaeul's Allwinner D1 Linux fork

Here are more useful links:

Image credit: This image is from mangopi.cc.