Overview

Elementary HAL (Hardware Abstraction Layer) for Allwinner D1H/D1s/F133 RISC-V SOC.

Based on @robots allwinner_t113 and @ua1arn hftrx projects. Also used some code from xboot, xfel (MIT, BSD, Apache Licenses)

Features

• Working graphics with LCD RGB 4.3 inch (043026-N6(ML) ST7701S SPI)
• USB Host with support USB 2.0/1.0 Keyboard, Mouse
• TWI (I2C) supported AXP228 Power management chip
• UART, GPIO

Details

• LCD MIPI not work yet (6.86 inch icnl9707)
• USB not work from SD card image, from xfel work ok
• UART output is blocking

Executed at hardware such as:

• Sipeed Lichee RV + Dock
• ClockworkPi DevTerm R-01

Build

Compile firmware ('D1H' SoC and 'Sipeed Lichee RV' platform by default)

make

Compile firmware for specific platform ClockworkPi Devterm R-01 platform

make soc=d1h platform=devterm

soc could be: d1h, d1s
platform could be: sipeed, devterm

Clean all objects

make clean

Flash firmware to MCU by XFEL

make flash

Installation

In repository exist pre-builded images for SD card in folder image, need to flash it to SD card and install to device.

Windows

Could use https://etcher.balena.io/#download-etcher for flash image to SD card.

Linux

make sd_burn

Run

Configure UART adapter to 115200 baud rate, 8N1 (screen /dev/ttyUSB0 115200).
Insert flashed SD card to device OR flash by XFEL and power on, should see at the end of output like this:

[INF]:  \ | /
[INF]:  - Allwinner D1 HAL [ver: 0.0.1-5-gd69c9f1]
[INF]:  / | \
[INF]:  SoC: D1H
[INF]:  Platform: ClockworkPi Devterm R-01
[DBG]:irq_init
[DBG]:twi_init

Environment

Tested on Ubuntu 22.04.3 64x. On machine need to be installed make environment:

sudo apt install git make build-essential libusb-1.0-0-dev libncurses5-dev

If needed to specify installation folders for toolchain please modify environment.sh script to specify this variable

• TOOLCHAIN_INSTALL_DIR - path for installation dir for toolchain ex.: $HOME/toolchain

Then execute due each session:

source ./environment.sh

Or add to ~/.bashrc

Build toolchain

Installing toolchain

make toolchain

* T-HEAD_DebugServer will request specify installation dir: 'Set full installing path:'
  Could be seted as $HOME/toolchain or RT-Thread-on-Allwinner-D1H/toolchain folder

Will be installed:

• xpack-riscv-none-elf-gcc-14.2.0-2-linux-x64 (for compiling)
• xfel (for flash MCU by USB)
• T-HEAD_DebugServer (for JTAG)

Build SD card image

To create SD card image in image folder:

make sd

To create SD card image for ClockworkPi Devterm platform

make sd platform=devterm

For flash to SD card:

make sd_burn

Debugging

For debugging used Sipeed RV-Debugger Plus with T-Head CKLink firmware.
To connect debugger to board need use MicroSD breakout board because in D1H JTAG pins mapped to SD Card pins.

For flash firmware to Sipeed RV-Debugger Plus - Press and hold the boot pin then plug the usb in the computer to go to the boot mode. And execute command:

make debug-burn

To start GDB session in device that have FEL button (Sipeed Lichee RV) - press and hold the FEL button then press RESET button to go to the FEL mode, then execute command OR for device without FEL button (Clockwork Devterm) just don't insert boot SD card, press POWER button and execute command:

make debug

Should see at the output like this:

+---                                                    ---+
|  T-Head Debugger Server (Build: Oct 21 2022)             |
   User   Layer Version : 5.16.05
   Target Layer version : 2.0
|  Copyright (C) 2022 T-HEAD Semiconductor Co.,Ltd.        |
+---                                                    ---+

...
GDB connection command for CPUs(CPU0):
        target remote 127.0.0.1:1025
...

0x000000000000a22a in ?? ()
Restoring binary file build/app.bin into memory (0x40000000 to 0x40600000)

TODO:

• LCD mipi (take dsi driver from Linux or RTT)
• USB not work from SD card image
• Do as library and external main function
• ehci/ohci auto switch
• LCD output double buffered
• MMU
• No libc ?
• simple linker script ?
• FreeRTOS ?
• Own bootloader
• Changelog
• Kbuild ? obj-y ?
• Common for T113 ?
• spi-nand ?