C# (C Sharp)

C# – Enviar datos ESC POS a impresora térmica

En este post vamos a ver cómo usar C# nativamente para abrir una impresora térmica como un archivo y enviarle bytes o datos entre los cuales puede haber comandos ESC POS.

Recuerda que yo ya tengo un plugin que permite imprimir en impresoras térmicas y expone una API HTTP consumible desde cualquier lenguaje de programación para que tú lo uses y no implementes tu propia librería, pero si quieres ver cómo se hace sigue leyendo.

Conectando con impresora térmica en C#

Para comunicarnos con la impresora térmica en Visual Studio debemos abrirla como si de un archivo se tratase.

Antes de abrirla, debemos compartirla. Esto es porque vamos a usarla como si fuera una impresora de red.

Luego importamos la función SafeFileHandle de kernel32.dll y abrimos nuestra impresora:

SafeFileHandle fh = CreateFile(ubicacionCompletaImpresora, FileAccess.Write, 0, IntPtr.Zero, FileMode.OpenOrCreate, 0, IntPtr.Zero);

En este caso la ubicación completa de la impresora es la concatenación del hostname y el nombre de la impresora compartida usando dobles barras invertidas \\.

string ubicacionCompletaImpresora = string.Format("\\\\{0}\\{1}", System.Environment.MachineName, nombreImpresora);

Imprimir en impresora térmica desde C#

Ahora que tenemos a la impresora abierta como un archivo podemos escribirle datos y si esos datos siguen el protocolo ESC POS entonces podremos explotar el potencial de la impresora.

var impresoraComoArchivo = new FileStream(fh, FileAccess.ReadWrite);
impresoraComoArchivo.WriteByte(0x1b); // ESC
impresoraComoArchivo.WriteByte(0x40); // @
impresoraComoArchivo.Write(Encoding.ASCII.GetBytes(textoParaImprimir), 0, textoParaImprimir.Length);
impresoraComoArchivo.WriteByte(0x1b); // Feed
impresoraComoArchivo.WriteByte(Convert.ToByte('d'));
impresoraComoArchivo.WriteByte(Convert.ToByte(1)); // 1 línea
impresoraComoArchivo.Dispose();

Solo hay que escribir bytes. Por ejemplo, para iniciar se envían los bytes ESC y arroba. Luego podemos escribir texto y hacer un recorrido de papel con 0x1b, la letra d y la cantidad de saltos que queremos.

A partir de esto ya podemos ver las especificaciones ESC POS y escribir bytes a nuestras impresoras térmicas desde C#.

Poniendo todo junto

Conectar C# con impresora térmica

Anteriormente te mostré el código básico para enviar bytes raw a una thermal printer desde C#, ahora te enseñaré el código completo para enviar un Hola mundo a una impresora POS desde C#.

Yo lo he compilado incluso sin Visual Studio con csc.

using System;
using System.IO;
using System.Text;
using Microsoft.Win32.SafeHandles;
using System.Runtime.InteropServices;

public class ImpresoraTermica
{

    [DllImport("kernel32.dll", SetLastError = true)]
    static extern SafeFileHandle CreateFile(string lpFileName, FileAccess dwDesiredAccess, uint dwShareMode, IntPtr lpSecurityAttributes, FileMode dwCreationDisposition, uint dwFlagsAndAttributes, IntPtr hTemplateFile);

    public static void Main()
    {
        string nombreImpresora = "PT210";
        string textoParaImprimir = "Hola impresora desde C#!";
        string hostname = System.Environment.MachineName;
        string ubicacionCompletaImpresora = string.Format("\\\\{0}\\{1}", System.Environment.MachineName, nombreImpresora);
        SafeFileHandle fh = CreateFile(ubicacionCompletaImpresora, FileAccess.Write, 0, IntPtr.Zero, FileMode.OpenOrCreate, 0, IntPtr.Zero);
        if (fh.IsInvalid)
        {
            Console.WriteLine("Error abriendo impresora");
            return;
        }
        var impresoraComoArchivo = new FileStream(fh, FileAccess.ReadWrite);
        impresoraComoArchivo.WriteByte(0x1b); // ESC
        impresoraComoArchivo.WriteByte(0x40); // @
        impresoraComoArchivo.Write(Encoding.ASCII.GetBytes(textoParaImprimir), 0, textoParaImprimir.Length);
        impresoraComoArchivo.WriteByte(0x1b); // Feed
        impresoraComoArchivo.WriteByte(Convert.ToByte('d'));
        impresoraComoArchivo.WriteByte(Convert.ToByte(1)); // 1 línea
        impresoraComoArchivo.Dispose();
    }
}

Cuando ejecutes ese código, y si tu impresora térmica ya está instalada, compartida y conectada por USB entonces se imprimirá el mensaje que ves en la foto.

A partir de aquí ya puedes leer el protocolo e implementar todo lo necesario para tu impresora térmica.

Si lo prefieres puedes usar mi plugin gratuito que ya tiene varias funciones como estilos de texto, impresión de imágenes, códigos qr, definición de caracteres personalizados, impresión en red, versión Bluetooth y muchas cosas más. Además, ya existe su versión para C# así que puedes evitarte implementar todas las funciones y usar mi plugin que cuenta con más características.

Estoy aquí para ayudarte 🤝💻


Estoy aquí para ayudarte en todo lo que necesites. Si requieres alguna modificación en lo presentado en este post, deseas asistencia con tu tarea, proyecto o precisas desarrollar un software a medida, no dudes en contactarme. Estoy comprometido a brindarte el apoyo necesario para que logres tus objetivos. Mi correo es parzibyte(arroba)gmail.com, estoy como@parzibyte en Telegram o en mi página de contacto

No te pierdas ninguno de mis posts 🚀🔔

Suscríbete a mi canal de Telegram para recibir una notificación cuando escriba un nuevo tutorial de programación.
parzibyte

Programador freelancer listo para trabajar contigo. Aplicaciones web, móviles y de escritorio. PHP, Java, Go, Python, JavaScript, Kotlin y más :) https://parzibyte.me/blog/software-creado-por-parzibyte/

Ver comentarios

Entradas recientes

Desplegar PWA creada con Vue 3, Vite y SQLite3 en Apache

Ya te enseñé cómo convertir una aplicación web de Vue 3 en una PWA. Al…

3 días hace

Arquitectura para wasm con Go, Vue 3, Pinia y Vite

En este artículo voy a documentar la arquitectura que yo utilizo al trabajar con WebAssembly…

3 días hace

Vue 3 y Vite: crear PWA (Progressive Web App)

En un artículo anterior te enseñé a crear un PWA. Al final, cualquier aplicación que…

3 días hace

Errores de Comlink y algunas soluciones

Al usar Comlink para trabajar con los workers usando JavaScript me han aparecido algunos errores…

3 días hace

Esperar promesa para inicializar Store de Pinia con Vue 3

En este artículo te voy a enseñar cómo usar un "top level await" esperando a…

3 días hace

Solución: Apache – Server unable to read htaccess file

Ayer estaba editando unos archivos que son servidos con el servidor Apache y al visitarlos…

4 días hace

Esta web usa cookies.