DHOActions for the DHO800-900 Sparrow Extended GUI

[mriscoc]

From v0.6.2 a DHO Actions apk is included in the Sparrow Extended bundle, this apk allows to create some automation using SCPI commands and STP files, also allows to launch other applications. The user can configure the buttons of this panel by editing the file in Android/media/com.rigol.dhoactions/dhoactions.json the glyphs for the buttons must be a PNG file of 80x80 pixels.

For install the DHO Actions panel, connect to the device and install via ADB. You can also install it in another Android device but only one instance can be connected at time to the DHO oscilloscope.

Note

DHO Actions must be started after the Oscilloscope application is loaded to be able to connect to it, if the Oscilloscope application closes and restarts, you must force a reconnect by pressing and holding the close icon [X] in the upper right corner of the DHO Actions screen and start it from the DHO Sparrow application.

The path for the json settings file and the buttons' PNG glyphs is: Android/media/com.rigol.dhoactions in the Android emulated storage (Internal Storage)

The format of the dhoactions.json settings file is:

{
  "dhoIP":"localhost",
  "buttons": [
    {
      "glyph": "ic_coupling_ac.png",
      "caption": "AC Coupling",
      "type": "SCPI",
      "command": ":CHAN1:COUP AC; :CHAN2:COUP AC"
    },
    {
      "glyph": "ic_coupling_dc.png",
      "caption": "DC Coupling",
      "type": "SCPI",
      "command": ":CHAN1:COUP DC; :CHAN2:COUP DC"
    },
    {
      "glyph": "browser.png",
      "caption": "Browser",
      "type": "APP",
      "command": "acr.browser.barebones"
    },
    {
      "glyph": "browser.png",
      "caption": "MathStudio",
      "type": "DOC",
      "command": "http://mathstud.io/"
    },
    {
      "glyph": "save.png",
      "caption": "Save Settings",
      "type": "SCPI",
      "command": ":SAVE:OVERlap ON;:SAVE:SETup C:/dhotools.stp"
    },
    {
      "glyph": "load.png",
      "caption": "Load Settings",
      "type": "SCPI",
      "command": ":LOAD:SETup C:/dhotools.stp"
    }
  ]
}

There are three types of buttons: SCPI, DOC and APP, the first allows to send a chain of SCPI commands, you can separate the commands using a semicolon ";" (look at the AC/DC Coupling example). The DOC buttons allow to open URL in the default browser and the APP buttons allow to run applications installed in the DHO device, for example the Lightning browser. To make a button to run an application, you need to know the package name of the application, you can get it by using this command:

$ adb shell "pm list packages -f browser"

Will give the following answer:

package:/system/app/Lightning/Lightning.apk=acr.browser.barebones

Indicating that the package name of browser is acr.browser.barebones

Here are some example PNG images:
png_images.zip

Tip

A long press on the close panel X will force the panel to reconnect to the Sparrow applications and also reload the JSON settings file.

From the version 1.1 it is possible to customize the size of the DHO Actions panel by adding numColumns and numRows before of the dhoIP value in the JSON settings file:

{
  "numColumns":4,
  "numRows":2,
  "dhoIP":"localhost",
  "buttons": [
...
  ]
}

[mriscoc]

Sample PNG icons:

Note

You need to setup Github with a dark background theme to see the white foreground with transparent background images

More icons resources:
https://pictogrammers.com/library/mdi/
https://fonts.google.com/icons

[mriscoc]

Additional applications:

DHO tools

    {
      "glyph": "dhotools.png",
      "caption": "DHO tools",
      "type": "APP",
      "command": "org.mriscoc.dhotools"
    },

icon

ElectroDoc

    {
      "glyph": "electrodoc.png",
      "caption": "ElectroDoc",
      "type": "APP",
      "command": "it.android.demi.elettronica"
    },

Your copy of ElectroDoc may have a different application ID. For the Pro version use: it.android.demi.elettronica.pro

icon

---

F-Droid

    {
      "glyph": "fdroid.png",
      "caption": "F-Droid",
      "type": "APP",
      "command": "org.fdroid.fdroid"
    },

icon

---

MathStudio

    {
      "glyph": "mathstudio.png",
      "caption": "MathStudio",
      "type": "DOC",
      "command": "http://mathstud.io/"
    },

icon

[WIZM]

What way you recommend to edit dhoactions.json ?

[mriscoc]

If you are using ADB, the path is a slightly different:
\storage\emulated\0\Android\media\com.rigol.dhoactions\dhoactions.json