Comments (17)
From @jamesmunns on July 10, 2018 9:16
@thejpster proposed moving Sections 7.1-7.4 into a new section (how to think in embedded rust), to be placed after section 2.
from book.
From @jamesmunns on July 10, 2018 9:17
@japaric proposed splitting up Section 3 (embedded-hal) into two Sections, one covering Portablility, and one covering Static Guarantees
Edit: This was agreed in the meeting on 2018-07-09. For now I have split these up as 3A and 3B until we update the outline.
from book.
Tock-OS Ecosystem
Are Tock userland apps working on stable? The books should only contain stuff that works on stable.
I propose we add a section on concurrency briefly talking about Send and Sync (which are well covered in the Rust book) and then go over the concurrency systems / pattetrns that exists: bare metal (static + interrupt handlers), Real Time For the Masses (tasks, message passing) and, if stable, Tock (multiprocess and cooperative within a process).
from book.
From @thejpster on July 17, 2018 12:8
Will this be updated with the revised layout as discussed at the WG meeting, or is that tracked elsewhere?
from book.
From @ryankurte on July 17, 2018 12:9
@jamesmunns there was some discussion in #56 and from there #112 about building Running and Debugging into a good tool-independent resource (which I definitely support), and in which case I would suggest it could be a separate section?
from book.
@thejpster the issue description has bee updated with the revised outline.
the embedded book is aimed at people familiar with embedded development. IME running and debugging Rust programs doesn't look much different from running and debugging C programs -- the same tooling is used, the format is the same (ELF or binary) -- so I'm not sure if such section should be in the embedded book (i.e. it could live elsewhere). It also seems more efficient (less work) to point to existing resources (e.g. Discovery for OpenOCD + GDB, C resources for other tools) and just cover Rust specific stuff: the compiler produces ELF files and places them in target/$TARGET/$binary; use objcopy to get a binary file out of that; Rust symbols look like foo::bar::$function::$hash
; and so on.
Of course if someone commits to writing documentation for every combination of flashing / debugging tool out there then we would be happy to publish such documentation somewhere.
from book.
From @thejpster on July 20, 2018 9:20
LGTM
from book.
From @kjetilkjeka on July 20, 2018 10:0
I've already mentioned bobbin-cli in other issues. This tool is unique to rust, integrated well with existing tools and makes debugging and running rust programs a much more pleasant experience than c. I think this tool should be mentioned in the book. It do not need its own section and csn be included into "Introduction" or "Blinking Your First LED"
from book.
From @jamesmunns on July 29, 2018 14:32
Hey all, I've started implementing this new outline in rust-embedded/wg#133. I would appreciate any review.
If you think any of my old notes should be preserved in the new outline, please feel free to let me know.
from book.
From @jamesmunns on August 4, 2018 13:17
I've written up my plan for getting the book shipped this year. TL;DR, I am going to commit to shipping one chapter every two weeks until the end of the year.
If anyone has time to contribute, review, or expand on anything towards the book. It would be very welcome. Hopefully I should be much more active on this issue over the next 18 weeks :)
from book.
From @andre-richter on August 4, 2018 14:2
Whoa that's an ambitious plan. Let's see if we can keep you motivated :). I'll try to help with some review work whenever I can in my abundance of free time... 😕
from book.
From @jamesmunns on August 4, 2018 14:8
Yeah, We'll see how far I get! I signed up for this a while back, and life happened. Hopefully after RustConf (in about two weeks), I'll be able to commit more of my "free" cycles. I don't think two weeks is enough to make each chapter a master work, but hopefully enough to ship our first version of the book, and functional enough for people new to working in embedded rust.
I definitely think I would benefit from any additional help, but I wanted to put my commitment out there, hoping other people would benefit from seeing my schedule.
rust-embedded/wg#133 is up for review if you have any cycles now :)
from book.
@jamesmunns awesome! I'll be assigning all the book issues to you then. I will try to submit some braindumps for memory management, singletons and concurrency this week.
from book.
Oh and we should move out the book ASAP to have a dedicated issue tracker.
from book.
And that means migrating the book issues in this issue tracker to the other one. (I don't know how to do that :-).
from book.
Triage: blocked on having more content on the book. Then we can decide how to sort out the chapters.
from book.
We discussed this in a previous meeting and the required changes were done in #80
from book.
Related Issues (20)
- zsh: no such file or directory: gdb
- Apple Silicon can't install gdb, lldb instructions needed? HOT 3
- I think this repository can support more languages HOT 21
- How would one cite this book in an academic resource? HOT 5
- Where can I find the definition of the set_timer_1hz function?
- GDB blocks after running the continue command in 2.2-hardware HOT 1
- Doens't Work Verification OPENOCD
- Concurrency / Atomic access section contains factual errors HOT 6
- Discuss the usage of the `log` crate HOT 2
- Mention the critical-section crate?
- Memory-mapped Registers: does `W` give read access to the register?
- Interoperability: On the availability of `std::ffi` and `std::os::raw` in `core` HOT 1
- linking failed when using own svd2rust library
- Is there a procedure required to translate the repository into another language? HOT 11
- Links to other resources HOT 2
- Tooling page is significantly outdated HOT 4
- Very bad advice - off putting - in 10.2: A little Rust with your C HOT 3
- Bad example to show indices begin at 0
- After tool setup, Openocd quits before connecting HOT 1
- Point to the new target docs
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from book.