Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

tp-react-native-bluetooth-printer

Package Overview
Dependencies
Maintainers
1
Versions
12
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

tp-react-native-bluetooth-printer

React-Native plugin for the bluetooth ESC/POS printers. This plugin is fork of react-native-bluetooth-escpos-printer

  • 1.5.0
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
114
decreased by-20.28%
Maintainers
1
Weekly downloads
 
Created
Source

tp-react-native-bluetooth-printer

React-Native plugin for the bluetooth ESC/POS & TSC printers.

This plugin is a fork of react-native-bluetooth-escpos-printer. Because we made changes print picture and print qr code methods.

Any questions or bug please raise a issue.

##Still under developement

#May support Android / IOS

Installation

Step 1

Install via NPM Check In NPM

npm install tp-react-native-bluetooth-printer --save

Or install via github

npm install https://github.com/tulparyazilim/tp-react-native-bluetooth-printer.git --save

Step2

Link the plugin to your RN project

react-native link tp-react-native-bluetooth-printer

Or you may need to link manually. //TODO: manually link guilds.

Step3

Refers to your JS files

import {
  BluetoothManager,
  BluetoothEscposPrinter,
  BluetoothTscPrinter,
} from "tp-react-native-bluetooth-printer";

Usage and APIs

BluetoothManager

BluetoothManager is the module that for Bluetooth service management, supports Bluetooth status check, enable/disable Bluetooth service,scan devices,connect/unpair devices.

  • isBluetoothEnabled ==> async function, check whether Bluetooth service is enabled. //TODO: consider to return the the devices information already bound and paired here..
BluetoothManager.isBluetoothEnabled().then(
  (enabled) => {
    alert(enabled); // enabled ==> true /false
  },
  (err) => {
    alert(err);
  }
);
  • enableBluetooth ==> diff + ANDROID ONLY async function, enable the bluetooth service, returns the devices information already bound and paired. diff - IOS would just resovle with nil
BluetoothManager.enableBluetooth().then(
  (r) => {
    var paired = [];
    if (r && r.length > 0) {
      for (var i = 0; i < r.length; i++) {
        try {
          paired.push(JSON.parse(r[i])); // NEED TO PARSE THE DEVICE INFORMATION
        } catch (e) {
          //ignore
        }
      }
    }
    console.log(JSON.stringify(paired));
  },
  (err) => {
    alert(err);
  }
);
  • disableBluetooth ==> diff + ANDROID ONLY async function ,disable the bluetooth service. diff - IOS would just resovle with nil
BluetoothManager.disableBluetooth().then(
  () => {
    // do something.
  },
  (err) => {
    alert(err);
  }
);
  • scanDevices ==> async function , scans the bluetooth devices, returns devices found and pared after scan finish. Event [BluetoothManager.EVENT_DEVICE_ALREADY_PAIRED] would be emitted with devices bound; event [BluetoothManager.EVENT_DEVICE_FOUND] would be emitted (many time) as long as new devices found.

samples with events:

DeviceEventEmitter.addListener(
  BluetoothManager.EVENT_DEVICE_ALREADY_PAIRED,
  (rsp) => {
    this._deviceAlreadPaired(rsp); // rsp.devices would returns the paired devices array in JSON string.
  }
);
DeviceEventEmitter.addListener(BluetoothManager.EVENT_DEVICE_FOUND, (rsp) => {
  this._deviceFoundEvent(rsp); // rsp.devices would returns the found device object in JSON string
});

samples with scanDevices function

BluetoothManager.scanDevices().then(
  (scannedDevices) => {
    const parsedObj = JSON.parse(scannedDevices);
    this.setState(
      {
        pairedDs: this.state.pairedDs.cloneWithRows(parsedObj.paired || []),
        foundDs: this.state.foundDs.cloneWithRows(parsedObj.found || []),
        loading: false,
      },
      () => {
        this.paired = parsedObj.paired || [];
        this.found = parsedObj.found || [];
      }
    );
  },
  (er) => {
    this.setState({
      loading: false,
    });
    alert("error" + JSON.stringify(er));
  }
);
  • connect ==> async function, connect the specified devices, if not bound, bound dailog promps.
BluetoothManager.connect(rowData.address) // the device address scanned.
  .then(
    (s) => {
      this.setState({
        loading: false,
        boundAddress: rowData.address,
      });
    },
    (e) => {
      this.setState({
        loading: false,
      });
      alert(e);
    }
  );
  • Events of BluetoothManager module
Name/KEYDESCRIPTION
EVENT_DEVICE_ALREADY_PAIREDEmits the devices array already paired
EVENT_DEVICE_DISCOVER_DONEEmits when the scan done
EVENT_DEVICE_FOUNDEmits when device found during scan
EVENT_CONNECTION_LOSTEmits when device connection lost
EVENT_UNABLE_CONNECTEmits when error occurs while trying to connect device
EVENT_CONNECTEDEmits when device connected
EVENT_BLUETOOTH_NOT_SUPPORTEmits when device not support bluetooth(android only)

BluetoothTscPrinter

The printer for label printing.

  • printLabel ==> async function the perform label print action.
BluetoothTscPrinter.printLabel(options).then(
  () => {
    //success
  },
  (err) => {
    //error
  }
);
Options of printLabel( ) function: (JSON object)
width
label with , the real size of the label, matured by mm usualy.
height
label height, the real size of the label, matured by mm usualy.
direction
the printing direction, constants of DIRECTION, values DIRECTION.FORWARD/DIRECTION.BACKWARD (0/1)
gap
the gap between 2 labels, matured by mm usualy.
reference
the "zero" position of the label, values [x,y], default [0,0]
tear
switch of the paper cut, constants of TEAR, values ON/OFF (string 'ON','OFF')
sound
switch of the bee sound, values 0/1
text
the collection of texts to print, contains following fields as the configuration:
    * text
        the text string,
    * x
        the text print start position-x
    * y
        the text print start position-y
    * fonttype
        the font type of the text, constanst of FONTTYPE,refereces as table:
            | CONSTANTS | VALUE   |
            |---|---|
            |FONT_1| "1"|
            |FONT_2| "2"|
            |FONT_3| "3"|
            |FONT_4| "4"|
            |FONT_5| "5"|
            |FONT_6| "6"|
            |FONT_7| "7"|
            |FONT_8|"8"|
            |SIMPLIFIED_CHINESE| "TSS24.BF2"|
            |TRADITIONAL_CHINESE| "TST24.BF2"|
            |KOREAN| "K"|
    * rotation
        the rotation of the text, constants of the ROTATION, referces as table:
               | CONSTANTS | VALUE   |
               |---|---|
               |ROTATION_0| 0|
               |ROTATION_90| 90|
               |ROTATION_180| 180|
               |ROTATION_270| 270|
    * xscal
        the scal in x,
    * yscal
        the scal in y, xscal/yscal is the constants of the FONTMUL, referces as table:
         | CONSTANTS | VALUE   |
         |---|---|
         |MUL_1| 1|
         |MUL_2| 2|
         |MUL_3| 3|
         |MUL_4| 4|
         |MUL_5| 5|
         |MUL_6| 6|
         |MUL_7| 7|
         |MUL_8| 8|
         |MUL_9| 9|
         |MUL_10: 10|
qrcode
the collection of qrcodes to print, contains following fields as the configuration:
    * code
        the qrcode content string.
    * x
        the print start position at x
    * y
        the print start position at y
    * level
        the error correction level, constants of EEC, referces as tables:
        | CONSTANTS | VALUE   |
        |---|---|
        |LEVEL_L|"L"|
        |LEVEL_M| "M"|
        |LEVEL_Q| "Q"|
        |LEVEL_H| "H"|
    * width
        the qrcode size (width X width),since the qrcode are squre normally, so we just config the width.

    * rotation
        rationtion. the same as text object.
barcode
the collection of barcode to print, contains foloowing fields as configuration
  * x
    the print start position of x,
  * y
    the print start position of y,
  * type
    the barcode type, constants of BluetoothTscPrinter, definition as table:
    | CONSTRANTS | VALUE |
    |---|---|
    | CODE128 | "128" |
    | CODE128M | "128M" |
    | EAN128 | "EAN128" |
    | ITF25 | "25" |
    | ITF25C | "25C" |
    | CODE39 | "39" |
    | CODE39C | "39C" |
    | CODE39S | "39S" |
    | CODE93 | "93" |
    | EAN13 | "EAN13" |
    | EAN13_2 | "EAN13+2" |
    | EAN13_5 | "EAN13+5" |
    | EAN8 | "EAN8" |
    | EAN8_2 | "EAN8+2" |
    | EAN8_5 | "EAN8+5" |
    | CODABAR | "CODA" |
    | POST | "POST" |
    | UPCA | "EAN13" |
    | UPCA_2 | "EAN13+2" |
    | UPCA_5 | "EAN13+5" |
    | UPCE | "EAN13" |
    | UPCE_2 | "EAN13+2" |
    | UPCE_5 | "EAN13+5" |
    | CPOST | "CPOST" |
    | MSI | "MSI" |
    | MSIC | "MSIC" |
    | PLESSEY | "PLESSEY" |
    | ITF14 | "ITF14" |
    | EAN14 | "EAN14" |

 * height
  the height of the barcode.
 * readable
  the hunman readable factor, 0-not readable, 1-readable.
 * rotation
  rotation, the same as text.
 * code
  the code to generate and print, should follow the restriction of the code type using.
 * wide
 the wide bar lines width (dot)
 * narrow
 the narrow bar line widht (dot)
image
the collection of the image to print.
 * x
 the print start position x.
 * y
 the print start position y.
 * mode
 the bitmap mode of print, constants of BITMAP_MODE, valuse OVERWRITE(0),OR(1),XOR(2).
 * width
 the width of the image to print. (height will be calculated by image ratio)
 * image
 the base64 encoded image data(without schema)
demo of printLabel() options
let options = {
  width: 40,
  height: 30,
  gap: 20,
  direction: DIRECTION.FORWARD,
  reference: [0, 0],
  tear: TEAR.ON,
  sound: 0,
  text: [
    {
      text: "I am a testing text",
      x: 20,
      y: 0,
      fonttype: FONTTYPE.SIMPLIFIED_CHINESE,
      rotation: TSC_ROTATION.ROTATION_0,
      xscal: FONTMUL.MUL_1,
      yscal: FONTMUL.MUL_1,
    },
    {
      text: "Second testing text",
      x: 20,
      y: 50,
      fonttype: FONTTYPE.SIMPLIFIED_CHINESE,
      rotation: TSC_ROTATION.ROTATION_0,
      xscal: FONTMUL.MUL_1,
      yscal: FONTMUL.MUL_1,
    },
  ],
  qrcode: [
    {
      x: 20,
      y: 96,
      level: EEC.LEVEL_L,
      width: 3,
      rotation: TSC_ROTATION.ROTATION_0,
      code: "show me the money",
    },
  ],
  barcode: [
    {
      x: 120,
      y: 96,
      type: TSC_BARCODETYPE.CODE128,
      height: 40,
      readable: 1,
      rotation: TSC_ROTATION.ROTATION_0,
      code: "1234567890",
    },
  ],
  image: [
    {
      x: 160,
      y: 160,
      mode: BITMAP_MODE.OVERWRITE,
      width: 60,
      image: base64Image,
    },
  ],
};

BluetoothEscposPrinter

the printer for receipt printing, following ESC/POS command.

printerInit()

init the printer.

printAndFeed(int feed)

printer the buffer data and feed (feed lines).

printerLeftSpace(int sp)

set the printer left spaces.

printerLineSpace(int sp)

set the spaces between lines.

printerUnderLine(int line)

set the under line of the text, @param line -- 0 -off, 1 - on, 2 - deeper

printerAlign(int align)

set the printer alignment, constansts: ALIGN.LEFT/ALIGN.CENTER/ALIGN.RIGHT. Not works ant printPic() method.

printText(String text, ReadableMap options)

print text, options as following:

  • encoding => text encoding, default GBK.
  • codepage => codepage using, default 0.
  • widthtimes => text font multi times in width, default 0.
  • heigthTimes => text font multi times in height, default 0.
  • fonttype => text font type, default 0.

Example usage:

const printText = async (text, height = 0, width = 0) => {
  return await BluetoothEscposPrinter.printText(text, {
    encoding: "Cp857", // This is Turkish encoding. If you want to print English characters, you don't need to set this option.
    codepage: 13, // This is Turkish codepage. If you want to print English characters, you don't need to set this option.
    fonttype: 0, // This is default font type.
    widthtimes: width, // Text width times
    heigthtimes: height, // Text heigth time
  });
};
printColumn(ReadableArray columnWidths, ReadableArray columnAligns, ReadableArray columnTexts, ReadableMap options)

print texts in column, Parameters as following:

  • columnWidths => int arrays, configs the width of each column, calculate by english character length. ex:the width of "abcdef" is 5 ,the width of "中文" is 4.
  • columnAligns => arrays, alignment of each column, values is the same of printerAlign().
  • columnTexts => arrays, the texts of each colunm to print.
  • options => text print config options, the same of printText() options.
setWidth(int width)

sets the widht of the printer.

printPic(String base64encodeStr, ReadableMap options)

prints the image which encoded by base64, without schema.

  • options: contains the params that may use in printing pic: "width": Picture width, basic on devices width(dots, 58mm-384); "left": Left padding of the picture, for the printing position adjustment.

Example usage:

const printImage = async (base64Image, imageWidth = 384, leftPadding = 0) => {
  return await BluetoothEscposPrinter.printPic(base64Image, {
    width: imageWidth,
    left: leftPadding,
  });
};
rotate()

set the rotate of the line.

setBold(int weight)

set bold of the line.

printQRCode(String content, int size, int correctionLevel, int leftPadding)

prints the qrcode. content: string text value size: integer size of qr code. correctionLevel: L:1, M:0, Q:3, H:2 leftPadding: integer value for left padding of qrcode

Example usage:

const printQRCode = async (qrCodeText, qrCodeWidth = 200, leftPadding = 90) => {
  return await BluetoothEscposPrinter.printQRCode(
    qrCodeText,
    qrCodeWidth,
    ERROR_CORRECTION.H,
    leftPadding
  );
};
printBarCode(String str, int nType, int nWidthX, int nHeight, int nHriFontType, int nHriFontPosition)

prints the barcode.

Example usage:

const printBarcode = async (barcodeText, barcodeType = BARCODETYPE.JAN13) => {
  return await BluetoothEscposPrinter.printBarCode(
    barcodeText,
    barcodeType,
    3,
    120,
    0,
    2
  );
};

Demos of printing a receipt

await BluetoothEscposPrinter.printerAlign(ALIGN.CENTER);
await BluetoothEscposPrinter.setBold(0);
await BluetoothEscposPrinter.printText("MY LOVED TITLE\n\r", {
  encoding: "GBK",
  codepage: 0,
  widthtimes: 3,
  heigthtimes: 3,
  fonttype: 1,
});
await BluetoothEscposPrinter.setBold(0);
await BluetoothEscposPrinter.printText("SECOND TITLE\n\r", {
  encoding: "GBK",
  codepage: 0,
  widthtimes: 0,
  heigthtimes: 0,
  fonttype: 1,
});
await BluetoothEscposPrinter.printerAlign(ALIGN.LEFT);
await BluetoothEscposPrinter.printText("Label:Value\n\r", {});
await BluetoothEscposPrinter.printText("Code:xsd201909210000001\n\r", {});
await BluetoothEscposPrinter.printText(
  "Date:" + dateFormat(new Date(), "yyyy-mm-dd h:MM:ss") + "\n\r",
  {}
);
await BluetoothEscposPrinter.printText("Number:18664896621\n\r", {});
await BluetoothEscposPrinter.printText(
  "--------------------------------\n\r",
  {}
);

await BluetoothEscposPrinter.printText("Amount:64000.00\n\r", {});
await BluetoothEscposPrinter.printText("Tax:0.00\n\r", {});
await BluetoothEscposPrinter.printText("Total:64000.00\n\r", {});
await BluetoothEscposPrinter.printText(
  "--------------------------------\n\r",
  {}
);
await BluetoothEscposPrinter.printerAlign(ALIGN.CENTER);
await BluetoothEscposPrinter.printText("Thanks for payment\n\r\n\r\n\r", {});
await BluetoothEscposPrinter.printerAlign(ALIGN.LEFT);

Keywords

FAQs

Package last updated on 15 Nov 2023

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc