[ISSUE-214] Add Support for Power Tracing

[hkpeprah]

[ISSUE-214] Add Support for Power Tracing

Overview

This PR adds support to PyLink for using the Power Trace API. Example usage:

import time

import pylink
import pylink.enums


if __name__ == "__main__":
    jl = pylink.JLink()
    jl.open()

    try:
        channels = jl.power_trace_get_channels()
        print(f"{channels=}")

        channel_caps = jl.power_trace_get_channel_capabilities(channels)
        print(f"{channel_caps=}")

        freq = jl.power_trace_configure(channels, channel_caps.max_sample_freq / 10, pylink.enums.JLinkPowerTraceRef.TIME, True)
        print(f"{freq=}")

        jl.power_trace_start()
        time.sleep(0.1)

        num_items = jl.power_trace_get_num_items()
        print(f"{num_items=}")

        items = jl.power_trace_read(num_items)
        print(f"{items=}")

        jl.power_trace_flush()
        jl.power_trace_stop()
    finally:
        jl.close()

Summary of Changes

1. Updated pylink/__main__.py to handle old and new six with with_metaclass.
2. Added power trace enums.
3. Added power trace API methods.
4. Added power trace structures.
5. Updated unit tests.

[bbrown1867]

Should we test the channel values are in the range of 0-7?

[hkpeprah]

Yah. Are you thinking of filtering out the values outside of the range, or raising a ValueError? I think either could work here.

[bbrown1867]

Was thinking along the lines of a ValueError or just an assert.

[diggit]

Hi,
I can confirm it works with my J-Link Base Compact.

My observations (not relevant to pylink):

channels=[0]
channel_caps=JLinkPowerTraceChannelCaps(SampleFreq=1000Hz, MinDiv=1)

• 1 kHz maximum sample rate
• 1 mA resolution, but the quantization step seems to be much larger, possibly around 12 mA (observed only values: 5, 17, 43, 56, 69, 82 - not an extensive test)