Aller au contenu principal

Configuration des imprimantes par marque

L'agent trouve les imprimantes tout seul :

  • Imprimantes du système : toutes les imprimantes installées dans Windows, macOS (CUPS) ou Linux (CUPS).
  • Imprimantes thermiques USB sans pilote du système.
  • Imprimantes réseau sur le port 9100, quand la découverte réseau est activée (printers.discovery.network) ou quand elles sont ajoutées à la main.
  • Imprimantes série et Bluetooth (SPP) ajoutées à la main.

Les imprimantes qui ne peuvent pas être découvertes s'ajoutent dans la configuration de l'appareil (Tableau de bord → Configuration) :

{
  "printers": {
    "manual": [
      {
        "name": "Kitchen",
        "connection": "network",
        "address": "192.168.1.50:9100",
        "kind": "thermal",
        "paper": "80mm"
      },
      { "name": "Bar", "connection": "serial", "address": "COM3", "serial": { "baudRate": 19200 } }
    ],
    "aliases": { "receipt": "prn_7f3a", "kitchen": "prn_91cc" }
  }
}

Donnez des alias aux imprimantes (receipt, kitchen, label) pour que votre code ne dépende pas des ID d'imprimante, qui changent d'un ordinateur à l'autre. Lancez jodaprint-agent status pour voir l'ID et l'état de chaque imprimante.

L'agent choisit un profil d'après le nom de l'imprimante (epson-tm, star-tsp, xprinter, rongta, sunmi-cloud, generic-80mm, generic-58mm). Le profil définit le nombre de caractères par ligne, la table des pages de code, et si l'imprimante prend en charge les QR codes natifs, un buzzer et l'état en temps réel.

Epson (TM-T20, TM-T88, TM-m30…)​

  • USB : installez le pilote Windows d'Epson (« EPSON Advanced Printer Driver ») ou utilisez l'imprimante sans pilote ; les deux fonctionnent. Avec le pilote, l'état de l'imprimante vient uniquement du spouleur Windows.
  • Réseau : fixez une adresse IP (maintenez le bouton d'avance papier à l'allumage pour imprimer les paramètres réseau) et ajoutez l'imprimante en network, port 9100. L'état en temps réel (plus de papier, capot ouvert) fonctionne en réseau.
  • La page de code CP858 imprime les accents du français et du créole.

Star (TSP100, TSP650, mC-Print)​

  • Mettez l'imprimante en mode émulation ESC/POS (avec l'utilitaire de Star, ou les commutateurs DIP sur les anciens modèles). L'agent envoie de l'ESC/POS à toutes les marques.
  • Les modèles TSP100 « futurePRNT » n'impriment les graphiques qu'en mode Star : préférez un modèle plus récent ou l'interface réseau en mode ESC/POS.

Xprinter, Rongta et autres imprimantes ESC/POS génériques​

  • Généralement vendues sans pilote : branchez-les en USB, et l'agent trouve l'imprimante. Sous Windows, installer le pilote « POS-80 » du fabricant fonctionne aussi.
  • Beaucoup de clones ont une table de pages de code plus petite. Si les accents sont faux, essayez CP850 ou CP1252 dans printers.defaults, et voir Dépannage.
  • Modèles 58 mm : définissez "paper": "58mm" dans printers.defaults.<printerId> si l'agent suppose du 80 mm.

Zebra (séries ZD, GK, GX) et autres imprimantes ZPL​

  • Installez le pilote Zebra (ZDesigner) ou ajoutez l'imprimante par son adresse IP (port 9100).
  • Envoyez des travaux zpl. L'agent transmet le ZPL sans modification ; la taille de l'étiquette vient de votre ZPL (^PW, ^LL).
  • Concevez vos étiquettes dans le tableau de bord avec les modèles et imprimez-les avec { templateId, data }.
  • Les imprimantes EPL (anciennes Zebra LP/TLP) acceptent les travaux epl.

Imprimantes d'étiquettes Brother QL et Dymo​

  • Ces imprimantes ne parlent pas le ZPL. Installez le pilote du fabricant ; l'imprimante apparaît alors comme une imprimante du système (kind: document).
  • Imprimez des travaux pdf ou image au format de l'étiquette (par exemple 62 mm de large pour une Brother QL, 54 × 25 mm pour une étiquette d'adresse Dymo) avec scale: "actual".
  • Choisissez la taille d'étiquette dans les préférences par défaut du pilote.

Imprimantes de bureau (laser, jet d'encre)​

Toute imprimante installée dans le système imprime les travaux PDF, image, texte et HTML. Voir PDF et documents.

Terminaux de caisse Android​

Les imprimantes intégrées des appareils Sunmi, PAX, iMin et Telpo sont détectées automatiquement. Voir Terminaux Android et shell WebView.