Adding some very basic documentation.

Author: aentinger

.gitignore

@@ -1,3 +1,4 @@
 .vscode/
 .idea/
 build/
+cmake-build-debug/

extras/cyphal++/examples/example-01-opencyphal-basic-node/README.md

@@ -0,0 +1,30 @@
+<a href="https://opencyphal.org/"><img align="right" src="https://raw.githubusercontent.com/107-systems/.github/main/logo/opencyphal.svg" width="25%"></a>
+:floppy_disk: `example-01-opencyphal-basic-node`
+================================================
+* Setup a virtual CAN interface (`vcan0`)
+```bash
+sudo ./setup_vcan.sh
+```
+* Install `yakut`
+```bash
+python3 -m pip install yakut
+```
+* Compile OpenCyphal DSDL
+```bash
+yakut compile https://github.com/OpenCyphal/public_regulated_data_types/archive/refs/heads/master.zip 
+```
+* Setup `yakut`
+```bash
+./setup_yakut.sh
+```
+* Start `yakut`
+```bash
+yakut monitor 
+```
+* Use `yakut`
+
+Read the register list of the node.
+```bash
+yakut rl 42
+[cyphal.node.description, cyphal.node.id, cyphal.pub.temperature.id, cyphal.pub.temperature.type]
+```

extras/cyphal++/examples/example-01-opencyphal-basic-node/example-01-opencyphal-basic-node.cpp

@@ -5,12 +5,6 @@
  * Contributors: https://github.com/107-systems/107-Arduino-Cyphal/graphs/contributors.
  */
 
-/*
- * Note: Before running this example make sure to set-up a virtual can interface
- * by executing
- *  sudo ./setup_vcan.sh
- */
-
 /**************************************************************************************
  * INCLUDES
  **************************************************************************************/

extras/cyphal++/examples/example-01-opencyphal-basic-node/setup_yakut.sh

@@ -0,0 +1,6 @@
+export YAKUT_COMPILE_OUTPUT=.yakut
+export YAKUT_PATH="$YAKUT_COMPILE_OUTPUT"
+export UAVCAN__CAN__IFACE='socketcan:vcan0'
+export UAVCAN__CAN__MTU=8
+export UAVCAN__NODE__ID=$(yakut accommodate)  # Pick an unoccupied node-ID automatically for this shell session.
+echo "Auto-selected node-ID for this session: $UAVCAN__NODE__ID"