Work

calibration_and_testing/exp01_sensor_calibration.md

@@ -1,16 +1,43 @@
 # Experiment 01 - Sensor Calibration
 
-- Purpose: to understand how the values provided by sensor XXX vary in
-  different humidity conditions.
-- Components:
-    - Arduino Proto
-    - Sensor XXX
-- Methodology
-    - Prepare the board and sensor to take measurements.
-    - Prepare production code and alternative code with raw values.
-    - Prepare 6 testing conditions: air, water, and three pots with different
-      humidity conditions (completely dry, XXXml watered, XXXml watered and
-      XXXml watered).
-    - Perform raw and production-grade measurements in each environment.
-- Results
-- Take-aways
+## Purpose
+
+The purpose of experiment 1 is to map the analog output values of the hydration
+sensor to different levels of water concentration in soil. This mapping will be
+necessary to adjust the user experience of the final device.
+
+## Components and equipment
+
+- Arduino board to run code
+- Three male to male jumper cables
+- One moisture sensor
+- A cup of soil
+- Water
+
+## Methodology
+
+1. Prepare the code. Three versions of the code will be used raw, slightly
+   smoothed and heavily smoothed.
+    - Raw version outputs the sensor's measurement to the serial port in
+      real-time, unfiltered.
+    - The slightly smoothed version will take 10 measurements with 50ms of
+      delay between each and return the mean.
+    - The heaviliy smoothe version will take 100 measurements with 50ms of
+      delay between each and return the mean.
+2. Prepare the soil
+    - In a small recipient (weight: 80g), place 200g of soil.
+    - Let it dry for X days (collection on 24/10/2022) to obtain the driest
+      possible soil.
+3. The next steps will be performed repeteadly by adding 10ml of water to the
+   soil at each step. Start by first measuring the completely dry-soil. Ensure
+   that the water is distributed uniformly across the soil. For each amount of
+   water up to a max of 200ml, and for each version of the code:
+    - Obtain measurements from the sensor. If the measurement is unstable,
+      record the observed range and the most frequent value.
+4. Finally, obtain measurements in a glass of pure water, with no soil at all.
+
+## Results
+
+Make line chart with measurement by hydration level.
+
+## Conclusions