This website is using cookie. By continuing to browse you are accepting our Privacy Policy.

Find out more Accept

FAQ (Frequently Asked Questions) : Mobile SDK

Our answers to frequently asked questions about mobile SDKs so far are shown below. Before you email us your questions, please check the following.

General

Q

Are the SDKs on this website available for free?

A

Yes, the SDKs on this website are available free of charge, once you have accepted the EULA.

Q

Which devices support the additional printing features described on this site?

A

We provide SDKs for Windows Mobile, Windows CE (Bluetooth®, IrDA, USB, Wi-Fi®), and for Android™ (Bluetooth®, Wi-Fi®). These SDKs enable you to develop programs to print from Brother mobile printers.
Please refer to the Tool list and Map for the combinations of the available SDKs and printers.

Q

Which models support ESC/P commands?

A

Brother mobile printers have printer fonts and you can print by using ESC/P compatible printer commands.

If you develop a program which sends print data from a host device, then you can use these commands to print from the printer.

Please visit the Brother Solutions Center where our ESC/P Command Reference Manuals are available. ESC/P compatible commands are standard in all of our mobile printers, but there are some differences between models. Please refer to the latest Command Reference Manuals for details.

Q

How do I print logos?

A

Please check the supported commands of your model, and use either of the following method.

  • It is possible to print logos by using a raster SDK or printer driver.
  • It is possible to print logos by using an ESC/P graphic command.
  • It is possible to print logos by using P-touch Template. Prepare template data including logos with P-touch Editor and transfer them in advance to the printer main body by using the Transfer Manager.

For details, please refer to the Command Reference Manuals for your printer.

Q

Is it possible to print Chinese characters, Hindi or other languages using the SDK?

A

Yes, this is possible.

Our standard SDK has a printing feature that uses API tools from Windows. It is possible to draw a bitmap picture on to a device and send the data to a printer. You can print out any text that you can see on the screen of your handheld device which is running either Windows Mobile or Windows CE without mis-encoding. If it cannot be shown on the screen of your handheld device, it cannot be printed from the machine.

Q

I have experience in adding custom printer support to my own programs. Is it easy to add printer support for Brother mobile printers?

A

Please refer to the Command Reference Manuals for your target mobile printer.
If you have experience in outputting graphic images to a printer, please refer to the Raster Command Reference Manuals.
If you have experience in using ESC/P commands to control printing, please refer to the ESC/P Command Reference Manuals.
If you have experience in using ZPL® II commands to control printing, please refer to the P-touch Template 2.0 Command Reference Manual.

They are available from the Brother Solutions Center.

Q

I already have an application to print from a Brother mobile printer. Can I also print from other Brother mobile printers using this?

A

Small changes to your application will be required if you used the SDKs for the same platform and developed a program for a different printer. Please download the latest version of the SDK and then rebuild the program. Please refer to the manuals which are included in the SDKs.

Q

How many variable objects can the printer receive using P-touch Template(in a lbx file)?

A

It depends on the printer. Please refer to the limitations in the P-touch Template Command Reference Manual for your target printer.

Q

When I print directly to the machine via Bluetooth®, it will produce an incorrect printout, or a printing error will occur when not using the Software Development Kit.

A

When you are connecting the machine via Bluetooth®, the printer may not start to receive the data immediately after the port is opened. We advise to wait for an interval of 500 msec before sending the print data to the machine.

If you normally close and re-open the Bluetooth® port between prints, we would again advise to leave 500 msec between the port being closed and re-opened.

Also, once you have sent the print data, and the printing process has begun, do not close the port. Please ensure 32 bytes of data has been received by the printer, and then close the port.

If you use the latest version of the SDK, this will already have the interval time included automatically.

Q

How do I use the infrastructure mode for PJ-673?

A

Please refer to the document "How to use the infrastructure mode for PJ-673".

Q

How do I switch between Raster, ESC/P, ZPL®, CPCL and Template command modes?

A

Please refer to the Command Reference Manual for your target printer, or please use the Printer Setting Tool to define the default command.

Q

What fonts are used with each command mode?

A

Please refer to the ESC/P Command Reference Manual and P-Touch Template Command Reference Manual for your target printer.

iPhone, iPad

Q

Timeout error does not come up even though I set this function on in Brother Print SDK for iPhone/iPad Ver 1.x.

A

Sometimes the arguments (nTimeout) of function (printImage, printPDFAtPath, etc) do not come up.
This is because of the bugs in the SDK Ver.1.x. Please try the following solutions.

  1. 1. Make sure that the printer and the host device are ready for communication to prevent starting printing without connection. Please call the function isPrinterReady before sending the function printImage or printPDFAtPath.
    *For PJ-673, please use the Brother Print SDK for iPhone /iPad Ver.1.2.6 or later version to use isPrinterReady.
  2. 2. Please cancel the print job when you fail to print. For example, please execute the timeout in each sub threads, and kill the printImage threads after the timeout.
Q

Precautions for users who will update the version of Brother Print SDK for iPhone/iPad from 3.0.0 - 3.0.5 to 3.0.6 or higher

A

The following parameters are unavailable to the version 3.0.6 or higher of Brother Print SDK for iPhone/iPad because they will be deprecated.
Please delete them if you are using these parameters.

<Parameters to be deprecated>
Target class: BRPtouchPrinter.h

  • ERROR_WRONG_MEDIA_
  • ERROR_WRONG_COSTOMEPAPERIFO_
  • ERROR_ADD_PRN_DATA_
  • ERROR_BADENCRYP_

Target class: BRPtouchPrinterInfo.h

  • nNumberofCopies

Q

When building the sample project included in the Brother Print SDK for iPhone/iPad Ver3.1.1 with Xcode 9, a build error occurs.

A

Because the sample project included in the Brother Print SDK for iPhone/iPad Ver3.1.1 is designed for Xcode 8, it is not supported by Xcode 9.
However, the framework included in the Brother Print SDK for iPhone/iPad Ver3.1.1 is supported by Xcode 9.

Q

A build error occurs when building the Swift sample project included in the Brother Print SDK for iPhone/iPad Ver3.x with Xcode.

A

When building the Swift sample project, make sure you set the framework type manually:

  • For Wi-Fi® connected printers only
    BRPtouchPrinterKitW.framework
  • For both Wi-Fi® connected printers and MFi-certified printers, or to support MFi-certified printers only
    BRPtouchPrinterKit.framework

Q

The paper sizes acquired using the getPTStatus function in the Brother Print SDK for iPhone/iPad are different from the values described in the consumables product package.

A

For the paper sizes in the table below, the values acquired using the getPTStatus function are different from the ones described in the consumables product package.

Models Paper Type ID [Paper Width]
In The Printer
Value Acquired Using The "getPTStatus" Function Consumables Product Package Information
Paper Size Product Number Area
QL-1110/1110NWB/
1115NWB
Continuous Length Roll 265 103.6mm 104mm 103mm DK-2246/
DK-22246
All areas except for Japan
Die-cut Label 366 101.6mm x
152.8mm
102mm x
153mm
102mm x
152mm
DK-1241/
DK-11241
All areas except for Japan
Die-cut Label 385 103.6mm x
164.3mm
104mm x
164mm
103mm x
164mm
DK-1247/
DK-11247
All areas except for Japan
QL-1110/1110NWB/
1115NWB
QL-710W/720NW/
810W/820NWB
Die-cut Label 383 60.0mm x
86.8mm
60mm x
87mm
60mm x
86mm
DK-1234 USA only
PT-P900W/P950NW Continuous Length Tape 263 3.38mm 4mm 3.5mm TZe-N201 All areas
PT-P750W Continuous Length Tape 263 3.40mm 4mm 3.5mm TZe-N201 All areas

Windows Mobile, Windows CE

Q

Which language / development environment should I use? Which SDK is the best for me?

A

The Tool list and Map shows the availability of the combination of the SDKs and the Brother mobile printers. Please refer to the map.

Q

We would like to use either VisualBasic or C# for coding. Is this available?

A

It depends on which SDK you are using whether it is compatible with these types of coding. Please refer to the Tool list and Map. The development applications you can use are Visual Studio.NET 2003, Visual Studio 2005 or Visual Studio 2008 which you can program using Visual Basic or C#. You may also need to prepare the SDK compatible to .NET Compact Framework (which is supplied by Microsoft) for coding with Visual Basic or C#. Please use the latest version of the MPrint&PocketJetSDK for .NET Compact Framework. The compatible versions are .NET Compact Framework version 1.0, 2.0 and 3.5.

Q

How can I change the printer settings directly from my program?

A

Please refer to the explanations of printer setting functions in the manual which is included in the SDK you use.

Q

Can I use the MPrint&PocketJetSDK for controlling Windows Mobile / Windows CE?

A

Yes, you can add a printing feature to your program for devices running Windows Mobile or Windows CE, by using the specific Mprint&PocketJetSDK for Windows Mobile / Windows CE.
But please note that Brother cannot guarantee printing from all Windows Mobile / Windows CE devices, so please try to use it before purchasing the printer.
However, Mprint&PocketJetSDK for Windows Mobile / Windows CE does not support the barcode generator. If you want this feature you will have to prepare the generator for barcodes yourself and use it to generate bitmap graphics of the barcode.

Q

How long will it take to develop the program using the SDK?

A

It can vary and mostly depends on the program you are wanting to build. Also, factors like the environment, the scale of your project and the programmer's skill will all have an affect. For reference, here is an estimated example of how long it may take.

Conditions
A program developer with experience in VC coding who is using this to develop a sample project called "ABC Receipt".

Estimated Time
We would estimate 40 hours to understand the MPrint&PocketJetSDK for Windows Mobile / Windows CE, plus around 60 hours for the coding of the program.
Therefore we estimate approximately 100 hours.

Q

The program does not work correctly. The error message "The file '....' cannot be opened. Either it is not signed with a trusted certificate, or one of it's components cannot be found. You might need to reinstall or restore this file. If the problem persists, try reinstalling or restoring this file." appears in the dialog box.

A

The MPrint&PocketJetSDK for Windows Mobile / Windows CE will not work with just the '.exe' file you built. You will also have to copy the .dll files in to the appropriate folder.

Both the "MwRes.dll" file and the "MwRuntime.dll" should be located below the "Windows" folder on devices running Windows Mobile / Windows CE. Both the .dll files can be found in the folder named after your specific OS in the 'Runtime' folder within the SDK.

If you create an installer for the application, please also configure it to include these two .dll files.

If you create a .exe file using MPrint&PocketJetSDK for .NET Compact Framework, in addition to the above settings of the two .dll files, please also copy the "MwLibrary.dll" file to the folder where the .exe file is saved.

Q

How do I check what version my SDK is?

A

You can find the version of your SDK by checking the "MwRuntime.dll" file.

How to check the version:

  1. 1. Locate the "MwRuntime.dll" file on your PC.
  2. 2. Right click on the file and select Properties.
  3. 3. Select the "Version" tab.
  4. 4. The version of your SDK is shown where it states 'File Version'.

If you create an installer for the application, please also configure it to include these two .dll files.

If you create a .exe file using MPrint&PocketJetSDK for .NET Compact Framework, in addition to the above settings of the two .dll files, please also copy the "MwLibrary.dll" file to the folder where the .exe file is saved.

Q

Is it possible to handle errors and customize error messages?

A

Yes, it is possible to handle and customize error messages. Using the SDK it is also possible to print without using the printer dialog box. You can use the "mpGetLastError" function to handle and customize error dialogs. For more details, please refer to the "function reference" - "samples" section of the SDK manual.

Download

For Developers

  • Choose from Purposes

    Label printing, printer setup and management information.

  • b-PAC

    Information on application development tools for Windows

  • Mobile SDK

    Information on application development tools for mobile terminals

  • Command Reference

    Information on control command reference for label printers and mobile printers

  • Choose from Models

    Introduction of Brother tools applicable to your model

  • Video Library

    Videos showing how to use SDK and other information

  • Contact Us

    Fill out the contact us form if you have questions about Brother developer tool.

Share This Page