aboutsummaryrefslogtreecommitdiff
path: root/book/en/src/by-example/tips_indirection.md
diff options
context:
space:
mode:
authordatdenkikniet <jcdra1@gmail.com>2023-04-23 13:22:35 +0200
committerdatdenkikniet <jcdra1@gmail.com>2023-05-11 19:20:58 +0200
commite51146a98cc7c83ea574d13b4b5d8e7ceeeb004b (patch)
tree2c177aa08778c51167835278d4d3e0c777d03019 /book/en/src/by-example/tips_indirection.md
parentcb0ceea472f33ed7a8b17fe7e0b98f24927d9185 (diff)
Move tips into their own subdir
Diffstat (limited to 'book/en/src/by-example/tips_indirection.md')
-rw-r--r--book/en/src/by-example/tips_indirection.md26
1 files changed, 0 insertions, 26 deletions
diff --git a/book/en/src/by-example/tips_indirection.md b/book/en/src/by-example/tips_indirection.md
deleted file mode 100644
index 0de14a6..0000000
--- a/book/en/src/by-example/tips_indirection.md
+++ /dev/null
@@ -1,26 +0,0 @@
-# Using indirection for faster message passing
-
-Message passing always involves copying the payload from the sender into a static variable and then from the static variable into the receiver. Thus sending a large buffer, like a `[u8; 128]`, as a message involves two expensive
-`memcpy`s.
-
-Indirection can minimize message passing overhead: instead of sending the buffer by value, one can send an owning pointer into the buffer.
-
-One can use a global memory allocator to achieve indirection (`alloc::Box`, `alloc::Rc`, etc.), which requires using the nightly channel as of Rust v1.37.0, or one can use a statically allocated memory pool like [`heapless::Pool`].
-
-[`heapless::Pool`]: https://docs.rs/heapless/0.5.0/heapless/pool/index.html
-
-As this example of approach goes completely outside of RTIC resource model with shared and local the program would rely on the correctness of the memory allocator, in this case `heapless::pool`.
-
-Here's an example where `heapless::Pool` is used to "box" buffers of 128 bytes.
-
-``` rust
-{{#include ../../../../rtic/examples/pool.rs}}
-```
-
-``` console
-$ cargo run --target thumbv7m-none-eabi --example pool
-```
-
-``` console
-{{#include ../../../../rtic/ci/expected/pool.run}}
-```