SVD File XML Header Parsing Issue in GD32F30x Pack Causes pyocd Board Detection Failure

When attempting to flash/debug GD32F303RC (and likely other GD32F30x series chips) using pyocd, the following error sequence occurs:
Board ID Recognition Failure:​ 0000758 W Board ID 8A62 is not recognized [mbed_board]
SVD File XML Parsing Exception:​ The pyocd SVD loader thread fails with an xml.etree.ElementTree.ParseError: XML or text declaration not at start of entity: line 1, column 2
Root Cause Analysis:

The issue appears to be in the official GD32F30x device support pack. The SVD (System View Description) XML file within the pack contains whitespace (spaces or newlines) before the XML declaration (). According to XML specification, the declaration must be at the very beginning of the file. This malformed XML causes pyocd's SVDParserto fail during device initialization.

Workaround:

The current workaround requires manual intervention:
Extract the pack file
Locate the problematic SVD file (typically GD32F30x.svdor similar)
Remove any leading whitespace before the <?xmldeclaration
Repackage the modified pack

This issue prevents proper board detection and debug functionality for GD32F30x devices using pyocd. The problem has reportedly persisted for 2-3 years, requiring users to manually fix the pack files.

Start with pyOCD's SVDParser and SVD loader path, using the GD32F30x.svd file described in the issue as the reproduction case. Check how leading whitespace before the XML declaration is handled, then identify or add a focused parsing test. Done means GD32F30x packs load without the XML ParseError and device initialization can proceed.