aboutsummaryrefslogtreecommitdiff
path: root/docs/modules/ROOT/pages/faq.adoc
diff options
context:
space:
mode:
authorAdin Ackerman <[email protected]>2023-11-27 10:44:47 -0800
committerAdin Ackerman <[email protected]>2023-11-27 10:44:47 -0800
commit142f42fe90caf8edddb34ba1fe6119dbd80a67e6 (patch)
tree06082615ae93d924f540a03678563abf1fca6bf0 /docs/modules/ROOT/pages/faq.adoc
parent5844f5ce2d704058312ea607eb976e438ad990cb (diff)
...
Diffstat (limited to 'docs/modules/ROOT/pages/faq.adoc')
-rw-r--r--docs/modules/ROOT/pages/faq.adoc81
1 files changed, 0 insertions, 81 deletions
diff --git a/docs/modules/ROOT/pages/faq.adoc b/docs/modules/ROOT/pages/faq.adoc
index 2d49b68a6..2994c6278 100644
--- a/docs/modules/ROOT/pages/faq.adoc
+++ b/docs/modules/ROOT/pages/faq.adoc
@@ -4,87 +4,6 @@ These are a list of unsorted, commonly asked questions and answers.
4 4
5Please feel free to add items to link:https://github.com/embassy-rs/embassy/edit/main/docs/modules/ROOT/pages/faq.adoc[this page], especially if someone in the chat answered a question for you! 5Please feel free to add items to link:https://github.com/embassy-rs/embassy/edit/main/docs/modules/ROOT/pages/faq.adoc[this page], especially if someone in the chat answered a question for you!
6 6
7== How do I even start?
8
9There are many ways to configure embassy and it's components for your exact application. The link:https://github.com/embassy-rs/embassy/tree/main/examples[examples] directory for each chipset demonstrate how your project structure should look. Let's break it down:
10
11The toplevel file structure of your project should look like this:
12[source,plain]
13----
14{} = Maybe
15
16my-project
17|- .cargo
18| |- config.toml
19|- src
20| |- main.rs
21|- build.rs
22|- Cargo.toml
23|- {memory.x}
24|- rust-toolchain.toml
25----
26
27=== .cargo/config.toml
28
29This directory/file describes what platform you're on, and configures link:https://github.com/probe-rs/probe-rs[probe-rs] to deploy to your device.
30
31Here is a minimal example:
32
33[source,toml]
34----
35[target.thumbv6m-none-eabi] # <-change for your platform
36runner = 'probe-rs run --chip STM32F031K6Tx' # <- change for your chip
37
38[build]
39target = "thumbv6m-none-eabi" # <-change for your platform
40
41[env]
42DEFMT_LOG = "trace" # <- can change to info, warn, or error
43----
44
45=== build.rs
46
47This is the build script for your project. It links defmt (what is defmt?) and the `memory.x` file if need be. This file is pretty specific for each chipset, just copy and paste from the corresponding link:https://github.com/embassy-rs/embassy/tree/main/examples[example].
48
49=== Cargo.toml
50
51This is your manifest file, where you can configure all of the embassy components to use the features you need.
52
53TODO: someone should exhaustively describe every feature for every component!
54
55=== memory.x
56
57This file outlines the flash/ram usage of your program. It is especially useful when using link:https://github.com/embassy-rs/nrf-softdevice[nrf-softdevice] on an nRF5x.
58
59Here is an example for using S140 with an nRF52840:
60
61[source,x]
62----
63MEMORY
64{
65 /* NOTE 1 K = 1 KiBi = 1024 bytes */
66 /* These values correspond to the NRF52840 with Softdevices S140 7.0.1 */
67 FLASH : ORIGIN = 0x00027000, LENGTH = 868K
68 RAM : ORIGIN = 0x20020000, LENGTH = 128K
69}
70----
71
72=== rust-toolchain.toml
73
74This file configures the rust version and configuration to use.
75
76A minimal example:
77
78[source,toml]
79----
80[toolchain]
81channel = "nightly-2023-08-19" # <- as of writing, this is the exact rust version embassy uses
82components = [ "rust-src", "rustfmt" ] # <- optionally add "llvm-tools-preview" for some extra features like "cargo size"
83targets = [
84 "thumbv6m-none-eabi" # <-change for your platform
85]
86----
87
88== How to deploy to RP2040 without a debugging probe. 7== How to deploy to RP2040 without a debugging probe.
89 8
90Install link:https://github.com/JoNil/elf2uf2-rs[elf2uf2-rs] for converting the generated elf binary into a uf2 file. 9Install link:https://github.com/JoNil/elf2uf2-rs[elf2uf2-rs] for converting the generated elf binary into a uf2 file.