aboutsummaryrefslogtreecommitdiff
path: root/book/en/src/by-example/software_tasks.md
diff options
context:
space:
mode:
authorbors[bot] <26634292+bors[bot]@users.noreply.github.com>2021-09-25 17:09:54 +0000
committerGitHub <noreply@github.com>2021-09-25 17:09:54 +0000
commitf0c319982524988fa67cac3c59a4a4a863c409c9 (patch)
treede4cbe4b43d399d4dcf2021c33225ccd00627434 /book/en/src/by-example/software_tasks.md
parentc8621d78b9b1c0c67dff31404ade873a9d7b426e (diff)
parentb71df58f2fb4ed85d4c8cf806d5837ce63c73f31 (diff)
Merge #528
528: The great 0.6 docs update r=AfoHT a=korken89 Closes #530 Closes #527 Closes #487 Closes #461 Closes #448 Closes #440 Closes #422 Co-authored-by: Emil Fresk <emil.fresk@gmail.com>
Diffstat (limited to 'book/en/src/by-example/software_tasks.md')
-rw-r--r--book/en/src/by-example/software_tasks.md16
1 files changed, 16 insertions, 0 deletions
diff --git a/book/en/src/by-example/software_tasks.md b/book/en/src/by-example/software_tasks.md
new file mode 100644
index 0000000..0c9b62e
--- /dev/null
+++ b/book/en/src/by-example/software_tasks.md
@@ -0,0 +1,16 @@
+# Software tasks & spawn
+
+To declare tasks in the framework the `#[task]` attribute is used on a function.
+By default these tasks are referred to as software tasks as they do not have a direct coupling to
+an interrupt handler. Software tasks can be spawned (started) using the `task_name::spawn()` static
+method which will directly run the task given that there are no higher priority tasks running.
+This is exemplified in the following:
+
+``` rust
+{{#include ../../../../examples/spawn.rs}}
+```
+
+``` console
+$ cargo run --target thumbv7m-none-eabi --example spawn
+{{#include ../../../../ci/expected/spawn.run}}
+```