Quick wins for a faster PC:
Scan for outdated or missing drivers - takes under a minuteDriver Scan →Repair Windows errors before they cause bigger problemsFix Now →Some links on this page are affiliate links: if you buy through them we may earn a commission, at no extra cost to you.
To build a Raspberry Pi receipt printer, you need four essentials: a Raspberry Pi with Raspberry Pi OS, an 8 GB-or-larger microSD card, a USB or TTL-serial thermal receipt printer, and a separately regulated power supply that can handle the printer’s peak print-head current. Mini models commonly use 58 mm (2.25-inch) thermal rolls. USB is the simplest connection; TTL serial needs crossed TX/RX wires, a shared ground, correct voltage levels, and the printer’s baud rate. For software, Python 3 with Adafruit Blinka and the Adafruit CircuitPython Thermal Printer library suits application-controlled receipts, while CUPS is better for queued or networked jobs. Expect basic Linux administration, serial troubleshooting, and—if you make a permanent enclosure—soldering and mechanical mounting.
What parts do you need for a Raspberry Pi receipt printer?
A reliable build starts with a complete power and paper plan, not just the computer and printer. The following checklist covers a first prototype and leaves room for a more permanent installation.
As an Amazon Associate I earn from qualifying purchases.
| Part | What to specify | Why it matters |
|---|---|---|
| Raspberry Pi | Any model supported by your chosen Raspberry Pi OS release | Runs the print application, CUPS, or both. |
| microSD card | 8 GB or larger | Adafruit’s required-items guide specifies an 8 GB-or-larger card for Raspberry Pi OS. |
| Thermal receipt printer | USB or TTL serial; confirm ESC/POS support if you need raw commands | Determines cabling, drivers, baud-rate configuration, and available features. |
| Thermal paper | Usually 58 mm (2.25 inches) for mini printers; verify roll diameter too | Paper that is too wide will not feed correctly, and an oversized roll may not fit the printer bay. |
| Regulated power supply | At least 5 V and 2 A for the combined Pi/printer arrangement in Adafruit’s guide; some mini printers specify 5–9 V regulated and at least 1.5 A during high-current printing | The print head can draw substantially more current than idle electronics. Undersizing the supply causes resets, faded output, or feed failures. |
| Connection hardware | USB cable, DC barrel-jack adapter, jumper wires, or a USB-to-serial/FTDI adapter as required | The correct cable depends on whether the printer exposes USB, TTL pins, or a barrel power input. |
| Setup accessories | Network connection, monitor, keyboard, and mouse | These are listed in Adafruit’s setup requirements and make the initial OS and printer configuration easier. |
| Optional build hardware | Case, mounting hardware, pushbutton, status indicator, soldering tools, and strain relief | Useful when converting a bench prototype into a kiosk, counter unit, or embedded appliance. |
The two power figures describe different use cases rather than a contradiction. Adafruit’s Learning System guide (originally published in 2016 and updated in 2024) calls for a 5 V supply rated at 2 A or more for its Raspberry Pi printer arrangement. Pimoroni’s mini-printer specification calls for a regulated 5–9 V source capable of at least 1.5 A during high-current printing. Follow the rating printed for your exact printer, then leave practical headroom instead of selecting a supply that only meets the nominal value.
Which thermal printer interface is easiest with a Raspberry Pi?
USB is usually the easiest option because Linux exposes the printer as a USB device and you avoid manual serial wiring. TTL serial is flexible and common on inexpensive mini printers, but it requires correct signal routing, voltage-safe connections, and baud-rate matching.
#1 Best Overall
- Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
- Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
- Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
- Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
- 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.
| Consideration | USB printer | TTL-serial printer |
|---|---|---|
| Physical connection | Plug into a Pi USB port or powered hub. | Connect TX, RX, and ground; use a USB-to-serial adapter if the Pi’s GPIO serial pins are not convenient. |
| Initial setup | Usually faster; identify the USB device and select it in your application or CUPS. | More steps: enable the serial interface, identify the device, set framing and baud rate, and check permissions. |
| Typical troubleshooting | Cable, USB power, device permissions, and driver/filter selection. | Crossed TX/RX, missing common ground, wrong voltage level, wrong baud rate, and swapped device names. |
| Best fit | First projects, CUPS queues, and installations where a USB cable is acceptable. | Embedded builds, custom wiring, and printers that expose ESC/POS over a serial header. |
Do not assume that every printer described as “serial” accepts the same electrical levels. Confirm whether its pins are 3.3 V TTL, 5 V TTL, or another interface before connecting them to a Pi. A level-safe interface is preferable to gambling on GPIO protection.
How much power does a Raspberry Pi thermal printer need?
Power the printer from its specified regulated supply; do not attempt to drive its print head from a Raspberry Pi GPIO pin. The Pi’s GPIO output is a logic signal, not a high-current printer supply, and a voltage sag during printing can reboot the computer or corrupt a job.
The Tool Desk
Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →Outbyte Driver Updater FREEScan for outdated or missing drivers - takes under a minuteDriver Scan →- Read the printer label or manual for voltage range, connector polarity, and peak current.
- Use a regulated adapter within that voltage range. Pimoroni’s mini unit, for example, specifies 5–9 V regulated and at least 1.5 A during high-current printing.
- For an arrangement powered at 5 V, Adafruit’s guide specifies a 2 A-or-larger supply. Treat that as a minimum for that documented arrangement, not a universal rating for every model.
- Keep the printer’s high-current path separate from logic wiring. Join grounds where the interface requires a common reference, but do not route motor or heater current through GPIO traces or a breadboard jumper that was not designed for it.
- If the Pi and printer share an adapter, verify that the adapter and wiring can deliver the combined load. Otherwise, use separate regulated supplies and connect signal grounds as required by the interface.
Symptoms of inadequate power include a printer that works in its self-test but fails when printing dense lines, a Pi that resets as the paper advances, intermittent USB disconnects, or output that becomes pale partway through a receipt. Test with a short receipt first, then with the longest barcode, logo, or black area your application will generate.
How do you wire a TTL receipt printer to Raspberry Pi GPIO?
TTL wiring uses three basic signals: the printer’s transmit line, its receive line, and ground. The transmit and receive lines cross between devices.
- Run the printer’s self-test. Use the printer’s documented button or power-on procedure. Record the firmware information, interface type, and printed baud rate before changing software settings.
- Power the printer independently. Connect the regulated adapter to the printer’s barrel jack or power input. Do not feed the print head from a GPIO pin.
- Connect the data lines. Connect printer TX to the Pi’s RX, printer RX to the Pi’s TX, and printer GND to Pi GND. A USB-to-serial or FTDI adapter can replace the Pi GPIO serial pins when that is safer or more convenient.
- Check voltage levels. Verify that the printer’s logic voltage is safe for the Pi. Use a level shifter or a suitable adapter when it is not.
- Enable and identify the serial device. In Raspberry Pi OS, enable the serial interface without assigning a login console to the same port. Identify the resulting device name, such as
/dev/serial0or a USB adapter such as/dev/ttyUSB0. - Match serial settings. Set the baud rate printed by the self-test—9,600 and 19,200 are common values noted in Adafruit’s printer guidance—along with the printer’s documented data bits, parity, and stop bits.
- Send a short test. Print a few ASCII characters and a line feed before attempting barcodes or graphics. Garbled characters usually indicate a baud or framing mismatch; no output usually points to wiring, permissions, or the wrong device node.
Keep the wires short for a prototype and add strain relief in a finished enclosure. A loose ground can create failures that look like software bugs, especially when the printer motor starts.
Rank #2
- 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
- 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
- Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
- 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
- What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.
How do you prepare Raspberry Pi OS for printing?
Install Raspberry Pi OS on the microSD card, complete first-boot configuration, and make the serial or USB device usable by the account that will run the application.
Recommended Free Tools
- Flash Raspberry Pi OS to an 8 GB-or-larger microSD card, insert it, and complete the initial account and locale setup.
- Connect the Pi to the network, then apply the available operating-system updates before installing printer software.
- For a headless installation, enable secure remote access during setup or attach a monitor and keyboard for the first configuration.
- Plug in the printer and inspect the kernel’s device list. For USB, note the assigned
/dev/ttyUSB0,/dev/ttyACM0, or printer device; for GPIO serial, use the enabled serial alias. - Check permissions. The account running Python or the print service may need membership in the appropriate serial or printing group. Log out and back in after changing group membership.
- Record the device name in configuration rather than assuming it will never change. USB enumeration order can differ after reconnecting multiple adapters.
A monitor, keyboard, mouse, and network connection are not required once the system is stable, but Adafruit lists them as setup equipment because they simplify imaging, updates, and first-run diagnostics.
Should you use Python, CUPS, or raw ESC/POS?
Choose software according to who creates the receipt. Python direct control is best when your application decides the exact text and barcode content. CUPS is better when several computers submit jobs to one printer. Raw ESC/POS is the lowest-level option when you need model-specific commands and are prepared to verify the command dialect.
Python with Blinka and the thermal-printer library
Adafruit describes its CircuitPython Thermal Printer module as an easy way to use a thermal printer with CircuitPython or Python through the Blinka compatibility layer. The usual setup is Python 3, a virtual environment, Blinka, the thermal-printer package, and the correct serial device and baud rate.
python3 -m venv ~/receipt-env
source ~/receipt-env/bin/activate
python -m pip install --upgrade pip
python -m pip install adafruit-blinka adafruit-circuitpython-thermal-printer pyserialIn your program, open the printer’s USB or serial device with its documented baud rate, send text, and use the library’s barcode methods where supported. The CircuitPython implementation supports text and barcodes, but bitmap support is limited; do not design a logo-heavy receipt until you have confirmed what your specific library and printer can render. Keep the device path and baud rate in a configuration file so a hardware swap does not require editing application logic.
Rank #3
- Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
- Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
- Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
- Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
- What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.
CUPS for queued and networked jobs
CUPS adds spooling, scheduling, filtering, and queue management. It is the better fit when a point-of-sale application, another computer, or several users need to submit jobs without opening the serial port themselves. CUPS can rasterize output for thermal printers when the appropriate thermal-printer filter is installed.
- Install the CUPS packages supplied for your Raspberry Pi OS release.
- Enable and start the CUPS service, then add the account that administers printers to the system’s printer-administration group.
- Connect the printer and select its USB or serial backend in the CUPS administration interface.
- Install the model’s filter or a compatible ESC/POS thermal filter. If an exact model is not listed, verify paper width, character encoding, and raster behavior with a short test page.
- Set the queue as shared only when the network and authentication policy justify it. A shared queue should not be exposed broadly without access controls.
CUPS separates application output from the physical device, but that abstraction can hide printer-specific features. Test cutting, barcode density, code pages, and paper-feed commands before deploying a queue to a busy counter.
Raw ESC/POS commands
Many receipt printers expose an ESC/POS-style command language over USB or serial. Raw output gives precise control over alignment, emphasis, barcodes, QR codes, line feeds, and cutter commands, but command dialects and status responses vary by model. Confirm the printer’s supported commands and error behavior before depending on automatic cutting or paper sensors.
What paper width and receipt features should you compare?
Paper width affects every layout decision, from line length to barcode size. Mini units commonly use 58 mm (2.25-inch) rolls; 80 mm printers provide a wider receipt but require different paper, holders, and formatting.
Outdated Drivers Are Slowing You Down
One free scan finds every outdated or missing driver and matches the right update for your exact hardware.Free scan · exact hardware matchPC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11| Feature | Questions to answer before buying |
|---|---|
| Paper | Is the roll 58 mm/2.25 inches or 80 mm? What maximum roll diameter fits the enclosure? |
| Power | What regulated voltage and peak current does the exact model require? |
| Connection | Does it expose USB, TTL serial, or both? Is a USB-to-serial adapter needed? |
| Output | Does it handle plain text, barcodes, QR codes, and raster images through your chosen software? |
| Mechanics | Does it include an automatic cutter, paper-out sensor, cover sensor, or only a manual tear edge? |
| Linux integration | Is there a usable CUPS filter, or will your application send raw ESC/POS? |
| Enclosure | Where will the paper roll, power connector, cable strain relief, and tear edge sit? |
Design for the printer’s actual printable columns rather than the nominal roll width. Leave margins for the feed mechanism, keep barcodes at a scanner-friendly width, and test long item names, accented characters, and line wrapping. Many small printers require manual tearing even when the software can issue a feed command.
Rank #4
- Dual Converters, Infinite Potential：Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
- Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
- Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
- Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
- Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft
Which skills are needed to finish the project?
You do not need advanced electronics training, but a dependable build combines several basic skills.
- Linux administration: imaging Raspberry Pi OS, updating packages, reading logs, managing services, and changing group permissions.
- Python fundamentals: creating a virtual environment, installing packages, handling exceptions, and separating receipt data from printer commands.
- Serial troubleshooting: identifying
/dev/tty*devices, matching baud and framing, and recognizing the difference between a permissions error and garbled serial data. - Low-voltage wiring: identifying TX, RX, and GND, sharing a reference ground, checking logic levels, and avoiding GPIO overcurrent.
- Receipt layout: controlling line width, alignment, character encoding, barcode and QR-code sizing, feed length, and manual tear position.
- Mechanical assembly: soldering permanent joints, adding strain relief, mounting the printer, and leaving access for paper replacement.
- Operational testing: testing empty, short, dense, and long receipts; recovering from paper-out conditions; and deciding how the application reports a failed print.
What should you test before putting the printer into service?
Use a staged test so a hardware fault does not get mistaken for an application problem.
- Print the printer’s built-in self-test and confirm paper direction, firmware, and interface settings.
- Print a plain text line through the operating system or Python library.
- Print a receipt at the intended maximum line width and verify wrapping.
- Test one barcode and one QR code if your workflow needs them.
- Disconnect and reconnect USB or serial power to verify that the application handles device disappearance cleanly.
- Run a dense black or long receipt while watching for Pi resets, faded output, or motor stalls that indicate inadequate power.
- Test paper-out, cover-open, and manual-tear behavior. Document what the operator should do and how the software reports the failure.
- After soldering or enclosing the project, repeat the tests with the lid closed and all cables under their expected strain.
How do you troubleshoot common failures?
| Symptom | Likely causes | Checks and fixes |
|---|---|---|
| No device appears | Bad cable, missing power, disabled serial interface, or wrong adapter | Verify the printer’s power LED and self-test, replace the cable, inspect the device list, and confirm the interface is enabled. |
| Garbled characters | Wrong baud rate, parity, data bits, or stop bits | Rerun the self-test, copy its serial settings exactly, and make sure the application uses the same framing. |
| Nothing prints over TTL | TX/RX not crossed, no common ground, unsafe level conversion, or permission denial | Check printer TX to Pi RX and printer RX to Pi TX, connect grounds, verify levels, and test access as the service account. |
| Pi reboots during printing | Supply or wiring cannot handle print-head and motor peaks | Use the printer’s specified regulated voltage, increase current capacity, shorten high-current wiring, and keep printer power off GPIO. |
| Paper feeds but output is blank | Wrong paper orientation, incompatible paper, or a print command the model does not understand | Confirm that the roll is thermal and loaded with its heat-sensitive side facing the print head, then test plain text with the printer’s documented command set. |
| Text is clipped or wrapped oddly | Application assumes the wrong paper width or character mode | Configure the actual 58 mm or 80 mm width, reduce line length, and test the printer’s code page and font settings. |
| CUPS job remains queued | Missing filter, backend, or device permission | Inspect the queue and service logs, verify the selected backend, and test the printer directly before changing application code. |
What is the most practical build path?
For a first project, choose a USB mini printer that accepts 58 mm rolls, use the printer’s specified regulated adapter, and start with a short Python receipt. Once text and barcodes work, decide whether you need CUPS for shared queues or raw ESC/POS for model-specific features. Move to TTL serial only when the enclosure or hardware design benefits from it, and make the serial self-test, power rating, and wiring diagram part of your project documentation.
A durable Raspberry Pi receipt printer is therefore a small Linux-and-electronics system, not merely a script connected to a USB cable. The critical decisions are safe power, matching paper, correct interface settings, and a software path that fits the way jobs arrive.
Frequently Asked Questions
Can I print images or logos from a Raspberry Pi receipt printer?
It depends on the printer and software path. The CircuitPython thermal-printer implementation has limited bitmap support, while CUPS can rasterize output when a suitable thermal filter is installed; raw ESC/POS may offer model-specific raster commands.
Best Value
- 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
- Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
- Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
- HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
- What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.
Do I need a GPIO connection if my printer has USB?
No. A USB model can use a Pi USB port or a powered hub, so TX/RX wiring and GPIO voltage-level concerns are avoided. You still need the printer’s separate regulated power source and appropriate Linux permissions.
How can I find the correct serial baud rate?
Run the printer’s built-in self-test and read the printed interface settings. Common values include 9,600 and 19,200, but the self-test for your particular firmware is the authority.
Free tools Windows power users keep installed
One-click scans. No signup required.
Is 58 mm paper interchangeable between all mini receipt printers?
The width is common, but roll diameter, core size, and the printer’s paper bay still need to match. Confirm those dimensions and load the roll so the heat-sensitive side faces the print head.
Why does a printer work in a self-test but fail from my program?
A self-test bypasses your operating-system device selection, permissions, baud setting, and command format. Compare the program’s device path and serial framing with the self-test, then send a minimal plain-text command before testing barcodes or graphics.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
