Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ HostProject(et-driver "")
HostProject(common-sw "" g3log)
HostProject(device-api "" common-sw)
DeviceProject(etsoc-hal "")
HostProject(erbium-hal "")
DeviceProject(et-trace "")
DeviceProject(et-common-libs "-DENABLE_WARNINGS_AS_ERRORS=OFF" et-trace etsoc-hal)

Expand Down Expand Up @@ -77,7 +78,7 @@ DeviceProject(test-compute-kernels ""
#
# Runtime
#
HostProject(sw-sysemu "" g3log common-sw et-driver)
HostProject(sw-sysemu "" g3log common-sw et-driver erbium-hal)
HostProject(devicelayer "" common-sw sw-sysemu)
HostProject(esperanto-tools-libs ""
devicelayer device-api g3log cereal easy_profiler
Expand Down
61 changes: 61 additions & 0 deletions erbium-hal/CMakeLists.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
# Copyright (c) 2026 AIFoundry
# SPDX-License-Identifier: Apache-2.0

cmake_minimum_required(VERSION 3.15)
project(erbium_hal VERSION 0.1.0 LANGUAGES C)

set(TARGET_NAME erbium_hal)
set(TARGET_NAMESPACE erbium_hal)

include(GNUInstallDirs)

### Header-only library

# hwinc/*.h are generated register headers — no .c files to compile, so
# erbium_hal is an INTERFACE library that just exposes the include tree.
# If later additions introduce compiled sources (e.g. SP-boot wrappers
# analogous to etsoc_hal), switch STATIC and add sources here.
add_library(${TARGET_NAME} INTERFACE)
add_library(${TARGET_NAMESPACE}::${TARGET_NAME} ALIAS ${TARGET_NAME})

target_include_directories(${TARGET_NAME}
INTERFACE
$<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/include>
$<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}/esperanto-fw/${TARGET_NAME}>
)

### Install project

include(CMakePackageConfigHelpers)

# hwinc/*.h — generated register headers + top.h
install(DIRECTORY include/hwinc
DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/esperanto-fw/${TARGET_NAME}
)

install(TARGETS ${TARGET_NAME}
EXPORT ${TARGET_NAME}Targets
)

install(EXPORT ${TARGET_NAME}Targets
DESTINATION ${CMAKE_INSTALL_LIBDIR}/cmake/${TARGET_NAME}
NAMESPACE ${TARGET_NAMESPACE}::
)

configure_package_config_file(
${CMAKE_CURRENT_SOURCE_DIR}/${TARGET_NAME}Config.cmake.in
${CMAKE_CURRENT_BINARY_DIR}/${TARGET_NAME}Config.cmake
INSTALL_DESTINATION ${CMAKE_INSTALL_LIBDIR}/cmake/${TARGET_NAME}
)

write_basic_package_version_file(
${CMAKE_CURRENT_BINARY_DIR}/${TARGET_NAME}ConfigVersion.cmake
VERSION ${CMAKE_PROJECT_VERSION}
COMPATIBILITY SameMajorVersion
)

install(FILES
${CMAKE_CURRENT_BINARY_DIR}/${TARGET_NAME}Config.cmake
${CMAKE_CURRENT_BINARY_DIR}/${TARGET_NAME}ConfigVersion.cmake
DESTINATION ${CMAKE_INSTALL_LIBDIR}/cmake/${TARGET_NAME}
)
7 changes: 7 additions & 0 deletions erbium-hal/erbium_halConfig.cmake.in
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Copyright (c) 2026 AIFoundry
# SPDX-License-Identifier: Apache-2.0

@PACKAGE_INIT@

include(${CMAKE_CURRENT_LIST_DIR}/erbium_halTargets.cmake)
check_required_components(erbium_hal)
3,071 changes: 3,071 additions & 0 deletions erbium-hal/include/hwinc/esr.h

Large diffs are not rendered by default.

294 changes: 294 additions & 0 deletions erbium-hal/include/hwinc/i2c.h
Original file line number Diff line number Diff line change
@@ -0,0 +1,294 @@
/* Auto-generated by rdl2hal.py from SystemRDL. Do not edit. */
#ifndef _I2C_H_
#define _I2C_H_

#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

/* ============================================================ */
/* Block: I2C_Reg (macro prefix: I2C) */
/* ============================================================ */

/* Register: I2C.Commands */
#define I2C_COMMANDS_ADDRESS 0x00000000ul
#define I2C_COMMANDS_BYTE_ADDRESS 0x00000000ul
#define I2C_COMMANDS_OFFSET 0x00000000ul
#define I2C_COMMANDS_BYTE_OFFSET 0x00000000ul
#define I2C_COMMANDS_SIZE 0x00000004ul
#define I2C_COMMANDS_BYTE_SIZE 0x00000004ul
#define I2C_COMMANDS_READ_ACCESS 1u
#define I2C_COMMANDS_WRITE_ACCESS 1u
#define I2C_COMMANDS_RESET_VALUE 0x00000000ul
#define I2C_COMMANDS_RESET_MASK 0x00007F1Ful
#define I2C_COMMANDS_READ_MASK 0x00007F1Ful
#define I2C_COMMANDS_WRITE_MASK 0x00007F1Ful

/* Field: I2C_COMMANDS.start */
#define I2C_COMMANDS_START_MSB 0u
#define I2C_COMMANDS_START_LSB 0u
#define I2C_COMMANDS_START_WIDTH 1u
#define I2C_COMMANDS_START_READ_ACCESS 1u
#define I2C_COMMANDS_START_WRITE_ACCESS 1u
#define I2C_COMMANDS_START_RESET 0x00000000ul
#define I2C_COMMANDS_START_FIELD_MASK 0x00000001ul
#define I2C_COMMANDS_START_GET(x) ((x) & 0x00000001ul)
#define I2C_COMMANDS_START_SET(x) ((x) & 0x00000001ul)
#define I2C_COMMANDS_START_MODIFY(r, x) ((((x) << 0) & 0x00000001ul) | ((r) & 0xFFFFFFFEul))

/* Field: I2C_COMMANDS.read */
#define I2C_COMMANDS_READ_MSB 1u
#define I2C_COMMANDS_READ_LSB 1u
#define I2C_COMMANDS_READ_WIDTH 1u
#define I2C_COMMANDS_READ_READ_ACCESS 1u
#define I2C_COMMANDS_READ_WRITE_ACCESS 1u
#define I2C_COMMANDS_READ_RESET 0x00000000ul
#define I2C_COMMANDS_READ_FIELD_MASK 0x00000002ul
#define I2C_COMMANDS_READ_GET(x) (((x) & 0x00000002ul) >> 1)
#define I2C_COMMANDS_READ_SET(x) (((x) << 1) & 0x00000002ul)
#define I2C_COMMANDS_READ_MODIFY(r, x) ((((x) << 1) & 0x00000002ul) | ((r) & 0xFFFFFFFDul))

/* Field: I2C_COMMANDS.write */
#define I2C_COMMANDS_WRITE_MSB 2u
#define I2C_COMMANDS_WRITE_LSB 2u
#define I2C_COMMANDS_WRITE_WIDTH 1u
#define I2C_COMMANDS_WRITE_READ_ACCESS 1u
#define I2C_COMMANDS_WRITE_WRITE_ACCESS 1u
#define I2C_COMMANDS_WRITE_RESET 0x00000000ul
#define I2C_COMMANDS_WRITE_FIELD_MASK 0x00000004ul
#define I2C_COMMANDS_WRITE_GET(x) (((x) & 0x00000004ul) >> 2)
#define I2C_COMMANDS_WRITE_SET(x) (((x) << 2) & 0x00000004ul)
#define I2C_COMMANDS_WRITE_MODIFY(r, x) ((((x) << 2) & 0x00000004ul) | ((r) & 0xFFFFFFFBul))

/* Field: I2C_COMMANDS.write_multiple */
#define I2C_COMMANDS_WRITE_MULTIPLE_MSB 3u
#define I2C_COMMANDS_WRITE_MULTIPLE_LSB 3u
#define I2C_COMMANDS_WRITE_MULTIPLE_WIDTH 1u
#define I2C_COMMANDS_WRITE_MULTIPLE_READ_ACCESS 1u
#define I2C_COMMANDS_WRITE_MULTIPLE_WRITE_ACCESS 1u
#define I2C_COMMANDS_WRITE_MULTIPLE_RESET 0x00000000ul
#define I2C_COMMANDS_WRITE_MULTIPLE_FIELD_MASK 0x00000008ul
#define I2C_COMMANDS_WRITE_MULTIPLE_GET(x) (((x) & 0x00000008ul) >> 3)
#define I2C_COMMANDS_WRITE_MULTIPLE_SET(x) (((x) << 3) & 0x00000008ul)
#define I2C_COMMANDS_WRITE_MULTIPLE_MODIFY(r, x) ((((x) << 3) & 0x00000008ul) | ((r) & 0xFFFFFFF7ul))

/* Field: I2C_COMMANDS.stop */
#define I2C_COMMANDS_STOP_MSB 4u
#define I2C_COMMANDS_STOP_LSB 4u
#define I2C_COMMANDS_STOP_WIDTH 1u
#define I2C_COMMANDS_STOP_READ_ACCESS 1u
#define I2C_COMMANDS_STOP_WRITE_ACCESS 1u
#define I2C_COMMANDS_STOP_RESET 0x00000000ul
#define I2C_COMMANDS_STOP_FIELD_MASK 0x00000010ul
#define I2C_COMMANDS_STOP_GET(x) (((x) & 0x00000010ul) >> 4)
#define I2C_COMMANDS_STOP_SET(x) (((x) << 4) & 0x00000010ul)
#define I2C_COMMANDS_STOP_MODIFY(r, x) ((((x) << 4) & 0x00000010ul) | ((r) & 0xFFFFFFEFul))

/* Field: I2C_COMMANDS.address */
#define I2C_COMMANDS_ADDRESS_MSB 14u
#define I2C_COMMANDS_ADDRESS_LSB 8u
#define I2C_COMMANDS_ADDRESS_WIDTH 7u
#define I2C_COMMANDS_ADDRESS_READ_ACCESS 1u
#define I2C_COMMANDS_ADDRESS_WRITE_ACCESS 1u
#define I2C_COMMANDS_ADDRESS_RESET 0x00000000ul
#define I2C_COMMANDS_ADDRESS_FIELD_MASK 0x00007F00ul
#define I2C_COMMANDS_ADDRESS_GET(x) (((x) & 0x00007F00ul) >> 8)
#define I2C_COMMANDS_ADDRESS_SET(x) (((x) << 8) & 0x00007F00ul)
#define I2C_COMMANDS_ADDRESS_MODIFY(r, x) ((((x) << 8) & 0x00007F00ul) | ((r) & 0xFFFF80FFul))

/* Register: I2C.Status */
#define I2C_STATUS_ADDRESS 0x00000008ul
#define I2C_STATUS_BYTE_ADDRESS 0x00000008ul
#define I2C_STATUS_OFFSET 0x00000008ul
#define I2C_STATUS_BYTE_OFFSET 0x00000008ul
#define I2C_STATUS_SIZE 0x00000004ul
#define I2C_STATUS_BYTE_SIZE 0x00000004ul
#define I2C_STATUS_READ_ACCESS 1u
#define I2C_STATUS_WRITE_ACCESS 0u
#define I2C_STATUS_RESET_VALUE 0x00000000ul
#define I2C_STATUS_RESET_MASK 0x0000000Ful
#define I2C_STATUS_READ_MASK 0x0000000Ful
#define I2C_STATUS_WRITE_MASK 0x00000000ul

/* Field: I2C_STATUS.busy */
#define I2C_STATUS_BUSY_MSB 0u
#define I2C_STATUS_BUSY_LSB 0u
#define I2C_STATUS_BUSY_WIDTH 1u
#define I2C_STATUS_BUSY_READ_ACCESS 1u
#define I2C_STATUS_BUSY_WRITE_ACCESS 0u
#define I2C_STATUS_BUSY_RESET 0x00000000ul
#define I2C_STATUS_BUSY_FIELD_MASK 0x00000001ul
#define I2C_STATUS_BUSY_GET(x) ((x) & 0x00000001ul)
#define I2C_STATUS_BUSY_SET(x) ((x) & 0x00000001ul)
#define I2C_STATUS_BUSY_MODIFY(r, x) ((((x) << 0) & 0x00000001ul) | ((r) & 0xFFFFFFFEul))

/* Field: I2C_STATUS.bus_control */
#define I2C_STATUS_BUS_CONTROL_MSB 1u
#define I2C_STATUS_BUS_CONTROL_LSB 1u
#define I2C_STATUS_BUS_CONTROL_WIDTH 1u
#define I2C_STATUS_BUS_CONTROL_READ_ACCESS 1u
#define I2C_STATUS_BUS_CONTROL_WRITE_ACCESS 0u
#define I2C_STATUS_BUS_CONTROL_RESET 0x00000000ul
#define I2C_STATUS_BUS_CONTROL_FIELD_MASK 0x00000002ul
#define I2C_STATUS_BUS_CONTROL_GET(x) (((x) & 0x00000002ul) >> 1)
#define I2C_STATUS_BUS_CONTROL_SET(x) (((x) << 1) & 0x00000002ul)
#define I2C_STATUS_BUS_CONTROL_MODIFY(r, x) ((((x) << 1) & 0x00000002ul) | ((r) & 0xFFFFFFFDul))

/* Field: I2C_STATUS.bus_active */
#define I2C_STATUS_BUS_ACTIVE_MSB 2u
#define I2C_STATUS_BUS_ACTIVE_LSB 2u
#define I2C_STATUS_BUS_ACTIVE_WIDTH 1u
#define I2C_STATUS_BUS_ACTIVE_READ_ACCESS 1u
#define I2C_STATUS_BUS_ACTIVE_WRITE_ACCESS 0u
#define I2C_STATUS_BUS_ACTIVE_RESET 0x00000000ul
#define I2C_STATUS_BUS_ACTIVE_FIELD_MASK 0x00000004ul
#define I2C_STATUS_BUS_ACTIVE_GET(x) (((x) & 0x00000004ul) >> 2)
#define I2C_STATUS_BUS_ACTIVE_SET(x) (((x) << 2) & 0x00000004ul)
#define I2C_STATUS_BUS_ACTIVE_MODIFY(r, x) ((((x) << 2) & 0x00000004ul) | ((r) & 0xFFFFFFFBul))

/* Field: I2C_STATUS.missed_ack */
#define I2C_STATUS_MISSED_ACK_MSB 3u
#define I2C_STATUS_MISSED_ACK_LSB 3u
#define I2C_STATUS_MISSED_ACK_WIDTH 1u
#define I2C_STATUS_MISSED_ACK_READ_ACCESS 1u
#define I2C_STATUS_MISSED_ACK_WRITE_ACCESS 0u
#define I2C_STATUS_MISSED_ACK_RESET 0x00000000ul
#define I2C_STATUS_MISSED_ACK_FIELD_MASK 0x00000008ul
#define I2C_STATUS_MISSED_ACK_GET(x) (((x) & 0x00000008ul) >> 3)
#define I2C_STATUS_MISSED_ACK_SET(x) (((x) << 3) & 0x00000008ul)
#define I2C_STATUS_MISSED_ACK_MODIFY(r, x) ((((x) << 3) & 0x00000008ul) | ((r) & 0xFFFFFFF7ul))

/* Register: I2C.Cfg */
#define I2C_CFG_ADDRESS 0x00000010ul
#define I2C_CFG_BYTE_ADDRESS 0x00000010ul
#define I2C_CFG_OFFSET 0x00000010ul
#define I2C_CFG_BYTE_OFFSET 0x00000010ul
#define I2C_CFG_SIZE 0x00000004ul
#define I2C_CFG_BYTE_SIZE 0x00000004ul
#define I2C_CFG_READ_ACCESS 1u
#define I2C_CFG_WRITE_ACCESS 1u
#define I2C_CFG_RESET_VALUE 0x00000000ul
#define I2C_CFG_RESET_MASK 0x0001FFFFul
#define I2C_CFG_READ_MASK 0x0001FFFFul
#define I2C_CFG_WRITE_MASK 0x0001FFFFul

/* Field: I2C_CFG.prescale */
#define I2C_CFG_PRESCALE_MSB 15u
#define I2C_CFG_PRESCALE_LSB 0u
#define I2C_CFG_PRESCALE_WIDTH 16u
#define I2C_CFG_PRESCALE_READ_ACCESS 1u
#define I2C_CFG_PRESCALE_WRITE_ACCESS 1u
#define I2C_CFG_PRESCALE_RESET 0x00000000ul
#define I2C_CFG_PRESCALE_FIELD_MASK 0x0000FFFFul
#define I2C_CFG_PRESCALE_GET(x) ((x) & 0x0000FFFFul)
#define I2C_CFG_PRESCALE_SET(x) ((x) & 0x0000FFFFul)
#define I2C_CFG_PRESCALE_MODIFY(r, x) ((((x) << 0) & 0x0000FFFFul) | ((r) & 0xFFFF0000ul))

/* Field: I2C_CFG.stop_on_idle */
#define I2C_CFG_STOP_ON_IDLE_MSB 16u
#define I2C_CFG_STOP_ON_IDLE_LSB 16u
#define I2C_CFG_STOP_ON_IDLE_WIDTH 1u
#define I2C_CFG_STOP_ON_IDLE_READ_ACCESS 1u
#define I2C_CFG_STOP_ON_IDLE_WRITE_ACCESS 1u
#define I2C_CFG_STOP_ON_IDLE_RESET 0x00000000ul
#define I2C_CFG_STOP_ON_IDLE_FIELD_MASK 0x00010000ul
#define I2C_CFG_STOP_ON_IDLE_GET(x) (((x) & 0x00010000ul) >> 16)
#define I2C_CFG_STOP_ON_IDLE_SET(x) (((x) << 16) & 0x00010000ul)
#define I2C_CFG_STOP_ON_IDLE_MODIFY(r, x) ((((x) << 16) & 0x00010000ul) | ((r) & 0xFFFEFFFFul))

/* Register: I2C.Wdata */
#define I2C_WDATA_ADDRESS 0x00000018ul
#define I2C_WDATA_BYTE_ADDRESS 0x00000018ul
#define I2C_WDATA_OFFSET 0x00000018ul
#define I2C_WDATA_BYTE_OFFSET 0x00000018ul
#define I2C_WDATA_SIZE 0x00000004ul
#define I2C_WDATA_BYTE_SIZE 0x00000004ul
#define I2C_WDATA_READ_ACCESS 1u
#define I2C_WDATA_WRITE_ACCESS 1u
#define I2C_WDATA_RESET_VALUE 0x00000000ul
#define I2C_WDATA_RESET_MASK 0x000001FFul
#define I2C_WDATA_READ_MASK 0x000001FFul
#define I2C_WDATA_WRITE_MASK 0x000001FFul

/* Field: I2C_WDATA.wdata */
#define I2C_WDATA_WDATA_MSB 7u
#define I2C_WDATA_WDATA_LSB 0u
#define I2C_WDATA_WDATA_WIDTH 8u
#define I2C_WDATA_WDATA_READ_ACCESS 1u
#define I2C_WDATA_WDATA_WRITE_ACCESS 1u
#define I2C_WDATA_WDATA_RESET 0x00000000ul
#define I2C_WDATA_WDATA_FIELD_MASK 0x000000FFul
#define I2C_WDATA_WDATA_GET(x) ((x) & 0x000000FFul)
#define I2C_WDATA_WDATA_SET(x) ((x) & 0x000000FFul)
#define I2C_WDATA_WDATA_MODIFY(r, x) ((((x) << 0) & 0x000000FFul) | ((r) & 0xFFFFFF00ul))

/* Field: I2C_WDATA.wlast */
#define I2C_WDATA_WLAST_MSB 8u
#define I2C_WDATA_WLAST_LSB 8u
#define I2C_WDATA_WLAST_WIDTH 1u
#define I2C_WDATA_WLAST_READ_ACCESS 1u
#define I2C_WDATA_WLAST_WRITE_ACCESS 1u
#define I2C_WDATA_WLAST_RESET 0x00000000ul
#define I2C_WDATA_WLAST_FIELD_MASK 0x00000100ul
#define I2C_WDATA_WLAST_GET(x) (((x) & 0x00000100ul) >> 8)
#define I2C_WDATA_WLAST_SET(x) (((x) << 8) & 0x00000100ul)
#define I2C_WDATA_WLAST_MODIFY(r, x) ((((x) << 8) & 0x00000100ul) | ((r) & 0xFFFFFEFFul))

/* Register: I2C.Rdata */
#define I2C_RDATA_ADDRESS 0x00000020ul
#define I2C_RDATA_BYTE_ADDRESS 0x00000020ul
#define I2C_RDATA_OFFSET 0x00000020ul
#define I2C_RDATA_BYTE_OFFSET 0x00000020ul
#define I2C_RDATA_SIZE 0x00000004ul
#define I2C_RDATA_BYTE_SIZE 0x00000004ul
#define I2C_RDATA_READ_ACCESS 1u
#define I2C_RDATA_WRITE_ACCESS 1u
#define I2C_RDATA_RESET_VALUE 0x00000000ul
#define I2C_RDATA_RESET_MASK 0x000001FFul
#define I2C_RDATA_READ_MASK 0x000001FFul
#define I2C_RDATA_WRITE_MASK 0x000001FFul

/* Field: I2C_RDATA.rdata */
#define I2C_RDATA_RDATA_MSB 7u
#define I2C_RDATA_RDATA_LSB 0u
#define I2C_RDATA_RDATA_WIDTH 8u
#define I2C_RDATA_RDATA_READ_ACCESS 1u
#define I2C_RDATA_RDATA_WRITE_ACCESS 1u
#define I2C_RDATA_RDATA_RESET 0x00000000ul
#define I2C_RDATA_RDATA_FIELD_MASK 0x000000FFul
#define I2C_RDATA_RDATA_GET(x) ((x) & 0x000000FFul)
#define I2C_RDATA_RDATA_SET(x) ((x) & 0x000000FFul)
#define I2C_RDATA_RDATA_MODIFY(r, x) ((((x) << 0) & 0x000000FFul) | ((r) & 0xFFFFFF00ul))

/* Field: I2C_RDATA.rlast */
#define I2C_RDATA_RLAST_MSB 8u
#define I2C_RDATA_RLAST_LSB 8u
#define I2C_RDATA_RLAST_WIDTH 1u
#define I2C_RDATA_RLAST_READ_ACCESS 1u
#define I2C_RDATA_RLAST_WRITE_ACCESS 1u
#define I2C_RDATA_RLAST_RESET 0x00000000ul
#define I2C_RDATA_RLAST_FIELD_MASK 0x00000100ul
#define I2C_RDATA_RLAST_GET(x) (((x) & 0x00000100ul) >> 8)
#define I2C_RDATA_RLAST_SET(x) (((x) << 8) & 0x00000100ul)
#define I2C_RDATA_RLAST_MODIFY(r, x) ((((x) << 8) & 0x00000100ul) | ((r) & 0xFFFFFEFFul))

/* Block-level typedef: I2C */
typedef struct {
volatile uint32_t Commands; /* Offset 0x0 (R/W) */
uint8_t _pad0[0x4]; /* 0x4..0x7 reserved */
volatile uint32_t Status; /* Offset 0x8 (R) */
uint8_t _pad1[0x4]; /* 0xC..0xF reserved */
volatile uint32_t Cfg; /* Offset 0x10 (R/W) */
uint8_t _pad2[0x4]; /* 0x14..0x17 reserved */
volatile uint32_t Wdata; /* Offset 0x18 (R/W) */
uint8_t _pad3[0x4]; /* 0x1C..0x1F reserved */
volatile uint32_t Rdata; /* Offset 0x20 (R/W) */
} I2c_t, *PTR_I2c_t;

#ifdef __cplusplus
}
#endif

#endif /* _I2C_H_ */
Loading
Loading