chipscopy.sysmon

class chipscopy.api.sysmon.Sysmon(sysmon_tcf_node)[source]

Sysmon is the top level API for accessing System Monitor in Versal.

get_all_sensors(done=None)[source]

This function is identical to get_supported_sensors in customer releases. For VnC teams this API offers internal sensors. For information on how to use this API please contact @dkopelov or #chipscope.

Parameters

done (Optional[DoneHWCommand]) – Optional command callback that will be invoked when the response is received.

Return type

dict

Returns

A list of strings representing all sensors for the connected device.

get_measurements(done=None)[source]

Advanced API

Returns the measurement objects

Parameters

done (Optional[DoneHWCommand]) – Optional command callback that will be invoked when the response is received.

Return type

List[object]

Returns

Returns a list of measurement configuration objects

initialize_sensors(done=None)[source]

Initializes all of the server side constructs for sysmon, required for most subsequent APIs.

Parameters

done (Optional[DoneHWCommand]) – Optional command callback that will be invoked when the response is received.

Returns

No data is returned directly from this method.

refresh_measurement_schedule(done=None)[source]

Dynamically scans the SysMon to determine the sensors scheduled into the system, in order.

Parameters

done (Optional[DoneHWCommand]) – Optional command callback that will be invoked when the response is received.

Return type

Dict[int, str]

Returns

Returns a dict where the keys are the root IDs and the values are the named sensors.

stream_sensor_data(interval, done=None)[source]

This API configures polling in hw_server to stream the data from the measurement schedule (including device temps) at the specified interval.

To process the incoming data, a dm.NodeListener must be declared and registered on this node.

node_listener = dm.NodeListener(sysmon)

session.chipscope_view.add_node_listener(node_listener)

Parameters
  • interval (int) – poll period (in ms)

  • done (Optional[DoneHWCommand]) – Optional command callback that will be invoked when the response is received.

Return type

None