Page 1
Barcode Controller Scenario & Manual BP30/BM180, EF400/EF500 Bluebird, inc. ver : 1.3...
Page 2
Contents 1. Introduction 2. BarcodeController working scenario(Chart) 3. BarcodeController working scenario(Details) 4. Exception 5. Information...
Page 3
1. Introduction - 1 Purpose BarcodeController is an Android service that allows App to use Barcode module on • Android OS based devices. This document is a summary of scenario and program development to support the user • on building application that uses barcode with BarcodeController. Information ...
Page 4
1. Introduction - 2 Term definition app : • Android application that communicates with BarcodeController. The users actually uses this application. BarcodeController : • Middleware(Android service) that allows application to use Barcode Module. DataWedgeMode : • Function that allows to read in barcode data without building additional application. Read-in value goes into text window of current screen where the cursor is on.
Page 5
1. Introduction - 2 Term definition Profile : • Database that sets function details of Barcode module. Changeable on BBSettings app on device. Sequence number : • The value to distinguish each intend when application send Intent to BarcodeController. When BarcodeController returns the result to app (ACTION_BARCODE_REQUEST_SUCCESS/FAILED), this value is save in Intent.
Page 6
2.1 BarcodeController Operation scenario BarcodeController User App ACTION_BARCODE_CALLBACK_REQUEST_SUCCESS ACTION_BARCODE_OPEN EXTRA_INT_DATA3 : Sequence num EXTRA_INT_DATA3 : Sequence num ACTION_BARCODE_CALLBACK_REQUEST_FAILED EXTRA_INT_DATA2 : 에러ID EXTRA_INT_DATA3 : Sequence num ACTION_BARCODE_SET_TRIGGER EXTRA_INT_DATA2 : trigger value(1:on / 0:off) ACTION_BARCODE_CALLBACK_DECODING_ EXTRA_INT_DATA3 : Sequence num DATA EXTRA_BARCODE_DECODING_DATA : Barcode read data(byte[]) EXTRA_INT_DATA3 : Sequence num ACTION_BARCODE_CALLBACK_REQUEST_FAILED...
Page 7
3.1 Specific Scenario Barcode Open Opens Barcode module. Function that allows Barcode module and use app to communicate. • If module Open is successful, handle value will be transferred through • ACTION_BARCODE_CALLBACK_REQUEST_SUCCESS. If the Module fails to open, it will return ACTION_BARCODE_CALLBACK_REQUEST_FAILED Intent. •...
Page 8
3.2 Specific Scenario Barcode Set Trigger Function that delivers trigger command to Barcode module and sets beam to on/off and sets barcode read to standby mode. • If the Intent is used, EXTRA_INT_DATA2 should be sent as 0 or 1.(0:trigger off / 1:trigger on) •...
Page 9
3.3 Specific Scenario Barcode Decoding Timeout Intent that BarcodeController transfers to application if valid barcode read is not tried for Decoding Timeout • period(default: 5 seconds). ( ACTION_BARCODE_CALLBACK_REQUEST_FAILED). ACTION_BARCODE_SET_TRIGGER(EXTRA:1) ACTION_BARCODE_CALLBACK_REQUEST_FAILED(-6) Put extra : Name ExtraName Type EXTRA_HANDLE EXTRA_HANDLE EXTRA_INT_ERROR_ID EXTRA_INT_DATA2 EXTRA_INT_SEQUENCE_ID...
Page 10
3.4 Specific Scenario Barcode Close Intent : -> finished module activation through transfer close command to the barcode module. • If the closed process is completed, the program cannot use the barcode module until the module is re-opened using •...
Page 11
3.5 Specific Scenario Barcode Get Status Description : Current barcode status value. • STATUS_CLOSE(0) / STATUS_OPEN(1) / STATUS_TRIGGER_ON(2) • ACTION_BARCODE_GET_STATUS ACTION_BARCODE_CALLBACK_GET_STATUS Put extra : Name ExtraName Type EXTRA_HANDLE EXTRA_HANDLE EXTRA_INT_STATUS_ID EXTRA_INT_DATA2 EXTRA_INT_SEQUENCE_ID EXTRA_INT_DATA3 Example …. BarcodeIntent.ACTION_BARCODE_GET_STATUS); String action = intent.getAction(); if(action.equals(BarcodeIntent.ACTION_BARCODE_CALLBACK_GET_STATUS)) intent.putExtra(“EXTRA_HANDLE”, handle);...
Page 12
3.6 Specific Scenario Barcode Set Parameter The function set the Barcode specific value without BBSetting option. • The parameter has to be set using the standard registered values in BBAPI class • Values have to be set depending on the parameter •...
Page 13
3.7 Specific Scenario Barcode Get Parameter The function can check the Barcode specific value. • Parameter have to set the registered values in BBAPI class • A parameter of values has to be set in BBAPI class. • ACTION_BARCODE_SET_PARAMETER ACTION_BARCODE_CALLBACK_PARAMETER Put extra : Name ExtraName...
Page 14
3.8 Specific Scenario Barcode Preview The function can Preview. • Method name • 1) public void onPreviewFrame(int fullLength, boolean option, int width, int height, byte[] data) Param Explain Type fullLength Data length option Option value Boolean width width height height data Data array...
Page 16
4. Exception If scan key is press on DataWedgeMode : On / Status : Close Mode Delay occurs for 2~3 seconds until beam turns on since Trigger gets on after completion • of Open operation If attempts to symbology was made to while it is set as disabled on Profile ...
Page 17
5.1 Information Intent set Name Type Content ACTION_BARCODE_OPEN String BarcodeIntent. ACTION_BARCODE_OPEN ACTION_BARCODE_CLOSE String BarcodeIntent. ACTION_BARCODE_CLOSE ACTION_BARCODE_SET_TRIGGER String BarcodeIntent. ACTION_BARCODE_SET_TRIGGER ACTION_BARCODE_CALLBACK_DECODING_DATA String BarcodeIntent. ACTION_BARCODE_CALLBACK_DECODING_DATA ACTION_BARCODE_CALLBACK_REQUEST_SUCCESS String BarcodeIntent. ACTION_BARCODE_CALLBACK_REQUEST_SUCCESS ACTION_BARCODE_CALLBACK_REQUEST_FAILED String BarcodeIntent. ACTION_BARCODE_CALLBACK_REQUEST_FAILED...
Page 18
5.2 Information Error Id Name realValue Type ERROR_DECODING_TIMEOUT Timeout period is passed after Trigger on ERROR_USE_TIMEOUT No Action is take after 30 seconds from last Action(except CLOSE) ERROR_BATTERY_LOW If barcode related Action has been made when battery is lower than ERROR_NOT_SUPPORTED Unsupportable API ERROR_NORMAL...
Page 19
5.3 Information Symbology ID Name Name Name SYMBOLOGY_UPC_A SYMBOLOGY_ISBT128 SYMBOLOGY_KOREAN_POST SYMBOLOGY_UPC_E SYMBOLOGY_COMPOSITE_CC_C SYMBOLOGY_US_POSTNET SYMBOLOGY_UPC_E1 SYMBOLOGY_MATRIX2OF5 SYMBOLOGY_US_PLANET SYMBOLOGY_EAN8 SYMBOLOGY_DATAMATRIX SYMBOLOGY_UPC_A_PREAMBLE SYMBOLOGY_EAN13 SYMBOLOGY_MAXICODE SYMBOLOGY_UPC_A_TRANSMIT_CHECK_DIGIT SYMBOLOGY_BOOKLAND SYMBOLOGY_AZTECCODE SYMBOLOGY_UPC_E_PREAMBLE SYMBOLOGY_SUPPLEMENTAL_CODE SYMBOLOGY_MICROPDF SYMBOLOGY_UPC_E_TRANSMIT_CHECK_DIGIT SYMBOLOGY_CODE39 SYMBOLOGY_QRCODE SYMBOLOGY_UPC_E1_PREAMBLE SYMBOLOGY_CODE93 SYMBOLOGY_TRIOPTIC_CODE SYMBOLOGY_UPC_E1_TRANSMIT_CHECK_DIGIT SYMBOLOGY_CODE128 SYMBOLOGY_DISCRETE2OF5 SYMBOLOGY_EAN8_EXTEND SYMBOLOGY_INTERLEAVED2OF5 SYMBOLOGY_USPS4CB SYMBOLOGY_EAN_TRANSMIT_ISSN SYMBOLOGY_CODABAR SYMBOLOGY_AUSTRALIA_POST...
Page 20
5.4 Information Symbology ID Name Name Name SYMBOLOGY_MATRIX2OF5_SUPPLEMENTAL_RE SYMBOLOGY_CODE39_CHECK_DIGIT SYMBOLOGY_CODE11_LENGTH_MIN DUNDANCY SYMBOLOGY_CODE39_TRANSMIT_CHECK_DIGIT SYMBOLOGY_CODE11_LENGTH_MAX SYMBOLOGY_MATRIX2OF5_CHECK_DIGIT SYMBOLOGY_MATRIX2OF5_TRANSMIT_CHECK_ SYMBOLOGY_CODE39_FULL_ASCII SYMBOLOGY_CODE11_CHECK_DIGIT DIGIT SYMBOLOGY_CODE11_TRANSMIT_CHECK_DIGI SYMBOLOGY_CODE93_LENGTH_MIN SYMBOLOGY_COMPOSITE_CC_AB SYMBOLOGY_CODE93_LENGTH_MAX SYMBOLOGY_MSI_LENGTH_MIN SYMBOLOGY_COMPOSITE_TLC_39 SYMBOLOGY_CODE128_LENGTH_MIN SYMBOLOGY_MSI_LENGTH_MAX SYMBOLOGY_COMPOSITE_UPC SYMBOLOGY_CODE128_LENGTH_MAX SYMBOLOGY_MSI_CHECK_DIGIT SYMBOLOGY_DATAMATRIX_INVERSE SYMBOLOGY_CODE128_EMULATION SYMBOLOGY_MSI_TRANSMIT_CHECK_DIGIT SYMBOLOGY_DATAMATRIX_ONLY SYMBOLOGY_INTERLEAVED2OF5_LENGTH_MIN SYMBOLOGY_MSI_CHECK_DIGIT_ALGORITHM SYMBOLOGY_DISCRETE2OF5_LENGTH_MIN SYMBOLOGY_INTERLEAVED2OF5_LENGTH_MAX SYMBOLOGY_GS1_LIMITED SYMBOLOGY_DISCRETE2OF5_LENGTH_MAX SYMBOLOGY_INTERLEAVED2OF5_CHECK_DIGIT SYMBOLOGY_GS1_LIMITED_SECURITY_LEVEL SYMBOLOGY_US_TRANSMIT_CHECK_DIGIT...
Page 21
5.5 Information Symbology ID Name Name Name SYMBOLOGY_CONVERT_UPCE1_TO_A SYMBOLOGY_MICROQR SYMBOLOGY_CONVERT_CODE39_TO_32 SYMBOLOGY_HANXIN SYMBOLOGY_CONVERT_I2OF5_TO_EAN13 SYMBOLOGY_HANXIN_INVERSE SYMBOLOGY_CONVERT_GS1_TO_UPCEAN SYMBOLOGY_IATA SYMBOLOGY_GS1_DATABAR_EXPANDED SYMBOLOGY_EAN128 SYMBOLOGY_GS1_128_EMULATION_FOR_UCC_CO SYMBOLOGY_UPC_D MPOSITE_CODE SYMBOLOGY_INVERSE_1D SYMBOLOGY_GS1_DATABAR SYMBOLOGY_UPU_FICS_POSTAL SYMBOLOGY_SCANLET SYMBOLOGY_UPC_COMPOSITE_MODE SYMBOLOGY_CUECODE SYMBOLOGY_AZTEC_INVERSE SYMBOLOGY_SIGNATURE_CAPTURE SYMBOLOGY_SPECIFIC_REDUNDANCY_LEVEL SYMBOLOGY_AUSTRALIA_POST_FORMAT SYMBOLOGY_TRANSMIT_UK_POST_CHECK_DIGIT SYMBOLOGY_CODE32_PREFIX SYMBOLOGY_USER_SUPPLEMENTAL_1 SYMBOLOGY_USER_SUPPLEMENTAL_2...
Need help?
Do you have a question about the BP30 and is the answer not in the manual?
Questions and answers