|
| 1 | +<!-- This is a directory of XML files for a specific processor or a |
| 2 | + a set. It contains "links" to other XML files based on lookup |
| 3 | + criteria. The file is organized into Boards (target boards), |
| 4 | + Chips (processor+ASIC chip definitions), and RTOSes. |
| 5 | + The containers for each are per processor family. The processor |
| 6 | + families are such as "ARM7", "Cortex-M", etc. Within are the |
| 7 | + links per specific item. --> |
| 8 | +<!ELEMENT directory (boards*,chips*,rtoses*)> |
| 9 | + <!-- 1st is Boards. These are target boards. The name match is |
| 10 | + normally from the user specifying the board by name (at |
| 11 | + install time or dynamically or via configuration). Board |
| 12 | + lookup by mapped register value is only available for a class |
| 13 | + of boards, since there is no standards. --> |
| 14 | + <!ELEMENT boards (board*)> <!ATTLIST boards |
| 15 | + chipVendor CDATA #REQUIRED> |
| 16 | + <!-- Board defines a board by name, the chip on it, and optional |
| 17 | + description. It also has the link to the XML file with |
| 18 | + the details. Note that the board XML file may be a shared |
| 19 | + file with more than one board in it, so the consumer must |
| 20 | + look for the matching board by name. |
| 21 | + If the name has a "*" or "?" in it, those are wildcards |
| 22 | + to allow multiple matches. |
| 23 | + The chip attribute is used to search for the chip file |
| 24 | + (see "chips" below). --> |
| 25 | + <!ELEMENT board (EMPTY)> <!ATTLIST board |
| 26 | + name CDATA #REQUIRED |
| 27 | + xml_file CDATA #REQUIRED |
| 28 | + chip CDATA #REQUIRED |
| 29 | + description CDATA #IMPLIED> |
| 30 | + |
| 31 | + <!-- Chips define processor chips (processor+ASIC). These include |
| 32 | + peripherals, Flash programming information, memory layout, |
| 33 | + and vendor information. |
| 34 | + If the name has a "*" or "?" in it, those are wildcards |
| 35 | + to allow multiple matches. --> |
| 36 | + <!ELEMENT chips (chip*)> <!ATTLIST chips |
| 37 | + chipVendor CDATA #REQUIRED |
| 38 | + family CDATA #IMPLIED> |
| 39 | + <!-- Chip defines a chip by name, optionally the exact processor |
| 40 | + in it, and an optional description. It also has the link to |
| 41 | + the XML file with the details. Note that the chip XML file |
| 42 | + may be a shared file with more than one chip in it, so the |
| 43 | + consumer must look for the matching chip by name. Note that |
| 44 | + default is only filled in for one chip, and that is what will |
| 45 | + be selected if nothing requested. |
| 46 | + If the name has a "*" or "?" in it, those are wildcards |
| 47 | + to allow multiple matches. |
| 48 | + The proc attribute may be used to ensure support for the |
| 49 | + specific processor in the family. --> |
| 50 | + <!ELEMENT chip (EMPTY)> <!ATTLIST chip |
| 51 | + name CDATA #REQUIRED |
| 52 | + xml_file CDATA #REQUIRED |
| 53 | + proc CDATA #IMPLIED |
| 54 | + description CDATA #IMPLIED |
| 55 | + default (true|false) #IMPLIED> |
| 56 | + |
| 57 | + <!-- Rtoses defines embedded operating systems (and kernels and |
| 58 | + the like). RTOS is used loosely, so that even an application |
| 59 | + may be represented this way. The rtos data model allows for |
| 60 | + both intelligent structure viewing (converting fields into |
| 61 | + meaningful data, linked list and array following) and optionally |
| 62 | + agent interactions (live debug of a running system). |
| 63 | + The RTOS list allows for finding a matching rtos by name |
| 64 | + or symbol match. |
| 65 | + If the name has a "*" or "?" in it, those are wildcards |
| 66 | + to allow multiple matches. --> |
| 67 | + <!ELEMENT rtoses (rtos*)> <!ATTLIST rtoses |
| 68 | + chipVendor CDATA #REQUIRED> |
| 69 | + <!-- Rtos defines an rtos by name, optionally the chip it is |
| 70 | + for (e.g. BSP/HAL), optionally the board it is for (e.g. |
| 71 | + BSP/HAL), optionally a symbol match (to verify in the current |
| 72 | + application), and an optional description. It also has the |
| 73 | + link to the XML file with the details. Note that the rtos |
| 74 | + XML file may be a shared file with more than one rtos in it, |
| 75 | + so the consumer must look for the matching rtos by name. |
| 76 | + If the name has a "*" or "?" in it, those are wildcards |
| 77 | + to allow multiple matches. |
| 78 | + The chip and board may have "*" or "?" for matching as well. |
| 79 | + The sym_match attribute allows matching automatically based |
| 80 | + on a symbol name in the current application (to load). --> |
| 81 | + <!ELEMENT rtos (EMPTY)> <!ATTLIST rtos |
| 82 | + name CDATA #REQUIRED |
| 83 | + xml_file CDATA #REQUIRED |
| 84 | + chip CDATA #REQUIRED |
| 85 | + board CDATA #REQUIRED |
| 86 | + sym_match CDATA #REQUIRED |
| 87 | + description CDATA #IMPLIED> |
| 88 | + |
0 commit comments