metisvela / sailtrack-strain

Module of the SailTrack system for measuring the forces acting on the boat maneuvers.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

SailTrack Strain

SailTrack Strain is a component of the SailTrack system, it manages load cells mounted on the boat maneuvers, providing load and stress information about them. To learn more about the SailTrack project, please visit the project repository.

The SailTrack Strain module is based on a battery powered LilyGo TTGO T7, consisting of an ESP32 microcontroller, connected to an Operational Amplifier breakout board connected to a load cell, mounted "in parallel" to the boat shroud. For a more detailed hardware description of the module, please refer to the Bill Of Materials. The 3D-printable enclosure con be found here.

The module performs the following tasks:

  • It gets the raw load cell measurments, it amplifies and converts them to readable values and it sends them to the SailTrack Network.


module-image

Installation

Follow the instructions below to get the SailTrack Strain firmware correctly installed. If you encounter any problem, please open an issue.

  1. Install PlatformIO Core.
  2. Clone the SailTrack Strain repository:
    git clone https://github.com/metisvela/sailtrack-strain.git 
    
  3. Cd into the directory:
    cd sailtrack-strain
    
  4. (macOS ONLY) Uncomment the commented lines after "Patch for macOS" in the platformio.ini file.
  5. Connect the module with an USB cable.
  6. Finally, flash the firmware:
    pio run
    

Usage

Once the firmware is uploaded the module can work with the SailTrack system. When SailTrack Strain is turned on, a LED start to blink to notify the user about the connection status with SailTrack Core. Then, if the connection is successful, the LED stays on, otherwise the module will put itself to sleep, and it will try to connect later. Once the module is connected it will automatically start sending measurements.

Contributing

Contributors are welcome. If you are a student of the University of Padova, please apply for the Metis Sailing Team in the website, specifying in the appliaction form that you are interested in contributing to the SailTrack Project. If you are not a student of the University of Padova, feel free to open Pull Requests and Issues to contribute to the project.

License

Copyright © 2023, Metis Sailing Team. SailTrack Strain is available under the GPL-3.0 license. See the LICENSE file for more info.

About

Module of the SailTrack system for measuring the forces acting on the boat maneuvers.

License:GNU General Public License v3.0


Languages

Language:C++ 86.7%Language:Python 13.3%