Merge tag '0.55.0' into merge-0.55.0

 Conflicts:
	.github/workflows/build.yml
	.github/workflows/checkpatch.yml
	.github/workflows/format_check.yml
	.github/workflows/license_check.yml
	.gitignore
	CMakeLists.txt
	Kconfig
	README.md
	cores/arduino/Arduino.h
	cores/arduino/main.cpp
	cores/arduino/zephyrPrint.cpp
	cores/arduino/zephyrPrint.h
	cores/arduino/zephyrSerial.cpp
	cores/arduino/zephyrSerial.h
	documentation/variants.md
	libraries/SPI/SPI.cpp
	libraries/SPI/SPI.h
	libraries/Wire/Wire.cpp
	libraries/Wire/Wire.h
	samples/analog_input/CMakeLists.txt
	samples/attach_interrupt/CMakeLists.txt
	samples/blinky_arduino/CMakeLists.txt
	samples/button_press_led/CMakeLists.txt
	samples/fade/CMakeLists.txt
	samples/hello_arduino/CMakeLists.txt
	samples/i2cdemo/CMakeLists.txt
	samples/serial_event/CMakeLists.txt
	samples/spi_controller/CMakeLists.txt
	samples/threads_arduino/CMakeLists.txt
	variants/default/variant.h
	west.yml

Author: soburi

.gitignore

@@ -1 +1,11 @@
-rust/Cargo.lock
+/build/
+/distrib/
+/firmwares/*
+/rust/Cargo.lock
+/venv/
+llext-edk/
+cflags.txt
+cxxflags.txt
+includes.txt
+syms-dynamic.ld
+syms-static.ld

README.gsoc.md

@@ -0,0 +1,55 @@
+# GSoC 2022 Project: Arduino Core API module for Zephyr
+
+![](https://dhruvag2000.github.io/Blog-GSoC22/assets/images/website_header.png)
+
+The **Arduino Core API** module for zephyr leverages the power of Zephyr under an Arduino-C++ style abtraction layer thus helping zephyr new-comers to start using it without worrying about learning about new APIs and libraries. See the project documentation folder for detailed documentation on these topics:
+
+* [Using external Arduino Libraries](/documentation/arduino_libs.md)
+* [Adding custom boards/ variants](/documentation/variants.md)
+
+## Adding Arduino Core API to Zephyr
+
+* **Pre requisites:** It is assumed that you have zephyrproject configured and installed on your system as per the official [Get Started Guide](https://docs.zephyrproject.org/latest/develop/getting_started/index.html). The recommended path to install is `~/zephyrproject` as specified in the guide. If you have zephyr installed in a custom path you may need to make changes to the CMakeLists.txt file in the sample code directory when building these samples.
+
+* Add following entry to `west.yml` file in `manifest/projects` subtree of Zephyr:
+```
+# Arduino API repository.
+- name: Arduino-Core-Zephyr
+  path: modules/lib/Arduino-Zephyr-API
+  revision: main
+  url: https://github.com/zephyrproject-rtos/gsoc-2022-arduino-core
+```
+
+* Then, clone the repository by running
+
+```sh
+west update
+```
+
+* **Note:** For ***Linux users only*** there exists an ``install.sh`` script in this project that can be run to quickly link the ArduinoCore-API to this module.
+If you are able to run that script successfully then you can skip the next steps.
+
+* To "complete" the core you need to copy or symlink the api folder from the [ArduinoCore-API](https://github.com/arduino/ArduinoCore-API.git) repo to the target's ``cores/arduino`` folder:
+```sh
+$ git clone git@github.com:arduino/ArduinoCore-API # Any location
+$ ln -s /<your>/<location>/ArduinoCore-API/api cores/arduino/.
+```
+The `cores` folder can be found at `~/zephyrproject/modules/lib/Arduino-Zephyr-API/cores`.
+
+**Known Bug(s):**
+
+__NOTE:__ You can skip this step as well if you ran ``install.sh``.
+
+**Maintainers**:
+- [DhruvaG2000](https://github.com/DhruvaG2000)
+- [soburi](https://github.com/soburi)
+- [szczys](https://github.com/szczys)
+- [beriberikix](https://github.com/beriberikix)
+- [alvarowolfx](https://github.com/alvarowolfx)
+
+## License
+Please note that the current license is Apache 2. Previously it was LGPL 2.1 but after careful review it was determined that no LGPL code or derivates was used and the more permissive license was chosen.
+
+**Additional Links**
+* [Official Project Blog](https://dhruvag2000.github.io/Blog-GSoC22/)
+* Golioth's Article: [Zephyr + Arduino: a Google Summer of Code story](https://blog.golioth.io/zephyr-arduino-a-google-summer-of-code-story/)

cores/arduino/DebugLog.h

@@ -0,0 +1,23 @@
+/*
+ * Copyright (c) Arduino s.r.l. and/or its affiliated companies
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+/*
+ * This header is used to forcibly disable logging and assertions in the
+ * MsgPack library. It is here to shadow the real DebugLog library available in
+ * the index, which is currently not compatible with the latest boards.
+ */
+
+#define LOG_ERROR(...) ((void)0)
+#define LOG_WARN(...)  ((void)0)
+#define LOG_INFO(...)  ((void)0)
+#define LOG_DEBUG(...) ((void)0)
+#define LOG_TRACE(...) ((void)0)
+#define ASSERT(...)    ((void)0)
+#define ASSERTM(...)   ((void)0)
+#define PRINT(...)     ((void)0)
+#define PRINTLN(...)   ((void)0)

cores/arduino/SerialUSB.h

@@ -0,0 +1,62 @@
+/*
+ * Copyright (c) Arduino s.r.l. and/or its affiliated companies
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#include <zephyrSerial.h>
+
+#if defined(CONFIG_USB_DEVICE_STACK_NEXT)
+#include <zephyr/usb/usbd.h>
+extern "C" struct usbd_context *usbd_init_device(usbd_msg_cb_t msg_cb);
+#endif
+
+namespace arduino {
+
+class SerialUSB_ : public ZephyrSerial {
+
+public:
+	SerialUSB_(const struct device *dev) : ZephyrSerial(dev) {
+	}
+
+	void begin(unsigned long baudrate, uint16_t config);
+
+	void begin(unsigned long baudrate) {
+		begin(baudrate, SERIAL_8N1);
+	}
+
+	operator bool() override;
+	size_t write(const uint8_t *buffer, size_t size) override;
+
+	size_t write(const uint8_t data) override {
+		return write(&data, 1);
+	}
+
+	void flush() override;
+
+protected:
+	uint32_t dtr = 0;
+	uint32_t baudrate;
+	static void baudChangeHandler(const struct device *dev, uint32_t rate);
+
+	void _reinit_if_needed() override {
+		/* prevent reinit: USB device is always available */
+	}
+
+private:
+	bool started = false;
+
+#if defined(CONFIG_USB_DEVICE_STACK_NEXT)
+	struct usbd_context *_usbd;
+	int enable_usb_device_next();
+	static void usbd_next_cb(struct usbd_context *const ctx, const struct usbd_msg *msg);
+	static int usb_disable();
+#endif
+};
+} // namespace arduino
+
+#if ZARD_FIRST_SERIAL_IS_SERIALUSB
+extern arduino::SerialUSB_ Serial;
+#endif

cores/arduino/USB.cpp

@@ -0,0 +1,109 @@
+/*
+ * Copyright (c) Arduino s.r.l. and/or its affiliated companies
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr/devicetree.h>
+#include <zephyr/drivers/uart.h>
+#include <zephyr/drivers/uart/cdc_acm.h>
+#include <zephyr/usb/usb_device.h>
+#include <SerialUSB.h>
+
+#if ZARD_FIRST_SERIAL_IS_SERIALUSB
+const struct device *const usb_dev =
+	DEVICE_DT_GET(DT_PHANDLE_BY_IDX(DT_PATH(zephyr_user), cdc_acm_serial, 0));
+
+void __attribute__((weak)) _on_1200_bps() {
+	NVIC_SystemReset();
+}
+
+void arduino::SerialUSB_::baudChangeHandler(const struct device *dev, uint32_t rate) {
+	(void)dev; // unused
+	if (rate == 1200) {
+		usb_disable();
+		_on_1200_bps();
+	}
+}
+
+#if defined(CONFIG_USB_DEVICE_STACK_NEXT)
+int arduino::SerialUSB_::usb_disable() {
+	// To avoid Cannot perform port reset: 1200-bps touch: setting DTR to OFF: protocol error
+	k_sleep(K_MSEC(100));
+	return usbd_disable(Serial._usbd);
+}
+
+void arduino::SerialUSB_::usbd_next_cb(struct usbd_context *const ctx, const struct usbd_msg *msg) {
+	if (usbd_can_detect_vbus(ctx)) {
+		if (msg->type == USBD_MSG_VBUS_READY) {
+			usbd_enable(ctx);
+		}
+
+		if (msg->type == USBD_MSG_VBUS_REMOVED) {
+			usbd_disable(ctx);
+		}
+	}
+
+	if (msg->type == USBD_MSG_CDC_ACM_LINE_CODING) {
+		uint32_t baudrate;
+		uart_line_ctrl_get(Serial.uart, UART_LINE_CTRL_BAUD_RATE, &baudrate);
+		Serial.baudChangeHandler(nullptr, baudrate);
+	}
+}
+
+int arduino::SerialUSB_::enable_usb_device_next(void) {
+	int err;
+
+	_usbd = usbd_init_device(arduino::SerialUSB_::usbd_next_cb);
+	if (_usbd == NULL) {
+		return -ENODEV;
+	}
+
+	if (!usbd_can_detect_vbus(_usbd)) {
+		err = usbd_enable(_usbd);
+		if (err) {
+			return err;
+		}
+	}
+	return 0;
+}
+#endif /* defined(CONFIG_USB_DEVICE_STACK_NEXT) */
+
+void arduino::SerialUSB_::begin(unsigned long baudrate, uint16_t config) {
+	if (!started) {
+#ifndef CONFIG_USB_DEVICE_STACK_NEXT
+		usb_enable(NULL);
+#ifndef CONFIG_CDC_ACM_DTE_RATE_CALLBACK_SUPPORT
+#warning "Can't read CDC baud change, please enable CONFIG_CDC_ACM_DTE_RATE_CALLBACK_SUPPORT"
+#else
+		cdc_acm_dte_rate_callback_set(usb_dev, SerialUSB_::baudChangeHandler);
+#endif
+#else
+		enable_usb_device_next();
+#endif
+		ZephyrSerial::begin(baudrate, config);
+		started = true;
+	}
+}
+
+arduino::SerialUSB_::operator bool() {
+	uart_line_ctrl_get(uart, UART_LINE_CTRL_DTR, &dtr);
+	return dtr;
+}
+
+size_t arduino::SerialUSB_::write(const uint8_t *buffer, size_t size) {
+	if (!Serial) {
+		return 0;
+	}
+	return arduino::ZephyrSerial::write(buffer, size);
+}
+
+void arduino::SerialUSB_::flush() {
+	if (!Serial) {
+		return;
+	}
+	arduino::ZephyrSerial::flush();
+}
+
+arduino::SerialUSB_ Serial(usb_dev);
+#endif

cores/arduino/abi.cpp

@@ -0,0 +1,26 @@
+/*
+ * Copyright (c) Arduino s.r.l. and/or its affiliated companies
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <stdlib.h>
+
+extern "C" {
+
+void *__dso_handle = (void *)&__dso_handle;
+
+void __cxa_pure_virtual(void) {
+}
+
+void __cxa_deleted_virtual(void) {
+}
+
+int __cxa_atexit(void (*func)(void *), void *arg, void *dso_handle) {
+	(void)func;
+	(void)arg;
+	(void)dso_handle; // unused
+	return 0;
+}
+
+} /* extern "C" */