; --------------------------------------------------------------------------------
; @Title: CMSIS-SVD to TRACE32 Peripheral File Converter
; @Description:
;   An ARM CMSIS-SVD file (*.svd, *.xsd) describes the peripherals of a device in
;   an XML file and it can be used to create peripheral awareness in the TRACE32
;   debugger by converting it to a TRACE32 peripheral description file (*.per).
; @Keywords: CMSIS, SVD
; @Author: PEG
; @Copyright: (C) 1989-2022 Lauterbach GmbH, licensed for use with TRACE32(R) only
; --------------------------------------------------------------------------------
; $Id: readme.txt 20238 2022-12-27 15:09:32Z rtylka $

What is CMSIS-SVD:
The ARM "Cortex Microcontroller Software Interface Standard" (CMSIS) is a vendor-
independent hardware abstraction layer especially for the Cortex-M processor series.
The "System View Description" (SVD) for peripherals defines how to describe
peripheral register of a device in an XML file. Some chip vendors use this 
specification to describe the peripheral register of their chip and provide the
description files (*.svd, *.xsd) to their user and third-parties.

Peripheral register display on TRACE32:
In TRACE32 you select the device you intend to debug by "SYStem.CPU <device>". Then
the debugger should be aware of the included peripherals and you should be able
to view the peripheral register on higher, logical level. The TRACE32 debugger use
for this feature a device specific peripheral description file (*.per) in a TRACE32
proprietary syntax (described in general_ref_p.pdf).

When shall I use this converter:
If this *.per file is not available and you can't get it on our web site but you
have CMSIS-SVD files for this device at hand, then you could use this converter
to generate a *.per file for your device. You can call the generated file in the
TRACE32 debugger by entering "PER <filename>.per". The converter can optionally
generate a menu file (*.men) which you can use to add a pull-down menu for
viewing the peripherals by entering "MENU.ReProgram <filename>.men".

How to use the converter:
Run the svdconverter.exe on a Windows host. It requires the files perfilexmllib.dll
and svdtoxmllib.dll. A dialog opens where you need to fill in file names and where
you can select certain options. When you hover an input element with your mouse
you get a tooltip displayed which explains what you need to do. There is a "HELP"
button providing additional information. If you need help on this converter
contact support@lauterbach.com.