3. Pressure Logger Setup - sunny-day-flooding-project/tutorials_v1 GitHub Wiki

Tutorial Overview

Once the pressure logger has been constructed, there are several steps that must be taken to update and setup the firmware of the data logger (OLA). These updates are made by communicating with the OLA via a computer and terminal. Note, the OLA settings vary for the pressure logger calibration, connecting the pressure logger electronics to the communications gateway setup, and finally for deployment. Thus, you will need to come back to this wiki to ensure you are using the right settings.

Equipment List

Additional to a fully-built pressure logger, you will need the following:

Jumper shunt, to reconnect the MEAS Jumper on the OLA
USB-A to USB-C cable, to connect the OLA to the computer
90 degree USB-C Male to Female Adapter, to better attach the USB-A to USB-C cable to the OLA

Open Log Artemis (OLA) Setup

OLA Firmware

The OLA is an Sparkfun open-source data logger that can interface with our Bar02 pressure transducer. Before updating the OLA settings, make sure you have the latest OLA firmware using the Artemis Firmware Uploader available here.

Some other notes about setup follows:

We will be using a terminal program, such as Putty or SecureCRT, to connect to the OLA with a USB-C cable.
The connection should be serial with a baud rate of 115200.
If the baud rate is correct, it will start printing information to the terminal window.
To get to the main menu press any key.
These settings below will prepare the pressure logger for Pressure Logger Calibration. After calibration, settings that need to be changed before the Communications Gateway Setup and Deployment, respectively.

Establishing OLA Connection to the Computer

To setup the Pressure Logger, we will be toggling through menus and entering data via the terminal. Thus, we need to setup a connection through a computer. Before connecting to the pressure logger to the computer, review the Pressure Logger Precautions about the MEAS Jumper and battery pack.

Configure the OLA as shown in the image below with the jumper shunt the two MEAS prongs and with no batteries installed.
Then, connect your computer to the OLA using the USB-A to USB-C cable.

MEAS Jumper attached and connected to computer

Connecting to the Terminal

Reference the following pictures to connect to the terminal via Putty or SecureCRT.

Connecting using Putty (seen on left-hand side) and connecting using SecureCRT (seen on right-hand side)

Main Menu

You will land on a main menu screen that looks like this. Type the number of the menu you want then hit enter to access different configuration menus.

Main menu

Menu 1: Configure Terminal Output

The explanation for each option in Menu 1 is below. For quick reference, look at the picture below.

Display of the changes made to Main Menu 1

Option 1.3: 9600
- After changing the baud rate, you will have to exit the terminal, restart the OLA by holding down on the power button, and then re-connect to the terminal using the new baud rate of 9600.

Establishing new baud rate and reconnecting to the terminal

Option 1.5:
- Set to 1 for Pressure Logger Calibration.
- Set to 20 for Communications Gateway Setup.
- Set to 360 for Deployment.
Option 1.9: Enabled
Option 1.10: 86400
- Controls how frequently data is saved to and output file (.txt). We chose to start a new text file every day.
Option 1.14: Enabled
Option 1.15: No
- If using a float switch, set to Yes so that logging frequency increases when the water level passes a certain threshold. Otherwise, choose No for a consistent logging frequency.
Option 1.21: 15000 if we are power cycling the OLA/BLE board on and off between measurements.
- 15 seconds, or 15000 ms, allows 5 extra seconds after the sample to both transmit the data via BLE and give an opportunity to interrupt the OLA before it goes back to sleep.
- Alternatively, if we want to keep the OLA/BLE board constantly powered on, set this to the maximum allowable value. This maximum value is 1 second less than the selected in option 1.5, and changes when the selected value for option 1.5 changes.

Menu 2: Configure Time Stamp

The explanation for each option in Menu 2 is below. For quick reference, look at the picture below.

Display of the changes made to Main Menu 2

Option 2.4: (enter the current date)
Option 2.6: (enter the current time in hours, minutes, and seconds)
- update and double-check this setting before every deployment.
Option 2.9: (enter offset based off your time zone)
- Our group logs time/date in EST year-round. EST is five hours behind UTC, but your offset will vary depending on your time zone.

Menu 3: Configure IMU

The OLA data logger is compatible with many non-pressure sensors. We disable the functionalities that do not pertain to our data.

Display of the changes made to Main Menu 3

Option 3.3: Disabled
Option 3.4: Disabled

Menu 4: Configure Digital Logging

Leave this menu at its default settings. This menu may not appear at all on your Main Menu in the terminal, which is fine.

Main Menu 4 left at its default settings

Menu 5: Configure Analog Logging

For Analog logging, we would like to track the battery voltage (which has a maximum of 6V) so that we can estimate the remaining capacity of the battery pack.

Display of the changes made to Main Menu 5

Option 5.6: Enabled

Menu 6: Configure Attached Devices

Menu 6 is composed of several sub-menus. Enter 1 or 2 to make edits to Menu 6.1 and 6.2, respectively.

Menu 6.1: Configure MS5837 Pressure Sensor

We only need the raw pressure and temperature data from the pressure logger, so options 4-7 are not used.

Display of the changes made to Main Menu 6.1

Option 6.1.4: Disabled
Option 6.1.5: Disabled

Menu 6.2: Configure QWIIC Bus

Display of the changes made to Main Menu 6.2

Option 6.2.1: Yes if you want to cycle power on the OLA/BLE board on and off between readings. No if you want to keep the OLA/BLE board always on.
Option 6.2.3: 10000
- 10 seconds, or 10000 ms, allows a time for a connection between the OLA and BLE to be established and recognized by the software.

Menu 7: Configure Power Options

Display of the changes made to Main Menu 7

Option 7.1: Yes if you want to cycle power on the OLA/BLE board on and off between readings. No if you want to keep the OLA/BLE board always on.
Option 7.3: Disabled
Option 7.4: Enabled
Option 7.5: 3.2

Hidden OLA Menu "d": Debug Menu

Access this menu by typing d on the OLA main menu.

Option 4: Yes
- We want only printable characters in the output data. This keeps the OLA from sending strange characters triggered by Bluetooth interference.

Adafruit Bluefruit LE UART Friend (BLE) Board Setup

Before connecting to the BLE board to the gateway, confirm that the firmware on the board is up to date.

Install Bluefruit Connect app app on your mobile device.
Connect your mobile device to the BLE board and check for firmware updates.
If firmware updates for the board are available, accept them.