BOUNTY: Create Mini-tutorials for Starter and Ultimate Kits

Skills Required: Basic Fritzing/Image Manipulation/Writing
Difficulty: Easy

Challenges/Thoughts:

Use the Oak Fritzing part (to get it see #38) to put together a simple Fritzing connection graphic of a basic lesson that can be done with the Starter or Ultimate kit.

Provide text for this lesson, including how to do it, what it teaches, and what the components involved are and very briefly how they work/what they do (ex: An LED produces light when powered)

Provide example code for the user to run on their Oak, keeping it simple and well commented.

Provide the image (with a 300+ dpi version linked), text, and example code as a wiki entry at digistump.com/wiki/oak/tutorials (if you are the first make a new list on that page for links to these lessons)

Formatting and general layout should at least roughly follow this template:
Template: http://digistump.com/wiki/oak/tutorials/lesson_template

Parts List: http://digistump.com/wiki/oak/tutorials/kit_parts
Lesson Ideas (other welcome!): http://digistump.com/wiki/oak (list at bottom of page)

Please add your name or however you'd like to be credited to your wiki page.

Bounty

$25 credit or 2 Oaks per lesson, one person can do as many as they would like.

Cash or credit is your choice. Cash to be paid via Paypal. Credit has no expiration but can only be applied to a single order and does not cover shipping (because that is how our shopping cart works, not because we want to be limiting). Oaks reward includes shipping.

You may credit yourself in the files as well, leaving in tact existing licenses and credits.

Legal Stuff: We will choose a winner at our sole discretion. Cash awards will be made in USD. This is not an offer for hire. All work submitted becomes the property of Digistump LLC to be used at our discretion in compliance with any associated licenses. Void where prohibited by law.

[jwhendy]

Not sure it counts as a starter or ultimate tutorial per se, but just wrote a guide for connecting to the Oak via serial through an Arduino Uno. I was primarily interested since I didn't have a 3.3v UART but did have an arduino. I figured a lot of others could be in the same boat so after successfully using a chip-less Uno to apply OakRestore, I wrote it up.

Links:

• Got some helpful input and initial feedback from @DeuxVis on Possible to use Arduino Uno as a 3.3v UART? #56
• The tutorial on the wiki

[DJFliX]

I'm working on a button tutorial, explaining both digitalRead and interrupts. I have the text, but did not include the Fritzing yet, as I'm currently out of time. Sorry about that. Will be working on the rest tomorrow:

• Use the Oak Fritzing part (to get it see BOUNTY: Make Fritzing Part for Oak #38) to put together a simple Fritzing connection graphic of a basic lesson that can be done with the Starter or Ultimate kit.
• Provide text for this lesson, including how to do it, what it teaches, and what the components involved are and very briefly how they work/what they do (ex: An LED produces light when powered)
• Provide example code for the user to run on their Oak, keeping it simple and well commented.
• Provide the image (with a 300+ dpi version linked), text, and example code as a wiki entry at digistump.com/wiki/oak/tutorials (if you are the first make a new list on that page for links to these lessons)

[jwhendy]

Update 3/25: Done with all of the below; if you find anything, feel free to let me know or edit at will, and feedback is welcome!

• blink: stuck to just the on-board LED. As the very first sketch ever, gives opportunity to just verify a working environment and ability to flash a sketch to the Oak
• LED basics: demonstrates connecting an external LED and using analogWrite() instead of just digitalWrite()
• Advanced LEDs: multiple LEDs, for() loop, map(), and constrain()
• RGB led: not much to add other than taking the advanced LED tutorial and applying analogWrite() to three pins on the same LED vs. separate pins on 3 LEDs
• photoresistor
• Oak serial using arduino's USB UART
• accessing the Oak's data using Particle.variable()
• telling the Oak to do something with Particle.function()
• using python to read data with Particle.variable() and sending an email notification
• using python to send data with Particle.function() based on input from a local sensor
• super short tutorial on getting device ID and token from Particle and making sure API calls are working; don't think the format rules really apply as there's no circuit or sketch

[jwhendy]

@DJFliX Nice! If you need any help on the Fritzing, I could do the pulldown vs. float one. No pressure to accept... just throwing it out there.

Regarding the pulldown stuff, I used to do this until I found out one could do pinMode(n, INPUT_PULLUP). I use this exclusively so I don't have to use physical resistors... [old content snipped].

EDIT: Whoops. Using INPUT_PULLUP doesn't seem to work for me, so perhaps there's no internal pullups... sorry for the noise.

[jwhendy]

@DJFliX Had to make some Fritzing's myself and made a floating vs. pulldown button example for you. Your choice to keep or re-do. Hopefully I got close to what you were looking for there.

[DJFliX]

@jwhendy Thank you very much! I don't have any experience in Fritzing at all, just got to creating an image of the set up. Thanks a lot for adding the pullup/pulldown images! The internal pullup/pulldown functionality would be awesome, but because this is a breadboard/tinkering type of lesson I thought it would be better to explain the pullup/down mechanism with physical parts first. It's a "hello button" exercise after all :).

Also: after viewing your images on the buttons lesson, I realised that the female Oak is much more sensible to use in the example. Going to redo my fritzing now :P

[DJFliX]

RE: http://digistump.com/wiki/oak/tutorials/button
@digistump Erik, I've made some changes in the text and uploaded both instructions to build the circuit and the Fritzing image of the circuit. @jwhendy kindly provided examples of a pull-down and a direct connection of a button to the Oak. Could you (swiftly) have a look at the page and tell me if there's anything missing, or anything you'd like me to add? I used the 150R resistors for the LED as they are the only suitable resistors in the kit, is that OK?

Also, would it be better to remove the external led and use the on-board LED instead? I wanted to show the example of blinking a LED with actual parts, but I realised later on that it might be defeating the purpose of the separate LED tutorial as well as adding extra noise to what the tutorial is actually about (reading button input).

[jwhendy]

@DJFliX: no problem at all. With just a couple of components it went fast :) Nice work, really liked your layout/format.

[exeng]

I will claim the Temperature Sensing and the 1-Wire Bus tutorial. Draft is ready. Just need to transfer to DokuWiki and do some final tests.

[exeng]

Here are the images for the Temperature Sensing tutorial.
Oak-Temp-Sensing-1-Wire.zip

@DJFliX - that is a great little tutorial and laid out perfectly, thank you! Please email us to claim the bounty. 150R is fine, using the external LED was perfect and a great way to build on the LEDs tutorial that will be before that.

@jwhendy - thanks for doing those two tutorials, they look good. Could I ask you to format them to follow the sections and formatting recommended here: http://digistump.com/wiki/oak/tutorials/lesson_template, and to also break the First Blink tutorial down into some small steps as far as the hookup, and maybe add a diagram with the LED labeled (or some other way of making it super basic)? The First Blink tutorial is really essential that it uses super super basic steps since for some it may be the first time they've ever touched a development board. The photocell diagram and gifs on both are awesome! Please email us (support at digistump dot com) whenever you are ready to claim your bounties.

@exeng - as noted (but not very clearly) in the description please upload the images directly into the wiki for these. Your tutorial is very comprehensive and has lots of great advanced detail, but it isn't very beginner friendly in its language, layout, and its lack of small steps with diagrams. I've moved it to a different section (as part of the temp shield tutorial: http://digistump.com/wiki/digispark/tutorials/temp#programming) and left the dead link for the starter kit lesson, feel free to tackle that using the same info you have put together but greatly simplified with diagrams and following the layout recommended (and you can collect the bounty for that as well).
If you'll upload the images into it I'm still happy to pay you the bounty on this of course - it really is a great advanced tutorial and most valuable to have!

@ Any one submitting a tutorial, please add your name or however you'd like to be credited to your wiki page.

[jwhendy]

@digistump Will do, and sorry about that! I saw the note on formatting initially but it just took me to the wiki syntax. Missed the template above... I'm in the process of writing a more advanced LED tutorial, want to write an intro to Particle.function(), and one on pushing something to the oak with python to complement the other one I did.

Any other feedback is welcome... I'm reasonably new to microcontrollers (maybe 2 years with an Arduino to date), so I was really shooting in the dark regarding how basic/advanced to target!

@jwhendy No problem, I apologize if the formatting expectations weren't clear.

The most basic steps are the goal of these tutorials since they are for the "Starter Kit" which we found generally sold to people with zero or nearly zero electronics experience (with some exceptions of course)