Add bsc exercise text #196

Mirabellensaft · 2023-02-21T15:28:44Z

No description provided.

miguelraz · 2023-03-14T19:10:48Z

embedded-workshop-book/src/SUMMARY.md

@@ -26,6 +26,8 @@
      - [Starting a Project from Scratch](./from-scratch.md)
 - [Down the Stack Workbook](./down-the-stack.md)
    - [BSC Exercise](./bsc-exercise.md)


This particular file ./bsc-exercise.md shows up as empty on my version of the mdbook when rendering. Slight papercut, but a small blurb or image about the exercise (or an off-beat motivational sentence to encourage the participants) could occupy some space there.

embedded-workshop-book/src/bsc-exercise.md

miguelraz · 2023-03-14T19:19:41Z

embedded-workshop-book/src/bsc-exercise.md

+## Knowledge
+
+### Comments
+The `lib.rs` has an attribute #![deny(missing_docs)]. This means, that missing doc comments for structs are returned as compiler errors, to remind you to document your work properly. 


Nit:
Backticks on #![deny(missing_docs)].

jonathanpallant

Left some comments. Most of it is re-ordering "Exercise Button" to "Button Exercise", but there are also some notes which I hope clarify the Uarte example a little bit.

Looks like a fun exercise!

down-the-stack/dk_bsc/src/lib_solution.rs

embedded-workshop-book/src/uarte-implementation.md

jonathanpallant · 2023-03-20T10:21:30Z

embedded-workshop-book/src/uarte-implementation.md

+ls /dev/tty.usbmodem*
+```
+
+✅  Run the following command to run `screen` with the nRF52840-DK with 115200 baud. 


screen is a bit of a pain to exit and doesn't have a great UI. I have had a lot of success with python3 -m serial.tools.miniterm (or the alias pyserial-miniterm), but that requires you have Python and pyserial installed. PuTTY and TeraTerm are other popular options (especially on Windows).

jonathanpallant · 2023-03-20T10:22:01Z

embedded-workshop-book/src/uarte-implementation.md

+
+On your terminal window where `screen` runs, "Hello, World" should appear. 
+
+You need to terminate `screen` manually.


Ha! Good luck with that. It's very easy to 'disconnect' the instance but leave it running in the background, hogging the COM port device.

How is that done properly?

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Mirabellensaft added 4 commits February 21, 2023 16:48

add pages to book

14d76fb

add step by step solution

3afc29c

add exercise intro draft

c1825d1

add uarte draft

bf87279

Mirabellensaft force-pushed the add_bsc_exercise_text branch from 6591dae to bf87279 Compare February 21, 2023 15:50

Mirabellensaft added 17 commits February 22, 2023 19:11

add learning goals

dffa5d4

add most of exercise text

453eb95

finish draft of uarte implementation

a142d15

rm button from example

16fbd1c

correct uarte peripheral

1665506

mark code

cd345aa

clean text

373e791

Intro to testing

a1e990b

add todo

b2adf4a

add comments and solution file

3465441

clarification

71ad8b0

correct message

59a08c6

add uarte tasks

37930c3

add generate docs instruction

5b11a4d

clarifications after test

38c963e

address issues from testing

3b72b1b

last formatting and adding code snippets

9a354f2

Mirabellensaft marked this pull request as ready for review March 14, 2023 18:43

Mirabellensaft requested review from jonathanpallant and miguelraz March 14, 2023 18:43

miguelraz reviewed Mar 14, 2023

View reviewed changes

embedded-workshop-book/src/bsc-exercise.md Outdated Show resolved Hide resolved

miguelraz reviewed Mar 14, 2023

View reviewed changes

embedded-workshop-book/src/bsc-exercise.md Outdated Show resolved Hide resolved

miguelraz reviewed Mar 14, 2023

View reviewed changes

polish

30fe350

jonathanpallant reviewed Mar 20, 2023

View reviewed changes

Mirabellensaft and others added 25 commits March 20, 2023 14:34

Update down-the-stack/dk_bsc/src/lib_solution.rs

bfcb572

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update down-the-stack/dk_bsc/src/lib_solution.rs

ab2d908

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update down-the-stack/dk_bsc/src/lib_solution.rs

5f079cd

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update down-the-stack/dk_bsc/src/lib_solution.rs

2505e00

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update down-the-stack/dk_bsc/src/lib_solution.rs

e7eef7a

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update embedded-workshop-book/src/uarte-implementation.md

f0bf2ec

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update embedded-workshop-book/src/uarte-implementation.md

5fc64c5

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update down-the-stack/dk_bsc/src/lib_solution.rs

b5c3480

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update down-the-stack/dk_bsc/src/lib_solution.rs

a3f653d

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update down-the-stack/dk_bsc/src/lib_solution.rs

89ee72e

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update down-the-stack/dk_bsc/src/lib_solution.rs

274767b

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update down-the-stack/dk_bsc/src/lib_solution.rs

d647036

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update down-the-stack/dk_bsc/src/lib_solution.rs

dc9232f

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update down-the-stack/dk_bsc/src/lib_solution.rs

81b6657

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update down-the-stack/dk_bsc/src/lib_solution.rs

4fb7415

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update down-the-stack/dk_bsc/src/lib_solution.rs

8de826d

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update down-the-stack/dk_bsc/src/lib_solution.rs

1db5935

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update down-the-stack/dk_bsc/src/lib_solution.rs

08654a5

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update embedded-workshop-book/src/bsc-exercise.md

ee29b74

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update embedded-workshop-book/src/uarte-implementation.md

f981189

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

rm led color comment

debd765

Update embedded-workshop-book/src/uarte-implementation.md

7701ae8

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update embedded-workshop-book/src/uarte-implementation.md

5e5ccb5

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

Update embedded-workshop-book/src/uarte-implementation.md

b09dd73

Co-authored-by: Jonathan Pallant <jonathan.pallant@ferrous-systems.com>

add links to html doc

ee0f7b1

Mirabellensaft merged commit 70ce745 into new_embedded_assignment Mar 20, 2023

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add bsc exercise text #196

Add bsc exercise text #196

Mirabellensaft commented Feb 21, 2023

miguelraz Mar 14, 2023

miguelraz Mar 14, 2023

jonathanpallant left a comment

jonathanpallant Mar 20, 2023

jonathanpallant Mar 20, 2023

Mirabellensaft Mar 20, 2023


		On your terminal window where `screen` runs, "Hello, World" should appear.

		You need to terminate `screen` manually.

Add bsc exercise text #196

Add bsc exercise text #196

Conversation

Mirabellensaft commented Feb 21, 2023

miguelraz Mar 14, 2023

Choose a reason for hiding this comment

miguelraz Mar 14, 2023

Choose a reason for hiding this comment

jonathanpallant left a comment

Choose a reason for hiding this comment

jonathanpallant Mar 20, 2023

Choose a reason for hiding this comment

jonathanpallant Mar 20, 2023

Choose a reason for hiding this comment

Mirabellensaft Mar 20, 2023

Choose a reason for hiding this comment