Merge branch 'pr329' into merge

Conflicts:
	.github/workflows/build.yml
	.github/workflows/checkpatch.yml
	.github/workflows/format_check.yml
	.github/workflows/license_check.yml
	.gitignore
	CMakeLists.txt
	README.md
	cores/arduino/Arduino.h
	cores/arduino/main.cpp
	cores/arduino/zephyrCommon.cpp
	cores/arduino/zephyrPrint.cpp
	cores/arduino/zephyrPrint.h
	cores/arduino/zephyrSerial.cpp
	cores/arduino/zephyrSerial.h
	documentation/variants.md
	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/hello_arduino/src/app.cpp
	samples/i2cdemo/CMakeLists.txt
	samples/serial_event/CMakeLists.txt
	samples/spi_controller/CMakeLists.txt
	samples/threads_arduino/CMakeLists.txt
	variants/arduino_nano_33_ble_nrf52840_sense/variant.h
	variants/arduino_nano_33_ble_sense/variant.h
	variants/arduino_opta_stm32h747xx_m7/variant.h
	west.yml

Author: soburi

.gitmodules

@@ -0,0 +1,6 @@
+[submodule "libraries/Arduino_RouterBridge"]
+	path = libraries/Arduino_RouterBridge
+	url = https://github.com/arduino-libraries/Arduino_RouterBridge.git
+[submodule "libraries/Arduino_RPClite"]
+	path = libraries/Arduino_RPClite
+	url = https://github.com/arduino-libraries/Arduino_RPClite.git

Kconfig

@@ -42,3 +42,23 @@ config ARDUINO_MAX_TONES
 	  If set to a negative value, the maximum number will be determined from the
 	  system's digital pin configuration.
 endif
+
+if USB_DEVICE_STACK_NEXT
+
+config USB_DEVICE_PRODUCT
+	string "USB Device Product"
+	default "Arduino Generic board"
+
+config USB_DEVICE_MANUFACTURER
+	string "USB Device Manufacturer"
+	default "Arduino"
+
+config USB_DEVICE_VID
+	hex "USB Device Vendor ID"
+	default 0x2341
+
+config USB_DEVICE_PID
+	hex "USB Device Product ID"
+	default 0x0001
+
+endif

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/)