main_logo

Web App Print

How to install and setup the Hardware

Applicable Interface

USB
Connecting
• Connect the USB cable to the B-gate and the host, and turn on the B-gate.
 
Wired LAN
Connecting

• After B-gate booting is complete, proceed to "Opening the printer cover  Pressing the Feed key Closing the printer cover", and the B-gate self-test describing the LAN configuration information is printed.

• Check the ETH_DHCP value in the self-test. If the value is Disabled, open the network configuration of the host (e.g., PC) and set the LAN of the host to the same as the LAN configuration of the B-gate. For example, if the default IP of the B-gate is 192.168.192.168, set the IP of the host to 192.168.192.x (x = 1 ~ 254) and the Subnet Mask to 255.255.255.0.

• When connecting the LAN cable with the ETH_DHCP value set to Enabled, the B-gate automatically brings IP information from the DHCP server (router). By printing the self-test of B-gate, you can check the IP assigned to B-gate.
Setting

• Utilities are provided so that users can set up the interface.

• Web Utilities: It can be accessed by entering IP of B-gate in the address window of the web browser.

• Native Utilities: Utility apps that can run on each OS are provided.

Wireless LAN
Connecting

• Connect the supported WLAN dongle to the B-gate, and turn on the B-gate.

• After B-gate booting is complete, proceed to "Opening the printer cover  Pressing the Feed key Closing the printer cover", and the B-gate self-test describing the WLAN configuration information is printed.

• First check the network value in the self-test. If the value is adhoc, open the wireless connection menu of the host (PC, tablet, smartphone) and set it as adhoc before connecting. The default network mode for B-gate is adhoc, ESSID is BIXOLON_adhoc, and IP address is 192.168.1.1.

• If the value is infra, connect the host to the AP connected to the B-gate.

• Check the WLAN_DHCP value in the self-test. If the value is disable, the host (e.g. PC), open the network configuration and set the host's WLAN to the same as the B-gate's WLAN configuration. For example, if the default IP of the B-gate is 192.168.192.168, set the host IP to 192.168.192.x (x = 1 ~ 254) and Subnet Mask to 255.255.255.0.

• When connecting the LAN cable with the ETH_DHCP value set to enabled, the B-gate automatically brings IP information from the DHCP server (router). By printing the self-test of B-gate, you can check the IP assigned to B-gate.
Setting

• Utilities are provided so that users can set up the interface.

• Web Utilities: It can be accessed by entering the IP of B-gate in the address window of web browser.

• Native Utilities: Utility apps that can run on each OS are provided.
 
Bluetooth
Connecting

• Turn on the B-gate that supports Bluetooth.

• After B-gate booting is complete, proceed to "Opening the printer cover  Pressing the Feed key Closing the printer cover", and the B-gate self-test describing the WLAN configuration information is printed.

Check the device Name value in the self-test.

Pair the devices you want to connect from the list of devices found in the host.

Setting

• Utilities are provided so that users can set up the interface.

• Native Utilities: Utility apps that can run on each OS are provided.

How to install peripherals

Connecting

Connect supported peripherals to the USB-A type on the back of the B-gate, and turn on the B-gate.

After B-gate booting is complete, proceed to "Opening the printer cover → Pressing the Feed key → Closing the printer cover", and the B-gate self-test describing the enabled peripheral configuration information is printed.

How to connect B-gate to Web Server

The B-gate comes with built-in webserver and a Web Configuration Tool (BGATE WebCONFIG Tool) as well. All the B-gate’s Web Print configuration and setting done via BGATE WebCONFIG Tool. Since the BGATE WebCONFIG Tool is a web application, the supported interfaces are

LAN (Local Area Network)

WLAN (Wireless Local Area Network)
 

Caution

The BGATE WebCONFIG Tool is password protected, please contact BIXOLON for account credential details.

LAN

1. Connect the LAN cable into the B-gate and then turn on the B-gate.
2. After the B-gate is booted, Open Printer Cover → Press and Release Feed Button Close Printer Cover. This will print the B-gate’s Self Test Page, which includes LAN Configuration Information as well.
3. From the Self Test Page, take a note on the value of ETH_DHCP, if the value is Disabled then, open your Host(e.g. PC) Network Configuration and set your Host in the same LAN network as the B-gate’s LAN Configuration. For example, if the B-gate’s default IP is 192.168.192.168 then, make your Host IP into 192.168.192.X (x = 1~255) and the Subnet Mask is 255.255.255.0 and Save your new setting.
4. If the ETH_DHCP value is Enabled then just connect the LAN Cable, the B-gate will automatically acquire the IP Information from your DHCP Server(router), print the B-gate self Test Page again to get know the B-gate’s IP Information.
5. Open the web browser on your Host and enter the B-gate’s IP in the address bar, if it is open the BGATE WebCONFIG Tool then you have configured your PC and the B-gate Correctly.

WLAN

1. Connect a WLAN Dongle into the B-gate and turn on the B-gate.
2. After the B-gate is booted, Open Printer Cover → Press and Release Feed Button → Close Printer Cover. This will print the B-gate’s Self Test Page, which includes WLAN Configuration Information as well.
3. From the Self Test Page, take a note on the value of the Network, if the value is infra then, use the B-gate network utilities to set the WLAN configuration.
4. If the Network value is adhoc then, connect your host (PC/Tablet/Smart Phone) to the B-gate. The default ESSID of the B-gate is BIXOLON_adhoc and the default IP address is 192.168.1.1
5. Open the Wireless Connection on your Host(e.g. PC/Tablet/Smart Phone) and connect to BIXOLON_adhoc and configure Static IP setting with the IP Address is 192.168.1.2 and the Subnet Mask is 255.255.255.0 and save the new setting.
6. Open the web browser on your Host and enter the B-gate’s IP in the address bar, if it is open the BGATE WebCONFIG Tool then you have configured your PC and the B-gate Correctly.

Utility Setup

Network Configuration

Verify LAN Information
1) Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the address bar of the web browser.
2) Click General Information >> Wired TCP/IP Info menu, it will display the current LAN Settings information.

Set LAN Information
1) Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the address bar of the web browser.
2) Click Configuration >> Set LAN TCP/IP Menu.
3) After entering the required LAN information click on the Set LAN IP button.
4) Restart the B-gate after receiving the LAN setting success message from the B-gate to apply the new LAN setting information.

Verify WLAN Information
1) Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the address bar of the web browser.
2) Click General Information >> Wireless TCP/IP Info menu, it will display the current WLAN information.

Set WLAN Information
1) Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the address bar of the web browser.
2) Click Configuration >> Set WLAN TCP/IP  menu.
3) After entering the required WLAN information click on the Set WLAN IP  button.
4) Restart the B-gate after receiving the WLAN setting success message from the B-gate to apply the new WLAN setting information.

External Printer Configuration

USB Printer Settings
A printer, which is connected to the B-gate via USB does not require a separate ID setting. The B-gate will recognize the connected USB printer by the USB physical connection and the connected USB printers can be controlled with the specified ID by the B-gate
1) Local Printer: The ID of the Printer which is integrated in B-gate(local_printer)
2) USB Printer: The ID of the Printer which is connected to the B-gate via USB port (usb_printer1 ~ 4)



Network Printer Settings

An external network printer, which is connected to the B-gate requires a separate unique ID setting. The B-gate will recognize the connected network printer using the given unique ID.
 

1)Verify Network Printer Information
(1)Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the address bar of the web browser.
(2)Click  Device >> Register Network Printer menu.
(3)Device List will display all the registered printer information.
 

2) Register Network Printer

(1) Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the address bar of the web browser.
(2) Click  Device >> Register Network Printer menu.
(3) Enter the required information and then click the Register Device button.

3) Register Network Printer

(1) Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the address bar of the web browser.
(2) Click  Device >> Register Network Printer menu.
(3) From the Device List table, click the Remove Printer button on the printer you want to delete.

Rerouting Printer Settings
Rerouting printers are just like the back-up printer, when the designated printer is out of service. The printer job will automatically redirect to the registered rerouting printer based on its priority.
 

Caution

The Rerouting Device ID and the Network Printer Device ID are different IDs


1) Verify Rerouting Printer Information

(1) Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the address bar of the web browser.
(2) Click  Device >> Register Rerouting Printer menu.
(3) The Rerouting Printer List table will display the registered rerouting printer list information.
 
2) Register Rerouting Printer
(1) Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the address bar of the web browser.
(2) Click  Device >> Register Rerouting Printer menu.
(3) Enter the required information in the Register Rerouting Printer fields and then click the Register button.
 
3) Remove Rerouting Printer
(1) Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the address bar of the web browser.
(2) Click Device >> Register Rerouting Printer menu.
(3) From the Rerouting Printer List table, click the Remove Printer button on the printer you want to delete from the Rerouting Printer List.
 
4) Change Priority
(1) Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the address bar of the web browser.
(2) Click  Device >> Register Rerouting Printer menu.

(3) From the Rerouting Printer List table, click the Up or Dw button on the rerouting  printer to change its priority and then click the UPDATE PRIORITY button.
 

Restart Web Server
1) Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the address bar of the web browser.
2) Click Configuration >> Restart Web Server menu.
3) Enter the IP address of the B-gate web server and click the Restart Web Server button. This will restart the web server and the B-gate will send the acknowledgement to the web browser as well.

Upload Web Application

Since the B-gate comes with its own built-in web server, you can upload your own web application to the B-gate. The compressed Web Application can been uploaded to the web server document’s root directory and decompressed. To open the uploaded web application, enter the web server IP address/”Web Application Name”  in the address bar of the web browser.
 

Caution

Only a ZIP compression format is supported.

1) WebApp Print, Web Application Upload 
(1) Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the address bar of the web browser.
(2) Click Configuration >> Upload Web Application menu.
(3) Select the web application file, which you want to upload to the B-gate.
(4) Click the UPLOAD button.

Protocol Configuration

Protocol Configuration

1 Enable/Disable Telnet Protocol
  1. Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the

 address bar of the web browser.

  1. Click Configuration >> Set Protocol menu
  2. From TELNET list box, select Enable if you want to enable the Telnet Protocol,

   select Disable if you want to disable it.

  1. Click the Set Protocol button, it will enable/disable the Telnet protocol and

   displayed the B-gate acknowledgement message as well.
 

2 Enable/Disable SNMP Protocol
  1. Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the

 address bar of the web browser.

  1. Click Configuration >> Set Protocol menu
  2. From SNMP list box select Enable if you want to enable the SNMP Protocol,

   select Disable if you want to disable it.

  1. Click the Set Protocol button, it will enable/disable the SNMP protocol and

   displayed the B-gate acknowledgement message as well.
 

3 Configure SNMP Protocol

  1. Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the

 address bar of the web browser.

  1. Click Configuration >> SNMP Configuration menu
  2. Enter the required details and then click the Configure button, This will

   configure the SNMP protocol and the B-gate will send the acknowledgement to 

   the web browser as well
 

4 Enable/Disable XPM Protocol

  1. Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the

 address bar of the web browser.

  1. Click Configuration >> Set Protocol menu
  2. From XPM list box, select Enable if you want to enable the XPM Protocol,

   select Disable if you want to disable it.

  1. Click the Set Protocol button, it will enable/disable the XPM protocol and

             displayed the B-gate acknowledgement message as well
 

5 Get XPM Protocol Configuration

  1. Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the

 address bar of the web browser.

  1. Click Configuration >> XPM Configuration menu
  2. Click the Get XPM button, This will get the current XMP configuration

   information from the B-gate and displayed it on the necessary fields in the web

   browser as well.
 

6 Set XPM Protocol Configuration

  1. Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the

 address bar of the web browser.

  1. Click Configuration >> XPM Configuration menu
  2. Enter the required details and then Click the Set XPM button, This will Set the

   current XMP configuration information to the B-gate and displayed the

          acknowledgement message on the web browser as well.

Development Environment

Web Application usually runs in web browsers, so there is no need for specific operating system supports; however, the selection of web browser should be relevant. Since our BIXOLON’s B-gate uses HTML 5 features, it is essential to use HTML5 supported web browsers, this section will discuss about the browser versions which are supported by our SDK APIs.

Supported Web Browser Versions

IE (Internet Explorer): 10.0 and above

Chrome: 16 and above

Chrome Mobile: 16 and above

Safari: 6.0 and above

Safari Mobile: 6.0 and above

Firefox: 11.0 and above

Firefox Mobile: 11.0 and above

Opera: 12.10 and above

Opera Mobile: 12.10 and above

Android Browser: 4.4 and above

Black Berry Browser: 7.0 and above

Sample Apps

The B-gate comes with built-in Sample App to test the B-gate’s WebApp Print functionality. The Sample App  has three kinds of demo applications, POS DEMO, LABEL DEMO and DEVICE CONTROL, The POS DEMO is used to test the POS Printers with B-gate.

The LABEL DEMO is used to test the Label Printers with B-gate.

The DEVICE CONTROL demo is used to test the Peripheral devices, such as,   

Scanners, MSR, RFID, NFC, Dallas Key Readers, Scale and BCD Display

 

WebApp Print Testing
1. Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the address bar of the web browser.
2. Click WebApp Demo menu.
3. A new web page for the WebApp Print demo will appear in your web browser.
4. 
Click POS DEMO button.
5.  A new web page for the POS DEMO will appear in your web browser
6. There are 4 kinds of demo applications,
  • EDITOR -  Make your sample print page and Print
  • COFFEE SHOP – Sample Coffee Shop demo
  • QUEUE TICKET – sample Queue Ticket Printing
  • COUPON            – Sample Coupon Printing
7. If you want to Print Sample Queue Ticket, Enter the B-gate’s IP Address in IP Address box and then click Get Shops button and then click Get Device button and select your designated printer from the Get Device drop down box, by default  local_printer is selected. After selecting the designated printer, click the QUEUE TICKET button it will print the sample queue ticket on the selected printer and display the printer status as well.




8. If you want to Print Sample Coupon, Enter the B-gate’s IP Address in IP Address box and then click the Get Shops button and then click the Get Device button and then select your designated printer from the Get Device drop down box, by default  local_printer is selected. After selecting the designated printer, click the COUPON button it will print the sample coupon on the selected printer and display the printer status as well.


 
9. If you want to check Editor Demo, please click the EDITOR button, it will show the sample editor demo application, design your sample print page by clicking the required buttons on the left side, after designing your sample print page, Enter the B-gate’s IP Address in IP Address box and then click the Get Shops button and then click the Get Device button and then select your designated printer from the Get Device drop down box, by default  local_printer is selected. After selecting the designated printer, click the PRINT DATA button, it will print the data on the selected printer and display the printer status.
 

10. To test Coffee Shop demo, please click the COFFESHOP button, it will show the Coffee Shop demo application, Click the items you order and then enter the cash amount and then Enter the B-gate’s IP Address in IP Address box and then click the Get Shops button and then click the Get Device button and then select your designated printer from the Get Device drop down box, by default  local_printer is selected. After selecting the designated printer, click the PRINT button, it will print the order on the selected printer and display the printer status.




 
WebApp Print Testing (LABEL MEMO)
 
1. Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the address bar of the web browser.
 
2. Click WebApp Demo menu.
 
3. A new web page for the WebApp Print demo will appear in your web browser
 
4. Click LABEL DEMO button.
 
5. A new web page for the LABEL DEMO will appear in your web browser
 
6. There are 2 kinds of LABEL demo applications
 ALL DEMO
 RESTAURANT

 
7. To test the ALL DEMO, please click the ALL DEMO button and it will show the ALL DEMO application, ALL Demo application is used to test the ALL Label Print SDK APIs, it has the following sub demos
Shapes Demo  - Its used to test the circle and block shapes printing
Barcode Demo  - Three kind of Barcode Demos, 
1D Barcode Printing – Its used to test all types of 1D barcodes
2D Barcode Printing – Its used to test all types of 2D barcodes
(Maxi Code, PDF419, QRCode, Data Matrix, Aztec, Code49, CODABLOCK and Micro-PDF Barcodes)
Special Barcodes Printing – Its used to test all the special
     barcodes
(IMB, MSI, Plessey, TLC39 and RSS Barcodes.)
    1. Text Demo  - Its used to test the Text strings (Bitmap and  vector fonts)
        1. Bitmap Font Printing
        2. Vector Font Printing
  1. Image Demo – Its used to test the Image printing


 
8. To test the Shapes Demo Click the Printer Setting button to set the printer properties, Enter B-gates’s IP Address in IP Address box an then Get Shops button. Click the Get Devices button and then select your designated printer from the Get Devices drop down box and then Select the Shapes Demo from the Select Demo Type drop box ( By default Shapes Demo will be Selected), It will display the Shapes Demo section, If you want to test the Circle then enter the required values and then click the Draw Circle button and it will print the circle on the selected printer and display the printer status. If you want to test the Block Shapes printing then enter the required values and then click the Draw Block button and it will print the selected block options on the selected printer and display the printer status.
9. To test the Barcode Demo Click the Printer Setting button to set the printer properties, Enter B-gates’s IP Address in IP Address box an then Get Shops button. Click the Get Devices button and then select your designated printer from the Get Devices drop down box and then Select the Barcode Demo from the Select Demo Type drop box (By default Shapes Demo will be Selected), this will display the Barcode demo testing section)

if you want to test the 1D Barcodes then select the ID Barcode Demo from the Select Barcode Demo drop box( by default 1D Barcode Demo is selected) If you want to test the all the supported 1D barcodes then click the  Draw ALL 1DBarcode  button and it will print all the 1D barcodes on the selected printer and display the printer status. If you want to test each 1D Barcodes one by one, then select the Required Barcode type from the Type drop box then and then click the Draw 1DBarcode button and it will print the selected 1D barcode type on the selected printer and display the printer status.
If you want to test the 2D Barcodes then select the 2D Barcode Demo from the Select Barcode Demo drop box (by default 1D Barcode Demo is selected) If you want to test all the supported 2D barcodes then click the Draw ALL 2DBarcode  button and it will print all the 2D barcodes on the selected printer and display the printer status. If you want to test each 2D Barcodes one by one, then select the required 2D Barcode type from the 2D Type drop box then and then click the Draw [2D Type] button and it will print the selected 2D barcode type on the selected printer and display the printer status.
If you want to test the Special Barcodes then select the Special Barcode Demo from the Select Barcode Demo drop box( by default 1D Barcode Demo is selected) If you want to test the all the supported special barcodes then click the Draw ALL SplBarcode  button and it will print all the special barcodes on the selected printer and display the printer status. If you want to test each Special Barcodes one by one, then select the required Special Barcode type from the Special Barcode drop box then and then click the Draw [Special Barcode] button and it will print the selected special barcode type on the selected printer and display the printer status.

 
10. To test the Text Demo Click the Printer Setting button to set the printer properties, Enter B-gates’s IP Address in IP Address box and then Get Shops button. Click the Get Devices button and then select your designated printer from the Get Devices drop down box and then Select the Text Demo from the Select Demo Type drop box (By default Shapes Demo will be Selected), this will display the Text Demo testing section,
if you want to test the Bitmap text string printing then select the Bitmap Font Demo from the Text Type  drop box( by default Bitmap Font Demo is selected), It will display the Bitmap font demo section, Enter the required details and then click the Print Bitmap Font button and it will print the text string in the selected printer and display the printer status.

if you want to test the Vector text string printing then select the Vector Font Demo from the Text Type  drop box(by default Bitmap Font Demo is selected), It will display the Vector font demo section, Enter the required details and then click the Print Vector Font button and it will print the text string on the selected printer and display the printer status.
 

11. To test the Image Demo Click the Printer Setting button to set the printer properties, Enter B-gates’s IP Address in IP Address box an then Get Shops button. Click the Get Devices button and then select your designated printer from the Get Devices drop down box and then Select the Image Demo from the Select Demo Type drop box (By default Shapes Demo will be Selected), It will display the Image Demo section, Enter required details and then click the Draw Image button and it will print the selected image on the selected printer and display the printer status.
 
12. To test the Restaurant Demo, please click the RESTAURANT button and it will show the Restaurant demo application. Click the items you would like to order. Enter the B-gate’s IP Address in IP Address box and click the Get Shops button. Click the Get Device button and then select your designated printer from the Get Device drop down box. After selecting the designated printer, click the Make Order button and it will print the order on the selected printer and display the printer status.



 

WebApp Print Testing – DEVICE CONTROL DEMO
 

1. Open the BGATE WebCONFIG Tool by entering the B-gate’s IP address in the address bar of the web browser
 
2. Click WebApp Demo menu
 
3. A new web page for the WebApp Print demo will appear in your web browser.
 
4. Click DEVICE CONTROL button.
 
5. A new web page for the Device Control Demo will appear in your web browser
 
6. There are 2 Kinds of Device Control Demos
READ INPUT DEMO  - Its used to test the connected Input devices
Scanner, MSR, RFID, DALLAS KEY, NFC and Scale
WRITE BCD DEMO – Its used to test the BCD manipulation SDK APIs
WRITE BCD, WRITE BCD I/O, Clear Screen, Image (Store, Display and Delete), Reset BCD.

 



 

7. To Test the READ INPUT DEMO, Enter the B-gate’s IP Address  in Printer IP box and then click the GET DEVICE LIST button, the connected input device READ button wil be enabled, for example , if a Scanner and a MSR device is connected then READ SCANNER and READ MSR buttons will be enabled, if you want to read a data from the connected input device then Click the Connected Device READ button then the read data will be displayed on the data text box, if you don’t want to read anymore then Click the Connected Device Stop button. For example, if you want to read a barcode data, then click the READ SCANNER button,  when you scan the barcode, the scanned data will be displayed in the Scanner data display area, once you done reading the data then click the Scanner Stop button.


 



 

8. To Test the WRITE BCD DEMO, Enter the B-gate’s IP Address in Printer IP box and then click the GET DEVICE LIST button, if the BCD display is connected then the BCD DEMO Test buttons will be enabled,

if you want to display a string into a BCD display, then Enter the string in the Display String box and then click the WRITE BCD button, it will display the string into the connected BCD and display the success message.

 



 

If you want to send direct I/O commands to the BCD display, then enter the commands in Hexadecimal format without 0x and then click the WRITE BCD I/0 button, it will send the I/O command to the connected BCD and display the success message.



 

If you want to Clear the BCD display screen, then click the CLEAR SCREEN button, it will clear the BCD screen and display the success message.
 


 

If you want to Reset the BCD display screen, then click the RESET BCD button, it will reset the BCD and display the success message.
 


 

To test the image store, display and clear functionalities then enter the required details and then click STORE BCD IMAGE button to store the image into the BCD. Click the DISPLAY BCD IMAGE button to display the stored image in the selected BCD index area. Click the CLEAR BCD IMAGE button to clear the BCD image in the selected index area. All image test options will display the corresponding success messages as well.