add example for STM32F4 chips

note that this is not part of the main `Cargo.toml` as it has to build
against a different target, which isn't supported if they are in the
same workspace.

Author: rursprung

.github/dependabot.yml

@@ -8,3 +8,7 @@ updates:
     directory: "/"
     schedule:
       interval: "weekly"
+  - package-ecosystem: "cargo"
+    directory: "/examples/stm32f4-single-motor-example"
+    schedule:
+      interval: "weekly"

.github/workflows/CI.yml

@@ -9,7 +9,7 @@ env:
   CARGO_TERM_COLOR: always
 
 jobs:
-  build:
+  lib:
     strategy:
       fail-fast: false
       matrix:
@@ -35,3 +35,31 @@ jobs:
         run: cargo clippy ${{ matrix.features }}
       - name: audit
         run: cargo audit
+
+  stm32f4-single-motor-example:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: install rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: thumbv7em-none-eabihf
+          components: rustfmt clippy
+      - name: Install flip-link
+        run: cargo install flip-link
+      - name: build
+        run: cargo build
+        working-directory: examples/stm32f4-single-motor-example
+      - name: check
+        run: cargo check
+        working-directory: examples/stm32f4-single-motor-example
+      # no tests available for now => no test step as it'd fail otherwise
+      - name: check formatting
+        run: cargo fmt --all -- --check
+        working-directory: examples/stm32f4-single-motor-example
+      - name: clippy
+        run: cargo clippy
+        working-directory: examples/stm32f4-single-motor-example
+      - name: audit
+        run: cargo audit
+        working-directory: examples/stm32f4-single-motor-example

.gitignore

@@ -1,5 +1,5 @@
-/target
+**/target
 /Cargo.lock
 
-.idea
-.vscode
+**/.idea
+**/.vscode

README.md

@@ -23,6 +23,9 @@ See the documentation for usage examples.
 ## Optional features
 * `defmt`: you can enable the [`defmt`](https://defmt.ferrous-systems.com/) feature to get a `defmt::debug!` call for every speed change.
 
+## Examples
+An simple example for the STM32F4 microcontrollers is [available](examples/stm32f4-single-motor-example/README.md).
+
 ## Changelog
 For the changelog please see the dedicated [CHANGELOG.md](CHANGELOG.md).
 

examples/stm32f4-single-motor-example/.cargo/config

@@ -0,0 +1,13 @@
+[target.thumbv7em-none-eabihf]
+runner = 'probe-run --chip STM32F401RE'
+rustflags = [
+    "-C", "link-arg=-Tlink.x",
+    "-C", "link-arg=-Tdefmt.x",
+    "-C", "linker=flip-link",
+]
+
+[build]
+target = "thumbv7em-none-eabihf"
+
+[env]
+DEFMT_LOG = "info"