Obtaining board system-level information: txinfo

Use txinfo to obtain board system-level information.

Run txinfo according to the following syntax:

txinfo -b boardnum

where:

Argument

Description

-b boardnum

TX board number from which to obtain information. Default is 1.


Description

txinfo issues a request for system information using txinfoSystemInfo. This request is then serviced by the $info task, which executes as part of the TX firmware. The $info task responds to the request by providing a copy of the relevant system-level information. Upon receipt of the response message containing this system-level information, txinfo displays select information. Refer to the TX INFO Library Reference Manual for more information.

The system-level information structure is defined in the txinfomsg.h include file.

The following example shows sample output from txinfo:

---------------------------------
TX board 1 System Information:
---------------------------------

    ID: cpNum: 1, BoardType: TX 5500E, serialNum: 104426053, kernel:15.28

  UTIL: idleCount: 40498654, idlePeak: 73111823

  TIME: bootMsecs: 13554 (bmsecWraps: 0), epochSecs: 1246162728
        6/28/2009 04:21:07(+554 msecs)


--------------------------
TX board 1 CPU Status:
--------------------------

CPU Util_____ 0...10...20...30...40...50...60...70...80...90...100
 Current:  26 =============
 Average:  20 ==========

CPU Temp: 30.2C [8603F] degrees
CPU  Fan: Normal

System-level information consists of the following sections:

Section

Description

Fields

ID

TX board and operating system identification.

cpNum = CP number.

BoardType = Type of TX board.

serialNum = Board serial number.

kernel = Operating system version/revision.

UTIL

System utilization area. Used for computing TX processor load.

idleCount = Counter maintained by $idle task (for computing CPU utilization).

idlePeak = Peak value that idleCount has ever reached.

TIME

Time handing area (the time since the TX board was booted and the current time of day).

bootMsecs = Number of milliseconds since boot.

bmsecWraps = Number of times bootMsecs has wrapped.

epochSecs = Number of seconds since epoch.

sysTime = System time in timestamp format.

CPU Status

TX board processor (CPU) current status.

Util = Average and current processor utilization (shown as numeric percentage and as a bar graph).

CPU Temp = Current CPU temperature.

Brd Temp = Overall board temperature.

Fan = Current state of the on-board fan or blower.


Note: txinfo is also provided as a sample application to easily obtain information such as the specific TX board type, the TX board serial number, and the current state of the CPU.