This is a testing site only. See the live Public Lab site here »

# (Draft, don't look) Meta-Riffle: Researching how to build Electronic Circuits with the Riffle

by pdhixenbaugh | 15 Sep 04:32

Draft -- may contain stream of consciousness -- not ready for primetime, but feel free to look at the work in progress.

### What I want to do

• gather resources for programming the riffle
• learn where resources for the riffle are located
• build a breadboard circuit that lights up an LED
• share the discovery and learning process

The Riffle-beta came with two protoboards - designed to help make use of the 14 pin-outs that the Riffle has to make circuits with. Now I'm not an electronics expert compared with other public lab posters, but I have an introductory knowledge of Ohm's law (Voltage == Current * Resistance) and basic circuit-building, so let's give it a shot. This research note hopes to document the learning process for anyone else who may go through a similar learning process.

Eventually I'd like to build some simple circuits to measure conductivity on a tabletop, to get a handle on calibration and data handling, and eventually, some hardier circuits for a long deployment. But walk before you can swim, right? So how about any circuit?

My goal: to light up an LED I found lying around, and measure the voltage at different points on the circuit.

Step zero: has anyone already done this in a research note? Looking at the search results for "Riffle" doesn't show anything exactly like this, but there are people doing similar work, like @rebeccah and the conductivity circuit. Maybe I can look at what they're doing. (In my first note, I learned how to make the riffle blink at different rates, and measure RTC temperatures by looking at sketches/codes linked to in @kinasmith and @donblair's research notes.)

The first step -- where can I find documentation on the riffle? My first stop is at the Riffle Wiki. As it stands currently, this contains links to the "Hardware and Software Development on Github." These are maintained by @donblair. While there are a whole bunch of people writing cutting edge sketches for the Riffle, these official repositories contain the tested and accepted code.

From the wiki:

# Hardware and Software Development on Github

Looking in these repositories yields some great information. The first one, "Openwaterproject"" is the umbrella containing all the repositories of information about the riffle, and it's interesting to see all the work being done with it.

Next is riffle_328. This is a great one, with an exellent readme geared toward introducing anyone to the riffle. I found two labeled pictures of the riffle's pinouts as well -- one here and one nested in a folder here. The labels "top of board" and "bottom of board" are important to get oriented. There's no full explanation about what each label means, but the important ones I recognize, like VBAT, GND, "D" (digital pins) "A" (analog pins), SCL & SDA (for I2C-type sensors) and 3V3 (provides regulated 3.3 V at some low current. What the current is, I don't know, but I've seen @bhickman boost the current using op-amps in his circuits.) I am sure that as I get more knowledgeable about the Riffle's uses, I'll learn more about the other specialized uses for the pinouts on the left side.

I also like this picture (taken from the thermsistor repository) as it shows more graphically the pinouts with respect to the orientation of the top and bottom of the board. (Can the photo be automatically resized with the upload photo tool? I'll try again - it was having trouble uploading.)

Moving on! How does one with no prior arduino experience use these pinouts? And are the pinouts labeled the right way?

The first 30 protoboards sent out have the 2x7 pinouts labeled in the wrong order. The labeling will be fixed in the next run, but in the meantime, go by the pictures online (or just mentally swap the columns).

NEXT! How to write sketches to make use of the pinouts, and where to find that information? (HINT: I asked Don, and he hinted to look at the sketches in the 'low power' repository...) --To Be Continuted

(Also -- I don't know how to use an LED without burning it out -- but maybe this will help: https://learn.sparkfun.com/tutorials/light-emitting-diodes-leds)

### Questions and next steps

• Somewhere early on, I stumbled upon the riffle wiki, but now when I search "riffle", it doesn't come up. I don't remember where I first found it. I think the wiki should be pretty easy to find especially if there's information on it that will help people get started.

### Why I'm interested

I love that you've posted this before it's "done"! I think we need to think of more ways to encourage people to do this in order to solicit input, get ideas out there, etc.

I had even proposed to @liz that we mark /all/ new posts as publicly visibledrafts until (as a second step) you "publish" or "mark as complete" -- anyhow great to see, thanks!

Reply to this comment...

This collecting of the Riffle documentation is much needed, thanks for giving it a shot! i'm interested in @warren and @liz's thoughts on this info going in the wiki directly at /open-water or /riffle.

@Donblair's intention is to have the instructions versioned with supporting hardware, software, and libraries on the github repository. how much of that info belongs on activity pages, or should the activity pages link to the repository info?

Is this a question? Click here to post it to the Questions page.

Reply to this comment...

I think that for /wiki/riffle and /wiki/open-water, we should try for as much as we can appearing as activities, listed in the grids, as well as in questions, listed in a FAQ. Links to design files in Github sound fine, though -- but they might primarily have a home within an activity's "Materials" section (even if they're also listed in a convenient place on a kit-specific page like on the Desktop Spectrometry Starter Kit page

But I also like the early-draft approach Patrick's taking here! I've been prototyping an idea for including a FAQ entry at the end of each post in the #evidence-project blog series: https://publiclab.org/notes/warren/08-18-2016/introducing-the-environmental-evidence-project-a-blog-series-from-public-lab#Questions

Reply to this comment...