libSMCE

Spiritual successor to the backend of SMartCarEmul
Copyright © ItJustWorks™

Status: Actively maintained

This cross-platform C++ library provides its consumers the ability to compile and execute Arduino sketches on a hosted environment, with bindings to its virtual I/O ports to allow the host application to interact with its child sketches.

Check our Wiki for more information about usage.

Supported I/O

GPIO (Arduino’s digitalRead, analogWrite, etc)
UART (Arduino’s Serial global)
SD (writes to host’s filesystem in a pre-configured root)
MQTT (interface of arduino-mqtt) - Note: cannot be monitored by host application
OV767X Camera (interface of Arduino_OV767X) - Note: available pixel formats differ

Supported sketch languages

C++
Arduino C++ (through arduino-prelude)
Juniper (requires the Juniper compiler to be already installed)

Build Requirements

CMake >= 3.16
C++20 compiler (tested with GCC >= 10, Clang/LLVM >= 10, MSVC >= 19.28, AppleClang)
OpenSSL (tested with 1.1.1)

Automatically built from source

Boost ~= 1.78 - Not an interface requirement however (you only need Boost headers to build the library, not when using it precompiled)
libmosquitto 2.0.9 - Used to provide MQTT support

Runtime Requirements

CMake >= 3.12
C++ compiler with support for at least C++11 - MinGW and MSVC-Wine are NOT officially supported

Optional

Ninja - On Un*x, will be used by setting CMAKE_GENERATOR (if that environment variable is unset)

Build instructions

cmake -S . -B build
cd build
cmake --build .

Running the testsuite

cmake --build . --target SMCE_Tests
ctest

Packaging

cpack

Future development

Serve the Doxygen-generated docs
Making a proper Hugo-generated wiki in Markdown
std::error_codeify smce::Board
Add more I/O features, in particular the ones that were in SMartCarEmul
Add interrupts support
Allow consumers to specify toolchain files

First-party frontend

See SMCE-gd, designed for Arduino RC vehicles.