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

ensemble_e8_ak/ae822fa0e5597bs0/rtss_he

E8

RTSS-HE

ensemble_e8_ak/ae822fa0e5597bs0/rtss_he/sram

E8

RTSS-HE

ensemble_e8_ak/ae822fa0e5597bs0/rtss_hp

E8

RTSS-HP

ensemble_e8_ak/ae822fa0e5597bs0/rtss_hp/sram

E8

RTSS-HP

ensemble_e8_ak/ae822fa0e5597bs0/apss

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

arm,cortex-a32

Clock control

on-chip

Generic fixed-rate clock provider5

fixed-clock

on-chip

Alif clock source multiplexer1

alif,clock-mux

on-chip

Generic fixed factor clock provider1

fixed-factor-clock

on-chip

Alif Semiconductor clock controller1

alif,clockctrl

Counter

on-chip

Synopsys Designware timer driver4

snps,dw-timers

Ethernet

on-chip

Alif Ensemble Ethernet MAC1

alif,ensemble-eth

on-chip

Synopsys DesignWare MAC MDIO controller1

snps,dwmac-mdio

on-chip

Synopsys DesignWare MAC PTP (Precision Time Protocol) Clock1

snps,dwmac-ptp-clock

Flash controller

on-chip

Alif on-chip MRAM flash controller1

alif,mram-flash-controller

GPIO & Headers

on-chip

Synopsys DesignWare GPIO313

snps,designware-gpio

I2C

on-chip

Synopsys DesignWare I2C4

snps,designware-i2c

Input

on-board

Group of GPIO-bound input keys1

gpio-keys

Interrupt controller

on-chip

ARM Generic Interrupt Controller v21

arm,gic-v2

LED

on-board

Group of GPIO-controlled LEDs1

gpio-leds

MTD

on-chip

Flash node1

soc-nv-flash

Pin control

on-chip

Alif Semiconductor pin controller1

alif,pinctrl

Serial controller

on-chip

ns16550 UART17

ns16550

SPI

on-chip

Synopsys DesignWare SPI controller4

snps,designware-spi

Timer

on-chip

per-core ARM architected timer1

arm,armv8-timer

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

arm,cortex-m55

Clock control

on-chip

Generic fixed-rate clock provider5

fixed-clock

on-chip

Alif clock source multiplexer1

alif,clock-mux

on-chip

Generic fixed factor clock provider1

fixed-factor-clock

on-chip

Alif Semiconductor clock controller1

alif,clockctrl

Counter

on-chip

Synopsys Designware timer driver4

snps,dw-timers

Ethernet

on-chip

Alif Ensemble Ethernet MAC1

alif,ensemble-eth

on-chip

Synopsys DesignWare MAC MDIO controller1

snps,dwmac-mdio

on-board

Generic MII PHY1

ethernet-phy

on-chip

Synopsys DesignWare MAC PTP (Precision Time Protocol) Clock1

snps,dwmac-ptp-clock

Flash controller

on-chip

Alif on-chip MRAM flash controller1

alif,mram-flash-controller

GPIO & Headers

on-chip

Synopsys DesignWare GPIO313

snps,designware-gpio

I2C

on-chip

Synopsys DesignWare I2C4

snps,designware-i2c

Input

on-board

Group of GPIO-bound input keys1

gpio-keys

Interrupt controller

on-chip

ARMv8.1-M NVIC (Nested Vectored Interrupt Controller)1

arm,v8.1m-nvic

LED

on-board

Group of GPIO-controlled LEDs1

gpio-leds

MMU / MPU

on-chip

ARMv8.1-M MPU (Memory Protection Unit)1

arm,armv8.1m-mpu

MTD

on-chip

Flash node1

soc-nv-flash

Pin control

on-chip

Alif Semiconductor pin controller1

alif,pinctrl

Serial controller

on-chip

ns16550 UART17

ns16550

SPI

on-chip

Synopsys DesignWare SPI controller4

snps,designware-spi

Timer

on-chip

ARMv8.1-M System Tick1

arm,armv8.1m-systick

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

arm,cortex-m55

Clock control

on-chip

Generic fixed-rate clock provider5

fixed-clock

on-chip

Alif clock source multiplexer1

alif,clock-mux

on-chip

Generic fixed factor clock provider1

fixed-factor-clock

on-chip

Alif Semiconductor clock controller1

alif,clockctrl

Counter

on-chip

Synopsys Designware timer driver4

snps,dw-timers

Ethernet

on-chip

Alif Ensemble Ethernet MAC1

alif,ensemble-eth

on-chip

Synopsys DesignWare MAC MDIO controller1

snps,dwmac-mdio

on-board

Generic MII PHY1

ethernet-phy

on-chip

Synopsys DesignWare MAC PTP (Precision Time Protocol) Clock1

snps,dwmac-ptp-clock

Flash controller

on-chip

Alif on-chip MRAM flash controller1

alif,mram-flash-controller

GPIO & Headers

on-chip

Synopsys DesignWare GPIO313

snps,designware-gpio

I2C

on-chip

Synopsys DesignWare I2C4

snps,designware-i2c

Input

on-board

Group of GPIO-bound input keys1

gpio-keys

Interrupt controller

on-chip

ARMv8.1-M NVIC (Nested Vectored Interrupt Controller)1

arm,v8.1m-nvic

LED

on-board

Group of GPIO-controlled LEDs1

gpio-leds

MMU / MPU

on-chip

ARMv8.1-M MPU (Memory Protection Unit)1

arm,armv8.1m-mpu

MTD

on-chip

Flash node1

soc-nv-flash

Pin control

on-chip

Alif Semiconductor pin controller1

alif,pinctrl

Serial controller

on-chip

ns16550 UART17

ns16550

SPI

on-chip

Synopsys DesignWare SPI controller4

snps,designware-spi

Timer

on-chip

ARMv8.1-M System Tick1

arm,armv8.1m-systick

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

arm,cortex-m55

Clock control

on-chip

Generic fixed-rate clock provider5

fixed-clock

on-chip

Alif clock source multiplexer1

alif,clock-mux

on-chip

Generic fixed factor clock provider1

fixed-factor-clock

on-chip

Alif Semiconductor clock controller1

alif,clockctrl

Counter

on-chip

Synopsys Designware timer driver4

snps,dw-timers

Ethernet

on-chip

Alif Ensemble Ethernet MAC1

alif,ensemble-eth

on-chip

Synopsys DesignWare MAC MDIO controller1

snps,dwmac-mdio

on-board

Generic MII PHY1

ethernet-phy

on-chip

Synopsys DesignWare MAC PTP (Precision Time Protocol) Clock1

snps,dwmac-ptp-clock

Flash controller

on-chip

Alif on-chip MRAM flash controller1

alif,mram-flash-controller

GPIO & Headers

on-chip

Synopsys DesignWare GPIO313

snps,designware-gpio

I2C

on-chip

Synopsys DesignWare I2C4

snps,designware-i2c

Input

on-board

Group of GPIO-bound input keys1

gpio-keys

Interrupt controller

on-chip

ARMv8.1-M NVIC (Nested Vectored Interrupt Controller)1

arm,v8.1m-nvic

LED

on-board

Group of GPIO-controlled LEDs1

gpio-leds

MMU / MPU

on-chip

ARMv8.1-M MPU (Memory Protection Unit)1

arm,armv8.1m-mpu

MTD

on-chip

Flash node1

soc-nv-flash

Pin control

on-chip

Alif Semiconductor pin controller1

alif,pinctrl

Serial controller

on-chip

ns16550 UART17

ns16550

SPI

on-chip

Synopsys DesignWare SPI controller4

snps,designware-spi

Timer

on-chip

ARMv8.1-M System Tick1

arm,armv8.1m-systick

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

arm,cortex-m55

Clock control

on-chip

Generic fixed-rate clock provider5

fixed-clock

on-chip

Alif clock source multiplexer1

alif,clock-mux

on-chip

Generic fixed factor clock provider1

fixed-factor-clock

on-chip

Alif Semiconductor clock controller1

alif,clockctrl

Counter

on-chip

Synopsys Designware timer driver4

snps,dw-timers

Ethernet

on-chip

Alif Ensemble Ethernet MAC1

alif,ensemble-eth

on-chip

Synopsys DesignWare MAC MDIO controller1

snps,dwmac-mdio

on-board

Generic MII PHY1

ethernet-phy

on-chip

Synopsys DesignWare MAC PTP (Precision Time Protocol) Clock1

snps,dwmac-ptp-clock

Flash controller

on-chip

Alif on-chip MRAM flash controller1

alif,mram-flash-controller

GPIO & Headers

on-chip

Synopsys DesignWare GPIO313

snps,designware-gpio

I2C

on-chip

Synopsys DesignWare I2C4

snps,designware-i2c

Input

on-board

Group of GPIO-bound input keys1

gpio-keys

Interrupt controller

on-chip

ARMv8.1-M NVIC (Nested Vectored Interrupt Controller)1

arm,v8.1m-nvic

LED

on-board

Group of GPIO-controlled LEDs1

gpio-leds

MMU / MPU

on-chip

ARMv8.1-M MPU (Memory Protection Unit)1

arm,armv8.1m-mpu

MTD

on-chip

Flash node1

soc-nv-flash

Pin control

on-chip

Alif Semiconductor pin controller1

alif,pinctrl

Serial controller

on-chip

ns16550 UART17

ns16550

SPI

on-chip

Synopsys DesignWare SPI controller4

snps,designware-spi

Timer

on-chip

ARMv8.1-M System Tick1

arm,armv8.1m-systick

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:

SW4

Target UART

Board target

Top

SEUART

Secure Enclave (not used by Zephyr)

Center

UART2

rtss_he, apss

Bottom

UART4

rtss_hp

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.

References