Gaggiuino Guide: Programming Advanced Pressure Profiles on Entry-Level Hardware

Prerequisites and Hardware Architecture

Before touching the code, you must understand the machine's internal layout. Successful implementation requires basic knowledge of DC electronics, circuit continuity, and firmware flashing. You will need an Arduino Nano (or similar microcontroller), a custom PCB, and a solid-state relay (SSR). Mechanically, the build demands a thermo probe to replace the stock fuse and a T-fitting to integrate a pressure transducer into the water line between the pump and the boiler.

Key Libraries & Tools

• Arduino IDE: The primary environment for writing and uploading the control firmware.
• Nextion Editor: Used for designing and flashing the HMI (Human-Machine Interface) touch screen layouts.
• PID Library: Manages the Proportional-Integral-Derivative loops that keep the boiler temperature within a 0.1°C tolerance.
• Gaggiuino Firmware: The community-developed source code that handles the logic for pressure profiling and flow sensing.

Code Walkthrough: Logic and Flow

The firmware operates by intercepting the user's input from the touch screen and translating it into Pulse Width Modulation (PWM) signals sent to the pump. Here is a conceptual breakdown of how a blooming espresso profile is handled:

// Conceptual Pump Control Logic
void applyProfile(float targetBars, int duration) {
  while(currentTime < duration) {
    float currentPressure = readPressureSensor();
    if(currentPressure < targetBars) {
      increasePumpPower(); // Adjusts PWM signal to the Ulka pump
    } else {
      modulateFlow(); // Maintains steady state pressure
    }
  }
}

During the pre-infusion phase, the code instructs the pump to run at low power until the pressure transducer detects initial resistance. Once the "bloom" begins, the firmware cuts the pump entirely for a set duration, allowing the coffee puck to saturate before ramping to full extraction pressure. This logic mimics the manual lever-pulling process used in professional cafes.

Syntax Notes: Polarity and PWM

In this environment, polarity matters for more than just the sensors. The SSR requires correct DC polarity to trigger the heating element; reversing these wires will result in a machine that boots but never heats. Furthermore, the firmware utilizes high-frequency PWM to control the vibratory pump. Standard AC dimmers fail here because they lack the micro-adjustments required to track the blue pressure curve seen on the Gaggiuino Project display.

Practical Examples

A real-world application of this code is the Descending Pressure Profile. Unlike stock machines that hit 9 bars until the pump stops, the Gaggiuino Project can be programmed to start at 9 bars and slowly taper to 6 bars as the puck erodes. This prevents channeling and ensures a sweeter, more balanced extraction in light-roast coffees.

Tips & Gotchas

Watch out for the Eco Mode found on European Gaggia models. These machines contain an extra motherboard for auto-shutoff that complicates the wiring path. You must bypass this board entirely to provide the Arduino with a clean power signal. Additionally, ensure you separate low-voltage signal wires (like the screen ribbon cable) from high-voltage heater lines to prevent electromagnetic interference from crashing your firmware mid-shot.