You are using an unsupported browser. Please update your browser to the latest version on or before July 31, 2020.
close

How-To: Image Pull


Overview

Image Pull is the ability to generate a small thumbnail image of the video being displayed on HDMI. In addition to being a powerful troubleshooting and diagnostic tool, Image Pull provides a more powerful user experience by giving the control system the capability of displaying a preview image inside the user interface.

Image Pull was introduced into the 2G/2G+ platform with a firmware update in version A5.21D on February 28, 2014 and is included in all releases after that date. This firmware can be applied to any Just Add Power 2G device built as early as September 2010.


Requirements

  • 2G, 3G, or MaxColor AV over IP system
  • Static routing via a router or modified default gateway
  • Minimum firmware:
    • 2G: A5.21D
    • 3G: A6.1.10
    • MaxColor: All versions

Access

To view Image Pull:

  • on 2G and 3G systems
    • Image Pull is available in BMP or PNG
    • (2G and 3G systems) go to the IP address of the device followed by /pull.bmp - http://172.16.128.1/pull.bmp
    • See Commands below to convert the default BMP image to a PNG
  • on MaxColor systems
    • Image Pull is available in JPG
    • (MaxColor systems) go to the IP address of the device followed by /pull.jpg - http://172.27.1.1/pull.jpg

Settings

Settings are applied on boot-up of the device, and persist through a reboot. Settings can be applied through the Console API of the webUI or a telnet connection.

Setting Description Variables Example
astparam s pull_on_boot {$SIZE}_{$PRI}_{$FREQ} Set default Image Pull parameters {$SIZE} = Integer width of video (320, 640, 1280, 1920, etc)
Larger image sizes may cause video stuttering
astparam s pull_on_boot 320_1_3
(default on 3G)
{$PRI} = 1 or 0
Recommend 1, as 0 will cause video stutter
{$FREQ} = Integer, number of seconds between image captures
Recommend 1 or higher
astparam s pull_on_boot Disable Image Pull None astparam s pull_on_boot
(default on 2G)
astparam save Send at the end of all other settings to Save to permanent memory None astparam save

Command

Commands are executed immediately, but do not persist through a reboot. Commands can be executed through the Console API of the webUI or a telnet connection.

Command Description Variables Example
start_image_pull {$SIZE} {$PRI} {$FREQ} Start an Image Pull process with the input variables
Stops all previous Image Pull processes
{$SIZE} = Integer width of video (320, 640, 1280, 1920, etc)
Larger image sizes may cause video stuttering
start_image_pull 320 1 3
{$PRI} = 1 or 0
Recommend 1, as 0 will cause video stutter
{$FREQ} = Integer, number of seconds between image captures
Recommend 1 or higher
stop_image_pull Stops all Image Pull processes None stop_image_pull
bmp2png -o /www/tmp.png /www/pull.bmp;mv /www/tmp.png /www/pull.png Converts the pull.bmp image to a PNG and names the file pull.png The name of the png file can be changed, but it is not recommended  

Notes on using the Commands:

  • The telnet session must remain open after start_image_pull is executed. If the telnet session is closed, the Image Pull process will stop and the image will not refresh.
  • On 2G units, start_image_pull should only be sent via TELNET. Sending through the Console API will cause device instability.
  • 90
  • 06-Dec-2022
  • 9182 Views