PDA-600 Software Change Notes -------------------------------------------------------------------------- version 2.4 patch published 06/07/2022 -------------------------------------------------------------------------- API DLL changes - addressed a logging buffer overflow issue. - corrected an issue in pda_get_vport_level related to the max level returned when the instrument is configured for 4 pair operation. - modified the message that is displayed when the user defined Vport level is overridden as a result of user defined level < measured Von. Added leading and trailing newlines, and prepended "INFORMATION" to make the message prominent in the GUI Status window. -------------------------------------------------------------------------- version 2.4 published 03/11/2022 -------------------------------------------------------------------------- API DLL changes - modified Ppeak violation check to use a counter, and flag a violation only if two or more adjacent samples exceed Ppeak. If only a single sample exceeds Ppeak, the counter will be reset on the next sample. Modified conformance test reporting of the max power level - if no Ppeak violation is flagged, the max value returned by pda_evaluate_trace_stats will be clipped to peakLimit, so the reported value will be consistent with the P/F state. - added constrain measured value to instrument uncertainty in pda_mfg_test for Iclass, and for all passive parameters in both 802.3at and 802.3bt conformance tests. - corrected a test logic issue that was preventing an 802.3bt Conformance Test sequence from running if the user had configured the instrument for LAN THRU. - corrected an issue that was introduced in the test sequence that was causing an error when the CT was run on an instrument that was not licensed for 2 Event classification. Tcl changes - corrected an issue in pda_wait_meas (pda600_library.tcl) where a use of $tkCallback was not conditioned for the case where the caller had not defined a callback (i.e. proc called directly from a console). -------------------------------------------------------------------------- version 2.3 patch published 12/06/2021 -------------------------------------------------------------------------- API changes - corrected pda_meas_vrefl meter used when DUT is SINGLE signature vs meter used when DUT is DUAL signature. -------------------------------------------------------------------------- version 2.3 published 10/25/2021 -------------------------------------------------------------------------- API changes - added support for a finite length transient trace. Publically accessible property functions pda_set_transient_length, pda_get_transient_length, pda_get_transient_acq. Extended pda_set_transient_config and pda_get_transient_config to support new trace mode. - modified conformance tests to perform a power up transient check if the connected instrument is running fw > 2.07 (finite length transient support was added in v 2.08). This addresses an interop issue encountered where a DUT exhibited a narrow, high transient after Tinrush, causing a PSE with very aggressive foldback to 'starve' the DC to DC startup, causing power up to fail. - extended CSV result file writers to support new parameter IlimMinViolation (802.3at CT CSV version 2.1, 802.3bt CT CSV version 31.0) - added filtering function to removing artifacts from the voltage trace that can be introduced when the DUT oscillates at turn on. Voltage spikes > 4V have been observed with the Von trace performed for certain Type 4 PDs. Function restores the trace data to a 'clean' linear ramp, allowing it to be used to lookup the voltage at the index where the current indicates the DUT turns on. Tcl Library changes - extended pda_transient command to support finite length transient trace. Config query extended to include HOLDOFF, MAX_LEN, and NUM_ACQ values. Stat query now supports TIMEOUT state. -------------------------------------------------------------------------- version 2.2 published 07/06/2021 -------------------------------------------------------------------------- API changes - added prompt to query user if the DUT can be externally powered in the 802.3bt Conformance Test, new test routine to check to insure that the device is not feeding the PI while being externally powered. - added capability to produce an EA GEN2 report - added check to constrain the test for 1 cycle performing an EA GEN2 test - added writeCSVActiveFPrecord for Vport_ext for each pairset when performing an EA GEN2 test - moved stmt storing type1Vport to occur after Von/Voff test, which is now used to determine whether or not Von < user defined level (which now defaults to 38.0 on the GUI). If yes, test bias is adjusted to 42.0V. - added support to parse limits for Vport_ext in initCTActiveLimitsData Tcl Library changes - added new args -ea and ext to on-line held for pda_bt_conformance command - added check for, error if EA test defined (rptType == PDA_EA_BTCT_RPT) and declSigtype == PDA_DUAL_SIG. Added check for doType3, doType4 (if declared class == 7 or 8) -------------------------------------------------------------------------- version 2.1 published 05/14/2021 -------------------------------------------------------------------------- - changed the record type from REPORT_PASS_WARN to REPORT_PASS_FAIL for Vrefl in the CSV file writer - added constrain measured values to instrument uncertainty in 802.3bt Rdet, Cdet, and Class tests - modified getIclassLimitsBasedOnBTClassNum to return accy percentage and offset values, removed calculation of expanded limits - updated 802.3bt report template to version 3.2 -- added PICS column on Note! tab, listed the various PICS items that are associated with each test group. This tab already had a column with 802.3bt clause and figure references, so that was not changed. -- updated acceptance criteria text on Note! tab for Tdelay_max, changing 0.005 sec to 5.0 ms, to match the units that are now used (and were updated in the original v3.0 report). -- corrected Acceptance Criteria column header, which still referenced 802.3at, to refer to 802.3bt -------------------------------------------------------------------------- version 2.0 published 03/15/2021 -------------------------------------------------------------------------- - modified Vhyst min to use fixed value (special case override for class 5, 6). - modified Imax Tdelay limits for 802.3bt CT, to correctly implement the critera outlined in clause 145.3.8.3 - modified classLimit value in the autoclass section of pda_do_bt_powered_on_test based on 802.3cv. If PD draws < Pclass_PD max for Class 1, set to Pclass_PD max for assigned class. - modified on-the-fly Imax_tdelay high limit determination for all 3 cases (4pr, 2pr A, 2pr B) to conform to the state diagram POWER_DELAY state defines pd_max_power = min(3, pd_req_class). - corrected issues related to DUAL signature test cases - modified Class tests to include Alt A and Alt B parameters on 802.3bt report. - added check of 802.3bt Type 3 or Type 4 PD support for 12 octet Power via MDI TLV per recommendation in 802.3cv. -------------------------------------------------------------------------- version 1.18 published 09/28/2020 -------------------------------------------------------------------------- - added new publically accessible 'macro' function pda_check_autoclass_support, which performs a class measurement, a coincident IV trace, then inspects the trace to determine whether or not the PD supports Autoclass. - increased filtering of current trace used for class stability assessment. -------------------------------------------------------------------------- version 1.17 published 03/05/2020 -------------------------------------------------------------------------- - corrected LLDP report for 802.3bt autoclass field - added a special case extensions in pdaDetermineVon and pdaDetermineVoff and to address PDs with behaviors not previously encountered. - improved responsiveness to user request to stop running Conformance Test - modifed Type 3 PHY, Type 4 PHY, and LLDP SINGLE sig calculations of IMIN and IAVG high limits in 802.3bt Conformance Test. - added check, warning for firmware < 2.07. New fw is needed to provide more protection of Cdet circuit. - modified class stability assessment algorithm. Corrected issue where events 3-5 evaluation started at first sample, not rising edge + 5ms. - added pda_4pr_mfg_test. - modified Tmpdo increment in checkForViolations and checkFor4prViolations - modified pda_do_bt_vonvoff_test to perform class measurement, followed by class reset, follwed by Von ramp. This addresses a vulnerability discovered with a PD controller that presents signature above Vclass_PD max until Von reached. -------------------------------------------------------------------------- version 1.16 published 09/06/2019 -------------------------------------------------------------------------- - added pda_set_override_alt and pda_get_override_alt, extended trace config functions to support new altoverride field. - extended Analyze tab on GUI to allow user to configure a 4pair trace or a 2pair trace of a specific ALT, when the instrument is configured for 4pair operation. - modified pda_get_version to pack the API library version into a packed 32-bit 4 field value. - modified Load Monitor Connection Check (4 pair mode) to display a MessageBox if the check fails, leaving the window open (prev behavior exit with error). - added enforcement of offTime after inrush, VonVoff tests for all iterations/quads in BT CT. Corrected class decisions in LLDP test case. - extended pda_lldp_filter_log_data to produce a .csv file format file that is the required input for the new psa_bt_lldp_trace.xlsm template. - extended GUI to support Tk 8.5, 8.6. - corrected logic that was inhibiting conformance test error from being displayed in certain cases. -------------------------------------------------------------------------- version 1.15 published 04/23/2019 -------------------------------------------------------------------------- - corrected an issue in Load Monitor dialog that occurred when the user has performed a 1-event classification based power up on the Analyze tab, then opened the LM and configured a 2 event classification, then pressed Start, causing an error. - added new correction factor determination in class margin measurement. - added alloc power level based decision to adjust assigned class for 802.3at branch (was only implemented for .bt branch), to correct LLDP based scale adjust on the Load Monitor. - extended Load Monitor to support 802.3bt LLDP. - corrected 29 octet Power via MDI TLV formation, removing unexpected 0 padding being introduced (compiler emitted code not honoring binary layout defined with #pragma pack(1)). - added additional information to error messagebox when WARNING reported by pda_read_device_settings. -------------------------------------------------------------------------- version 1.14 published 12/21/2018 -------------------------------------------------------------------------- - in pda_connect, added handle and serial number to the message text that is prepended to the WARNING from a PI check that discovers that the source is still ON. - added additional information to the error message synthesized by pda_check_pi_voltage when the source is discovered to be ON. - in pda_mfg_test, increased timeout = 45; for the Cdet measurement, to account for a use model where this test is used in a repetitive sequence. - extended pda_meas_rdet_at_margins to always produce a log file under pdaResults. Added logic to inhibit runtime error if a given voltage set point cannot be achieved. - added publically accessible function pda_meas_class_reset. -------------------------------------------------------------------------- version 1.13 published 11/06/2018 -------------------------------------------------------------------------- - added PI voltage check, to detect issues where a relay may have failed, leading to unexpected connections. Certain newer FET bridges have been observed to turn on under certain conditions (now removed from the hardware), leading to possible narrow, high current events. This can lead to electrical damage to the Cdet measurement circuit. - added check for PDA_WARNING response from pda_read_device_settings in pda_connect, which is a result that has been added to communicate 1) PI voltage check failed 2) connected instrument is running FW < 1.09 (HW1) or < 2.04 (HW2). Updated firmware required to support PI check, topology management during Rdet unpwr measurements. - corrected copy and paste issue in pda_meas_iclass_ext - extended pda_stream_trace_to_disk to work with new tracking logic related to source state. - updated pda_meas_rdet_unpwred_pair, remove the code block that checks and adjusts the polarity prior to performing the measurement, and the code block that reverts the polarity change at the end (if changed). -------------------------------------------------------------------------- version 1.12 published 09/26/2018 -------------------------------------------------------------------------- - added publically accessible functions pda_meas_vrefl and pda_vrefl_calibration - extended LLDP at the API level to support 802.3bt extensions. - added support for base PDA-604A (up to 3 event classification). - Corrected LLDP INITIAL values and CT handling for Type 1 PDs (finally got results from a actual real world Type 1 in the wild…). -------------------------------------------------------------------------- version 1.11 published 07/23/2018 -------------------------------------------------------------------------- - added suppression of current glitches caused by the on-board 0.47uF cap. - added support for 4-pair operation (powering, average, trace meters). - Changes made in binary API, Tcl application layer, and GUI. - expanded class result to use 802.3bt class definitions, break out assigned vs advertised class. - added 802.3bt connection check. -------------------------------------------------------------------------- version 1.10 published 03/02/2018 -------------------------------------------------------------------------- - Load Monitor GUI was not always clearing VIOLATION annunicators from run to run. - add squelch unrealistically low values (< 0.1mA) in pda_process_trace. - added code to clip current below 0.1mA to 0 when processing Von/Voff traces, to address an issue encountered with Von where a long series of 0mA with a few samples of a very low noise burst (0.048) caused an invalid transition detection. -------------------------------------------------------------------------- version 1.9 published 10/26/2017 -------------------------------------------------------------------------- - Add support for PDA-600 HW version 2 based instruments. - Added Rdet and Class margin measurements to Conformance Test (when running on HW version 2 instruments). - Added conditional output of Rdet and Class margin parameters to conformance test report based on HW version (meters added in HW version 2). - Added EA test support. - Error messages improved in all RC files. Implementation of pda_config also changed to tolerate one (or more) devices where the USB is connected but AC power is turned off, which is now reported vs causing an error. -------------------------------------------------------------------------- version 1.8 published 05/22/2017 -------------------------------------------------------------------------- - Added set/get functions to allow control of the new LAN switch. - Extended GUI to support LAN switch on the LLDP tab (renamed as LAN/LLDP). - Modified the behavior of the Class-Pwr Gap setting in the Source control group (spin box is labelled as such when 1-Event classification is selected) to allow settings in the range of 0..400, to map to the new pda_class delay arg. This allows 3 different PSE behaviors to be emulated: 1) PSE that transistions directly from Vclass to Vport_PD 2) PSE that exhibits a voltage dip in the Vmark_th range for ~300us while transitioning. 3) PSE that turns off any current sourcing after the completion of the class pulse, allowing voltage to drop as low as Vreset. -------------------------------------------------------------------------- version 1.7 published 12/15/2016 -------------------------------------------------------------------------- - Load Monitor randomly indicates an MPS VIOLATION, when the underlying stream data does not show any evidence of an actual violation, and none of the MPS violation flags are set. Windows event handler modified to deal with race condition (GUI management vs processing underlying data stream coming in via USB). -------------------------------------------------------------------------- version 1.6 published 10/05/2016 -------------------------------------------------------------------------- - Conformance Test is not correctly flagging an MPS failure that is flagged in the underlying stream data. Decision flow corrected. - CT can report odd values for Vhyst, incorrect values for Voff (if device never actually turned off). Now forces to -1 if detected. -------------------------------------------------------------------------- version 1.5 published 09/08/2016 -------------------------------------------------------------------------- - Expand the time imposed by the MPS violation check to allow for a 1 sample guard band, to prevent false error detection. Modify the violation check logic to allow the 75msec contiguous ON time to occur anywhere in the current 325msec window. - Add a transient trace meter. - Add a firmware update 'heartbeat' to PDA-600 Interactive. - Extended pda_get_excel_path to update ~env/excelpath.txt if it contains the initial default installation information. -------------------------------------------------------------------------- version 1.4 published 05/18/2016 -------------------------------------------------------------------------- - Address an issue related to GUI control of ramp step size and dwell time when connected to instruments running firmware version 1.3. -------------------------------------------------------------------------- version 1.3 published 05/09/2016 -------------------------------------------------------------------------- - Add support for the extended firmware control exposed for the source slow ramp, which allows the step size and dwell time to be defined by the user. -------------------------------------------------------------------------- version 1.2 published 05/03/2016 -------------------------------------------------------------------------- - Add a Mfg Test API function (pda_mfg_test). Exposed as a Tcl command, created a LabView wrapper. -------------------------------------------------------------------------- version 1.1 published 02/25/2016 -------------------------------------------------------------------------- - If an instrument is connected to a host for the first time, and the user runs PDA-600 Interactive, and immediately selects the Load Monitor, runs a trace, and then clicks on "Display Trace", an error dialog will be displayed stating that pda600_trace_report.xlsm cannot be located. - API extended to insure that a fresh copy of report template is always copied to the ~Results/{SN} directory before running Excel (the Tcl implementation already did this). - Added a 'composite' query command that returns multiple, disparite settings from the instrument in response to a single query, to improve GUI load time. -------------------------------------------------------------------------- version 1.0 published 02/08/2016 -------------------------------------------------------------------------- Initial Release.