Created to test out formatting for the riffle documentation on google drive (access it via the pl...
Public Lab is an open community which collaboratively develops accessible, open source, Do-It-Yourself technologies for investigating local environmental health and justice issues.
| 4 CURRENT | pdhixenbaugh |
May 22, 2016 18:35
| over 8 years ago
Created to test out formatting for the riffle documentation on google drive (access it via the plots-waterquality) for Formatting testing purposes only. Any changes made here should be merged upstream by the authors of the change, or it will not be kept. :) ~~~ What capitalization scheme should we stick to? “Sandbox” for testing formatting: https://publiclab.org/wiki/edit/sandbox-riffle Direct link to the google document: https://docs.google.com/document/d/1GTvRDV9Nq2zN6RFu4cQ-sCIWIaHGoIJzElE1nrMCmr4/edit?usp=sharing Getting started with the RIFFLE dataloggerThe RIFFLE is a datalogger that records water quality data, such as temperature, conductivity, and turbidity, from sensor boards that attach to it. The Riffle runs Arduino code, and is small enough to fit inside the mouth of a standard plastic water bottle for a low-cost, waterproof field deployment. For examples of what the Riffle can do, visit https://publiclab.org/tag/riffle What? This document contains step-by-step instructions for Getting Started with the Riffle. For Whom? This guide was created for people who have no prior experience with microelectronics to begin working with bits of circuitry related to water sensing Why? To provide a clear step-by-step process for setting up a Riffle datalogger When? With a Riffle and a computer, following this guide should take about an afternoon. So That… People with concerns about water quality can engage with the technical development process for creating sensors. What For? After going through this guide, you / your group will have…
Table of Contents
OverviewWelcome to Remote Independent Friendly Field-Logger Electronics, or RIFFLE, an open source datalogging system. The Riffle (version 0.1.8):
Receiving the RiffleCheck that you received all the Riffle pieces in your shipment:
Setting up the Arduino IDEThe RIFFLE can be programmed in the Arduino IDE (“integrated development environment”) as an "Arduino UNO" board. To get started working with the RIFFLE, * Install the Driver, so the computer and RIFFLE can communicate * Perform the Blink Test, to check that the RIFFLE is working * Install the Arduino IDE and work through Arduino tutorials “X” and “Y” - become familiar with the Arduino “sketches” used to program the RIFFLE * Start Basic Datalogging * Connect other Sensors Installing the DriverFYI this step involves your computer only, no Riffle needed just yet. Because the RIFFLE uses a slightly different USB ←→ Serial converter from the traditional Arduino, we need to install a special driver on our computer. Step by Step:
Blink TestFYI this step happens with your RIFFLE connected to a some kind of power source. The purpose of this step is to test if the program that’s already loaded onto your RIFFLE is working. The Riffle was pre-programmed by the factory to blink its onboard LED every second to indicate that the board is working. To test, we just need to apply power to the RIFFLE and watch for the blinking light. Required hardware
Required software
ProcedureUsing the blue battery:
When the Riffle blinks, it means the firmware has been loaded properly. If your Riffle is not blinking, check the connection of your power supply. If still not blinking, proceed to trying other power supply options as described below. Using USB cable Use a USB--MicroUSB cable (like for an android phone) to connect the RIFFLE to a computer or to an AC outlet. The switch position doesn’t matter for this option, so it should start blinking right away. Install the Arduino IDE and librariesRequired hardware
Required software
Some libraries Additionally, you'll need to install the following libraries in a 'libraries' folder within your Arduino IDE sketchbook folder: LINK TO HOW-TO for INSTALLING LIBRARIES BY OS **Libraries Needed - Low Power - DS3232RTC - Streaming - Time Restart the Arduino application after installing libraries. Arduino Tutorials(need more/different explanation or framing here) If you are just getting started with Arduino, the Arduino foundation has several tutorials designed to help people become familiar with writing and modifying Sketches (programs). You can find many at the Arduino home page. Get familiar with “Tutorial X” and Tutorial “Y”, and then head on to the datalogging section. Basic dataloggingThe Riffle is designed to log data, so let’s get started. ProcedureSetting the Real Time Clock. The goal of this activity is to set the Real Time Clock (RTC) so that it will assign accurate timestamps to the measurements we record with the Riffle. The Arduino code in set_rtc.ino is an Arduino sketch that allows one to set the time manually. The Riffle will remember the time you set for as long as the Real Time Clock battery lasts (typically, a year or more).
Where:
For example, if it was March 15th 2016 at 3:44pm, the input would look like:
Hit 'enter' after you are done SUCCESS means you will see that the date will have changed in the Serial Monitor. Basic datalogging Now that the time is set, we're ready to set up the Riffle for basic datalogging. The code in riffle_logger_test -accesible here: https://github.com/OpenWaterProject/riffle-getting-started/blob/master/riffle_basic_logging.ino is an Arduino sketch that will repeatedly log data to the SD card, and then sleep for N seconds in between. N can be set to any multiple of 8 seconds; it comes set to N=1, so that the Riffle will log every 8 seconds. The format of the output is:
The code defaults to saving data to a file called 'Datalog1.csv' on the SD card.
The Riffle should initially blink a few times at a rate of once per second, which is the original software working (see Blink Test step). If everything goes well (the SD card can be accessed, etc), the Riffle should then blink every 8 seconds, which indicates that data has been recorded. Take out the SD card and download the file onto your computer, see the CSV file….etc…. SUCCESS!!! The SD card will contain a CSV (Comma-Separated Values) file, which can be viewed using spreadsheet software such as LibreOffice and Google Spreadsheets. (Picture of a spreadsheet and graph, link to a live google spreadsheet?) Connecting other sensorsTo measure water quality data using the Riffle, we will need to attach some sensors. (Brief explanatory text) Temperature sensorsOne-wire temperature sensors Overview, code, and wiring diagram: http://www.hacktronics.com/Tutorials/arduino-1-wire-tutorial.html Image: https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/1-wire-hookup.png (original source: http://bildr.org/blog/wp-content/uploads/2011/06/DS18S20-hookup.png) (Replicate this, but for Riffle). Ingredients: 1-wire probe, 4.7K resistor, Riffle, protoboard / breadboard Wiring it up Code for datalogging with 1-wire probe Thermistors Overview: https://learn.adafruit.com/thermistor/overview Wiring diagram: https://learn.adafruit.com/thermistor/using-a-thermistor Image: https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/temperature_thermistor_bb.png (original: https://learn.adafruit.com/thermistor/using-a-thermistor) (Replicate, but for Riffle) Ingredients: 10K thermistor, 10K resistor, Riffle, protoboard / breadboard Wiring it up Code for datalogging with thermistor Image of riffle with thermistor as described. Not sure where to connect things though Light sensorsA photocell Overview: https://learn.adafruit.com/photocells/overview Wiring diagram: https://learn.adafruit.com/photocells/using-a-photocell Images: https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/light_cdspulldowndiag.gif https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/light_cdsanasch.gif (Same sort of diagram, but with Riffle) Ingredients: “10K” photocell, 10K resistor, Riffle, protoboard / breadboard Wiring it up Code for datalogging with light cell Charging the BatteryThe Riffle has a built-in lithium battery charger, so if the lithium battery is plugged into the 'lithium' plug and the Riffle is connected to USB power, it should be charging. There is currently no charging indicator or indicator light routine on the board. The battery is 2200 mAh at 3.7 V, and a USB port is 500 mA at 5 V, so four hours should guarantee a full charge. Next StepsField deployment: a Riffle in a bottle
Setup a Github Account
|
Revert | |
| 3 | pdhixenbaugh |
May 07, 2016 08:08
| over 8 years ago
Created to test out formatting for the riffle documentation on google drive (access it via the plots-waterquality) for Formatting testing purposes only. Any changes made here should be merged upstream by the authors of the change, or it will not be kept. :) ~~~ Getting started with the RIFFLE dataloggerIntroductionThe RIFFLE is a datalogger that records water quality data, such as temperature, conductivity, and turbidity, from sensor boards that attach to it. The Riffle runs Arduino code, and is small enough to fit inside the mouth of a standard plastic water bottle for a low-cost, waterproof field deployment. For examples of what the Riffle can do, visit https://publiclab.org/tag/riffle First-time SetupNo prior experience with Arduino or electronics is necessary. With a Riffle, a computer, and an afternoon, you/your group can
(Guiding ideas for editors)What? What capitalization scheme should we stick to? “Sandbox” for testing formatting: https://publiclab.org/wiki/edit/sandbox-riffle For Whom? This guide was created for people who have no prior experience with microelectronics to begin working with bits of circuitry related to water sensing Why? To provide a clear step-by-step process for setting up a Riffle datalogger When? With a Riffle and a computer, following this guide should take about an afternoon. So That… People with concerns about water quality can engage with the technical development process for creating sensors. What For? After going through this guide, you / your group will have… (connected your first sensor and begun recording data) * To Be Continued… Table of Contents
OverviewWelcome to Remote Independent Friendly Field-Logger Electronics, or RIFFLE, an open source datalogging system. The Riffle (version 0.1.8):
Receiving the RiffleCheck that you received all the Riffle pieces in your shipment:
Setting up the Arduino IDEThe RIFFLE can be programmed in the Arduino IDE (“integrated development environment”) as an "Arduino UNO" board. To get started working with the RIFFLE, * Install the Driver, so the computer and RIFFLE can communicate * Perform the Blink Test, to check that the RIFFLE is working * Install the Arduino IDE and work through Arduino tutorials “X” and “Y” - become familiar with the Arduino “sketches” used to program the RIFFLE * Start Basic Datalogging * Connect other Sensors Installing the DriverFYI this step involves your computer only, no Riffle needed just yet. Because the RIFFLE uses a slightly different USB ←→ Serial converter from the traditional Arduino, we need to install a special driver on our computer. Step by Step:
Blink TestFYI this step happens with your RIFFLE connected to a some kind of power source. The purpose of this step is to test if the program that’s already loaded onto your RIFFLE is working. The Riffle was pre-programmed by the factory to blink its onboard LED every second to indicate that the board is working. To test, we just need to apply power to the RIFFLE and watch for the blinking light. Required hardware
Required software
ProcedureUsing the blue battery:
When the Riffle blinks, it means the firmware has been loaded properly. If your Riffle is not blinking, check the connection of your power supply. If still not blinking, proceed to trying other power supply options as described below. Using USB cable Use a USB--MicroUSB cable (like for an android phone) to connect the RIFFLE to a computer or to an AC outlet. The switch position doesn’t matter for this option, so it should start blinking right away. Install the Arduino IDE and librariesRequired hardware
Required software
Some libraries Additionally, you'll need to install the following libraries in a 'libraries' folder within your Arduino IDE sketchbook folder: LINK TO HOW-TO for INSTALLING LIBRARIES BY OS **Libraries Needed - Low Power - DS3232RTC - Streaming - Time Restart the Arduino application after installing libraries. Arduino Tutorials(need more/different explanation or framing here) If you are just getting started with Arduino, the Arduino foundation has several tutorials designed to help people become familiar with writing and modifying Sketches (programs). You can find many at the Arduino home page. Get familiar with “Tutorial X” and Tutorial “Y”, and then head on to the datalogging section. Basic dataloggingThe Riffle is designed to log data, so let’s get started. ProcedureSetting the Real Time Clock. The goal of this activity is to set the Real Time Clock (RTC) so that it will assign accurate timestamps to the measurements we record with the Riffle. The Arduino code in set_rtc.ino is an Arduino sketch that allows one to set the time manually. The Riffle will remember the time you set for as long as the Real Time Clock battery lasts (typically, a year or more).
Where:
For example, if it was March 15th 2016 at 3:44pm, the input would look like:
Hit 'enter' after you are done SUCCESS means you will see that the date will have changed in the Serial Monitor. Basic datalogging Now that the time is set, we're ready to set up the Riffle for basic datalogging. The code in riffle_logger_test is an Arduino sketch that will repeatedly log data to the SD card, and then sleep for N seconds in between. N can be set to any multiple of 8 seconds; it comes set to N=1, so that the Riffle will log every 8 seconds. The format of the output is:
The code defaults to saving data to a file called 'Datalog1.csv' on the SD card.
The Riffle should initially blink a few times at a rate of once per second, which is the original software working (see Blink Test step). If everything goes well (the SD card can be accessed, etc), the Riffle should then blink every 8 seconds, which indicates that data has been recorded. Take out the SD card and download the file onto your computer, see the CSV file….etc…. SUCCESS!!! The SD card will contain a CSV (Comma-Separated Values) file, which can be viewed using spreadsheet software such as LibreOffice and Google Spreadsheets. (Picture of a spreadsheet and graph, link to a live google spreadsheet?) Connecting other sensorsTo measure water quality data using the Riffle, we will need to attach some sensors. (Brief explanatory text) Temperature sensorsOne-wire temperature sensors Overview, code, and wiring diagram: http://www.hacktronics.com/Tutorials/arduino-1-wire-tutorial.html Image: https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/1-wire-hookup.png (original source: http://bildr.org/blog/wp-content/uploads/2011/06/DS18S20-hookup.png) (Replicate this, but for Riffle). Ingredients: 1-wire probe, 4.7K resistor, Riffle, protoboard / breadboard Wiring it up Code for datalogging with 1-wire probe Thermistors Overview: https://learn.adafruit.com/thermistor/overview Wiring diagram: https://learn.adafruit.com/thermistor/using-a-thermistor Image: https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/temperature_thermistor_bb.png (original: https://learn.adafruit.com/thermistor/using-a-thermistor) (Replicate, but for Riffle) Ingredients: 10K thermistor, 10K resistor, Riffle, protoboard / breadboard Wiring it up Code for datalogging with thermistor Light sensorsA photocell Overview: https://learn.adafruit.com/photocells/overview Wiring diagram: https://learn.adafruit.com/photocells/using-a-photocell Images: https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/light_cdspulldowndiag.gif https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/light_cdsanasch.gif (Same sort of diagram, but with Riffle) Ingredients: “10K” photocell, 10K resistor, Riffle, protoboard / breadboard Wiring it up Code for datalogging with light cell Next StepsField deployment: a Riffle in a bottle
Setup a Github Account
|
Revert | |
| 2 | pdhixenbaugh |
May 07, 2016 08:01
| over 8 years ago
Created to test out formatting for the riffle documentation on google drive (access it via the plots-waterquality) for Formatting testing purposes only. Any changes made here should be merged upstream by the authors of the change, or it will not be kept. :) ~~~ Getting started with the RIFFLE dataloggerIntroductionThe RIFFLE is a datalogger that records water quality data, such as temperature, conductivity, and turbidity, from sensor boards that attach to it. The Riffle runs Arduino code, and is small enough to fit inside the mouth of a standard plastic water bottle for a low-cost, waterproof field deployment. For examples of what the Riffle can do, visit https://publiclab.org/tag/riffle First-time SetupNo prior experience with Arduino or electronics is necessary. With a Riffle, a computer, and an afternoon, you/your group can
(Guiding ideas for editors)What? What capitalization scheme should we stick to? “Sandbox” for testing formatting: https://publiclab.org/wiki/edit/sandbox-riffle For Whom? This guide was created for people who have no prior experience with microelectronics to begin working with bits of circuitry related to water sensing Why? To provide a clear step-by-step process for setting up a Riffle datalogger When? With a Riffle and a computer, following this guide should take about an afternoon. So That… People with concerns about water quality can engage with the technical development process for creating sensors. What For? After going through this guide, you / your group will have… (connected your first sensor and begun recording data) * To Be Continued… Table of Contents
OverviewWelcome to Remote Independent Friendly Field-Logger Electronics, or RIFFLE, an open source datalogging system. The Riffle (version 0.1.8):
Receiving the RiffleCheck that you received all the Riffle pieces in your shipment:
Setting up the Arduino IDEThe RIFFLE can be programmed in the Arduino IDE (“integrated development environment”) as an "Arduino UNO" board. To get started working with the RIFFLE, * Install the Driver, so the computer and RIFFLE can communicate * Perform the Blink Test, to check that the RIFFLE is working * Install the Arduino IDE and work through Arduino tutorials “X” and “Y” - become familiar with the Arduino “sketches” used to program the RIFFLE * Start Basic Datalogging * Connect other Sensors Installing the DriverFYI this step involves your computer only, no Riffle needed just yet. Because the RIFFLE uses a slightly different USB ←→ Serial converter from the traditional Arduino, we need to install a special driver on our computer. Step by Step:
Blink TestFYI this step happens with your RIFFLE connected to a some kind of power source. The purpose of this step is to test if the program that’s already loaded onto your RIFFLE is working. The Riffle was pre-programmed by the factory to blink its onboard LED every second to indicate that the board is working. To test, we just need to apply power to the RIFFLE and watch for the blinking light. Required hardware
Required software
ProcedureUsing the blue battery:
When the Riffle blinks, it means the firmware has been loaded properly. If your Riffle is not blinking, check the connection of your power supply. If still not blinking, proceed to trying other power supply options as described below. Using USB cable Use a USB--MicroUSB cable (like for an android phone) to connect the RIFFLE to a computer or to an AC outlet. The switch position doesn’t matter for this option, so it should start blinking right away. Install the Arduino IDE and librariesRequired hardware
Required software
Some libraries Additionally, you'll need to install the following libraries in a 'libraries' folder within your Arduino IDE sketchbook folder: LINK TO HOW-TO for INSTALLING LIBRARIES BY OS **Libraries Needed - Low Power - DS3232RTC - Streaming - Time Restart the Arduino application after installing libraries. Arduino Tutorials(need more/different explanation or framing here) If you are just getting started with Arduino, the Arduino foundation has several tutorials designed to help people become familiar with writing and modifying Sketches. You can find many at the Arduino home page Get familiar with “Tutorial X” and Tutorial “Y”, and then head on to the datalogging section. Basic dataloggingProcedureSetting the Real Time Clock. The goal of this activity is to set the Real Time Clock (RTC) so that it will assign accurate timestamps to the measurements we record with the Riffle. The Arduino code in set_rtc.ino is an Arduino sketch that allows one to set the time manually. The Riffle will remember the time you set for as long as the Real Time Clock battery lasts (typically, a year or more).
Where:
For example, if it was March 15th 2016 at 3:44pm, the input would look like:
Hit 'enter' after you are done SUCCESS means you will see that the date will have changed in the Serial Monitor. Basic datalogging Now that the time is set, we're ready to set up the Riffle for basic datalogging. The code in riffle_logger_test is an Arduino sketch that will repeatedly log data to the SD card, and then sleep for N seconds in between. N can be set to any multiple of 8 seconds; it comes set to N=1, so that the Riffle will log every 8 seconds. The format of the output is:
The code defaults to saving data to a file called 'Datalog1.csv' on the SD card.
The Riffle should initially blink a few times at a rate of once per second, which is the original software working (see Blink Test step). If everything goes well (the SD card can be accessed, etc), the Riffle should then blink every 8 seconds, which indicates that data has been recorded. Take out the SD card and download the file onto your computer, see the CSV file….etc…. SUCCESS!!! The SD card will contain a CSV (Comma-Separated Values) file, which can be viewed using spreadsheet software such as LibreOffice and Google Spreadsheets. (Picture of a spreadsheet and graph, link to a live google spreadsheet?) Connecting other sensorsTo measure water quality data using the Riffle, we will need to attach some sensors. (Brief explanatory text) Temperature sensorsOne-wire temperature sensors Overview, code, and wiring diagram: http://www.hacktronics.com/Tutorials/arduino-1-wire-tutorial.html Image: https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/1-wire-hookup.png (original source: http://bildr.org/blog/wp-content/uploads/2011/06/DS18S20-hookup.png) (Replicate this, but for Riffle). Ingredients: 1-wire probe, 4.7K resistor, Riffle, protoboard / breadboard Wiring it up Code for datalogging with 1-wire probe Thermistors Overview: https://learn.adafruit.com/thermistor/overview Wiring diagram: https://learn.adafruit.com/thermistor/using-a-thermistor Image: https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/temperature_thermistor_bb.png (original: https://learn.adafruit.com/thermistor/using-a-thermistor) (Replicate, but for Riffle) Ingredients: 10K thermistor, 10K resistor, Riffle, protoboard / breadboard Wiring it up Code for datalogging with thermistor Light sensorsA photocell Overview: https://learn.adafruit.com/photocells/overview Wiring diagram: https://learn.adafruit.com/photocells/using-a-photocell Images: https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/light_cdspulldowndiag.gif https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/light_cdsanasch.gif (Same sort of diagram, but with Riffle) Ingredients: “10K” photocell, 10K resistor, Riffle, protoboard / breadboard Wiring it up Code for datalogging with light cell Next StepsField deployment: a Riffle in a bottle
Setup a Github Account
|
Revert | |
| 1 | pdhixenbaugh |
May 07, 2016 08:00
| over 8 years ago
Created to test out formatting for the riffle documentation on google drive (access it via the plots-waterquality) for Formatting testing purposes only. Any changes made here should be merged upstream by the authors of the change, or it will not be kept. :) ~~~ Getting started with the RIFFLEIntroductionThe RIFFLE is a datalogger that records water quality data, such as temperature, conductivity, and turbidity, from sensor boards that attach to it. The Riffle runs Arduino code, and is small enough to fit inside the mouth of a standard plastic water bottle for a low-cost, waterproof field deployment. For examples of what the Riffle can do, visit https://publiclab.org/tag/riffle First-time SetupNo prior experience with Arduino or electronics is necessary. With a Riffle, a computer, and an afternoon, you/your group can
(Guiding ideas for editors)What? First things first, what capitalization should we stick to? I'm a fan of first letter capitalized ("Riffle") in standard use, and "RIFFLE" when needed for emphasis or introduction For Whom? This guide was created for people who have no prior experience with microelectronics to begin working with bits of circuitry related to water sensing Why? To provide a clear step-by-step process for setting up a Riffle datalogger When? With a Riffle and a computer, following this guide should take about an afternoon. So That… People with concerns about water quality can engage with the technical development process for creating sensors. What For? After going through this guide, you / your group will have… (connected your first sensor and begun recording data) * To Be Continued… Table of Contents
OverviewWelcome to Remote Independent Friendly Field-Logger Electronics, or RIFFLE, an open source datalogging system. The Riffle (version 0.1.8):
Receiving the RiffleCheck that you received all the Riffle pieces in your shipment:
Installing the DriverFYI this step involves your computer only, no Riffle needed just yet. Because the RIFFLE uses a slightly different USB ←→ Serial converter from the traditional Arduino, we need to install a special driver on our computer. Step by Step:
Blink TestFYI this step happens with your RIFFLE connected to a some kind of power source. The purpose of this step is to test if the program that’s already loaded onto your RIFFLE is working. The Riffle was pre-programmed by the factory to blink its onboard LED every second to indicate that the board is working. To test, we just need to apply power to the RIFFLE and watch for the blinking light. Required hardware
Required software
ProcedureUsing the blue battery:
When the Riffle blinks, it means the firmware has been loaded properly. If your Riffle is not blinking, check the connection of your power supply. If still not blinking, proceed to trying other power supply options as described below. Using USB cable Use a USB--MicroUSB cable (like for an android phone) to connect the RIFFLE to a computer or to an AC outlet. The switch position doesn’t matter for this option, so it should start blinking right away. Arduino Tutorials(need more/different explanation or framing here) The RIFFLE can be programmed in the Arduino IDE (“integrated development environment”) as an "Arduino UNO" board. Basic dataloggingRequired hardware
Required software
If you are just getting started with Arduino, the Arduino foundation has several tutorials designed to help people become familiar with writing and modifying Sketches. You can find many at the Arduino home page Some libraries Additionally, you'll need to install the following libraries in a 'libraries' folder within your Arduino IDE sketchbook folder: LINK TO INSTALLING LIBRARIES BY OS - Low Power - DS3232RTC - Streaming - Time Restart the Arduino application after installing libraries. ProcedureSetting the Real Time Clock. The goal of this activity is to set the Real Time Clock (RTC) so that it will assign accurate timestamps to the measurements we record with the Riffle. The Arduino code in set_rtc.ino is an Arduino sketch that allows one to set the time manually. The Riffle will remember the time you set for as long as the Real Time Clock battery lasts (typically, a year or more).
Where:
For example, if it was March 15th 2016 at 3:44pm, the input would look like:
Hit 'enter' after you are done SUCCESS means you will see that the date will have changed in the Serial Monitor. Basic datalogging Now that the time is set, we're ready to set up the Riffle for basic datalogging. The code in riffle_logger_test is an Arduino sketch that will repeatedly log data to the SD card, and then sleep for N seconds in between. N can be set to any multiple of 8 seconds; it comes set to N=1, so that the Riffle will log every 8 seconds. The format of the output is:
The code defaults to saving data to a file called 'Datalog1.csv' on the SD card.
The Riffle should initially blink a few times at a rate of once per second, which is the original software working (see Blink Test step). If everything goes well (the SD card can be accessed, etc), the Riffle should then blink every 8 seconds, which indicates that data has been recorded. Take out the SD card and download the file onto your computer, see the CSV file….etc…. SUCCESS!!! Connecting other sensorsBrief explanatory text Temperature sensorsOne-wire temperature sensors Overview, code, and wiring diagram: http://www.hacktronics.com/Tutorials/arduino-1-wire-tutorial.html Image: https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/1-wire-hookup.png (original source: http://bildr.org/blog/wp-content/uploads/2011/06/DS18S20-hookup.png) (Replicate this, but for Riffle). Ingredients: 1-wire probe, 4.7K resistor, Riffle, protoboard / breadboard Wiring it up Code for datalogging with 1-wire probe Thermistors Overview: https://learn.adafruit.com/thermistor/overview Wiring diagram: https://learn.adafruit.com/thermistor/using-a-thermistor Image: https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/temperature_thermistor_bb.png (original: https://learn.adafruit.com/thermistor/using-a-thermistor) (Replicate, but for Riffle) Ingredients: 10K thermistor, 10K resistor, Riffle, protoboard / breadboard Wiring it up Code for datalogging with thermistor Light sensorsA photocell Overview: https://learn.adafruit.com/photocells/overview Wiring diagram: https://learn.adafruit.com/photocells/using-a-photocell Images: https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/light_cdspulldowndiag.gif https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/light_cdsanasch.gif (Same sort of diagram, but with Riffle) Ingredients: “10K” photocell, 10K resistor, Riffle, protoboard / breadboard Wiring it up Code for datalogging with light cell Field deployment: a Riffle in a bottle
Setup a Github Account
|
Revert | |
| 0 | pdhixenbaugh |
May 07, 2016 05:59
| over 8 years ago
Created to test out formatting for the riffle documentation on google drive (access it via the plots-waterquality) for Formatting testing purposes only. Any changes made here should be merged upstream by the authors of the change, or it will not be kept. :) ~~~ Getting started with the RIFFLE dataloggerFor Whom? This guide was created for people who have no prior experience with microelectronics to begin working with bits of circuitry related to water sensing Why? To provide a clear step-by-step process for setting up a Riffle datalogger When? With a Riffle and a computer, following this guide should take about an afternoon. So That… People with concerns about water quality can engage with the technical development process for creating sensors. What For? After going through this guide, you / your group will have…
Table of Contents
OverviewWelcome to Remote Independent Friendly Field-Logger Electronics, or RIFFLE, an open source datalogging system. The Riffle (version 0.1.8):
Receiving the RiffleCheck that you received all the Riffle pieces in your shipment:
Installing the DriverFYI this step involves your computer only, no Riffle needed just yet. Because the RIFFLE uses a slightly different USB ←→ Serial converter from the traditional Arduino, we need to install a special driver on our computer. Step by Step:
Blink TestFYI this step happens with your RIFFLE connected to a some kind of power source. The purpose of this step is to test if the program that’s already loaded onto your RIFFLE is working. The Riffle was pre-programmed by the factory to blink its onboard LED every second to indicate that the board is working. To test, we just need to apply power to the RIFFLE and watch for the blinking light. Required hardware
Required software
ProcedureUsing the blue battery:
When the Riffle blinks, it means the firmware has been loaded properly. If your Riffle is not blinking, check the connection of your power supply. If still not blinking, proceed to trying other power supply options as described below. Using USB cable Use a USB--MicroUSB cable (like for an android phone) to connect the RIFFLE to a computer or to an AC outlet. The switch position doesn’t matter for this option, so it should start blinking right away. Arduino Tutorials(need more/different explanation or framing here) The RIFFLE can be programmed in the Arduino IDE (“integrated development environment”) as an "Arduino UNO" board. Basic dataloggingRequired hardware
Required software
If you are just getting started with Arduino, the Arduino foundation has several tutorials designed to help people become familiar with writing and modifying Sketches. You can find many at the Arduino home page Some libraries Additionally, you'll need to install the following libraries in a 'libraries' folder within your Arduino IDE sketchbook folder: LINK TO INSTALLING LIBRARIES BY OS - Low Power - DS3232RTC - Streaming - Time Restart the Arduino application after installing libraries. ProcedureSetting the Real Time Clock. The goal of this activity is to set the Real Time Clock (RTC) so that it will assign accurate timestamps to the measurements we record with the Riffle. The Arduino code in set_rtc.ino is an Arduino sketch that allows one to set the time manually. The Riffle will remember the time you set for as long as the Real Time Clock battery lasts (typically, a year or more).
Where:
For example, if it was March 15th 2016 at 3:44pm, the input would look like:
Hit 'enter' after you are done SUCCESS means you will see that the date will have changed in the Serial Monitor. Basic datalogging Now that the time is set, we're ready to set up the Riffle for basic datalogging. The code in riffle_logger_test is an Arduino sketch that will repeatedly log data to the SD card, and then sleep for N seconds in between. N can be set to any multiple of 8 seconds; it comes set to N=1, so that the Riffle will log every 8 seconds. The format of the output is:
The code defaults to saving data to a file called 'Datalog1.csv' on the SD card.
The Riffle should initially blink a few times at a rate of once per second, which is the original software working (see Blink Test step). If everything goes well (the SD card can be accessed, etc), the Riffle should then blink every 8 seconds, which indicates that data has been recorded. Take out the SD card and download the file onto your computer, see the CSV file….etc…. SUCCESS!!! Connecting other sensorsBrief explanatory text Temperature sensorsOne-wire temperature sensors Overview, code, and wiring diagram: http://www.hacktronics.com/Tutorials/arduino-1-wire-tutorial.html Image: https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/1-wire-hookup.png (original source: http://bildr.org/blog/wp-content/uploads/2011/06/DS18S20-hookup.png) (Replicate this, but for Riffle). Ingredients: 1-wire probe, 4.7K resistor, Riffle, protoboard / breadboard Wiring it up Code for datalogging with 1-wire probe Thermistors Overview: https://learn.adafruit.com/thermistor/overview Wiring diagram: https://learn.adafruit.com/thermistor/using-a-thermistor Image: https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/temperature_thermistor_bb.png (original: https://learn.adafruit.com/thermistor/using-a-thermistor) (Replicate, but for Riffle) Ingredients: 10K thermistor, 10K resistor, Riffle, protoboard / breadboard Wiring it up Code for datalogging with thermistor Light sensorsA photocell Overview: https://learn.adafruit.com/photocells/overview Wiring diagram: https://learn.adafruit.com/photocells/using-a-photocell Images: https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/light_cdspulldowndiag.gif https://raw.githubusercontent.com/OpenWaterProject/riffle-getting-started/master/assets/light_cdsanasch.gif (Same sort of diagram, but with Riffle) Ingredients: “10K” photocell, 10K resistor, Riffle, protoboard / breadboard Wiring it up Code for datalogging with light cell Field deployment: a Riffle in a bottle
Setup a Github Account
|
Revert |