Unofficial Guide To Expanding Your Numworks
This is a community driven manual for customizing and developing the newly released Numworks calculator. As such we encourage you to contribute if with corrections, clean up, or even whole new chapters explaining part of the Epsilon OS or the Numworks hardware. Also feel free to post questions or suggestions on the discussion page for each chapter if you have questions or suggestions, but aren't ready to edit directly.
To readers new to Wikibooks
[edit | edit source]There is no “Errata” document published for this book. This book is an evolving work, and any errors are likely to be fixed when pointed out or otherwise found. If there is a possible error to investigate, use the discussion link at the top of the page with questionable information so that it can be investigated. If any information in this book contradicts official documentation or specifications, the reader may make the assumption that the official documentation is correct, unless there is documented, verifiable proof to the contrary.
Structure of This Book
[edit | edit source]This book is setup expecting you to jump to the sections you want to understand. The chapters are roughly organized to guide you from setting up a development environment to deep understanding of the platform, but no effort has yet been made to ensure and front-to-back reading is seamless.
Programming Examples
[edit | edit source]It should go without saying that programming examples included with this book are released under the GNU Free Documentation License. Each example is intended to stand independently to demonstrate the immediate concept at hand, and examples should be heavily commented (more than “usual” code) to illustrate the how and why things are done.
Examples should also be tested, and cleanly work when copied and pasted for use. No warnings should be emitted, and examples should be kept up-to-date with current best practices and stadards, when possible. Any depreciated code should be clearly marked as such, when demonstrating historical methods.
Prior Experience
[edit | edit source]The reader is assumed to have prior experience programming in the C/C++ language on embedded ARM systems, but no prior experience with the Numworks platform is required. However, we are exploring and developing a new platform, so instead of complaining about gaps, please ask constructive questions in the talk page and contribute what you learn. The official forum for the Numworks platform is over on the subreddit /r/Numworks if you want to ask questions or share your triumphs.