Hydrogreen Team is a science club based at the Lublin University of Technology. It focuses on creating hydrogen-powered vehicles and, since its creation, has developed two vehicles: Hydros and Hydra.

Hydros is a prototype of an innovative three-wheeled vehicle equipped with an electric drive and hydrogen fuel cell. The vehicle has been designed to minimize energy losses through its aerodynamic body, incredibly low mechanical resistance, and a highly efficient drive system. The construction is based on a monocoque made of modern lightweight composite materials.

The project's goal is to participate and podium in the Shell Eco Marathon competitions. The Shell Eco Marathon competitions take place annually on three continents - Europe, America, and Asia. Shell Eco-Marathon is an event that brings together the worlds of science, technology, and industry in a competition where vehicle efficiency in terms of energy consumption is paramount.

We are migrating our core vehicle control systems to Zephyr RTOS for better modularity and reliability. To set up the complete development environment with all firmware repositories, use the Zephyr manifest.

• 🧠 Master control unit (MCU) · PCB · Firmware · SCADE model
  Central vehicle computer based on TI TM4C. Handles safety logic and state management.

• 🔋 Fuel cell control unit (FCCU) · PCB · Firmware
  Logic and regulation for the hydrogen stack.

• ⚡ Fuel cell module (FCM) · PCB
  Power stage and current control for the fuel cell stack.

• 🔌 Power distribution unit (PDU) · PCB
  Power stage and current control for the fuel cell stack.

• 🏎️ Steering wheel unit (SWU) · PCB · Firmware
  Driver interface and HMI logic. Manages steering wheel buttons, the dead man's switch, and cockpit displays.

• 🔄 Can converter unit (CCU) · PCB · Firmware
  Signal translation bridge for vehicle bus communication.

• 💡 Lighting control unit (LCU) · PCB · Firmware
  Manages external indicators, brake lights, and signaling.

Planned: A converter to bridge the fuel cell with the vehicle's main power circuit.

• 📦 Altium designer library · Repo
  Common footprints and symbols for hardware design.

• 📒 CAN definitions · Repo
  Single source of truth for CAN IDs and frame structures.

• 📝 Documentation · Repo
  Full technical documentation in LaTeX.

High-level computing, data acquisition, and cloud connectivity.

• 🐧 Onboard computer (RPi4) · Yocto OS · Telemetry layer
  Custom Linux distribution and application logic for LoRa, CAN, and local logging.

• 📻 Base station tools · Base station firmware · PC publisher script
  RP2040-based LoRa receiver and desktop utility for data transmission.

• ☁️ Cloud infrastructure · Server subscriber
  Backend service for incoming telemetry data aggregation.

Here is a look at how these software telemetry components connect to each other:

flowchart TD
    subgraph SERVER["Server"]
        G["Server Subscriber (Python)"]
    end
    subgraph BASE["Base Station"]
        n4["Base Station (RP2040)"]
        n7["PC Publisher (Python)"]
    end
    subgraph s1["Telemetry System"]
        n6["Custom Linux distro<br>(Yocto project)"]
        n5["Logic (Yocto layer)"]
    end
    subgraph VEHICLE["Vehicle"]
        direction LR
        s1
        A["Master Controller (TI)"]
        B["FCCU (ESP32)"]
        n2["Steering Wheel (STM32)"]
        n3(("CAN Bus"))
    end
    subgraph s2["Software"]
        SERVER
        BASE
        VEHICLE
    end
    VEHICLE -- LoRa <br> --> BASE
    BASE -- Internet </br> --> SERVER
    n4 --> n7
    A -- RS485 --- s1
    B --- n3
    n2 --- n3
    n3 --- s1
    
    click G "https://github.com/HydrogreenPollub/server-mqtt-subscriber";
    click n6 "https://github.com/HydrogreenPollub/rp4-yocto";
    click n5 "https://github.com/HydrogreenPollub/rp4-telemetry";
    click n2 "https://github.com/HydrogreenPollub/stm32-steering-wheel-unit";
    click A "https://github.com/HydrogreenPollub/tm4c-master-control-unit";
    click B "https://github.com/HydrogreenPollub/esp32-fuel-cell-control-unit";
    click n4 "https://github.com/HydrogreenPollub/rp2040-base-station";
    click n7 "https://github.com/HydrogreenPollub/pc-mqtt-publisher";