Add DAPLink instructions and CI test.

Author: carlosperate

.github/workflows/deploy-test.yml

@@ -109,3 +109,28 @@ jobs:
         run: |
           cd microbit-v2-samples
           python build.py
+
+  build-daplink:
+    name: DAPLink test build with master tag image
+    needs: deploy
+    runs-on: ubuntu-latest
+    container: ghcr.io/carlosperate/microbit-toolchain:master
+    steps:
+      - name: Check Versions
+        run: |
+          arm-none-eabi-gcc --version
+          cmake --version
+          ninja --version
+          yotta --version
+          srec_cat --version
+      - name: Clone DAPLink and checkout develop branch
+        run: |
+          git clone https://github.com/mbedmicro/DAPLink
+          cd DAPLink
+          git checkout -b develop origin/develop
+      - name: Install Python dependencies
+        run: pip install -r requirements.txt
+      - name: Build all micro:bit DAPLink projects
+        run: |
+          cd DAPLink
+          python tools/progen_compile.py -t make_gcc_arm kl26z_bl kl26z_microbit_if kl27z_microbit_bl kl27z_microbit_if nrf52820_microbit_bl nrf52820_microbit_if

README.md

@@ -99,6 +99,23 @@ $ docker run -v $(pwd):/home --rm ghcr.io/carlosperate/microbit-toolchain:latest
 $ docker run -v $(pwd):/home --rm ghcr.io/carlosperate/microbit-toolchain:latest bash -c "cd src && make"
 ```
 
+### Example: DAPLink for micro:bit V2
+
+The build steps from this example have been obtained from the
+[project developer's guide](https://github.com/ARMmbed/DAPLink/blob/develop/docs/DEVELOPERS-GUIDE.md).
+
+```bash
+# Clone the repository
+$ git clone https://github.com/mbedmicro/DAPLink
+$ cd DAPLink
+$ git checkout -b develop origin/develop
+# Install the Python dependencies in a venv saved in the project directory
+$ docker run -v $(pwd):/home --rm ghcr.io/carlosperate/microbit-toolchain:latest bash -c "pip install virtualenv && virtualenv venv && source venv/bin/activate && pip install -r requirements.txt"
+# Install the Python dependencies inside the docker image and run the build script
+$ docker run -v $(pwd):/home --rm ghcr.io/carlosperate/microbit-toolchain:latest bash -c "source venv/bin/activate && python tools/progen_compile.py -t make_gcc_arm kl27z_microbit_if"
+```
+
+
 ## How to use this Docker Image with GitHub Codespaces
 
 This section of the docs is still a WIP.
@@ -127,12 +144,3 @@ docker run --name microbit-toolchain-container -it --entrypoint /bin/bash microb
 ```
 docker cp microbit-toolchain-container:/home/artefacts .
 ```
-
-### Publish image
-
-```
-docker login ghcr.io -u <your_username>
-docker images
-docker tag IMAGE_ID ghcr.io/carlosperate/microbit-toolchain:VERSION
-docker push ghcr.io/carlosperate/microbit-toolchain:VERSION
-```

dev-notes.md

@@ -0,0 +1,10 @@
+# Developer docs
+
+## Publish image
+
+```
+docker login ghcr.io -u <your_username>
+docker images
+docker tag IMAGE_ID ghcr.io/carlosperate/microbit-toolchain:VERSION
+docker push ghcr.io/carlosperate/microbit-toolchain:VERSION
+```