Status

Lists statistics of input sources and connections. ADMIN privilege is required for all these functions.

status/connections

Lists currently-connected client devices.

{
   "totalCount" : 1,
   "entries" : [
      {
         "id" : 1,
         "started" : 1508668447,
         "server_port" : 9982,
         "server" : "x.x.x.x",
         "type" : "HTSP",
         "peer" : "x.x.x.y",
         "user" : "xxxxxx",
         "peer_port" : 57496
      }
   ]
}

status/subscriptions

Lists currently-active subscriptions.

{
   "entries" : [
      {
         "errors" : 0,
         "title" : "epggrab",
         "in" : 85222,
         "total_in" : 25162474,
         "total_out" : 25162474,
         "id" : 75,
         "out" : 85222,
         "service" : "Silicon Labs Si2168 : DVB-T #0/Sandy/690MHz/Raw PID Subscription",
         "state" : "Running",
         "start" : 1508763840
      }
   ],
   "totalCount" : 1
}

status/inputs

Lists statistics of input devices.

For DVB-T and DVB-S tuners at least, the signal and SNR values are only non-zero while TVH is actively using the device. Some items may be missing if the device is idle.

{
   "entries" : [
      {
         "ec_block" : 0,
         "uuid" : "20f11bcaaf93afb5fc13cce31278494e",
         "signal_scale" : 2,
         "weight" : 100,
         "cc" : 1,
         "ber" : 0,
         "tc_block" : 0,
         "input" : "Montage Technology M88DS3103 #0 : DVB-S #0",
         "tc_bit" : 0,
         "unc" : 0,
         "te" : 0,
         "bps" : 2257504,
         "subs" : 1,
         "ec_bit" : 0,
         "pids" : [
            0,
            1,
            16,
            17,
            18,
            269,
            5700,
            5701,
            5703,
            5704
         ],
         "stream" : "10773H in DVB-S Network",
         "snr" : 14149,
         "signal" : -75649,
         "snr_scale" : 2
      }
   ],
   "totalCount" : 1
}

The meaning of the statistics is below. Not all input sources provide all of the values.

ber	Bit Error Rate
bps	Bandwidth (bits/second)
cc	Continuity Errors
ec_bit	Bit Error Count
ec_block	Block Error Count
pids	List of pids present in the stream
signal	Signal Strength (see below)
signal_scale	See below
snr	Signal/Noise Ratio (see below)
snr_scale	See below
stream	Stream (multiplex) name
subs	Subscribers
tc_bit	Total Bit Error Count
tc_block	Total Block Error Count
te	Transport Errors
unc	Uncorrected Blocks
weight	Weight

For signal_scale and snr_scale, a value of 1 indicates that the corresponding signal or SNR reading is relative; 65535 = 100%. A value of 2 indicates the reading is absolute; 1000 = 1dB. A value of 0 indicates that the reading is not available or not valid.

The "pids" data is only present in TVH versions 4.3.1420 and later.

status/inputclrstats

Resets the input counters to zero.

• uuid The uuid of the input device from status/inputs. More than one uuid can be specified - syntax?

connections/cancel

Disconnects one or more clients.

• id ids of the connections, obtained from status/connections. If set to 'all' then all connections are cancelled (new in 4.3.1680).

status/activity

Provide information required for assessing the suitability for entering low-power mode and a suitable time for reawakening. For example, then TVH is used as part of an appliance configuration.

{
  "current_time": 1748659324,
  "next_activity": 1748659500,
  "activities": {
    "dvr": 1748764623,
    "ota_grabber": 1748659500,
    "int_grabber": 0,
    "mux_scheduler": 1748725200
  },
  "subscription_count": 1,
  "connection_count": 2
}

For finer analysis and control, the 'activities' property contains individual scheduling times for the following activities:

• DVR Recordings

• OTA EPG Grabber

• Internal EPG Grabber

• Mux Scheduler

Times are presented as standard Unix epoch values. A value of zero indicates that nothing for that activity type is currently scheduled.

It should be noted that the times provided are strictly from the point of view of TVH internal activities and that the calling program must take into account operating system and hardware boot times when determining the precise time to reawaken the system.

Times are only reported for the EPG grabbers if there are enabled grabbers of that type. Likewise, only enabled mux schedulers are reported.

DVR recordings in progress are also included, therefore, the reported DVR time may be in the past.

The connection and subscription counts are duplications of the summaries provided by the ‘status/connections’ and ‘status/subscriptions’ API calls and are included here in order to provide a single consolidated API call for assessing the suitability for entering low-power mode.

Requires v4.3-2405.