The Pocket 6: A Pocket-Sized ESP32 Touchscreen Synth


This is a handheld synth that lives entirely on a touchscreen. One octave of keys along the bottom, seven sliders along the top, a resonant filter, an LFO you can crank all the way into audio-rate chaos, and three presets that remember themselves when you switch it off.

Under the hood it's one ESP32 display board, one little speaker and a 3D-printed case. No soldering iron required.

One warning before you click buy: the board matters. The code is written for one specific Freenove display, so read Step 1 first.

 

What you'll need

Parts:

  • 1× Freenove ESP32 Display, 2.8 inch, ST7789 version (Freenove labels it FNK0103B; their newer docs list the same size and driver as FNK0114B_2P8)
  • 1× 8Ω 1W speaker with a PH1.25mm plug (the board doesn't include one)
  • 1× USB C cable (power + programming)
  • A small amount of 3D-printing filament, I used black, with yellow for the trim.

Tools:

  • 3D printer
  • Computer to program the board (Mac or Windows)
  • Arduino IDE (free)


Step 1 — Get the right board

The Pocket 6 runs on the Freenove ESP32 Display, 2.8 inch, ST7789 version. That's an ESP32-WROOM-32E with a 240×320 resistive touchscreen, a speaker connector, an SD card slot and an RGB LED, all on one board.

Freenove make this display in six versions, and the code only suits one of them:

  • Get: the 2.8 inch with the ST7789 screen driver (the B model)
  • Don't get: the 2.4, 3.2, 3.5 or 4.0 inch versions, or the 2.8 inch version with an ILI9341 driver (FNK0114F_2P8). They look similar, but the screen driver or resolution is different, so the display setup won't match
  • Other cheap yellow display boards (the ESP32-2432S028R type) use different pins and I haven't tried the Pocket 6 on them
  • Before you order, check the listing says 2.8 inch and ST7789.
 

 

Step 2 — Print the case

Print files are here:  https://makerworld.com/en/models/3549239 (MakerWorld).

Print settings

  • Printer:  P2S
  • Material: PLA
  • Layer height: 0.20
  • Supports: No
  • Colours: I did black main with yellow highlights, it's up to you, make awesome combos. 

There are only 2 parts, top and bottom and they snap together. 


Step 3 — Plug in the speaker

The board has a speaker socket (PH1.25mm). Buy an 8Ω 1W speaker with the plug already on the end and push it in. Nothing to solder.

 

Step 4 — Fit the board and speaker to the case

  • Lay the front panel face down, place the board into the front panel hole.
  • Place the speaker into the holder on the front panel.
  • With the board and speaker in place on the front panel, clip the rear panel in place, it just snaps together.



Step 5 — Install the USB driver and Arduino IDE

The board talks to your computer through a CH340 chip, so you need the CH340 driver first. Download it from WCH (wch-ic.com), or grab it from Freenove's package (github.com/Freenove/Freenove_ESP32_Display). Mac users: restart afterwards.
Install the Arduino IDE from arduino.cc/en/software

 

Step 6 — Add ESP32 support to the IDE

  • Open the Boards Manager, search for esp32 and install esp32 by Espressif Systems, version 3.2.0. That's the version Freenove's own guide uses.  
  • Go to Tools, then Board, and pick ESP32 Dev Module
  • Go to Tools, then Upload Speed, and choose 115200 (this seems to work better)
 

 Step 7 — Install the libraries

Freenove bundle the libraries this board needs, so do it their way:

  • Download each of these: TFT_Touch_vx.x.x.zip, TFT_eSPI_Setups_vx.x.zip and TFT_eSPI_vx.x.x.zip. This is the link to the libraries https://github.com/Freenove/Freenove_ESP32_Display/tree/main/Libraries/FNK0114B_2.8inch_ST7789
  • Click each ZIP, then use the download icon on its page. 
  • In the Arduino IDE choose Sketch, then Include Library, then Add .ZIP Library, and pick each of the three ZIPs you downloaded.
  • When the IDE offers library updates, click Later. Freenove warn that newer versions can break compiling

note: You really need these specific libraries installed. If you already have them from a previous project you need to start a new library folder and change the sketchbook location in Arduino/settings. Then reinstall the fresh libraries as per step 7

 

Step 8 — Upload the code

The Pocket 6 screen should appear, ready to play on preset 1.

 


Step 9 — Play

That's it, you've built a Pocket 6.

The keys: one octave, C to C, with OCT - and OCT + to shift it up and down. HOLD keeps a note sounding after you let go, so you can twist sliders while it rings. The screen only reads one finger at a time, so HOLD is how you play a note and tweak at once.

The sliders:

  • VOL: volume
  • RATE: LFO speed. The bottom of the slider is a slow wobble, and the top fifth is the crank zone, all the way up to about 500Hz where the LFO turns into audio
  • DEPTH: how much LFO you get
  • MOD: where the LFO goes. Down is pitch (vibrato), up is the filter (wobble)
  • WAVE: morphs the main oscillator from saw to square
  • CUTOFF: the filter cutoff
  • RES: filter resonance. Push it up with the cutoff low for the squelch

The presets: tap P1, P2 or P3 to recall a sound. Hold one for about a second to save what you're hearing into it. They're stored in the board's flash memory, so they're still there after you switch it off, and it powers up on P1. They start out as a bass, a wobble and a lead, so save over them as soon as you like. Touch any slider or the octave buttons and the highlight goes out, so you know the sound no longer matches the preset.

 


 

What's going on inside

It's a classic little subtractive synth: two slightly detuned oscillators and a sub-oscillator go into a resonant low-pass filter, and one LFO can move the pitch, the filter, or a blend of both. The ESP32's built-in DAC is only 8-bit, so it has a gritty, lo-fi edge that suits it. The sound runs on one core of the ESP32 while the screen and touch run on the other, which keeps the sound smooth while the screen redraws.

Make it yours

Everything below is near the top of the sketch:

  • Colours: change the C_YELLOW, C_YELLOW_LT and C_BK_LIT lines to match your own case
  • Starting sounds: edit the factoryPreset list
  • Touch polling: IDLE_POLL_MS, SLIDER_POLL_MS and KEY_POLL_MS control how often the touch chip is read. Slower polling means less noise leaking into the speaker
  • LFO and filter ranges: these are in the audio section if you want a faster LFO or a different filter sweep

If something goes wrong

  • Screen is blank, white or garbled: wrong board version (see Step 1) or the display library isn't set up for this board
  • Compile error about TFT_eSPI.h or TFT_Touch.h: a library isn't installed. Go back to Step 7, and don't update the libraries
  • No sound: check the speaker plug is fully in, the VOL slider is up, and you're touching a key. The amp is switched on by pin GPIO4 going LOW
  • A faint whine at idle: that's touch polling noise leaking into the amp. Increase the poll times, and keep the speaker wires short and away from the screen ribbon
  • Want to wipe the presets: in the Tools menu turn on Erase All Flash Before Sketch Upload, upload once, then turn it back off
  • Taps land in the wrong place: run Freenove’s Sketch_11.1 touch calibration and copy its numbers into XMIN, XMAX, YMIN, YMAX and XYSWAP at the top of the sketch. 

From here the real fun is in modifying: new waveforms, new presets, a different colour scheme, or a different-looking case.

One final note: all work is mine but I did have help from Claude with the code, particularly the library interface stuff with the display and touch functions.

Code is licensed CC BY-NC-SA 4.0 (credit me, non-commercial, share alike).

Happy noise making.

 











 

Post a Comment

0 Comments