@@ -94,13 +94,7 @@ osThreadNew(cmsis_dv, NULL, NULL);
9494to run all the tests that you have chosen in the next step.
9595
9696
97- \section step4 Step 4: Configure the CMSIS-Driver Validation framework in DV_Config.h file
98-
99- Open <b>DV_Config.h</b> under the <b>CMSIS Driver Validation</b> group in the Project window.
100-
101- In the configuration file <b>DV_Config.h</b> select <b>Plain Text</b> as the <b>Report Format</b>.
102-
103- \section step5 Step 5: Configure the interface settings and tests in related DV_interface_Config.h files
97+ \section step4 Step 4: Configure the interface settings and tests in related DV_interface_Config.h files
10498
10599Each interface has a related <b>DV_<i>interface</i>_Config.h</b> file, where <i>interface</i> represents interface's acronym or abbreviation.<br>
106100For example for Serial Peripheral Interface (SPI) related config file name is DV_SPI_Config.h.
@@ -109,7 +103,7 @@ For details on interface specific configuration and test selection please check
109103<a class="el" href="./modules.html">Reference</a> of the related interface.
110104
111105
112- \section step6 Step 6 : Configure the Heap memory
106+ \section step5 Step 5 : Configure the Heap memory
113107
114108Depending on the buffer sizes used for data transfer tests the heap size has to be adjusted to provide enough memory for these
115109buffers to be allocated.<br>
@@ -120,15 +114,15 @@ Set the <b>heap size</b> to minimum of <b>16384</b> bytes.
120114For details on heap requirements please refer to the \ref heap_req "Heap Memory requirements" documentation.
121115
122116
123- \section step7 Step 7 : Configure the CMSIS-RTOS2 (Keil RTX5)
117+ \section step6 Step 6 : Configure the CMSIS-RTOS2 (Keil RTX5)
124118
125119Open <b>RTX_Config.h</b> and set:
126120- <b>System Configuration: Global Dynamic Memory size [bytes]</b> to \a 16384
127121- <b>Thread configuration: Default Thread stack size [bytes]</b> to \a 3072
128122
129123For details on CMSIS-RTOS2 requirements please refer to the \ref rtos2_req "CMSIS-RTOS2 requirements" documentation.
130124
131- \section step8 Step 8 : Configure the Device
125+ \section step7 Step 7 : Configure the Device
132126
133127Depending on your device, you might have different pin/hardware configuration options. Usually, you can configure the device
134128using the \c RTE_Device.h file from the \b Device group or with a vendor provided pin configuration tool.
@@ -142,7 +136,7 @@ For a robust test with good coverage, implement various targets with different s
142136 <b>Options for Target</b> dialog
143137
144138
145- \section step9 Step 9 : Setup the required hardware
139+ \section step8 Step 8 : Setup the required hardware
146140
147141For the interfaces that support loopback testing: \ref dv_eth "Ethernet", \ref dv_usart "USART" and \ref dv_spi "SPI",
148142connect the following pins on your target hardware together (refer to the hardware schematics):
@@ -158,7 +152,7 @@ connect the related hardware as required by the related server:
158152- SPI: MOSI, MISO, SCLK, SS, GND to the same lines on the \ref spi_server
159153
160154
161- \section step10 Step 10 : Download and Run the Project
155+ \section step9 Step 9 : Download and Run the Project
162156
163157In the <b>Options for Target</b> dialog, under debug settings, if you use ITM as standard output channel ensure that
164158\b Trace and <b>ITM port 0</b> are enabled and that the correct <b>Core Clock</b> frequency is set:
@@ -242,37 +236,28 @@ Test Result: PASSED
242236/**
243237\page report Report
244238
245- The CMSIS-Driver Validation can output the test report in a <b>Plain Text</b> format or as an <b>XML</b> formatted file.<br>
246- Selection of the output report type is done in the <b>DV_Config.h</b> configuration file.
239+ The CMSIS-Driver Validation outputs the test report in a <b>Plain Text</b> format.
247240
248- \image html dv_config_h.png "Configuration file DV_Config.h in Configuration Wizard view mode"
241+ This report can be viewed using the <b>Debug (printf) Viewer</b> window or any terminal application.
249242
250- The <b>Plain Text</b> selection instructs the CMSIS-Driver Validation framework to generate a plain text report
251- which can be seen in the <b>Debug (printf) Viewer</b> window and is mostly used for driver debugging purposes
252- but can also be used as a final report.
253-
254- The <b>XML</b> selection instructs the CMSIS-Driver Validation framework to generate an XML formatted report
255- which is meant to be used as a final report and can be viewed nicely in any Web browser.<br>
243+ An example of a report captured in a terminal application is shown below:
244+ \verbatim
245+ CMSIS-Driver_Validation v3.1.0 CMSIS-Driver GPIO Test Report Oct 9 2025 09:15:16
256246
257- The report file can be written into a <b>TestReport.xml</b> file directly by the uVision with an additional debugger script
258- called <b>SaveXML.ini</b> which needs to be specified as <b>Initialization File:</b> for the <b>Debugger</b> in the
259- <b>Options for target</b> dialog, or it can be copy-pasted manually from the <b>Debug (printf) Viewer</b> window to
260- the TestReport.xml file.<br>
261- The SaveXML.ini script can be found in <c>\<pack root directory\></c><b>\\Scripts</b> directory.
247+ TEST 01: GPIO_Setup PASSED
248+ TEST 02: GPIO_SetDirection PASSED
249+ TEST 03: GPIO_SetOutputMode PASSED
250+ TEST 04: GPIO_SetPullResistor PASSED
251+ TEST 05: GPIO_SetEventTrigger PASSED
252+ TEST 06: GPIO_SetOutput PASSED
253+ TEST 07: GPIO_GetInput PASSED
262254
263- To view <b>TestReport.xml</b> file in a Web browser an additional style sheet <b>TR_Style.xsl</b> file needs to be
264- in the same directory as the TestReport.xml file.<br>
265- The TR_Style.xsl file contains the description of formatting for the Web browser to display the TestReport.xml report and
266- can be found in <c>\<pack root directory\></c><b>\\Scripts</b> directory.
255+ Test Summary: 7 Tests, 7 Passed, 0 Failed.
256+ Test Result: PASSED
267257
258+ \endverbatim
268259
269- The XML file uses coloring to differentiate the results in the following way:
270- - <span style="font-weight:bold; color:Green">Passed</span> status means that test function has passed successfully.
271- - <span style="font-weight:bold; color:DarkOrange">Passed</span> status means that test function has passed but there were some warnings
272- (<c>More details</c> can be used to see the details about warnings).
273- - <span style="font-weight:bold; color:Blue">Not executed</span> status means that test function did not check any assertions.
274- - <span style="font-weight:bold; color:Red">Failed</span> status means that test function has failed
275- (<c>More details</c> can be used to see the details on reasons of failure).
260+ > **Note:** XML format was deprecated and removed, only <b>Plain Text</b> mode is available now.
276261
277262*/
278263/*=======0=========1=========2=========3=========4=========5=========6=========7=========8=========9=========0=========1====*/
@@ -365,10 +350,6 @@ of the 25 executed tests have passed.
365350
366351This report could be used as an insurance that the SPI Driver on this device is compliant to the CMSIS-Driver specification.
367352
368- The TestReport.xml report created instead of Plain Text opened in a Web browser looks similar to the the picture below:
369-
370- \image html xml_report.png "XML test report"
371-
372353*/
373354/*=======0=========1=========2=========3=========4=========5=========6=========7=========8=========9=========0=========1====*/
374355/**
@@ -445,7 +426,6 @@ The following example projects are available:
445426<b>Project Targets</b>
446427
447428The example projects may contain some of the following target configurations:
448- - <b>Create Report</b>: test results and statistics are stored in the <b>TestReport\TestReport.xml</b> file, that can be viewed with a web browser.
449429- \b Debug: test results and statistics are printed to the <b>Debug (printf) Viewer</b> window or to the <b>Virtual COM Port</b> through the on-board debugger.
450430- \b Release: same as the Debug target but with higher level of code optimization selected.
451431*/
0 commit comments