Gaggiuino Gen 3 PCBv4: what to know before you build

Gaggiuino Gen 3 PCBv4 for Gaggia Classic: Compatibility and Build-Path Planner

This is a pre-install compatibility and build-path planner for Gaggiuino Gen 3 PCBv4 across the Gaggia Classic family: Original Classic, Classic Pro, Classic Pro Eco, Evo Pro, and E24. It helps you confirm your machine identity, select the correct generation, PCB revision, UI path, and wiring path, and understand machine-specific exceptions before you buy a kit or open the chassis.

This guide does not contain complete installation steps. It deliberately omits per-terminal wiring, line-by-line harness routing, Eco universal bypass procedures, community-sourced wire lengths or connector substitutions, and first power-on sequences. A full L3 iFixit step-by-step guide remains Blocked until HomeBaristaMods holds original real-machine evidence for at least one locked sample.

What this guide solves: machine identity confirmation, the current official compatibility table, Gen vs PCB revision naming, Screen vs Headless UI choice, Stock Wiring vs Custom Harness selection, machine-specific exceptions (Eco, 120V Evo/E24, Original GC grounding), official BOM categorization, and L3 stop conditions.

What this guide does not solve: complete wire routing, per-terminal pinouts, Eco universal bypass, first power-on validation, and any path that requires real-machine verification HomeBaristaMods has not yet completed.

Official Gaggiuino documentation checked for this guide: 2026-09-20. The official home/compatibility page reported last updated 16/09/2026 when checked.

Machine Confirmation Before Anything Else

Three independent checks must agree before you select a kit or wiring path. Do not rely on wire color, seller listing, or memory.

• Nameplate model ID: Locate the rating plate. Record the full model code, including suffix (e.g. RI9380/11, RI9480/01). Partial codes such as bare "RI9481" are not sufficient because regional variants exist.
• Voltage: Confirm 100-120V or 220-240V from the plate. Voltage determines OPV behavior, Eco PCB likelihood, and wiring path.
• Eco PCB presence: Open the chassis and visually confirm whether an Eco PCB is installed. The Eco PCB enforces an auto-shutoff and changes the recommended wiring path. Do not infer Eco status from the model code alone.

Model ID reference (per current Gaggiuino compatibility table)

• RI9380 / SIN035R: primarily 100-120V GCP, Evo, E24; a less common 220-240V non-Eco GCP variant also exists.
• RI9480 / SIN035UR: 2019-2022, 220-240V GCP Eco.
• RI9481 / SIN035UR: in the Gaggiuino table, corresponds to 2023+, 220-240V Evo/E24 Eco.

Current Official Gaggia Classic-Family Compatibility Snapshot

Checked against the current Gaggiuino compatibility table on 2026-09-20. This is a dated planning snapshot, not a substitute for the live official table on build day.

Gen 3 Is Not the Same as PCBv4

A common error is treating generation numbers and PCB revision numbers as the same axis. They are independent.

• Generation (Gen 2 / Gen 3): refers to the firmware and hardware feature set. Gen 3 is the current recommended path for Gaggia Classic and Rancilio Silvia variants. Gen 2 is primarily retained for unofficial compatible machines and stable legacy code paths.
• PCB revision (PCBv3.1 / PCBv4): refers to the physical board design. Gen 3 recommends PCBv4. Gen 2 recommends PCBv3.1. The labels "V3" and "V4" on community kits do not correspond to "third generation" and "fourth generation."

Current recommendation when checked on 2026-09-20: Gen 3 + PCBv4 for the supported Gaggia Classic and Rancilio Silvia paths described by the official project. Firmware and UI releases change, so this planner does not pin a specific build hash as “latest.”

Use the current official firmware/update instructions for the hardware path you actually have. Do not mix binaries, upgrade steps or archived instructions from different generations because an older HBM snapshot named a release.

Screen vs Headless

Gen 3 offers two UI paths. You must pick exactly one, and it must come from the current official supplier path. The ESP32 UI must be vendor-enabled; a generic ESP32-S3 board cannot be substituted.

Both paths belong to Gen 3. The choice affects physical installation, enclosure design, and whether the machine can be controlled without a network. Headless depends on reliable local network access to the Web UI.

Stock Wiring vs Custom Harness

Both paths use 3PLN and SSR integration. The difference is how much of the original harness you keep.

• Stock Wiring: taps into the original harness with a small number of jumpers. Fewer new wires, but identifying original connections can be more confusing and some machines require terminal insulation work.
• Custom Harness: fully replaces the original harness. More labor, but the finished result is cleaner and more direct. The current compatibility notes recommend Custom Wiring for the 220-240V Eco variants listed below.

Official recommendation by machine family:

• 220-240V Eco PCB machines (GCP Eco, Evo Eco, E24 Eco): Custom Harness recommended. Stock Integration is not the official path. Power switch handling is required.
• Non-Eco machines: Stock or Custom, with machine-specific exceptions noted in the next chapter.

Three Current Official Exceptions You Cannot Ignore

1. 220-240V Eco variants

The current Gaggiuino compatibility table calls out the Eco PCB variants separately and recommends custom wiring plus machine-specific power-switch handling. Use the live official machine-specific instructions; this planner does not reproduce a universal Eco bypass or per-terminal procedure.

2. 100-120V Evo Pro and E24

The current Gaggiuino compatibility table includes project-specific OPV and stock-wiring insulation requirements for these paths. Treat those values and changes as requirements of the current Gaggiuino build path, not as a general statement about the stock machine or an HBM pressure target. Follow the live official procedure for the exact model.

3. 100-120V Original Gaggia Classic

The current compatibility table flags this path as needing grounding. Grounding is mains-safety work; identify the exact machine and follow the current official machine-specific guidance and applicable electrical-safety requirements. HBM does not reproduce an executable grounding conversion here.

Official BOM Categories Plus What the Kit May Not Include

The official PCB BOM includes the core sensors and switching component. It does not include every harness, enclosure, or tool required for a complete install.

In the official PCB BOM

• Non-grounded K-type M4 thermocouple.
• Pressure sensor, 0-1.2 MPa range.
• SSR-40DA solid-state relay.

Missing components are not inferred from an old checklist

The official BOM and path-specific pages are the source of truth for the current build. If a component is absent from an older HBM snapshot, do not add or omit hardware based on inference; recheck the live BOM for your selected generation, board, machine and pressure path.

Out-of-kit checklist (verify before purchase)

The same "GCP" name can split into 100-120V vs 220-240V, RI9380 vs RI9480 vs RI9481, Eco vs non-Eco, Stock vs Custom, Screen vs Headless, and T-fitting vs Pressure Tap Block. Your out-of-kit list depends on the path. Common items to verify:

• Custom Harness materials (wire, terminals, heat shrink) if your machine is Eco or you chose Custom.
• 3D-printed protective enclosure for the PCB and UI.
• Pressure branch component: T-fitting or Pressure Tap Block, per your machine and path.
• Hose, barb, and clamp combination rated for your pressure branch (follow the BOM; do not substitute community-sourced combinations).
• ST-Link for firmware flashing.
• Crimping tool, pull-test, and insulation verification capability.
• Multimeter rated for your mains voltage.

Do not build a single "one-click buy" bundle across all machines. Pressure branch, harness, and enclosure parts are path-dependent.

Risk Level L3, Required Competency, and Power-Off Conditions

This modification is rated L3. It simultaneously involves mains voltage, the boiler heater, SSR, thermal fuse, internal harness, pump, and pressurized water circuit.

Primary hazards

• 100-240V mains shock and energized chassis.
• SSR or wiring sequence error causing sustained boiler heating.
• Thermal fuse, grounding, or insulation removed incorrectly.
• Pressure branch leak onto PCB, terminals, or SSR.
• Firmware/hardware mismatch causing abnormal control behavior.
• Insulation damage from wires routed near boiler, pump, or sharp chassis edges.

Required user competency

• Confirm machine version from nameplate, schematic, and real hardware, not wire color.
• Crimp, insulate, pull-test, and distinguish AC, DC, and protective earth correctly.
• Perform continuity and resistance checks with the machine fully de-energized.
• Identify reliable hose, fitting, seal, and pressure ratings.
• Know when to stop; do not hot-probe unknown wiring by trial and error.

Required test tools (publishing threshold, not equal to the full official BOM)

• Multimeter rated for local mains voltage.
• Grounding continuity and insulation safety test equipment; final publication should involve a qualified electrical professional.
• Crimping tool, pull-test, and insulation check capability.
• Empty / blocked-basket pressure verification setup.
• Water circuit leak check setup.
• Equipment to record firmware build, pressure, temperature, and SSR state.

Specific pass thresholds depend on machine region and local electrical safety standards. This guide does not fabricate numeric thresholds.

Pre-first-power-on checks

• All low-voltage bench tests pass.
• MCU, Embedded/Headless UI, and Web builds match.
• Pressure reads 0.0 bar with no pressure applied.
• Thermocouple reading changes reasonably when heated.
• SSR indicator logic matches official bench check.
• Protective earth, thermal fuse, and chassis grounding re-confirmed.
• No exposed terminals, pinched wires, heat-affected insulation, or loose crimps.
• Water circuit, pressure branch, boiler, and fittings show no seepage.
• PCB and UI installed in protective enclosure.
• First power-on and first shot recorded on video with readings.

Rollback requirements

• Photograph and label the complete original harness before disassembly.
• Store original harness, thermostat, connectors, Eco parts, and switch parts separately.
• Record every irreversible operation.
• After rollback, re-execute grounding, insulation, thermal protection, and water circuit verification.
• For Custom Harness, "machine powers on again" is not a sufficient rollback success criterion.

Professional review required

Yes, specifically for:

• All 220-240V Eco Custom Harness work.
• Original GC grounding modification.
• Any thermal fuse, SSR, boiler heater circuit, or power inlet modification.
• Final sample machine before HomeBaristaMods publishes an executable L3 guide.

Conditions to Upgrade This Page to a Full iFixit Step-by-Step Guide

The full L3 iFixit installation guide remains Blocked. It will be unlocked only when all of the following are true for at least one locked sample machine (for example: RI9480, 230V, EU GCP Eco, PCBv4, Gen 3 Screen, Custom Harness).

• Original continuous photography exists for pre-disassembly, during installation, and post-installation.
• Every wire is double-checked against both the official schematic for that specific machine and the real unit.
• Low-voltage bench, firmware, grounding, insulation, thermal protection, pressure, leak, and first power-on verification are all complete and recorded.
• Complete BOM, batch, firmware build, anomalies, and rollback records exist.
• A qualified professional with mains-voltage equipment experience has reviewed the build.
• On the day of publication, the current official documentation and the latest firmware release are re-checked.