ESC/POS Thermal Printer voor Home Assistant (Marketplace-integratie)

Installaties: 115 die analysegegevens delen
GitHub-sterren: 115
Verbinding: Werkt lokaal
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: v1.2.0, 26 oktober 2026
Categorie: Computers en netwerk, Printers
Soort: Marketplace-integratie
Vereist: Vereist de Marketplace (HACS op 2026.10 en ouder)
Domein: escpos_printer
Bron: github.com/cognitivegears/ha-escpos-thermal-printer
Problemen: Probleem melden

Onafhankelijk overzicht, gemaakt door de ontwikkelaar van Vulpo. Niet gelieerd aan Home Assistant of de Open Home Foundation.

Screenshots Uit de README van cognitivegears/ha-escpos-thermal-printer.

Over dit item

ESC/POS Thermal Printer is een integratie die vanuit automatiseringen van Home Assistant afdrukt op thermische printers via netwerk, USB, serieel of Bluetooth. Het voegt acties toe voor het afdrukken van opgemaakte tekst, QR-codes, barcodes, kaders, tabellen en afbeeldingen van URL's, bestanden, camera-entiteiten of afbeeldingsentiteiten. Andere acties regelen de papiertoevoer, het afsnijden en de zoemer, en sommige tonen een voorbeeld van een opmaak of afbeelding als bestand zonder papier te gebruiken. Sensoren melden de papierstatus, de status van het deksel, de onlinestatus, de laatste afdruk en de batterij, en knoppen op het apparaat voeren papier door, snijden af, laten een piep horen of drukken een testpagina af. Een begeleide kalibratiewizard drukt testpagina's af om de papierbreedte, het aantal kolommen, de codering en de afbeeldingsmethode te meten en slaat daarna de resultaten op. Het werkt lokaal zonder cloud, wordt ingesteld in de gebruikersinterface en kan sommige printers zelf vinden.

Automatische samenvatting van de README en de code van cognitivegears/ha-escpos-thermal-printer, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op

Ondersteunt

Werkt lokaal Praat met je apparaten op je eigen netwerk. Geen cloud van de aanbieder ertussen.
Wordt vanzelf gevonden Home Assistant vindt het op het netwerk en biedt aan om het toe te voegen.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.

Levert

Sensoren

Instellen

Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.

Verbindingstype

VerbindingstypeKies Netwerk voor printers die via TCP/IP zijn verbonden of USB voor direct aangesloten printers.

USB-printer bevestigen

PrinterprofielSelecteer je printermodel, of Generic (no profile) als het er niet bij staat. Modellen onder een andere merknaam verschijnen als "(compatible)"-items.

Netwerkprinter configureren

HostIP-adres of hostnaam van de printer.
PoortNetwerkpoort (meestal 9100).
Time-out (seconden)Time-out voor de verbinding in seconden.
PrinterprofielSelecteer je printermodel, of Generic (no profile) als het er niet bij staat. Modellen onder een andere merknaam verschijnen als "(compatible)"-items. Kies 'Custom' om handmatig een profielnaam in te voeren.

USB-printer configureren

USB-apparaatSelecteer je printer uit de gevonden USB-apparaten.
Time-out (seconden)Time-out voor de verbinding in seconden.
PrinterprofielSelecteer je printermodel, of Generic (no profile) als het er niet bij staat. Modellen onder een andere merknaam verschijnen als "(compatible)"-items.

USB-apparaat selecteren

USB-apparaatSelecteer je printer uit alle aangesloten USB-apparaten.
Invoereindpunt (geavanceerd)Laat dit op de standaardwaarde (130) staan, tenzij je printer niet werkt. Dit is het USB-adres voor het ontvangen van de status van de printer.
Uitvoereindpunt (geavanceerd)Laat dit op de standaardwaarde (1) staan, tenzij je printer niet werkt. Dit is het USB-adres voor het verzenden van gegevens naar de printer.
Time-out (seconden)Time-out voor de verbinding in seconden.
PrinterprofielSelecteer je printermodel, of Generic (no profile) als het er niet bij staat. Modellen onder een andere merknaam verschijnen als "(compatible)"-items.

Handmatige USB-configuratie

Vendor IDUSB Vendor ID. Gebruik de hex-notatie met 0x-voorvoegsel zoals getoond door lsusb / discovery, bijvoorbeeld 0x04B8 (aanbevolen). Een gewoon decimaal getal wordt ook geaccepteerd.
Product IDUSB Product ID. Gebruik de hexadecimale vorm met 0x-prefix, bijvoorbeeld 0x0E03. Een gewoon decimaal getal wordt ook geaccepteerd.
Invoereindpunt (geavanceerd)Laat dit op de standaardwaarde (130) staan, tenzij je printer niet werkt. Dit is het USB-adres voor het ontvangen van de status van de printer.
Uitvoereindpunt (geavanceerd)Laat dit op de standaardwaarde (1) staan, tenzij je printer niet werkt. Dit is het USB-adres voor het verzenden van gegevens naar de printer.
Time-out (seconden)Time-out voor de verbinding in seconden.
PrinterprofielSelecteer je printermodel, of Generic (no profile) als het er niet bij staat. Modellen onder een andere merknaam verschijnen als "(compatible)"-items.

Bluetooth-printer configureren

Bluetooth-apparaatSelecteer je printer uit de lijst met gekoppelde Bluetooth-apparaten.
Time-out (seconden)Time-out voor de verbinding in seconden.
PrinterprofielSelecteer je printermodel, of Generic (no profile) als het er niet bij staat. Modellen onder een andere merknaam verschijnen als "(compatible)"-items.
RFCOMM-kanaalRFCOMM-kanaal (bijna altijd 1 voor ESC/POS-printers; voer 'bluetoothctl info [MAC]' uit op de host en zoek de regel 'Channel:' van de SerialPort-service-record om dit te controleren).

Handmatige Bluetooth-configuratie

MAC-adresBluetooth MAC-adres in de notatie AA:BB:CC:DD:EE:FF.
RFCOMM-kanaalRFCOMM-kanaal (bijna altijd 1 voor ESC/POS-printers).
Time-out (seconden)Time-out voor de verbinding in seconden.
PrinterprofielSelecteer je printermodel, of Generic (no profile) als het er niet bij staat. Modellen onder een andere merknaam verschijnen als "(compatible)"-items.

Na het instellen

Time-out (seconden)Time-out voor de verbinding in seconden.
PrinterprofielSelecteer je printermodel. Als je dit wijzigt, worden de coderingsopties teruggezet.
TekencoderingTekencodering of codepage voor tekst.
Tekens per regelAantal tekens per regel (kolommen). Kies een voorinstelling of typ een eigen aantal.
Papierbreedte in pixels (optioneel)Overschrijft de afdrukbare breedte van het profiel voor afbeeldingen. Laat leeg om het profiel te gebruiken. Gangbare waarden: 384 (58 mm), 576 (80 mm).
StandaarduitlijningStandaard tekstuitlijning bij het afdrukken.
Standaard snijmodusStandaard snijmodus voor het papier na het afdrukken.
Betrouwbaarheidsprofiel voor afbeeldingenKiest veilige standaardwaarden voor de grootte van afbeeldingsblokken, de pauze tussen blokken en het ESC/POS-afbeeldingscommando. Opties van een serviceaanroep hebben altijd voorrang.
Implementatie voor afbeeldingen afdrukkenESC/POS-commandoset die wordt gebruikt om afbeeldingen af te drukken. Auto volgt het printerprofiel; overschrijf dit als afbeeldingen vervormd worden afgedrukt of mislukken.
Permanente verbinding behoudenHoud de verbinding open tussen afdruktaken (alleen netwerkprinters).
Interval voor statuscontrole (seconden)Hoe vaak de printerstatus wordt gecontroleerd (0 om uit te schakelen).
Lokale afbeeldings-URL's toestaanStaat toe dat print_image_url (en de andere afbeeldingsservices) URL's ophaalt die verwijzen naar privé-, LAN- of loopback-adressen en niet-standaardpoorten gebruikt (bijvoorbeeld een lokale camera, een Frigate-proxy op :5000 of je Home Assistant-instantie op :8123). Standaard uit. Cloud-metadata- en link-local-adressen blijven geblokkeerd, ook als dit is ingeschakeld.
Schrijfblokgrootte (bytes)Maximaal aantal bytes per schrijfaanroep. Stel in op 128 voor ESPHome/ESP32-seriële proxy's om bufferoverloop te voorkomen. 0 schakelt blokverdeling uit.
Pauze tussen blokken (ms)Pauze tussen opeenvolgende blokken (milliseconden). Geeft het ontvangende apparaat tijd om de buffer te legen. Geldt alleen als de blokgrootte niet nul is.
Actie
Patronen die schoon zijn afgedrukt
Actie
Breedste vak met een intacte rechterrand
Actie
Tekens op de eerste regel
Actie
Regels die overeenkomen met hun eigen verwachte tekst
Actie
Printermodel (optioneel, voor de deellink)
Actie
ProfielnaamDe exacte profielsleutel uit escpos-printer-db.

Teksten uit de code van cognitivegears/ha-escpos-thermal-printer. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

Entiteiten

Binaire sensorenOnline, Deksel open
KnoppenPapier doorvoeren, Papier afsnijden, Piep, Voorbeeldtestafdruk
SensorenLaatste afbeeldingsafdruk, Laatste afdruk, Batterij, Papierstatus

Acties

PiepActiveer de zoemer van de printer (indien ondersteund). Selecteer een doel: printerapparaat, entiteit, gebied, verdieping of label. Als er geen doel is geselecteerd, wordt er op elke geconfigureerde printer afgedrukt (verouderde terugvaloptie).Velden: Uitzenden, Duur, Aantal keer
Ditherteststrook afdrukkenDruk een kalibratievel af, met een pixelliniaal en een drempelstrook, om de dither- en drempelinstellingen voor afbeeldingen af te stemmen (niet de kalibratiewizard van de printer, zie de documentatiepagina Kalibratie). Verbruikt ongeveer 10 cm papier. Als er geen doel is geselecteerd, wordt er op elke geconfigureerde printer afgedrukt (verouderde terugvaloptie).Velden: Uitzenden, Afsnijden, Doorvoerregels
Papier afsnijdenSnijd het papier af. Selecteer een doel: printerapparaat, entiteit, gebied, verdieping of label. Als er geen doel is geselecteerd, wordt er op elke geconfigureerde printer afgedrukt (verouderde terugvaloptie).Velden: Uitzenden, Doorvoeren voor afsnijden, Modus
Papier doorvoerenVoer het papier een aantal regels door. Selecteer een doel: printerapparaat, entiteit, gebied, verdieping of label. Als er geen doel is geselecteerd, wordt er op elke geconfigureerde printer afgedrukt (verouderde terugvaloptie).Velden: Uitzenden, Regels
Voorbeeld van kader (geen papier)Voer de print_box-lay-outpipeline uit en schrijf de weergegeven tekst naar een .txt-bestand WITHOUT het af te drukken. Zo kun je randen, opvulling en breedte uitproberen zonder papier te verspillen. De velden cut en feed zijn bewust weggelaten, want een tekstbestand heeft geen papier. Geeft path, width, line_count en codepage terug als antwoordgegevens van de service. Schakel "Return response data" in Developer Tools in om de waarden te zien.Velden: Uitlijning, Apparaat, Uitvoerpad, Opvulling, Randstijl, Tekst, Totale breedte
Voorbeeld van afbeelding (geen papier)Voer de volledige afbeeldingspipeline uit (dither, formaat wijzigen enzovoort) en schrijf de 1-bit PNG naar schijf WITHOUT deze af te drukken. Geeft het uitvoerpad terug, zodat automatiseringen een melding kunnen koppelen. Opties voor communicatie met de printer (high density, impl, fragment height, chunk delay, center, cut, feed) zijn hier niet beschikbaar, omdat ze geen effect hebben op het bestand dat naar schijf wordt geschreven. Ze zijn alleen van belang bij het streamen naar een echte printer.Velden: Uitlijning, Grote bronnen automatisch verkleinen, Autocontrast, Apparaat, Ditheringmodus, Reserveafbeelding, Afbeelding, Breedte (pixels), Kleuren omkeren, Horizontaal spiegelen
Voorbeeld van tabel (geen papier)Voer de print_table-lay-outpipeline uit en schrijf de weergegeven tekst naar een .txt-bestand WITHOUT het af te drukken. Zo kun je kolombreedtes, uitlijning en randen uitproberen zonder papier te verspillen. De velden cut en feed zijn bewust weggelaten, want een tekstbestand heeft geen papier. Geeft path, width, line_count en codepage terug als antwoordgegevens van de service. Schakel "Return response data" in Developer Tools in om de waarden te zien.Velden: Kolomuitlijningen, Kolombreedtes, Apparaat, Koprij, Uitvoerpad, Rijscheidingen, Rijen, Randstijl, Totale breedte
Barcode printen
Afbeelding afdrukken (gemengde bron)Druk een afbeelding af vanaf een URL, bestandspad, camera.[id], image.[id] of base64-data-URI. Automatiseringen kunnen voor dit veld nog steeds een Jinja-template gebruiken, want Home Assistant rendert die voordat de service wordt aangeroepen, maar het veld zelf is een gewone tekenreeks die niet op de server wordt geëvalueerd. Voor een prettigere interface gebruik je liever de specifieke services (Afbeelding afdrukken vanaf URL, vanaf pad, Camerasnapshot, Afbeeldingsentiteit), zie docs/images.md. Als er geen doel is geselecteerd, wordt er op elke ingestelde printer afgedrukt (verouderde terugvaloptie).Velden: Uitlijning, Grote bronnen automatisch verkleinen, Autocontrast, Naar alle printers, Blokvertraging (ms), Snijden, Ditheringmodus, Reserveafbeelding, Aantal regels doorvoeren, Fragmenthoogte
Afbeeldingsentiteit afdrukkenDruk het huidige beeld van een Home Assistant-afbeeldingsentiteit af (weerradar, ML-overlay, gegenereerde grafiek enzovoort). Als er geen doel is geselecteerd, wordt er op elke ingestelde printer afgedrukt (verouderde terugvaloptie).Velden: Uitlijning, Grote bronnen automatisch verkleinen, Autocontrast, Naar alle printers, Blokvertraging (ms), Snijden, Ditheringmodus, Reserveafbeelding, Aantal regels doorvoeren, Fragmenthoogte
Afbeelding afdrukken vanaf padDruk een afbeelding af vanaf een lokaal bestandspad. Het pad moet binnen een van de allowlist_external_dirs van Home Assistant liggen (meestal /config of /media, voeg indien nodig mappen toe onder homeassistant -> allowlist_external_dirs in configuration.yaml). Als er geen doel is geselecteerd, wordt er op elke ingestelde printer afgedrukt (verouderde terugvaloptie).Velden: Uitlijning, Grote bronnen automatisch verkleinen, Autocontrast, Broadcast, Chunkvertraging (ms), Afsnijden, Ditheringmodus, Terugvalafbeelding, Invoerregels, Fragmenthoogte
Afbeelding afdrukken vanaf URLDruk een afbeelding af die via een HTTP(S)-URL is opgehaald. Met SSRF-bescherming: privé-adressen, loopback-adressen en link-local-adressen worden geweigerd. Als er geen doel is gekozen, wordt op elke ingestelde printer afgedrukt (verouderde terugval).Velden: Uitlijning, Grote bronnen automatisch verkleinen, Autocontrast, Broadcast, Chunkvertraging (ms), Afsnijden, Ditheringmodus, Terugvalafbeelding, Invoerregels, Fragmenthoogte
Sleutel/waarde-tabel afdrukkenDruk een tabel met twee kolommen af, label en waarde: kassabontotalen, sensormetingen, ingrediëntenlijsten. Labels staan links uitgelijnd, waarden volgens "value_align" (standaard rechts). Als er geen doel is gekozen, wordt op elke ingestelde printer afgedrukt (verouderde terugval).Velden: Broadcast, Afsnijden, Invoerregels, Items, Labelbreedte, Randstijl, Totale breedte, Uitlijning van waarden
Opgemaakt bericht afdrukkenDruk een bericht af met volledige tekstopmaak (vet, onderstreept, grootte, uitlijning) plus een optionele afbeeldingsbijlage die als één ononderbroken bon wordt afgedrukt. Richt zich op een ESC/POS-notify-entiteit. Zie docs/images.md.Velden: Uitlijning, Vet, Afsnijden

Probleemoplossing

DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.

Uit de README

Print receipts, labels, QR codes, and more from Home Assistant automations. Connect any ESC/POS capable network, USB, bluetooth, or serial thermal printer and start printing in minutes.
Print text with formatting (bold, underline, alignment, font sizes, invert, density, font)
Print QR codes, barcodes, and images from URLs, files, camera/image entities, or base64 (guide)
Text effects: boxes, multi-column tables, and custom-font / rotated text (guide)
Paper feed and cut control
Paper status sensor (network/USB): automate on paper low / paper out
Cover-open sensor (network/USB): automate on a stuck-open lid
Last-print timestamp sensor: automate on "no receipt printed today"
Image-print diagnostics sensor: success/failure counts and last-print details for tuning image options (guide)
Buzzer/beeper support
UTF-8 text with automatic character conversion
35+ printer profiles with automatic feature detection, plus 23 rebadged/clone models available directly as "(compatible)" dropdown entries
Guided calibration wizard: prints test pages to measure image implementation, paper width, columns, and codepage, then saves them for you (guide)