Skip to content

Commit 920d2cc

Browse files
ithinuel9names
andauthored
doc: Document the project creation process (#99)
* doc: Document the project creation process * fix: typo in readme.md introduced in the previous commit Co-authored-by: 9names <[email protected]> --------- Co-authored-by: 9names <[email protected]>
1 parent 55928a6 commit 920d2cc

File tree

1 file changed

+26
-1
lines changed

1 file changed

+26
-1
lines changed

README.md

Lines changed: 26 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ If you aren't using a debugger (or want to use other debugging configurations),
1818
<ol>
1919
<li><a href="#markdown-header-requirements">Requirements</a></li>
2020
<li><a href="#installation-of-development-dependencies">Installation of development dependencies</a></li>
21+
<li><a href="#project-creation">Project Creation</a></li>
2122
<li><a href="#running">Running</a></li>
2223
<li><a href="#alternative-runners">Alternative runners</a></li>
2324
<li><a href="#notes-on-using-rp2040_boot2">Notes on using rp2040_boot2</a></li>
@@ -41,7 +42,6 @@ If you aren't using a debugger (or want to use other debugging configurations),
4142
- flip-link - this allows you to detect stack-overflows on the first core, which is the only supported target for now.
4243

4344
- (by default) A [`probe-rs` installation](https://probe.rs/docs/getting-started/installation)
44-
4545
- A [`probe-rs` compatible](https://probe.rs/docs/getting-started/probe-setup) probe
4646

4747
You can use a second
@@ -67,6 +67,31 @@ If you get the error ``binary `cargo-embed` already exists`` during installation
6767

6868
</details>
6969

70+
<!-- Creating the project -->
71+
<details open="open">
72+
<summary><h2 style="display: inline-block" id="project-creation">Creating your project</h2></summary>
73+
74+
### Using `cargo-generate`
75+
76+
```sh
77+
cargo generate --git https://github.com/rp-rs/rp2040-project-template
78+
```
79+
80+
Follow the wizard 🪄 and enjoy your new project.
81+
82+
### Downloading as a zip file or using GitHub's template support
83+
84+
Obtain a copy of the code, either by downloading this repository as a zip file or using GitHub's
85+
template feature, then apply the following:
86+
- Remove `debug_probes.md`.
87+
- Remove the `cargo-generate` directory.
88+
- Remove/edit `README.md`.
89+
- If using vscode update `.vscode/launch.json`;
90+
Else: remove this file.
91+
- Edit `Cargo.toml` & adjust according to your project (especially its name).
92+
- Edit `.cargo/config.toml` to select your favorite runner.
93+
94+
</details>
7095

7196
<!-- Running -->
7297
<details open="open">

0 commit comments

Comments
 (0)