A React Native ESC/POS module to help you connect to your ESC/POS printer easily. It also has provide an intuitive way to design your layout, check below example to see how easy to get your layout ready!
$ yarn add @fmauz/react-native-esc-pos
** NOTE: Skip below installation guide if you are using React Native >= 0.60 **
$ react-native link @fmauz/react-native-esc-pos
- In XCode, in the project navigator, right click
Libraries
➜Add Files to [your project's name]
- Go to
node_modules
➜@fmauz
➜react-native-esc-pos
and addEscPos.xcodeproj
- In XCode, in the project navigator, select your project. Add
libEscPos.a
to your project'sBuild Phases
➜Link Binary With Libraries
- Run your project (
Cmd+R
)
- Open up
android/app/src/main/java/[...]/MainApplication.java
- Add
import fmauz.reactnativeescpos.EscPosPackage;
to the imports at the top of the file - Add
new EscPosPackage()
to the list returned by thegetPackages()
method
- Append the following lines to
android/settings.gradle
:include ':react-native-esc-pos' project(':react-native-esc-pos').projectDir = new File(rootProject.projectDir, '../node_modules/@fmauz/react-native-esc-pos/android')
- Insert the following lines inside the dependencies block in
android/app/build.gradle
:compile project(':react-native-esc-pos')
import EscPos from "@fmauz/react-native-esc-pos";
const design = `
D0004 {<>} Table #: A1
------------------------------------------
[ ] Espresso
- No sugar, Regular 9oz, Hot
{H3} {R} x 1
------------------------------------------
[ ] Blueberry Cheesecake
- Slice
{H3} {R} x 1
{QR[Where are the aliens?]}
`;
async function testPrinter() {
try {
// Can be `network` or `bluetooth`
EscPos.setConfig({ type: "network" });
// Connects to your printer
// If you use `bluetooth`, second parameter is not required.
await EscPos.connect("10.10.10.10", 9100);
// Once connected, you can setup your printing size, either `PRINTING_SIZE_58_MM` or `PRINTING_SIZE_80_MM`
EscPos.setPrintingSize(EscPos.PRINTING_SIZE_80_MM);
// 0 to 8 (0-3 = smaller, 4 = default, 5-8 = larger)
EscPos.setTextDensity(9);
// Test Print
await EscPos.printSample();
// Cut half!
await EscPos.cutPart();
// You can also print image!
await EscPos.printImage(file.uri);
// Print your design!
await EscPos.printDesign(design);
// Print QR Code, you can specify the size
await EscPos.printQRCOde("Proxima b is the answer!", 200);
// Cut full!
await EscPos.cutFull();
// Beep!
await EscPos.beep();
// Kick the drawer! Can be either `kickCashDrawerPin2` or `kickCashDrawerPin5`
await EscPos.kickCashDrawerPin2();
// Disconnect
await EscPos.disconnect();
} catch (error) {
console.error(error);
}
}
To scan for available bluetooth in range
EscPos.scanDevices();
To stop scan
EscPos.stopScan();
Register callback events to receive device found:-
EscPos.addListener("bluetoothDeviceFound", (event: any) => {
if (event.state === EscPos.BLUETOOTH_DEVICE_FOUND) {
console.log("Device Found!");
console.log("Device Name : " + event.deviceInfo.name);
console.log("Device MAC Address : " + event.deviceInfo.macAddress);
}
To listen to bluetooth state change
EscPos.addListener("bluetoothStateChanged", (event: any) => {
if (event.state === EscPos.BLUETOOTH_CONNECTED) {
console.log("Device Connected!");
console.log("Device Name : " + event.deviceInfo.name);
console.log("Device MAC Address : " + event.deviceInfo.macAddress);
}
});
To get Bluetooth Conenction State:
- EscPos.BLUETOOTH_CONNECTED
- EscPos.BLUETOOTH_DISCONNECTED
To get Connected / Disconnected Bluetooth Device Info Device Name:
- event.deviceInfo.name
Device MAC Address:
- event.deviceInfo.macAddress
- You can now easily duplicate a string or character and print onto your design.
- Introducing Repeat feature:
Main tag {RP: number of times to duplicate required: string or character to duplicate} Example: Input {RP:5:*} Output: *****
If you have few characters to duplicate in a line and some text within the line you wouldn't want to disturb, you can do it as per below: Example: Input: {RP:3:= }This is a test string{RP:2:@@} Output: = = = This is a test string@@@_@
Important note: this feature does not support repetitive printing of Closing Curly Bracket }.
- Android support
- iOS support
- Print barcode
- Add TypeScript support
- Bluetooth support
- Serial port support
- Add test
- Listen to the connection status