alt_core_api: Introduce a IDL/code-generation for compatible API headers

.gitignore

@@ -1 +1 @@
-rust/Cargo.lock
+alt_core_api/rust/Cargo.lock

CMakeLists.txt

@@ -18,75 +18,8 @@ if (CONFIG_ARDUINO_API)
   zephyr_include_directories(${variant_dir})
 
   if (CONFIG_USE_ARDUINO_API_RUST_IMPLEMENTATION)
-    # quote from https://github.com/zephyrproject-rtos/zephyr-lang-rust/blob/main/CMakeLists.txt
-    function (rust_target_arch RUST_TARGET)
-      # Map Zephyr targets to LLVM targets.
-      if(CONFIG_CPU_CORTEX_M)
-        if(CONFIG_CPU_CORTEX_M0 OR CONFIG_CPU_CORTEX_M0PLUS OR CONFIG_CPU_CORTEX_M1)
-    set(${RUST_TARGET} "thumbv6m-none-eabi" PARENT_SCOPE)
-        elseif(CONFIG_CPU_CORTEX_M3)
-    set(${RUST_TARGET} "thumbv7m-none-eabi" PARENT_SCOPE)
-        elseif(CONFIG_CPU_CORTEX_M4 OR CONFIG_CPU_CORTEX_M7)
-    if(CONFIG_FP_HARDABI OR FORCE_FP_HARDABI)
-      set(${RUST_TARGET} "thumbv7em-none-eabihf" PARENT_SCOPE)
-    else()
-      set(${RUST_TARGET} "thumbv7em-none-eabi" PARENT_SCOPE)
-    endif()
-        elseif(CONFIG_CPU_CORTEX_M23)
-    set(${RUST_TARGET} "thumbv8m.base-none-eabi" PARENT_SCOPE)
-        elseif(CONFIG_CPU_CORTEX_M33 OR CONFIG_CPU_CORTEX_M55)
-    # Not a typo, Zephyr, uses ARMV7_M_ARMV8_M_FP to select the FP even on v8m.
-    if(CONFIG_FP_HARDABI OR FORCE_FP_HARDABI)
-      set(${RUST_TARGET} "thumbv8m.main-none-eabihf" PARENT_SCOPE)
-    else()
-      set(${RUST_TARGET} "thumbv8m.main-none-eabi" PARENT_SCOPE)
-    endif()
-
-    # Todo: The M55 is thumbv8.1m.main-none-eabi, which can be added when Rust
-    # gain support for this target.
-        else()
-    message(FATAL_ERROR "Unknown Cortex-M target.")
-        endif()
-      elseif(CONFIG_RISCV)
-        if(CONFIG_RISCV_ISA_RV64I)
-    # TODO: Should fail if the extensions don't match.
-    set(${RUST_TARGET} "riscv64imac-unknown-none-elf" PARENT_SCOPE)
-        elseif(CONFIG_RISCV_ISA_RV32I)
-    # TODO: We have multiple choices, try to pick the best.
-    set(${RUST_TARGET} "riscv32i-unknown-none-elf" PARENT_SCOPE)
-        else()
-    message(FATAL_ERROR "Rust: Unsupported riscv ISA")
-        endif()
-      elseif(CONFIG_ARCH_POSIX AND CONFIG_64BIT AND (${CMAKE_HOST_SYSTEM_PROCESSOR} MATCHES "x86_64"))
-        set(${RUST_TARGET} "x86_64-unknown-none" PARENT_SCOPE)
-      elseif(CONFIG_ARCH_POSIX AND CONFIG_64BIT AND (${CMAKE_HOST_SYSTEM_PROCESSOR} MATCHES "aarch64"))
-        set(${RUST_TARGET} "aarch64-unknown-none" PARENT_SCOPE)
-      else()
-        message(FATAL_ERROR "Rust: Add support for other target")
-      endif()
-    endfunction()
-
-    rust_target_arch(RUST_TARGET_TRIPLE)
-
-    set(RUST_CRATE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/rust)
-    set(RUST_OUT_DIR   ${CMAKE_CURRENT_BINARY_DIR}/rust)
-    set(RUST_LIB       ${RUST_OUT_DIR}/target/${RUST_TARGET_TRIPLE}/release/libarduinocore_api_rust.a)
-
-    add_custom_command(
-      OUTPUT ${RUST_LIB}
-      COMMAND ${CMAKE_COMMAND} -E env CARGO_TARGET_DIR=${RUST_OUT_DIR}/target
-        cargo build --manifest-path ${RUST_CRATE_DIR}/Cargo.toml
-        --target ${RUST_TARGET_TRIPLE} --release
-      WORKING_DIRECTORY ${RUST_CRATE_DIR}
-      COMMENT "Building Rust staticlib for ${RUST_TARGET}"
-      VERBATIM
-    )
-
-    add_custom_target(arduinocore_api_rust_build ALL DEPENDS ${RUST_LIB})
-    add_library(arduinocore_api_rust STATIC IMPORTED GLOBAL)
-    set_target_properties(arduinocore_api_rust PROPERTIES IMPORTED_LOCATION ${RUST_LIB})
-    zephyr_link_libraries(arduinocore_api_rust)
-    zephyr_include_directories(${CMAKE_CURRENT_SOURCE_DIR}/zephyr/blobs/ArduinoCore-API/)
+    zephyr_include_directories(${CMAKE_CURRENT_SOURCE_DIR}/alt_core_api)
+    add_subdirectory(alt_core_api)
   else()
     zephyr_include_directories(${CMAKE_CURRENT_SOURCE_DIR}/zephyr/blobs/ArduinoCore-API/)
     zephyr_sources(${CMAKE_CURRENT_SOURCE_DIR}/zephyr/blobs/ArduinoCore-API/api/CanMsg.cpp)

Kconfig

@@ -20,6 +20,7 @@ if ARDUINO_API
 config USE_ARDUINO_API_RUST_IMPLEMENTATION
 	bool "Use Rust implementation API core"
 	select RUST
+	select NANOPB
 
 config QEMU_ICOUNT
 	bool "QEMU icount mode"

README.md

@@ -6,6 +6,7 @@ The **Arduino Core API** module for zephyr leverages the power of Zephyr under a
 
 * [Using external Arduino Libraries](/documentation/arduino_libs.md)
 * [Adding custom boards/ variants](/documentation/variants.md)
+* [Arduino IDL code generation](/documentation/idl_codegen.md)
 
 ## Adding Arduino Core API to Zephyr
 

alt_core_api/CMakeLists.txt

@@ -0,0 +1,79 @@
+# SPDX-License-Identifier: Apache-2.0
+
+function(rust_target_arch RUST_TARGET)
+  # Map Zephyr targets to LLVM targets.
+  if(CONFIG_CPU_CORTEX_M)
+    if(CONFIG_CPU_CORTEX_M0 OR CONFIG_CPU_CORTEX_M0PLUS OR CONFIG_CPU_CORTEX_M1)
+      set(${RUST_TARGET} "thumbv6m-none-eabi" PARENT_SCOPE)
+    elseif(CONFIG_CPU_CORTEX_M3)
+      set(${RUST_TARGET} "thumbv7m-none-eabi" PARENT_SCOPE)
+    elseif(CONFIG_CPU_CORTEX_M4 OR CONFIG_CPU_CORTEX_M7)
+      if(CONFIG_FP_HARDABI OR FORCE_FP_HARDABI)
+        set(${RUST_TARGET} "thumbv7em-none-eabihf" PARENT_SCOPE)
+      else()
+        set(${RUST_TARGET} "thumbv7em-none-eabi" PARENT_SCOPE)
+      endif()
+    elseif(CONFIG_CPU_CORTEX_M23)
+      set(${RUST_TARGET} "thumbv8m.base-none-eabi" PARENT_SCOPE)
+    elseif(CONFIG_CPU_CORTEX_M33 OR CONFIG_CPU_CORTEX_M55)
+      if(CONFIG_FP_HARDABI OR FORCE_FP_HARDABI)
+        set(${RUST_TARGET} "thumbv8m.main-none-eabihf" PARENT_SCOPE)
+      else()
+        set(${RUST_TARGET} "thumbv8m.main-none-eabi" PARENT_SCOPE)
+      endif()
+    else()
+      message(FATAL_ERROR "Unknown Cortex-M target.")
+    endif()
+  elseif(CONFIG_RISCV)
+    if(CONFIG_RISCV_ISA_RV64I)
+      set(${RUST_TARGET} "riscv64imac-unknown-none-elf" PARENT_SCOPE)
+    elseif(CONFIG_RISCV_ISA_RV32I)
+      set(${RUST_TARGET} "riscv32i-unknown-none-elf" PARENT_SCOPE)
+    else()
+      message(FATAL_ERROR "Rust: Unsupported riscv ISA")
+    endif()
+  elseif(CONFIG_ARCH_POSIX AND CONFIG_64BIT AND (${CMAKE_HOST_SYSTEM_PROCESSOR} MATCHES "x86_64"))
+    set(${RUST_TARGET} "x86_64-unknown-none" PARENT_SCOPE)
+  elseif(CONFIG_ARCH_POSIX AND CONFIG_64BIT AND (${CMAKE_HOST_SYSTEM_PROCESSOR} MATCHES "aarch64"))
+    set(${RUST_TARGET} "aarch64-unknown-none" PARENT_SCOPE)
+  else()
+    message(FATAL_ERROR "Rust: Add support for other target")
+  endif()
+endfunction()
+
+rust_target_arch(RUST_TARGET_TRIPLE)
+
+if (EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/rust/Cargo.toml)
+  set(RUST_CRATE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/rust)
+else()
+  set(RUST_CRATE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/../rust)
+endif()
+set(RUST_OUT_DIR   ${CMAKE_CURRENT_BINARY_DIR}/rust)
+set(RUST_LIB       ${RUST_OUT_DIR}/target/${RUST_TARGET_TRIPLE}/release/libarduinocore_api_rust.a)
+set(RUST_SRCS
+  ${RUST_CRATE_DIR}/src/lib.rs
+  ${RUST_CRATE_DIR}/src/common.rs
+)
+
+add_custom_command(
+  OUTPUT ${RUST_LIB}
+  COMMAND ${CMAKE_COMMAND} -E env CARGO_TARGET_DIR=${RUST_OUT_DIR}/target
+    cargo build --manifest-path ${RUST_CRATE_DIR}/Cargo.toml
+    --target ${RUST_TARGET_TRIPLE} --release
+  WORKING_DIRECTORY ${RUST_CRATE_DIR}
+  DEPENDS ${RUST_CRATE_DIR}/Cargo.toml ${RUST_SRCS}
+  COMMENT "Building Rust staticlib for ${RUST_TARGET_TRIPLE}"
+  VERBATIM
+)
+
+add_custom_target(arduinocore_api_rust_build ALL DEPENDS ${RUST_LIB})
+add_library(arduinocore_api_rust STATIC IMPORTED GLOBAL)
+set_target_properties(arduinocore_api_rust PROPERTIES IMPORTED_LOCATION ${RUST_LIB})
+zephyr_link_libraries(arduinocore_api_rust)
+
+add_subdirectory(idl)
+add_subdirectory(api)
+
+if(TARGET arduinocore_idl_generate_interfaces)
+  add_dependencies(app arduinocore_idl_generate_interfaces)
+endif()

alt_core_api/api/ArduinoAPI.h

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2026 TOKITA Hiroshi
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#include <stdint.h>
+#include <stddef.h>
+#include <stdlib.h>
+
+#include <zephyr/drivers/gpio.h>
+#include <zephyr/sys/util.h>
+
+#include "common_types.h"
+
+typedef gpio_port_pins_t pin_size_t;
+typedef uint8_t byte;
+
+typedef void (*voidFuncPtr)(void);
+typedef void (*voidFuncPtrParam)(void *);
+
+void setup(void);
+void loop(void);
+void delay(unsigned long);
+
+namespace arduino {}
+
+using namespace arduino;
+
+template <class T> constexpr T min(const T &a, const T &b) {
+	return (a < b) ? a : b;
+}

alt_core_api/api/CMakeLists.txt

@@ -0,0 +1,4 @@
+# SPDX-License-Identifier: Apache-2.0
+
+zephyr_sources(apiCommon.cpp)
+zephyr_sources(apiPrint.cpp)

alt_core_api/api/Common.h

@@ -0,0 +1,7 @@
+/*
+ * Copyright (c) 2026 TOKITA Hiroshi
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/* stub file for compat */

alt_core_api/api/HardwareSerial.h

@@ -0,0 +1,64 @@
+/*
+ * Copyright (c) 2026 TOKITA Hiroshi
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#include "Stream.h"
+#include <hardware_serial_interface.hpp>
+
+namespace arduino {
+
+enum SerialConfig {
+	SERIAL_5E1 = (SERIAL_DATA_5 | SERIAL_PARITY_EVEN | SERIAL_STOP_BIT_1),
+	SERIAL_5E2 = (SERIAL_DATA_5 | SERIAL_PARITY_EVEN | SERIAL_STOP_BIT_2),
+	SERIAL_5O1 = (SERIAL_DATA_5 | SERIAL_PARITY_ODD | SERIAL_STOP_BIT_1),
+	SERIAL_5O2 = (SERIAL_DATA_5 | SERIAL_PARITY_ODD | SERIAL_STOP_BIT_2),
+	SERIAL_5N1 = (SERIAL_DATA_5 | SERIAL_PARITY_NONE | SERIAL_STOP_BIT_1),
+	SERIAL_5N2 = (SERIAL_DATA_5 | SERIAL_PARITY_NONE | SERIAL_STOP_BIT_2),
+	SERIAL_5M1 = (SERIAL_DATA_5 | SERIAL_PARITY_MARK | SERIAL_STOP_BIT_1),
+	SERIAL_5M2 = (SERIAL_DATA_5 | SERIAL_PARITY_MARK | SERIAL_STOP_BIT_2),
+	SERIAL_5S1 = (SERIAL_DATA_5 | SERIAL_PARITY_SPACE | SERIAL_STOP_BIT_1),
+	SERIAL_5S2 = (SERIAL_DATA_5 | SERIAL_PARITY_SPACE | SERIAL_STOP_BIT_2),
+	SERIAL_6E1 = (SERIAL_DATA_6 | SERIAL_PARITY_EVEN | SERIAL_STOP_BIT_1),
+	SERIAL_6E2 = (SERIAL_DATA_6 | SERIAL_PARITY_EVEN | SERIAL_STOP_BIT_2),
+	SERIAL_6O1 = (SERIAL_DATA_6 | SERIAL_PARITY_ODD | SERIAL_STOP_BIT_1),
+	SERIAL_6O2 = (SERIAL_DATA_6 | SERIAL_PARITY_ODD | SERIAL_STOP_BIT_2),
+	SERIAL_6N1 = (SERIAL_DATA_6 | SERIAL_PARITY_NONE | SERIAL_STOP_BIT_1),
+	SERIAL_6N2 = (SERIAL_DATA_6 | SERIAL_PARITY_NONE | SERIAL_STOP_BIT_2),
+	SERIAL_6M1 = (SERIAL_DATA_6 | SERIAL_PARITY_MARK | SERIAL_STOP_BIT_1),
+	SERIAL_6M2 = (SERIAL_DATA_6 | SERIAL_PARITY_MARK | SERIAL_STOP_BIT_2),
+	SERIAL_6S1 = (SERIAL_DATA_6 | SERIAL_PARITY_SPACE | SERIAL_STOP_BIT_1),
+	SERIAL_6S2 = (SERIAL_DATA_6 | SERIAL_PARITY_SPACE | SERIAL_STOP_BIT_2),
+	SERIAL_7E1 = (SERIAL_DATA_7 | SERIAL_PARITY_EVEN | SERIAL_STOP_BIT_1),
+	SERIAL_7E2 = (SERIAL_DATA_7 | SERIAL_PARITY_EVEN | SERIAL_STOP_BIT_2),
+	SERIAL_7O1 = (SERIAL_DATA_7 | SERIAL_PARITY_ODD | SERIAL_STOP_BIT_1),
+	SERIAL_7O2 = (SERIAL_DATA_7 | SERIAL_PARITY_ODD | SERIAL_STOP_BIT_2),
+	SERIAL_7N1 = (SERIAL_DATA_7 | SERIAL_PARITY_NONE | SERIAL_STOP_BIT_1),
+	SERIAL_7N2 = (SERIAL_DATA_7 | SERIAL_PARITY_NONE | SERIAL_STOP_BIT_2),
+	SERIAL_7M1 = (SERIAL_DATA_7 | SERIAL_PARITY_MARK | SERIAL_STOP_BIT_1),
+	SERIAL_7M2 = (SERIAL_DATA_7 | SERIAL_PARITY_MARK | SERIAL_STOP_BIT_2),
+	SERIAL_7S1 = (SERIAL_DATA_7 | SERIAL_PARITY_SPACE | SERIAL_STOP_BIT_1),
+	SERIAL_7S2 = (SERIAL_DATA_7 | SERIAL_PARITY_SPACE | SERIAL_STOP_BIT_2),
+	SERIAL_8E1 = (SERIAL_DATA_8 | SERIAL_PARITY_EVEN | SERIAL_STOP_BIT_1),
+	SERIAL_8E2 = (SERIAL_DATA_8 | SERIAL_PARITY_EVEN | SERIAL_STOP_BIT_2),
+	SERIAL_8O1 = (SERIAL_DATA_8 | SERIAL_PARITY_ODD | SERIAL_STOP_BIT_1),
+	SERIAL_8O2 = (SERIAL_DATA_8 | SERIAL_PARITY_ODD | SERIAL_STOP_BIT_2),
+	SERIAL_8N1 = (SERIAL_DATA_8 | SERIAL_PARITY_NONE | SERIAL_STOP_BIT_1),
+	SERIAL_8N2 = (SERIAL_DATA_8 | SERIAL_PARITY_NONE | SERIAL_STOP_BIT_2),
+	SERIAL_8M1 = (SERIAL_DATA_8 | SERIAL_PARITY_MARK | SERIAL_STOP_BIT_1),
+	SERIAL_8M2 = (SERIAL_DATA_8 | SERIAL_PARITY_MARK | SERIAL_STOP_BIT_2),
+	SERIAL_8S1 = (SERIAL_DATA_8 | SERIAL_PARITY_SPACE | SERIAL_STOP_BIT_1),
+	SERIAL_8S2 = (SERIAL_DATA_8 | SERIAL_PARITY_SPACE | SERIAL_STOP_BIT_2),
+};
+
+class HardwareSerial : virtual public Stream, virtual public HardwareSerialInterface {
+public:
+	using Print::write;
+};
+
+extern void __weak serialEventRun(void);
+
+} // namespace arduino