Troubleshooting

My Stb-tester HDMI node is offline

images/Node-offline.png

The Stb-tester node must be able to access the Stb-tester web portal over the internet using HTTPS port 443. Make sure that your network configuration isn’t preventing this.

Diagnostic information about your network connectivity can be obtained by plugging a monitor into the Stb-tester node’s HDMI output. If you need further assistance, take a photo of the diagnostic screen and send it to support@stb-tester.com.

images/hdmi-output.jpg

Live video doesn’t play in the web portal

The live video only works if you are accessing the web portal from the same local network as the Stb-tester node. If you are accessing the Stb-tester portal from a different network, select JPEG thumbnails instead.

The set-top box intermittently ignores infrared keypresses

  • Check the position of stb-tester’s infrared transmitter. This is a low-power transmitter (to avoid interfering with other set-top boxes in your test lab) so it has to be close against the set-top box’s IR receiver.

    https://stb-tester.com/assets/images/charter-ir-receiver.jpg

    Some set-top boxes are very sensitive to the placement of the transmitter; for example this image shows a set-top box that has a cylindrical shield extending around the IR receiver diode, so Stb-tester’s IR transmitter must be placed precisely in front of the diode:

    Using a torch (flashlight) can help you to see the position of the IR receiver behind the set-top box’s plastic case.

  • If you’re still seeing issues, send us your infrared configuration file to support@stb-tester.com.

OCR doesn’t understand my language

  1. Install the necessary language pack (see instructions below). Since v30, the following language packs are already installed by default:

    • Danish (dan)
    • Dutch (nld)
    • English (eng)
    • French (fra)
    • German (deu)
    • Norwegian (nor)
    • Spanish (spa)

    Before v30, only English was installed by default.

  2. Use the lang parameter when you call stbt.ocr and stbt.match_text — for example stbt.ocr(lang="dan") or stbt.ocr(lang="eng+dan").

    You can set the default language globally by setting lang in the [ocr] section of .stbt.conf. For example:

    [ocr]
lang = eng+dan

To install additional languages, create the file config/setup/setup in your test-pack:

  • On v30 or newer, use the following contents:

    #!/bin/bash -ex

# Install Japanese language support for OCR:
sudo curl -o /usr/share/tesseract-ocr/4.00/tessdata/jpn.traineddata \
  https://raw.githubusercontent.com/stb-tester/tessdata/d0a9de7/jpn.traineddata

  • On v29 or earlier, use the following contents:

    #!/bin/bash -ex

# Install Japanese language support for OCR:
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y tesseract-ocr-jpn

In both cases, change “jpn” to the three-letter ISO-639-3 language code that you want.

For more information about the config/setup/setup script see Customising the test-run environment.

My IDE can’t find the stbt APIs

Install the stb-tester Python package using pip install stb-tester. See IDE Configuration for more details.

If your IDE still can’t find the stbt APIs, make sure that you installed stb-tester into the same Python environment that your IDE is using. For example, if you have a virtualenv under the .venv folder in your test-pack checkout, make sure that you activated that virtualenv before running pip install stb-tester.

If you’re using PyCharm you can configure the project’s Python interpreter in File > Settings > Project > Project Interpreter. In the screenshot below we have configured it to use Python from the project’s .venv folder:

images/project-interpreter.png