A2 Remote Shell web App – User Guide

Version A1.0.0 (31.12.2023)

1. Principle of operation

AndiScan Remote Shell Application enables to remotely control the device, remotely view the displayed and measured data and access the stored data. It uses web Bluetooth (BLE Bluetooth Low Energy) technology to connect to the AndiScan device. The application operates inside the supported web browser on arbitrary remote device platform (iOS, Android, Mac, Windows, Linux). The application web page can be used either on-line or locally stored on the remote access device (if there is no on-line Internet access). Locally stored application web page might have some limitations of (future) features, e.g. access to on-line updates, etc.

  • On-line Remote Shell Application (RemShApp)
  • Locally stored RemShApp – Download the web page from the link above and store it locally on your remote access device file system. In order to use it, simply open this file from your BLE compatible web browser.

2. Compatibility

  • AndiScan A2 device must have firmware A2.5.44/A2.4.33 (and later)
  • Remote access device HW must support BLE.
  • Web browser must support Web Blootooh API. This is a list of recommended tested browsers on various platforms.
    • Mac – Google Chrome. It must be installed by the user.
    • Windows – Google Chrome. It must be installed by the user.
    • Android – Google Chrome. It should be a part of standard Android system.
    • iOS – Bluefy It must be installed by the user.

3. Starting the application and connecting AndiScan

  1. Open a BLE compatible web browser on your remote access device. 
  2. On AndiScan, go to the config page C5 and select BLE Communication Interface, and leave the config mode to make this change active. BLE icon appears on AndiScan status line. 
  3. Open RemShApp. There are 3 tabs
    • Device – for accessing device related functions
    • Remote Control – this the main remote control and display screen
    • Data – for listing, viewing and storing the data from AndiScan
  4. In RemShApp Device tab, fill the device password shown in C5 config page. This will make sure, that it connects with your device and no one else could connect to your device without knowledge of the password. This needs to be done only once for a first time you use a given browser. The password will be stored locally in your browser and pre-filled for a subsequent use.
  5. Press [Connect] button. A pairing screen appears showing your AndiScan device. Pair the browser with that device. In the connection status line, yellow message “syncing – wait!” appears. AndiScan device and the browser are setting the connection and syncing the device state. It takes about 10 seconds on desktop computers. It might take a bit longer on mobile devices. Particularly in iOS with Bluefy browser it takes slightly longer. When all is done, there appears a blue message “on-line”. You can now operate remotely the device.

4. Disconnecting AndiScan

You can disconnect from web browser side or from AndiScan side.

  1. On web browser side, simply reload the page.
  2. On AndiScan side, go to C5 config screen and switch off the BLE CommIF.

5. Operating Remote Shell webApp

5.1 Device

This tab allows to connect the device and shows the device status and version.

5.2 Remote control

This tab allows to remotely control and to live-display the connected device.

The AndiScan device can be operated remotely using [Back], [Next], [Enter], [Mode] buttons. Pressing any of these directly on AndiScan or on the RemShApp is fully equivalent, you can press it on either of them with exactly the same response. For long presses on RemSh, there is a visual feedback (short darkening of the button) which informs you that the long press was recognized.

Remote Shell display values copy exactly the values shown on AndiScan measurement screen. RemShApp always shows the measurement screen values. It does not follow the screen rotation of modes (TRG/DAT/CFG) as the AndiScan device does on each press of [Mode] button. However the remote buttons still do their original operation on AndiScan.

5.3 Data

This tab allows listing and downloading data from the SD card of the connected device to the RemShApp.

  • [List] button lists the files in the folder.
  • [Load] button shows the measurement data record for a given Folder and Series and stores it locally in RemShApp for later use.

5.4 Process

This tab allows all operation with locally stored data in RemShApp. It does not need AndiScan device to be connected. 

  • [Process] button refreshes the list of locally stored data records. The list can be filtered by folder, series and date.
  • [FxxxSxx (YYYY-MM-DD hh:mm:ss) [Count]] shows the data of given folder and series and enables the bellow described operations on that data record.
  • [Save] button saves the measurement data record locally on the remote access device file system. An exact location where the file is saved depends on the remote device platform. Typically it is “Downloads” folder.
  • [Delete] button deletes the displayed data record. It deletes only the data record locally stored in the RemShApp. It does not touch the data in AndiScan.