Documentation

Community Guides

DeLonghi ECP & Stilosa

Community Guide for DeLonghi ECP and Stilosa Espresso Machines

Image credit: Torxfighter

Contents

Foreword

If you see any errors or have any suggestions on making purchasing cheaper or easier for people, please join us in the GaggiMate Discord channel.

About This Guide

Scope of Work

This is a major modification requiring a full rewire.

  • Rewiring: You will remove most existing wiring and create a new harness to connect to the GaggiMate PCB.
  • Controls: The stock rotary knob will be removed. The machine will be controlled entirely through the GaggiMate interface.
  • Power: You will install a new 3-prong plug and a 4-pin on/off switch (for the EU model).
  • Features: This process disables the stock “Eco Mode” found on EU models.

While not a “simple” mod, it is manageable if you are comfortable with basic hand tools and confident following detailed instructions. This guide assumes you have purchased the specific items listed below and is not suitable for a “LEGO” style build.

A Note on the Stilosa

This guide is compatible with the Stilosa. The only significant difference is the front panel, which may require a specific screen housing print (linked in the Printed Parts section). All images and references below feature the ECP, but the modification is identical.

But Why?!

DeLonghi makes several popular, affordable, and surprisingly capable semi-automatic espresso machines. You can often find a well-maintained pre-owned model on Facebook Marketplace or elsewhere for a great price. I paid just $50 for mine. Even in stock form, the ECP and Stilosa can produce excellent espresso. Their stainless-steel grouphead and sturdy internals make them very capable, especially when paired with a bottomless portafilter and a quality grinder.

However, if the idea of installing a Ferrari engine inside a Toyota chassis sounds exciting, this modification is for you. After installing the GaggiMate, these little sleepers can rival the performance and features of $1,000-plus single-boiler espresso machines for a fraction of the cost.

You Can Do This!

Before I started this modification, I had never cut, crimped, or spliced a wire in my life. Despite that, I successfully installed the GaggiMate on my DeLonghi ECP. If I can do it, you can do it too.

Take your time, follow each step carefully, and you will be just fine. Make sure to read through the entire guide at least once before you start working on the machine. This will help you understand the overall process and prepare you for what’s ahead.

Disclaimer

Working with high-voltage electricity carries a risk of serious injury, electrocution, or fire. The modifications described in this guide involve opening your machine and altering its internal wiring, which operates at mains voltage.

By proceeding with this project, you acknowledge and agree to the following:

  • Assumption of Risk: You perform these modifications at your own risk. The author of this guide assumes no liability for any damage to your equipment, property, or injury to yourself or others.
  • Full Responsibility: You take full responsibility for the safety and functionality of your machine.
  • Safety First: Always ensure the machine is completely unplugged from the wall outlet before removing the housing or touching any internal components.
  • Technical Competence: Do not attempt these modifications if you are not comfortable working with electrical circuits or interpreting wiring diagrams.

If you are unsure about any step, consult a qualified electrician or professional technician.

Shopping List

Before buying anything, please read the guide fully. To get the GaggiMate to work with the DeLonghi ECP series, you must buy the components in this list exactly as specified. The shopping list includes items that make the job easier, but experienced tinkerers should analyze the list and determine what they actually need to buy.

  1. A compatible ESP-32-S3 screen ⚠️ Buy only one. or
  1. or ℹ️ If you do not want to experience the frustration of crimping tiny JST connectors, buy these. You will splice the unconnected ends of these to their corresponding wires on the screen and SSR. You must buy both. Choose 30cm length for both to give you enough wire.

Tools & Consumables

Printed Parts

We recommend printing all parts using PETG or ABS for durability and heat resistance. PETG is preferred. It has a higher heat tolerance than ABS, comes in a wider variety of colors, and is easier to print. There’s no reason you can’t glam up your machine with a bright color while you’re at it!

Screen Prints

DeLonghi ECP

  • 2.1” Screen
    • TorxFighter designed the front panel replacement shown at the start of this guide. It’s not free, but it completely transforms the look of the machine by replacing the entire front panel and seamlessly integrating the screen. The author of this guide uses this print and recommends it. Find it here.
    • Alternatively, buy the housing for a 2.1” screen or download the model and print it yourself.
  • 2.8” Screen
    • Prowler has designed a screen housing for the 2.8” WaveShare screen that mounts on the front panel. Find the model here.

DeLonghi Stilosa

  • 2.8” Screen
    • Stuart has designed a screen housing for the 2.8” WaveShare screen that mounts on the front panel. Find the model here.

PCB Prints

Please keep your PCB and SSR secure within a housing when your build is done. Leaving them exposed is an electrocution risk.
  • TorxFighter, creator of the front panel replacement print, has also released a PCB housing that mounts on the back of the machine and holds both the PCB and SSR.
  • ph has designed and shared another version that also fits both the SSR and PCB, mounted on the back of the machine.
  • You can also buy a pre-printed GaggiMate Pro PCB housing or download the model and print it yourself. Note that this housing only holds the PCB. You’ll need a separate solution for the SSR.

Before You Begin

Diagram — Wiring

Please ensure you reference the appropriate wiring diagram below as your primary roadmap for this entire step. Do not skip this check, as it dictates your next sequence of operations. It might look intimidating, but take your time; we will break down each connection precisely. The diagram is your essential blueprint.

ℹ️ You may install a power switch on the American version of your machine if you wish, but it will require cutting an additional hole in the chassis to support the new switch. This is not covered by this guide. If you proceed with this addition, you must follow the principles of the European wiring diagram (Diagram B).

Diagram A — No Power Switch (e.g. American Models)

Diagram B — Power Switch (e.g. European Models)

Flashing the Hardware

Flash both the PCB and screen before installing them. It’s much easier to do outside the machine. Follow the instructions at docs.gaggimate.eu/docs/flashing.

Prepare the Machine

The abridged process is as follows:

Create a Wire Port

You will need to drill a hole in the back panel to route wires from inside the machine to the PCB. Choose a location that is easily accessible when fully assembled and does not interfere with any other components. Drill the hole large enough to fit at least a 13 mm (inner-dimension) grommet. This keeps the opening tidy and protects the wires from sharp edges.

Wire the Pump

The pump is not polarized. It does not matter which wire connects to which terminal. ↗️ Refer to the Wiring Diagram

Connect the Blue Pump Wire

Connect the Green Pump Wire

Prepare the Water Line

Re-seat the Frame

A correct installation of the Pressure Transducer and fittings will look similar to the image above.

Wire the Boiler

The boiler is not polarized. Note how the fuse is secured to the boiler via the metal clip. When you reconnect the fused wire, secure it the same way to ensure it stays in place and maintains good contact with the boiler surface. ↗️ Refer to the Wiring Diagram

The fused wire is indicated by the arrow pointing down from label 1.

Connect the Red Fused Boiler Wire

Connect the Blue Boiler Wire

Wire the Screen

This section explains how to prepare a WaveShare screen for connection to the PCB. If you purchased a LilyGo screen, the process will be similar, but wiring may differ. Refer to the documentation that came with your screen for specifics. ↗️ Refer to the Wiring Diagram

Prepare the 2-Pin Female PH 2.0 Connector

Prepare the 4-Pin Female SH 1.0 Connector

The WaveShare includes 2 of these. You only need 1, but keep the other as a backup.

Prepare the 22 AWG Wires

Prepare the Screen Connection

Prepare the PCB Connection

Attach the Thermocouple

A successful thermocouple installation will look like this (rear-view of the boiler).

Wire the Solid State Relay (SSR)

Attach the SSR Output-to-Plug Wire

Prepare the 3-Pin Female PH 2.0 Connector

Prepare the Control Wire Ends on the SSR Side

Diagram — PCB Wiring Pinout

Refer to the wiring pinout diagram below as we begin connecting the remaining wires to the PCB. Following the pinout carefully is crucial to ensure proper functionality and avoid damage to components.

Connect the Components

Keep your PCB and SSR secured inside a housing when your build is complete. Leaving them exposed is an electrocution hazard.

Connect the Boiler to the SSR — ↗️ Refer to the Wiring Diagram

Connect the Screen to the PCB — ↗️ Refer to the PCB Pinout

Connect the Solid State Relay (SSR) to the PCB — ↗️ Refer to the PCB Pinout

Connect the Pressure Transducer (PT) to the PCB — ↗️ Refer to the PCB Pinout

Connect the Thermocouple (TC) to the PCB — ↗️ Refer to the PCB Pinout

Connect the Green Pump Wire — ↗️ Refer to the Wiring Diagram and Refer to the PCB Pinout

Connect the Blue Neutral Wire — ↗️ Refer to the Wiring Diagram and Refer to the PCB Pinout

Connect the Red Line Wire — ↗️ Refer to the Wiring Diagram and Refer to the PCB Pinout

Wiring the Grounded Power Cord

Proper grounding is crucial for safety. If you are unsure about any part of this process, please join us in Discord.

Even though the American version is not grounded by default, the grounding-point is there for us to use. While the DeLonghi America engineers chose not to ground the boiler, they also didn’t expect dramatic modification of their machine. The GaggiMate team strongly recommends that you ground your boiler.

On the 3-prong power cord linked in the shopping list, identify the following wires:

  • Line is black . For the EU machine, it is brown .
  • Neutral is white . For the EU machine, it is black .
  • Ground is teal . For the EU machine, it is green and yellow .

Connect the SSR to the Plug — ↗️ Refer to the Wiring Diagram

Connect the Pump to the Plug — ↗️ Refer to the Wiring Diagram

Connect the Pump to the PCB — ↗️ Refer to the Wiring Diagram

Connect the Ground Wire to the Plug — ↗️ Refer to the Wiring Diagram

Connect the Boiler Side of the Ground Wire — ↗️ Refer to the Wiring Diagram

🇪🇺 European Version Only Replacing the Stock Power Switch (i.e. Disabling ECO Mode)

Disconnect and Remove the Stock Power Switch ▶️ This video guide is an excellent reference.

Replace the Power Switch

Connect the Plug to the Power Switch — ↗️ Refer to the Wiring Diagram

Connect the Power Switch to the SSR — ↗️ Refer to the Wiring Diagram

Power-On Test and First Boot

With everything connected, plug in your machine and turn it on. If everything is wired correctly, you should observe the following:

If any of these three things do not occur, there is likely a wiring issue. Unplug your machine, review the guide carefully, and retrace your connections to locate and correct the error.

Assuming all three systems power on correctly, visit the GaggiMate website and follow the instructions in the First Start documentation. While there, also review the Configuration, Touch Screen Usage documents to familiarize yourself with the GaggiMate software and its features. Lastly, if you experience any issues with the software, please first check the Troubleshooting section. If your issue is not addressed there, please join us in Discord. We’d be happy to try to help you.

Final Setup and Testing

  • Use GaggiMate’s software Auto-Tune feature in the PID Autotune page to generate PID values specific to your machine. This ensures the software can control temperature effectively and accurately.
  • For DeLonghi ECP users, it is recommended to disable Steam Assist in the Settings page by setting its value to 0.
  • Before reassembling your machine completely, test pulling a shot using the GaggiMate interface. Confirm that there are no leaks and that everything powers and functions as expected.
  • If everything looks good, you’re ready to reassemble your machine.
  • Before final reassembly, unplug your machine and take some time to organize your internal wiring using your solution of choice. Verify that no wires are resting directly on the boiler surface where heat could cause damage to them over time. The only wire that may rest on the boiler surface is the fuse-protected heater wire.

Troubleshooting

The list below contains common issues you might encounter. If your problem is not listed here, please join us in Discord. We’d be happy to try to help you.

  1. After starting my machine, I keep seeing a “Temperature error, please restart” message on my screen! What should I do?

    • First, use your multimeter and test the thermocouple while in continuity mode to make certain it is ungrounded by touching one probe to the thermocouple end, and the other probe to one of two terminal wires. If the multimeter beeps, your thermocouple is grounded. Return it and purchase an ungrounded thermocouple. If your thermocouple is ungrounded (i.e. no beep), try a different outlet. The PID controller does not like a noisy signal. If you’re plugged into an outlet that is weak or noisy (e.g. an extension outlet with lots of USB ports, etc.), your PID may not operate correctly.
  2. I moved it to a different outlet, but I still have the same error. What should I do?

    • Your thermocouple wires may not be making a tight connection inside their PCB slots. These wires are thin. If you’re using the naked wires, make sure you’ve folded them over and twisted them as instructed to give the slot clamps something to bite onto. If that still doesn’t work, consider wrapping the terminal wires in ferrite beads or adding an EMI filter to the power line to reduce electrical noise.
  3. My coffee tastes underextracted or sour. What’s wrong?

    • Nothing is wrong, per se. Even the highest-end machines have a temperature difference from where the thermocouple takes a measurement and the actual grouphead. The GaggiMate software allows you to compensate for this by adjusting the “Temperature Offset” value in the settings. You can increase this value to raise the target temperature that the PID controller is trying to reach, which will help ensure that the grouphead reaches your desired temperature for espresso extraction. Use a probe to measure the actual temperature at the grouphead and adjust the offset accordingly until you achieve the desired taste. Don’t be alarmed if you measure an offset of 10–20 degrees Celsius between the thermocouple reading and the actual grouphead temperature. This is normal for machines like the DeLonghi ECP that do not have a thermocouple located directly at the grouphead.
  4. I have my temperature offset dialed-in, but my coffee still tastes underextracted or sour. What else could be wrong?

    • According to odor4fun, the mushroom valve inside the DeLonghi machines requires at least 4-bars of pressure to hold open. If your pump is not generating enough pressure to extract properly, the mushroom valve may not be opening fully. This can lead to underextraction. If your shots still don’t taste correct after dialing in the temperature offset, increase the pressure values in all phases of your preferred profile(s) by plus 4. This should help ensure the mushroom valve is opening fully and allow for proper extraction.

    For more troubleshooting tips, please check the GaggiMate Troubleshooting Documentation. The ones mentioned above are commonly observed in DeLonghi ECP machines, but the troubleshooting documentation contains resolutions for a wide variety of issues.

Congratulations!

Welcome to the world of turbocharged espresso! Now you can extract café-quality shots from a compact, affordable machine that rivals the big names at a fraction of the cost.

Acknowledgements

  • Flavius for successfully being the first (as far as we know) to install GaggiMate on a DeLonghi ECP, answering a ton of questions, and helping identify the required components.
  • mdwasp for also providing a lot of information, and for being the creator of the GaggiMate project.
  • TorxFighter for doing a lot of tinkering and sharing awesome 3D-prints specific to our beloved little DeLonghis.
  • Abunchahicks for wiring assistance and general knowledge and helpfulness.
  • Stuart for technical support and clever mounting ideas (e.g. a DIN rail).
  • Prowler for a 2.8” screen print.
  • odor4fun for sharing his knowledge about the mushroom valve and how to optimize pressure values for better extraction.
  • The GaggiMate team for their incredible work and contributions.

Have questions?

Still have questions? Join the Discord!