Alkalinity Titrator Project

<!-- ALL-CONTRIBUTORS-BADGE:END -->

Project motivations

As CO2 levels increase, the ocean absorbs more CO2 and becomes more acidic. There currently exists a large deficit of data on how this affects wildlife. Alkalinity Titrators are needed for ocean acidification research​. Currently, available models are expensive ($10,000-$25,000)​. Models on the lower end of the price range are not automated and are therefore time intensive.

This project aims to make ocean acidification research more widely available by lowering the cost of alkalinity titrators.

The problems that the alkalinity-titrator seek to fix are as follows:

• Lower the cost of ocean science equipment by using inexpensive, widely-available parts
• To automate the titration process, saving time and effort when determining total alkalinity

The titration process used in this project is based on SOP 3b from

Christian, James Robert, Andrew G. Dickson, and Christopher L. Sabine. Guide to Best Practices for Ocean CO2 Measurements. Sidney, B.C.: North Pacific Marine Science Organization, 2007.

Current Development Note

The most recent development in this project is the implementation of a UI State Machine framework (see the titration/utils/UIState folder for UI states implemented). While the UI State Machine framework has been fully implemented, the actual titration processes and routines have not been integrated with the UI State Machine (see GitHub Issues for further specifications).

Setup and Installation

Setting up the Raspberry Pi

Refer to https://desertbot.io/blog/headless-raspberry-pi-3-bplus-ssh-wifi-setup for instructions on setting up the raspberry pi (note: headless setup is not required if a keyboard and monitor are available). Raspbian lite has everything needed, but the desktop version can be downloaded if working with a GUI is preferable.

Installing software

Run standard updates on the pi:

sh sudo apt-get update sudo apt-get upgrade

This project utilizes SPI and I2C protocols, both of which often come disabled on the pi. To enable them, run:

sh sudo raspi-config

and navigate to "Interfacing Options"; enable both SPI and I2C.

Install git:

sh sudo apt-get install git

Clone alkalinity titrator repository to the pi

sh git clone https://github.com/Open-Acidification/alkalinity-titrator.git

Run installation script

sh sudo ./install.sh

User Instructions

Run on Device

To run (with the UI State Machine integrated)

sh ./run.sh

Run in Local Environment

To run in a local environment with mocked devices (with the UI State Machine integrated)

sh ./run_mocked.sh

Testing

To perform Pytest tests for the devices and UI states.

sh ./test.sh

Pins

Temperature probe (MAX31865 breakout board)

• PIN 1 (3.3v) to sensor VIN
• PIN 9 to sensor GND
• PIN 19/BCM 10 to sensor SDI
• PIN 21/BCM 21 to sensor SDO
• PIN 23/BCM 23 to sensor CLK
• PIN 29/BCM 5 to sensor CS (or use any other free GPIO pin)

pH probe (ADS1115 analog converter)

• PIN 17 (3.3v) to ADS1115 VDD - Remember the maximum input voltage to any ADC channel cannot exceed this VDD 3V value!
• PIN 6 to ADS1115 GND
• PIN 5/BCM 3 SCL to ADS1115 SCL
• PIN 3/BCM 2 to ADS1115 SDA

Libraries

1. Circuit Python - https://github.com/adafruit/Adafruit_CircuitPython_MAX31865
   Used for communicating with the PT1000

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Kaden Sukachevin 💻 📖 🐛	Preston Carman 💻 🐛	Konrad McClure 💻	Noah-Griffith 💻	Barun Debnath 💻	Kieran Sukachevin ⚠️ 💻	Josh Soref 💻
TaylorSmith28 ⚠️ 💻

This project follows the all-contributors specification. Contributions of any kind welcome!