> For the complete documentation index, see [llms.txt](https://docs.emobiq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.emobiq.com/emobiq-client/006-actions-and-visual-logic/action-reference/cordova/printer/btprinterconnect.md).

# btPrinterConnect

## Description

Connects a bluetooth printer to the device.

## Input / Parameter

| Name      | Description                                     | Input Type  | Default | Options | Required |
| --------- | ----------------------------------------------- | ----------- | ------- | ------- | -------- |
| printerID | The id of the printer to connent.               | String/Text | -       | -       | Yes      |
| extra     | Extra parameters stored and passed to callback. | Any         | -       | -       | No       |

## Output

N/A

## Callback

### callback

The function to be executed if the printer is connected successfully.

### errCallback

The function to be executed if the printer is not connected successfully.

## Video

Coming Soon.

## Example

The user wants to connect a printer to their device.

### Steps

1. Drag a combobox and button component to a page in the mobile designer. Call the function `btPrinterConnect` in the button component.

   ![](/files/pt9QWDpcKwhceof3oUG3)
2. Call the function `componentValue` in the `printerId` parameter of the `btPrinterConnect` function. Select the combobox component in the `component` parameter of the `componentValue` function to view the printers connected.

   ![](/files/73tDFYWikPILS0r55tEs)

   ![](/files/Z0PZpAW4ieCpECKXo7W0)
3. Call the function `infoDialog` in the callbacks of the `btPrinterConnect` function.

   ![](/files/LtgfabTHlBewpQkHrhDD)

   ![](/files/3a8Se9MYYoSJ8lvF7mR7)

   ![](/files/5ePLVnvKMv16HquULs9k)

### Result

1. Select the printer to connect to from the combobox.

   ![](/files/KRcdBkzNq2gqzxGO2hfx)
2. Press the Connect button. If the printer is connected to the device successfully, the success infoDialog will appear. If the printer is not connected successfully, the error dialog will appear.

   ![](/files/NQhm5iGihJLfVsMl0Ljw)

## Links