Skip to main content

Application Home Page

The Aladdin application home page contains the following sections:

Battery​

This section displays battery related information e.g., current battery level and other battery related parameters.

Battery level indicator​

The application displays real time battery level of the connected HHS in an immersive view as shown in the screenshots below. Based on the battery level the color of the battery bar changes to show the current battery level on the home screen.

Battery_Level

Battery Information​

The application displays advanced battery information like percentage, management profile (user-customizable), charging status, source, temperature, voltage, current, charge left.

Battery_Information

Device Status​

Tap the >> icon next to the device name on the home page as shown in the first screenshot below. The HHS will make a beep sound and the application will take you to the Device Status page that displays:

  1. Device Type
  2. Firmware version
  3. Device ID
  4. Battery management profile

Device_Status

Integration​

Once connection between the application and the HHS is established, you can send commands to the scanner, or receive data from it. The Aladdin application starts a foreground service that keeps the communication with the scanner alive. When the foreground service is running, the mobile device running the application will show a persistent notification in the notification window. This foreground service does not start on boot, but only when connection with the HHS is established. With the help of foreground services, the application provides four interface methods:

  • Keyboard
  • Intent
  • WebSocket
  • SDK

Integration

Note

On Android 13 and above versions the app notifications are disabled by default. You may need to enable notifications manually to view foreground service notification.

Keyboard​

When Keyboard Method is enabled as Integration, the custom Aladdin keyboard receives the data from the HHS. For this to work, you need to enable Aladdin keyboard during the onboarding step.

Tap "Android Settings" > "Language & Inputs" > "On-Screen Keyboards" and select "Aladdin" as the keyboard input.

Use the diverse options available in the Aladdin app under Keyboard settings to copy the data received from the HHS and paste it anywhere (e.g., Web Browser, Notes, Clipboard etc.) on your mobile device.

Switch Keyboard​

You have the option to switch between the default keyboard and the Aladdin keyboard via dedicated setting, as shown in the screenshot below.

Switch_Keyboard

If you have not selected the Aladdin keyboard during the initial HHS onboarding, the application will display a hint on the top of the integration landing page as shown in the screenshot below.

Choose_Keyboard

Keyboard settings​

  • Standard – Barcode data scanned by the HHS are automatically copied to web browser window, notes etc. if these applications are open.
  • Keyboard – Barcode data scanned by the HHS are copied to the clipboard, and you can manually paste them to applications like Web Browser, Notes etc.

Keyboard_Settings

Keyboard barcode Settings​

  • Append – If apps like Web Browser and Notes are open, this function will append barcode data one by one as you keep scanning multiple barcodes in succession.
  • Substitution – This function will replace previously scanned barcode data with the new ones as you keep scanning multiple barcodes in succession.

Keyboard Mode​

  • Numeric – the Aladdin keyboard will display only numeric keypads.
  • Alpha Numeric – the Aladdin keyboard will display full-fledged keyboard.
  • Minimized Keyboard – you can choose to display or minimize the keyboard with this toggle.

Intent​

Select this option to set integration method as Intent. Please refer to the Intent Method User Guide for more details on the Intent feature. To use the Intent feature, install Aladdin application and pair to HHS with Aladdin foreground service running.

WebSocket​

Select this option to set integration method as WebSocket. Please refer to the WebSocket Integration User Guide for more details on the WebSocket feature. To use the Intent feature, install Aladdin application and pair to HHS with Aladdin foreground service running.

SDK​

Select this option to set integration method as SDK. Please refer to the SDK Integration User Guide for more details on the SDK feature. To use the Intent feature, install Aladdin application and pair to HHS with Aladdin foreground service running.

Configuration​

Once paired, a scanner configuration can be queried by the Aladdin application. The application can apply a minimal set of configurations (available even remotely). The following configurations are available to view and modify:

  • Pairing (Disconnection Timeout)
  • Feedback and Aiming (e.g. Beeper, Lateral LED, Vibration, Vibration duration, Aiming)
  • Battery (e.g. Battery profile, standby timeframe)
  • Device Key (e.g. Reading mode, Bluetooth link to host check, Battery status, Unlink etc.)
  • Reading (e.g. Pick list mode, Mobile phone display)
  • Symbologies 1D, 2D and Postal (e.g., 39, 128, UPC/EAN, Interleaved 2 of 5, POSTNET, IMB, QR, Datamatrix, Aztec, Maxicode, Green Spot Duration, Beeper duration)
  • Barcode Encoding (Unicode, Simplified Chinese, Korean)
  • Scan History toggle button.

Configuration

Configuration_2

It is also possible to configure the device by downloading configuration from the Aladdin configurator website and scanning the downloaded QR code (see the barcode icon on top right corner of the image above).

MDM​

Mobile Device Management (MDM) software allows administrators to control, configure and manage a large fleet of mobile devices remotely.

To configure the HHS remotely, the application must be integrated with an MDM (e.g. AirWatch). To enable/disable, configure the HHS remotely or change user interface (SDK, WebSocket…), you need to create the configuration on the Aladdin Cloud Portal and apply it via MDM.

Firmware Upgrade​

Aladdin application supports Firmware upgrade for the HHS via web services. It allows the HHS firmware to be upgraded over the air (OTA) whenever the latest version is available. This ensures the device is up-to-date with the latest features and security updates and performs at optimum level.

The application provides 2 options for Firmware upgrade: Manual and Automatic mode.

Manual OTA upgrade​

This feature requires you to manually check for firmware updates.

Manual_OTA

Automatic OTA upgrade​

In Automatic upgrade, you can set a time of your choice for firmware upgrade to be scheduled and installed. The application provides an intuitive UI to the user to set the time as shown in the screenshot below.

Automatic_OTA

Based on the selected time, the application will check for firmware availability and if a new version of firmware is available, it will automatically begin to download and install the new firmware.

The application also shows if the current firmware is up-to-date or if the latest version is available, as shown in the screenshot above. For this feature to work, Mobile device must be connected to internet.