Cordova-Plugin-Bluetooth-Printer

A cordova plugin for bluetooth printer for android platform, which support text, image and POS printing.

Supported Cordova Versions

cordova: >= 6
cordova-android: >= 6.4

Supports printing:

Text
POS Commands
Image Printing (Thanks to @CesarBalzer)
ToDo: Qrcode Printing (It can be achieved via image for now)
ToDo: Barcode Printing (It can be achieved via image for now)

Install

# Using the Cordova CLI and NPM, run:
cordova plugin add https://github.com/pvillaverde/Cordova-Plugin-Bluetooth-Printer

# Using Ionic run:
ionic cordova plugin add https://github.com/pvillaverde/Cordova-Plugin-Bluetooth-Printer

Functions

A notification does have a set of configurable properties. Not all of them are supported across all platforms.

Method	Description
BTPrinter.list(fnSuccess, fnError)	Returns array of strings with available bluetooth devices names
BTPrinter.connect(fnSuccess, fnError, name)	Connects to the device with the name specified (must be connected via bluetooth)
BTPrinter.disconnect(fnSuccess, fnError)	Disconnects from the currently connected device
BTPrinter.printText(fnSuccess, fnError, string)	Prints `string` text. You can use `\n` to break lines.
BTPrinter.printQRCode(fnSuccess, fnError, data)	ToDo: Prints a QRCode with data as its encoded message
BTPrinter.printImage(fnSuccess, fnError, base64ImageString)	Prints images with `base64ImageString`. You can print QRCodes && BarCodes this way
BTPrinter.printPOSCommandfn(Success, fnError, string)	Executes PosCommand specified in `string`. See useful PosCommands below

Important notes:

You have to send a new line \n or feed command 0D in order to print the last line.
POS Command 1B 40 restarts all previously set settings via POS Commands.

Useful POS Commands

These are only some of the POS Commands you can use to customize your printing

Command	Description	Command	Description
`1B 40`	Resets and initialize print	`0D`	Feeds paper
`1B 21 00`	Normal size for text	`1B 2D 00`	Underline font off
`1B 21 01`	Small size for text	`1B 2D 01`	Underline font 1-dot ON
`1B 21 10`	Double height text	`1B 2D 02`	Underline font 2-dot ON
`1B 21 20`	Double width text	`1B 21 20`	Double width text
`1B 21 30`	Double width & height text	`1B 21 30`	Double width & height text
`1B 45 00`	Bold font OFF	`1B 35`	Italic font OFF
`1B 45 01`	Bold font ON	`1B 34`	Italic font ON
`1B 61 00`	Align Left	`1B 4D 00`	Font type A
`1B 61 01`	Align-Center	`1B 4D 01`	Font type B
`1B 61 02`	Align-Right	`1B 4D 02`	Font type C

International Charset

You can specify which charset to use when printing, see reference As this is the first setting when printing, you can use this PosCommand 1B 40 1B 52 **code** 1B 74 16

Code	Charset	Code	Charset	Code	Charset
`00`	U.S.A.	`06`	Italy	`12`	Latin America
`01`	France	`07`	Spain I	`13`	Kirea
`02`	Germany	`08`	Japan	`14`	Slovenia / Croatia
`03`	U.K.	`09`	Norway	`15`	China
`04`	Denmark I	`10`	Denmark II	`16`	Vietnam
`05`	Sweden	`11`	Spain II	`15`	Arabia

Example Usage

If using Ionic with AngularJS, you can wrap plugin's function into promises like this:

function checkAvailable() {
	return new Promise((resolve, reject) => {
		$window.BTPrinter.list(success => resolve(success), failure => reject(failure));
	});
}

In my case I have done some functions to make it easy to format text:

function style(commands) {
	// https://github.com/humbertopiaia/escpos-commands-js
	const ESCPOS = {
		MARGINS: {
			BOTTOM: `1b 4F`, // Fix bottom size
			LEFT: `1B 6C`, // Fix left size
			RIGHT: `1B 51`, // Fix right size
		},
		TEXT_FORMAT: {
			'size-normal': `1B 21 00`, // Normal text
			'size-small': `1B 21 01`, // Initialize small sized
			'size-2h': `1B 21 10`, // Double height text
			'size-2w': `1B 21 20`, // Double width text
			'size-2x': `1B 21 30`, // Double width & height text

			'underline-off': `1B 2D 00`, // Underline font OFF
			'underline-on': `1B 2D 01`, // Underline font 1-dot ON
			'underline-on-2x': `1B 2D 02`, // Underline font 2-dot ON
			'bold-off': `1B 45 00`, // Bold font OFF
			'bold-on': `1B 45 01`, // Bold font ON
			'italic-off': `1B 35`, // Italic font ON
			'italic-on': `1B 34`, // Italic font ON

			'font-a': `1B 4D 00`, // Font type A
			'font-b': `1B 4D 01`, // Font type B
			'font-c': `1B 4D 02`, // Font type C

			'align-left': `1B 61 00`, // Left justification
			'align-center': `1B 61 01`, // Centering
			'align-right': `1B 61 02`, // Right justification
		},
	};
	let POSCommand = `1B 40`; // Recibe ordenes POS
	//POSCommand += ` 1B 52 11 1B 74 02`;
	commands.split(` `).forEach(cmd => POSCommand += ESCPOS.TEXT_FORMAT[cmd] ? ` ${ESCPOS.TEXT_FORMAT[cmd]}` : ``);
	return printPOSCommand(POSCommand);
}

function setInternationalCharset(country) {
	// https://reference.epson-biz.com/modules/ref_escpos/index.php?content_id=29
	const charsetCode = {
		'U.S.A.': `00`,
		'France': `01`,
		'Germany': `02`,
		'U.K.': `03`,
		'Denmark I': `04`,
		'Sweden': `05`,
		'Italy': `06`,
		'Spain I': `07`,
		'Japan': `08`,
		'Norway': `09`,
		'Denmark II': `10`,
		'Spain II': `11`,
		'Latin America': `12`,
		'Korea': `13`,
		'Slovenia / Croatia': `14`,
		'China': `15`,
		'Vietnam': `16`,
		'Arabia': `17`,
	};
	let POSCommand = `1B 40 1B 52 ${charsetCode[country]} 1B 74 16`;
	return printPOSCommand(POSCommand);
}

And then you can easily print whatever like this:

function printTicket(organization) {
	return printerService.checkAvailable().then(printers => {
		return printerService.connect(printers[0]).then(() => {
			const title = `\n\n${organization.name}\n\n`;
			const lineSeparator = `==============================\n\n`;
			const endSpace = `\n\n\n\n`;
			return printerService.setInternationalCharset(`Spain II`)
				.then(() => printerService.style(`align-center size-2h`))
				.then(() => printerService.printText(title))
				.then(() => printerService.style(`size-normal align-center`))
				.then(() => printerService.printText(`${organization.address.street}\n`))
				.then(() => printerService.printText(`${organization.address.postcode} ${organization.address.city}\n`))
				.then(() => printerService.printText(`${organization.telephone}\n`))
				.then(() => printerService.style(`align-left size-normal`))
				.then(() => printerService.printText(lineSeparator))
				.then(() => printerService.style(`align-center`))
				.then(() => printerService.printImage(qrCodeService.generate(organization.webPage).toDataURL()))
				.then(() => printerService.printText(endSpace));
		});
	}).catch(error => {
		console.error(error);
		printerService.disconnect();
		// Attempt to invoke virtual method 'void java.io.OutputStream.write(byte[])' on a null object reference => Printer not connected
		// read failed, socket might closed or timeout, read ret: -1 => Printer is offline or have been used and didn't disconnect before.
		// invalidAction => Function called with BTPrinter does not exist.
	});
}