So, after over a year of learning, development, implementation and testing, I am very near the point where my Raspberry Pi Perl software is ready for prime-time use by the masses. After a few more tweaks, test additions, documentation updates and one last once-over, I plan on writing a "Howto Pi with Perl" type tutorial, across several articles in a series.
Trying to put together some sort of sane format, I'm looking to those who have publishing experience or technical writers to give my initial thoughts a once-over and provide me any feedback. Most, if not all portions will include breadboard diagrams of each task, code (of course), pictures if reasonable and in some cases potentially even video clips.
Initial, broad-view structure:
- very brief intro to the Pi, its capabilities, and overview of the features/limitations of the software
- a synopsis of what will be being taught, formats/conventions that will be used
- basic intro on creating and using a Pi object
- intro to the most basic part of the Pi, the GPIO
- examples of creating and using a GPIO pin at the most basic level (INPUT, OUTPUT, HIGH and LOW etc)
- intro and examples using advanced pin features (interrupts, PWM, pull up/down etc)
- workshop: using simple pin-based sensors and devices (LEDs, hygrometers, thermo-resistors, distance sensors etc)
- detailed overview of the communication mechanisms included (I2C, Serial, SPI etc)
- workshop: detailed overview of using the comms, starting very basic, leading into writing your own device/sensor modules using the software
- workshop: using an LCD and/or OLED screen to display things on it
- workshop: intro to and using Analog to Digital converters
- workshop: intro to and using Digital to Analog converters
- workshop: intro to and using Digital Potentiometers
- workshop: intro to and using shift registers (basic through to advanced usage)
- workshop: using a GPS module
- workshop: advanced uses: utilizing several ICs and sensors in much larger and more involved projects (probably put together a few of these)
- workshop: connecting to and using features of an Arduino with the Pi (over varying communication methods, including example Arduino sketches)
- how this software came about, and some basic information on the underlying parts that allow it to work
- extensive article on how I ensure the code is fully tested after each commit on a custom hardware test platform
- possibly some details/photos on some of my real life projects I use at home (my indoor grow room automation system for example)
- possibly a demo example of writing a web UI with jQuery to automate and provide a GUI of a basic project
update: I think I'm going to use this as my initial template, so I may periodically update it with feedback and new ideas.../update
For each element that contains a specific topic, include, where feasible/available a section at the bottom of the doc for advanced users perhaps in <small> or equivalent tags (these are just thoughts, nothing firm):
- link to datasheet
- list of issues or possible enhancements
- link to relevant section in the Pi datasheet
- link to the specific module that houses the code
- link to a C/C++ example
- link to Python equivalent
Any thoughts on this general first thoughts layout? Anything that I should include that's not already? Anything I should remove? How about any thoughts on the individual elements and the manner in which to present them?
I think I will create the actual demonstration parts first, then weave in the commentary thereafter. At first thought, this seems like the simplest approach that'll allow me to review all of the actual working parts as I go back through and edit in commentary.
Thanks,
-stevieb
-
Are you posting in the right place? Check out Where do I post X? to know for sure.
-
Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
<code> <a> <b> <big>
<blockquote> <br /> <dd>
<dl> <dt> <em> <font>
<h1> <h2> <h3> <h4>
<h5> <h6> <hr /> <i>
<li> <nbsp> <ol> <p>
<small> <strike> <strong>
<sub> <sup> <table>
<td> <th> <tr> <tt>
<u> <ul>
-
Snippets of code should be wrapped in
<code> tags not
<pre> tags. In fact, <pre>
tags should generally be avoided. If they must
be used, extreme care should be
taken to ensure that their contents do not
have long lines (<70 chars), in order to prevent
horizontal scrolling (and possible janitor
intervention).
-
Want more info? How to link
or How to display code and escape characters
are good places to start.