Alif Ensemble E8 AI/ML AppKit
Overview
The Alif Ensemble E8 AI/ML AppKit is a development platform built around the CSP-packaged AE822FA0E5597BS0 device from the Alif Ensemble E8 series, targeted at artificial intelligence and machine learning applications.
The Ensemble family of devices contain multiple CPU clusters: up to two Cortex-M55 based Real Time SubSystems (RTSS), and a Cortex-A32 based Application Processor SubSystem (APSS).
RTSS-HP (High Performance): Cortex-M55 running at up to 400 MHz
RTSS-HE (High Efficiency): Cortex-M55 running at up to 160 MHz
APSS (Application Processor SubSystem): Cortex-A32 running at up to 800 MHz
Board Identifiers
The following board identifiers are supported:
Board Identifier |
SoC Series |
Core |
|---|---|---|
|
E8 |
RTSS-HE |
|
E8 |
RTSS-HE |
|
E8 |
RTSS-HP |
|
E8 |
RTSS-HP |
|
E8 |
APSS |
Hardware
The Ensemble E8 AI/ML AppKit provides the following hardware features:
64 MB Hex SPI HyperRAM PSRAM
128 MB Octal SPI (xSPI) Flash
Micro SD card slot
High-Speed USB Host interface (Type-A)
High-Speed USB Device interface (Micro-AB)
10/100 Mbit/s Ethernet
On-board J-Link debugger (
PRG USB, High-Speed USB Device, Micro-AB)20-pin Arm CoreSight JTAG connector (1.27 mm)
ICM-42670-P: 3-axis accelerometer and gyroscope
BMI323: 3-axis accelerometer, gyroscope and temperature sensor
CH201 ultrasonic range sensor
I2S digital microphones
PDM digital microphones
3.5 mm headphone (line out) and line in audio jacks
5-position joystick
Reset push-button
Multicolor LED
4.3-inch 480 x 800 color TFT LCD with capacitive touchscreen
2-lane MIPI CSI camera connector
38.4 MHz crystal oscillator
Supported Features
The ensemble_e8_ak board supports the hardware features listed below.
- on-chip / on-board
- Feature integrated in the SoC / present on the board.
- 2 / 2
-
Number of instances that are enabled / disabled.
Click on the label to see the first instance of this feature in the board/SoC DTS files. -
vnd,foo -
Compatible string for the Devicetree binding matching the feature.
Click on the link to view the binding documentation.
ensemble_e8_ak/ae822fa0e5597bs0/apss target
On-target memory for this board target: 4 MiB of RAM, 5632 KiB of Flash.
Type |
Location |
Description |
Compatible |
|---|---|---|---|
CPU |
on-chip |
ARM Cortex-A32 CPU1 |
|
Clock control |
on-chip |
Generic fixed-rate clock provider5 |
|
on-chip |
Alif clock source multiplexer1 |
||
on-chip |
Generic fixed factor clock provider1 |
||
on-chip |
Alif Semiconductor clock controller1 |
||
Counter |
on-chip |
Synopsys Designware timer driver4 |
|
Ethernet |
on-chip |
Alif Ensemble Ethernet MAC1 |
|
on-chip |
Synopsys DesignWare MAC MDIO controller1 |
||
on-chip |
Synopsys DesignWare MAC PTP (Precision Time Protocol) Clock1 |
||
Flash controller |
on-chip |
Alif on-chip MRAM flash controller1 |
|
GPIO & Headers |
on-chip |
||
I2C |
on-chip |
Synopsys DesignWare I2C4 |
|
Input |
on-board |
Group of GPIO-bound input keys1 |
|
Interrupt controller |
on-chip |
ARM Generic Interrupt Controller v21 |
|
LED |
on-board |
Group of GPIO-controlled LEDs1 |
|
MTD |
on-chip |
Flash node1 |
|
Pin control |
on-chip |
Alif Semiconductor pin controller1 |
|
Serial controller |
on-chip |
||
SPI |
on-chip |
Synopsys DesignWare SPI controller4 |
|
Timer |
on-chip |
per-core ARM architected timer1 |
ensemble_e8_ak/ae822fa0e5597bs0/rtss_he target
On-target memory for this board target: 256 KiB of RAM, 5632 KiB of Flash.
Type |
Location |
Description |
Compatible |
|---|---|---|---|
CPU |
on-chip |
ARM Cortex-M55 CPU1 |
|
Clock control |
on-chip |
Generic fixed-rate clock provider5 |
|
on-chip |
Alif clock source multiplexer1 |
||
on-chip |
Generic fixed factor clock provider1 |
||
on-chip |
Alif Semiconductor clock controller1 |
||
Counter |
on-chip |
Synopsys Designware timer driver4 |
|
Ethernet |
on-chip |
Alif Ensemble Ethernet MAC1 |
|
on-chip |
Synopsys DesignWare MAC MDIO controller1 |
||
on-board |
Generic MII PHY1 |
||
on-chip |
Synopsys DesignWare MAC PTP (Precision Time Protocol) Clock1 |
||
Flash controller |
on-chip |
Alif on-chip MRAM flash controller1 |
|
GPIO & Headers |
on-chip |
||
I2C |
on-chip |
Synopsys DesignWare I2C4 |
|
Input |
on-board |
Group of GPIO-bound input keys1 |
|
Interrupt controller |
on-chip |
ARMv8.1-M NVIC (Nested Vectored Interrupt Controller)1 |
|
LED |
on-board |
Group of GPIO-controlled LEDs1 |
|
MMU / MPU |
on-chip |
ARMv8.1-M MPU (Memory Protection Unit)1 |
|
MTD |
on-chip |
Flash node1 |
|
Pin control |
on-chip |
Alif Semiconductor pin controller1 |
|
Serial controller |
on-chip |
||
SPI |
on-chip |
Synopsys DesignWare SPI controller4 |
|
Timer |
on-chip |
ARMv8.1-M System Tick1 |
ensemble_e8_ak/ae822fa0e5597bs0/rtss_he/sram target
On-target memory for this board target: 4 MiB of RAM, 5632 KiB of Flash.
Type |
Location |
Description |
Compatible |
|---|---|---|---|
CPU |
on-chip |
ARM Cortex-M55 CPU1 |
|
Clock control |
on-chip |
Generic fixed-rate clock provider5 |
|
on-chip |
Alif clock source multiplexer1 |
||
on-chip |
Generic fixed factor clock provider1 |
||
on-chip |
Alif Semiconductor clock controller1 |
||
Counter |
on-chip |
Synopsys Designware timer driver4 |
|
Ethernet |
on-chip |
Alif Ensemble Ethernet MAC1 |
|
on-chip |
Synopsys DesignWare MAC MDIO controller1 |
||
on-board |
Generic MII PHY1 |
||
on-chip |
Synopsys DesignWare MAC PTP (Precision Time Protocol) Clock1 |
||
Flash controller |
on-chip |
Alif on-chip MRAM flash controller1 |
|
GPIO & Headers |
on-chip |
||
I2C |
on-chip |
Synopsys DesignWare I2C4 |
|
Input |
on-board |
Group of GPIO-bound input keys1 |
|
Interrupt controller |
on-chip |
ARMv8.1-M NVIC (Nested Vectored Interrupt Controller)1 |
|
LED |
on-board |
Group of GPIO-controlled LEDs1 |
|
MMU / MPU |
on-chip |
ARMv8.1-M MPU (Memory Protection Unit)1 |
|
MTD |
on-chip |
Flash node1 |
|
Pin control |
on-chip |
Alif Semiconductor pin controller1 |
|
Serial controller |
on-chip |
||
SPI |
on-chip |
Synopsys DesignWare SPI controller4 |
|
Timer |
on-chip |
ARMv8.1-M System Tick1 |
ensemble_e8_ak/ae822fa0e5597bs0/rtss_hp target
On-target memory for this board target: 1 MiB of RAM, 5632 KiB of Flash.
Type |
Location |
Description |
Compatible |
|---|---|---|---|
CPU |
on-chip |
ARM Cortex-M55 CPU1 |
|
Clock control |
on-chip |
Generic fixed-rate clock provider5 |
|
on-chip |
Alif clock source multiplexer1 |
||
on-chip |
Generic fixed factor clock provider1 |
||
on-chip |
Alif Semiconductor clock controller1 |
||
Counter |
on-chip |
Synopsys Designware timer driver4 |
|
Ethernet |
on-chip |
Alif Ensemble Ethernet MAC1 |
|
on-chip |
Synopsys DesignWare MAC MDIO controller1 |
||
on-board |
Generic MII PHY1 |
||
on-chip |
Synopsys DesignWare MAC PTP (Precision Time Protocol) Clock1 |
||
Flash controller |
on-chip |
Alif on-chip MRAM flash controller1 |
|
GPIO & Headers |
on-chip |
||
I2C |
on-chip |
Synopsys DesignWare I2C4 |
|
Input |
on-board |
Group of GPIO-bound input keys1 |
|
Interrupt controller |
on-chip |
ARMv8.1-M NVIC (Nested Vectored Interrupt Controller)1 |
|
LED |
on-board |
Group of GPIO-controlled LEDs1 |
|
MMU / MPU |
on-chip |
ARMv8.1-M MPU (Memory Protection Unit)1 |
|
MTD |
on-chip |
Flash node1 |
|
Pin control |
on-chip |
Alif Semiconductor pin controller1 |
|
Serial controller |
on-chip |
||
SPI |
on-chip |
Synopsys DesignWare SPI controller4 |
|
Timer |
on-chip |
ARMv8.1-M System Tick1 |
ensemble_e8_ak/ae822fa0e5597bs0/rtss_hp/sram target
On-target memory for this board target: 4 MiB of RAM, 5632 KiB of Flash.
Type |
Location |
Description |
Compatible |
|---|---|---|---|
CPU |
on-chip |
ARM Cortex-M55 CPU1 |
|
Clock control |
on-chip |
Generic fixed-rate clock provider5 |
|
on-chip |
Alif clock source multiplexer1 |
||
on-chip |
Generic fixed factor clock provider1 |
||
on-chip |
Alif Semiconductor clock controller1 |
||
Counter |
on-chip |
Synopsys Designware timer driver4 |
|
Ethernet |
on-chip |
Alif Ensemble Ethernet MAC1 |
|
on-chip |
Synopsys DesignWare MAC MDIO controller1 |
||
on-board |
Generic MII PHY1 |
||
on-chip |
Synopsys DesignWare MAC PTP (Precision Time Protocol) Clock1 |
||
Flash controller |
on-chip |
Alif on-chip MRAM flash controller1 |
|
GPIO & Headers |
on-chip |
||
I2C |
on-chip |
Synopsys DesignWare I2C4 |
|
Input |
on-board |
Group of GPIO-bound input keys1 |
|
Interrupt controller |
on-chip |
ARMv8.1-M NVIC (Nested Vectored Interrupt Controller)1 |
|
LED |
on-board |
Group of GPIO-controlled LEDs1 |
|
MMU / MPU |
on-chip |
ARMv8.1-M MPU (Memory Protection Unit)1 |
|
MTD |
on-chip |
Flash node1 |
|
Pin control |
on-chip |
Alif Semiconductor pin controller1 |
|
Serial controller |
on-chip |
||
SPI |
on-chip |
Synopsys DesignWare SPI controller4 |
|
Timer |
on-chip |
ARMv8.1-M System Tick1 |
Ethernet
The Ethernet MAC of the RTSS cores is enabled only in the sram variants of
the board targets. The other targets use DTCM as zephyr,sram, and Ethernet
DMA to DTCM is not supported. The sram variants use a system SRAM as
zephyr,sram instead and enable the MAC, the MDIO bus, the PHY and the PTP
hardware clock of the MAC:
# From the root of the zephyr repository
west build -b ensemble_e8_ak/ae822fa0e5597bs0/rtss_he/sram samples/net/dhcpv4_client
Programming and Debugging
The ensemble_e8_ak board supports the runners and associated west commands listed below.
| flash | debug | debugserver | attach | reset | rtt | |
|---|---|---|---|---|---|---|
| alif_flash | ✅ (default) | |||||
| jlink | ✅ | ✅ (default) | ✅ | ✅ | ✅ | ✅ |
Configuring a Console
Connect a USB cable from your PC to the PRG USB connector, and use the
serial terminal of your choice (minicom, putty, etc.) with the following
settings:
Speed: 115200
Data: 8 bits
Parity: None
Stop bits: 1
The target UART connected to PRG USB is selected with the 3-position
slide switch SW4:
|
Target UART |
Board target |
|---|---|---|
Top |
SEUART |
Secure Enclave (not used by Zephyr) |
Center |
UART2 |
|
Bottom |
UART4 |
|
Flashing
Alif Ensemble E8 AI/ML AppKit is programmed with west flash through the
Alif Security Toolkit (SETOOLS), using the alif_flash runner. Set up SETOOLS as described there, move SW4 to the SE-UART
position and connect the PRG USB connector to your host computer. Pass the
SE-UART device with --port if it differs from the SETOOLS configuration.
Move SW4 back to the console position after flashing.
Alternatively, the board can be flashed using a SEGGER J-Link debug probe with
west flash -r jlink. Connect a USB cable from your host computer to the
PRG USB connector. The sample application Hello World
is used for this example.
Building and flashing for the High Performance core (RTSS-HP):
# From the root of the zephyr repository
west build -b ensemble_e8_ak/ae822fa0e5597bs0/rtss_hp samples/hello_world
west flash
On the serial terminal, you should see the following message:
Hello World! ensemble_e8_ak/ae822fa0e5597bs0/rtss_hp
Building and flashing for the High Efficiency core (RTSS-HE):
# From the root of the zephyr repository
west build -b ensemble_e8_ak/ae822fa0e5597bs0/rtss_he samples/hello_world
west flash
On the serial terminal, you should see the following message:
Hello World! ensemble_e8_ak/ae822fa0e5597bs0/rtss_he
Building for the Application Processor (APSS):
Note
On the APSS (Cortex-A32) cluster, Zephyr boots in the Non-Secure state, with Arm Trusted Firmware-A (TF-A) acting as the first-stage bootloader that initializes the system and hands off to the Zephyr image. The TF-A port for the Ensemble APSS cluster is not yet available upstream and is currently maintained in Alif’s public repository: Alif Trusted Firmware-A [1].
The alif_flash runner programs the TF-A BL32 image together with the
Zephyr image; pass the BL32 image with --bl32-bin. --bl32-base
may also need to be set if the default value differs from the
base address your BL32 image was built for, IE bl32-base=0x80100000
# From the root of the zephyr repository
west build -b ensemble_e8_ak/ae822fa0e5597bs0/apss samples/hello_world
west flash --bl32-bin=<path to bl32.bin> --bl32-base=<link address of bl32>
Debugging
You can debug an application using west debug:
# From the root of the zephyr repository
west build -b ensemble_e8_ak/ae822fa0e5597bs0/rtss_hp samples/hello_world
west debug
This will start a GDB server and connect to the target.