Test controller, intro

Commands

This is software to control and log data from many different devices (Like: DMM, power supplies, electronic load). It is not designed to use devices to their limit, but to run test where different brands of devices is used together and make a common logfile in CSV format from all of them. It can also be used for some data analyses and make charts.
It has a command line, but that is only necessary to use for more advanced stuff, for simple setup, logging and looking at data the line is not needed.

Contents
    Other documents
        Installation guide
        Documentation for main pages
        Documentation for popups
        Other documentation
        Examples
    Commands
    Other popups
    Current values
    Table
    Chart
    Scales for chart
    Histogram
    Range
    Math
    Load devices
    Generally
    Conclusion
    Notes & Download


Other documents

This document is only a introduction, the documents below will contain more details. Many of them can be access directly from TestController by pressing F1 when using the page/popup.

Installation guide
Installation guide



Documentation for main pages
Commands page documentation
Current value page documentation
Table documentation
Chart page documentation
Histogram page documentation
Scales for chart page documentation
Range page documentation
Math page documentation
Remap handles page documentation
Load devices page documentation
Configuration page documentation



Documentation for popups
Calculator popup
Timer popup
Alarm popup
Adjust scale
Log popup
Export popup
Test interface popup
Connected devices popup
Readout popup
Virtual generators
Sound card devices
Image viewer
Param adjuster

Other documentation
Functions for use in calculator and definitions

Configuration of a SCPI devices
Configuration of a non SCPI devices


Examples
Scripting example
Battery test with resistor



Commands

Commands1

This is the initial screen that is shown, it may look boring, but there is a lot of functions hidden on it. For SCPI devices it will directly pass commands to them, for other devices it has build in command parse, making it possible them. The help window will list possible commands for many devices.

For any device that can be controlled pressing the mode or setup button will open a control popup for that device:

PopupIT85121

Setup popup for an electronic load (These popups are customized for each brand/device).

PopupQPX1200

Setup popup for a power supply.

PopupDMM6500

Mode popup for a DMM.




Other popups

TestController has a collection of popups in addition to the above mode/setup popups.

PopupCalculator

A calculator, it can do all standard operations and functions, including complex numbers. It do also have a some electronic related functions.

a3

A analog scale for adjusting values.

Alarm1

A alarm that can turn devices off or just make a lot of noise.

PopupTimer

A general purpose timer to manually time stuff.

Readout

One or more readouts from devices. These popups can be customized to be transparent or not, color and size can be adjusted.



Current values

CurrentValues

Next page is the current values, when it is selected it will request values from all devices a few times each second and show them.
Some calculations are also done.



Table

Table

This is used for the logged values or for a loaded CSV file. The largest dataset I have tested with until now is 5.5 million samples with 3 devices (The 3 internal), it took 55 hours to log.
There is support for two CSV formats and a TAB format for saving and loading. The export button do also use CSV formats, but allows customizing formats, columns and select part of the data.



Chart

Chart

The chart screen is used to view and select part of the data. Any value can be used on either axis and it is possible to use logarithmic scales.

Chart1

The chart has a cursor that can do a couple of things. It is used to locate and copy position to the two boxes below the chart, this can then be used to zoom the chart and be transferred to some other pages. The cursor works directly on the raw data, not the data shown in the chart, i.e. search functions will work at any zoom.

PopupValuesFromChart

When the cursor is visible a small popup will show the values at the curser.



Scales for chart

Scales%20for%20chart

The get the best charts there is a rather elaborate setting for the scale, they can be automatic with some restriction or manually.



Histogram

Histogram

This shows the distribution of values over a range of data.

Histogram1

Up to 3 histograms can be shown at once.



Range

Range

This will do calculations over a range of the data, it can be all the data or a small part of them.



Math

Math

Want Ah, but you only have the current, this page can add columns to the table that is calculated from the other data in the table.
The formula is one or more column names and the standard mathematical operators and functions. The result is then passed to the the type that can sum over time, filter and many other things.
These calculates do also work on "Current values".



Load devices

Load%20devices

This is the inventory of the devices you have, check the ones that is connected.
All supported devices is found in the combobox at the bottom, add the devices you have to the inventory list.



Generally

Settings are automatic saved to disk, this includes: Math, Remap handles, Load devices and configuration.
Many tables can be right clicked and copied as text that can be pasted into a spreadsheet.
The shown window size is the minimum, the program can scale to a larger window.
Number input to expressions support SI prefixes, i.e. 33k or 4.7n is valid value.

The software is tested on a fairly fast Windows machine with lots of ram where is works very smoothly.
I have also tested with a limited virtual Linux machine on the same computer, doing fast logging is not a good idea there.




Conclusion

I have tested with a lot of different equipment and have added what I believe to be equipment with the same protocol. I have not retested after each change, i.e. some equipment may not work anymore (But will be fixed when I discover a problem).

The software frequently get updates, this can fix bugs or add new functions. New devices are also added to the software.

Adding new devices can not only be done by me, the configuration of a device is a plain text file that is used to configure a device driver (Multiple are included). There are some articles on configuring devices.


Notes & Download

Ideas and bug rapport can be send to my email: info@lygte-info.dk

A discussion thread about TestController can be found on EEVBlog, it is also possible to post ideas and bug rapports there.

Download program

Anybody with problems please contact my either on EEVBlog or directly on my Email, I want to know about problems and will try to improve TestController to reduce it. Improvements can be better documentation or changes in TestController, but without information about what the problems are I cannot do anything to improve.