blob: 1a6664cb40421b14ab6ee4e8d601cca478c9f975 [file] [log] [blame]
Joachim Krechdfe628f2016-07-01 15:36:52 +02001<?xml version="1.0" encoding="UTF-8"?>
2<!--
3
4 Copyright (c) 2013-2016 ARM Limited. All rights reserved.
5
6 SPDX-License-Identifier: Apache-2.0
7
8 Licensed under the Apache License, Version 2.0 (the License); you may
9 not use this file except in compliance with the License.
10 You may obtain a copy of the License at
11
12 http://www.apache.org/licenses/LICENSE-2.0
13
14 Unless required by applicable law or agreed to in writing, software
15 distributed under the License is distributed on an AS IS BASIS, WITHOUT
16 WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17 See the License for the specific language governing permissions and
18 limitations under the License.
19
Joachim Krech98aeaab2016-10-25 21:02:23 +020020 $Date: 25. November 2016
21 $Revision: 1.4.7
Joachim Krechdfe628f2016-07-01 15:36:52 +020022
23 $Project: Schema File for Package Description File Format Specification
24
25 Package file name convention <vendor>.<name>.<version>.pack
26 SchemaVersion=1.4
27
Joachim Krech98aeaab2016-10-25 21:02:23 +020028 25. November 2016: 1.4.7
29 - added multiple version types to tighten the schema checking depending on context
30 - added new generator sections for exe, web and eclipse based generators
31 - added new processor attributes Dtz = Trustzone and Ddsp = DSP instructions for ARMv8-M
32 - added new processors Cortex-M23 and Cortex-M33
33
Joachim Krech6ccd9852016-07-12 16:05:11 +020034 12. July 2016: 1.4.6
Joachim Krech98aeaab2016-10-25 21:02:23 +020035 - refined Dname string pattern restriction
Joachim Krech6ccd9852016-07-12 16:05:11 +020036
Joachim Krechdfe628f2016-07-01 15:36:52 +020037 13. June 2016: 1.4.5
38 - added: Punits to ProcessorType
39 - added: Punit to DebugType
40
41 26. April 2016: 1.4.4
42 - added: attribute defaultResetSequence to DebugType.
43 - added: <requirements> section:
44 - <packages> defining dependencies between packs
45 - <languages> defining required language support e.g. C99
46 - <compiler> defining required toolchains
47 - added: <create> section used for tool independent project description
48 - attributes: name, documentation, condition
49 - <target> specifies the board and device targeted by the project
50 - <options>
51 - <files> specifies the grouped files
52 - updated: <algorith> element
53 - added attributes: style, parameter and endian
54 - updated: <memory> element
55 - added attributes: name, access and alias
56 - deprecating attribute: id (replaced by name + access)
57
58 03. Dec 2015: 1.4.3
59 - adding attribute "sdf" to devices section element debugconfig
60
61 16. Oct 2015: 1.4.1
Joachim Krech6ccd9852016-07-12 16:05:11 +020062 - Pname, Dname, Dvariant type changed from xs:string to RestrictedString
Joachim Krechdfe628f2016-07-01 15:36:52 +020063
64 28. Aug 2015: 1.4.0
65 - deprecate devices memory tag attribute id and use
66 introduced name and access attributes instead
67 - added devices memory tag attribute: alias
68 - added devices algorithm tag attribute: style
69 - added attribute to define a default component variant
70 - added board book category: layout
71
72 29. May 2015
73 - added missing Pname attribute to GeneratorDeviceSelectType used for multi processor
Joachim Krech98aeaab2016-10-25 21:02:23 +020074 devices
75
Joachim Krechdfe628f2016-07-01 15:36:52 +020076 12. Jan. 2014
77 - allow to link a component with a generator via new component attribute
78 - generator command extended to deal with more sophisticated command lines / document sequence
79
80-->
81
Joachim Krech6ccd9852016-07-12 16:05:11 +020082<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="qualified" version="1.4">
Joachim Krechdfe628f2016-07-01 15:36:52 +020083
84 <!-- NonNegativeInteger specifies the format in which numbers are represented in hexadecimal or decimal format -->
85 <xs:simpleType name="NonNegativeInteger">
86 <xs:restriction base="xs:string">
87 <xs:pattern value="[+]?(0x|0X)?[0-9a-fA-F]+"/>
88 </xs:restriction>
89 </xs:simpleType>
90
91 <!-- Registered Device Vendors -->
92 <xs:simpleType name="DeviceVendorEnum">
93 <xs:restriction base="xs:token">
94 <xs:enumeration value="ABOV Semiconductor:126"/>
95 <xs:enumeration value="Actel:56"/>
96 <xs:enumeration value="Altera:85"/>
97 <xs:enumeration value="Altium:65"/>
98 <xs:enumeration value="Ambiq Micro:120"/>
99 <xs:enumeration value="Analog Devices:1"/>
100 <xs:enumeration value="ARM:82"/>
101 <xs:enumeration value="ARM CMSIS:109"/>
102 <xs:enumeration value="Atmel:3"/>
103 <xs:enumeration value="CSR:118"/>
104 <xs:enumeration value="Cypress:19"/>
105 <xs:enumeration value="Dialog Semiconductor:113"/>
106 <xs:enumeration value="Dolphin:57"/>
107 <xs:enumeration value="Domosys:26"/>
Christopher Seidl1c8b6512016-08-31 16:55:41 +0200108 <xs:enumeration value="Elmos Semiconductor AG:138"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +0200109 <xs:enumeration value="Ember:98"/>
110 <xs:enumeration value="Energy Micro:97"/>
111 <xs:enumeration value="EnOcean:91"/>
112 <xs:enumeration value="Evatronix:64"/>
113 <xs:enumeration value="Generic:5"/>
114 <xs:enumeration value="GigaDevice:123"/>
115 <xs:enumeration value="Holtek:106"/>
116 <xs:enumeration value="Hynix Semiconductor:6"/>
117 <xs:enumeration value="Hyundai:35"/>
118 <xs:enumeration value="Infineon:7"/>
119 <xs:enumeration value="Kionix:127"/>
120 <xs:enumeration value="Lapis Semiconductor:10"/>
121 <xs:enumeration value="Linear Technology:136"/>
122 <xs:enumeration value="Luminary Micro:76"/>
123 <xs:enumeration value="Maxim:23"/>
124 <xs:enumeration value="MediaTek:129"/>
125 <xs:enumeration value="MegaChips:128"/>
126 <xs:enumeration value="Mentor Graphics Co.:24"/>
127 <xs:enumeration value="Micronas:30"/>
128 <xs:enumeration value="Microsemi:112"/>
129 <xs:enumeration value="Milandr:99"/>
130 <xs:enumeration value="MindMotion:132"/>
131 <xs:enumeration value="NetSilicon:67"/>
132 <xs:enumeration value="Nordic Semiconductor:54"/>
133 <xs:enumeration value="Nuvoton:18"/>
134 <xs:enumeration value="NXP:11"/>
135 <xs:enumeration value="OKI SEMICONDUCTOR CO.,LTD.:108"/>
136 <xs:enumeration value="Panasonic:131"/>
137 <xs:enumeration value="Realtek Semiconductor:124"/>
138 <xs:enumeration value="Redpine Signals:125"/>
139 <xs:enumeration value="Renesas:117"/>
140 <xs:enumeration value="ROHM:103"/>
141 <xs:enumeration value="Samsung:47"/>
142 <xs:enumeration value="Silicon Labs:21"/>
143 <xs:enumeration value="SONiX:110"/>
144 <xs:enumeration value="Spansion:100"/>
145 <xs:enumeration value="STMicroelectronics:13"/>
146 <xs:enumeration value="Sunrise Micro Devices:121"/>
147 <xs:enumeration value="TI:16"/>
148 <xs:enumeration value="Texas Instruments:16"/>
149 <xs:enumeration value="Toshiba:92"/>
150 <xs:enumeration value="Triad Semiconductor:104"/>
Joachim Krech199f8df2016-08-29 16:46:44 +0200151 <xs:enumeration value="Vorago:137"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +0200152 <xs:enumeration value="WIZnet:122"/>
153 <xs:enumeration value="Xinnova:135"/>
Joachim Krech996ee322016-07-27 08:59:55 +0200154 <xs:enumeration value="Zilog:89"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +0200155 <!-- deprecated: do not use -->
156 <xs:enumeration value="Freescale:78"/>
157 <xs:enumeration value="Freescale Semiconductor:78"/>
158 <xs:enumeration value="NXP (founded by Philips):11"/>
159 </xs:restriction>
160 </xs:simpleType>
161
162 <!-- AlgorithmStyleType: allow support of different flash programming algorithm styles -->
163 <xs:simpleType name="AlgorithmStyleType">
164 <xs:restriction base="xs:token">
165 <xs:enumeration value="Keil"/>
166 <xs:enumeration value="IAR"/>
167 <xs:enumeration value="CMSIS"/>
168 </xs:restriction>
169 </xs:simpleType>
170
171 <!-- Component Class Name Type: specify your own Class in taxonomy -->
172 <xs:simpleType name="CclassType">
173 <xs:restriction base="xs:string">
174 <xs:minLength value="3"/>
175 <xs:maxLength value="32"/>
176 </xs:restriction>
177 </xs:simpleType>
178
179 <!-- Component Group Name Type -->
180 <xs:simpleType name="CgroupType">
181 <xs:restriction base="xs:string">
182 <xs:minLength value="3"/>
183 <xs:maxLength value="32"/>
184 </xs:restriction>
185 </xs:simpleType>
186
187 <!-- Component Sub Name Type -->
188 <xs:simpleType name="CsubType">
189 <xs:restriction base="xs:string">
190 <xs:minLength value="0"/>
191 <xs:maxLength value="32"/>
192 </xs:restriction>
193 </xs:simpleType>
194
195 <!-- Component Variant Name Type -->
196 <xs:simpleType name="CvariantType">
197 <xs:restriction base="xs:string">
198 <xs:minLength value="3"/>
199 <xs:maxLength value="32"/>
200 </xs:restriction>
201 </xs:simpleType>
202
203 <!-- AccessType (added in 1.4.4) -->
204 <xs:simpleType name="AccessType">
205 <xs:restriction base="xs:string">
206 <xs:pattern value="[rwxpsnc]+"/>
207 </xs:restriction>
208 </xs:simpleType>
209
210 <!-- Processor Type -->
211 <xs:complexType name="ProcessorType">
212 <!-- Pname defines an identifier for a specific processor in a multi-processor devices -->
213 <xs:attribute name="Pname" type="RestrictedString"/>
214 <!-- Punits specifies the number of processing units in a symmetric multi-processor core -->
215 <xs:attribute name="Punits" type="InstancesType"/>
216 <!-- Dcore specifies the processor from a list of supported processors -->
217 <xs:attribute name="Dcore" type="DcoreEnum"/>
218 <!-- Dfpu specifies the hardware floating point unit -->
219 <xs:attribute name="Dfpu" type="DfpuEnum"/>
220 <!-- Dmpu specifies the memory protection unit -->
221 <xs:attribute name="Dmpu" type="DmpuEnum"/>
Joachim Krech98aeaab2016-10-25 21:02:23 +0200222 <!-- Dtz specifies the processor TrustZone support -->
223 <xs:attribute name="Dtz" type="DtzEnum"/>
224 <!-- Tdsp specifies the processor support for DSP instructions -->
225 <xs:attribute name="Ddsp" type="DdspEnum"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +0200226 <!-- Dendian specifies the endianess supported by the processor -->
227 <xs:attribute name="Dendian" type="DendianEnum"/>
228 <!-- Dclock specifies the maximum core clock frequency -->
229 <xs:attribute name="Dclock" type="xs:unsignedInt"/>
230 <!-- DcoreVersion specifies the revision of the processor -->
231 <xs:attribute name="DcoreVersion" type="xs:string"/>
232 </xs:complexType>
233
234 <!-- Compile Type: -->
235 <xs:complexType name="CompileType">
236 <!-- Pname identifies the processor this setting belongs to -->
237 <xs:attribute name="Pname" type="RestrictedString" use="optional"/>
238 <!-- CMSIS-CORE device header file (sets compiler include path) -->
239 <xs:attribute name="header" type="xs:string"/>
240 <!-- Device specific preprocessor define (sets preprocessor define -->
241 <xs:attribute name="define" type="xs:string"/>
242 <!-- Processor instance specific preprocessor define (sets preprocessor define on the commandline) -->
243 <xs:attribute name="Pdefine" type="xs:string"/>
244 </xs:complexType>
245
246 <!-- DebugVarsType -->
247 <xs:complexType name="DebugVarsType">
248 <xs:simpleContent>
249 <xs:extension base="xs:string">
250 <xs:attribute name="configfile" type="xs:string" use="optional"/>
Joachim Krech98aeaab2016-10-25 21:02:23 +0200251 <xs:attribute name="version" type="ComponentVersionType" use="optional"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +0200252 <xs:attribute name="Pname" type="xs:string" use="optional"/>
253 <xs:anyAttribute processContents="lax"/>
254 </xs:extension>
255 </xs:simpleContent>
256 </xs:complexType>
257
258 <!-- DebugProtocolEnum -->
259 <xs:simpleType name="DebugProtocolEnum">
260 <xs:restriction base="xs:token">
261 <xs:enumeration value="jtag"/>
262 <xs:enumeration value="cjtag"/>
263 <xs:enumeration value="swd"/>
264 </xs:restriction>
265 </xs:simpleType>
266
267 <!-- DebugConfigType -->
268 <xs:complexType name="DebugConfigType">
269 <xs:attribute name="default" type="DebugProtocolEnum" use="optional" default="swd"/>
270 <xs:attribute name="clock" type="xs:unsignedInt" use="optional"/>
271 <xs:attribute name="swj" type="xs:boolean" use="optional"/>
272 <!-- Debugger System Description File -->
273 <xs:attribute name="sdf" type="xs:string" use="optional"/>
274 <xs:anyAttribute processContents="lax"/>
275 </xs:complexType>
276
277 <!-- JtagType -->
278 <xs:complexType name="JtagType">
279 <xs:attribute name="tapindex" type="NonNegativeInteger" use="optional"/>
280 <xs:attribute name="idcode" type="NonNegativeInteger" use="optional"/>
281 <xs:attribute name="targetsel" type="NonNegativeInteger" use="optional"/>
282 <xs:attribute name="irlen" type="xs:unsignedInt" use="optional"/>
283 <xs:anyAttribute processContents="lax"/>
284 </xs:complexType>
285
286 <!-- SwdType -->
287 <xs:complexType name="SwdType">
288 <xs:attribute name="idcode" type="NonNegativeInteger" use="optional"/>
289 <xs:attribute name="targetsel" type="NonNegativeInteger" use="optional"/>
290 <xs:anyAttribute processContents="lax"/>
291 </xs:complexType>
292
293 <!-- DebugPortType -->
294 <xs:complexType name="DebugPortType">
295 <xs:sequence>
296 <xs:element name="jtag" type="JtagType" minOccurs="0" maxOccurs="1"/>
297 <xs:element name="swd" type="SwdType" minOccurs="0" maxOccurs="1"/>
298 </xs:sequence>
299 <xs:attribute name="__dp" type="xs:unsignedInt" use="optional"/>
300 <xs:anyAttribute processContents="lax"/>
301 </xs:complexType>
302
303 <!-- DataPatchAccessTypeEnum enumeration type -->
304 <xs:simpleType name="DataPatchAccessTypeEnum">
305 <xs:restriction base="xs:token">
306 <xs:enumeration value="DP"/>
307 <xs:enumeration value="AP"/>
308 <xs:enumeration value="Mem"/>
309 </xs:restriction>
310 </xs:simpleType>
311
312 <!-- ExpressionType -->
313 <xs:simpleType name="ExpressionType">
314 <xs:restriction base="xs:string"/>
315 </xs:simpleType>
316
317 <!-- DataPatchType -->
318 <xs:complexType name="DataPatchType">
319 <xs:attribute name="type" type="DataPatchAccessTypeEnum" use="optional"/>
320 <xs:attribute name="address" type="NonNegativeInteger" use="required"/>
321 <xs:attribute name="__dp" type="xs:unsignedInt" use="optional"/>
322 <xs:attribute name="__ap" type="xs:unsignedInt" use="optional"/>
323 <xs:attribute name="value" type="NonNegativeInteger" use="required"/>
324 <xs:attribute name="mask" type="NonNegativeInteger" use="optional"/>
325 <xs:attribute name="info" type="xs:string" use="optional"/>
326 <xs:anyAttribute processContents="lax"/>
327 </xs:complexType>
328
329 <!-- BlockType -->
330 <xs:complexType name="SequenceBlockType">
331 <xs:simpleContent>
332 <xs:extension base="xs:string">
333 <xs:attribute name="atomic" type="xs:boolean" use="optional"/>
334 <xs:attribute name="info" type="xs:string" use="optional"/>
335 <xs:anyAttribute processContents="lax"/>
336 </xs:extension>
337 </xs:simpleContent>
338 </xs:complexType>
339
340 <!-- ControlType -->
341 <xs:complexType name="SequenceControlType">
342 <xs:sequence>
343 <xs:group ref="SequenceElementGroup" minOccurs="0" maxOccurs="unbounded"/>
344 </xs:sequence>
345 <xs:attribute name="if" type="xs:string" use="optional"/>
346 <xs:attribute name="while" type="ExpressionType" use="optional"/>
347 <xs:attribute name="timeout" type="xs:unsignedInt" use="optional"/>
348 <xs:attribute name="info" type="xs:string" use="optional"/>
349 <xs:anyAttribute processContents="lax"/>
350 </xs:complexType>
351
352 <!-- SequenceElementType -->
353 <xs:group name="SequenceElementGroup">
354 <xs:choice>
355 <xs:element name="block" type="SequenceBlockType"/>
356 <xs:element name="control" type="SequenceControlType"/>
357 </xs:choice>
358 </xs:group>
359
360
361 <!-- SequenceType -->
362 <xs:complexType name="SequenceType">
363 <xs:sequence>
364 <xs:group ref="SequenceElementGroup" minOccurs="0" maxOccurs="unbounded"/>
365 </xs:sequence>
366 <xs:attribute name="name" type="xs:string" use="required"/>
367 <xs:attribute name="Pname" type="RestrictedString" use="optional"/>
368 <xs:attribute name="disable" type="xs:boolean" use="optional"/>
369 <xs:attribute name="info" type="xs:string" use="optional"/>
370 <xs:anyAttribute processContents="lax"/>
371 </xs:complexType>
372
373 <!-- SequencesType -->
374 <xs:complexType name="SequencesType">
375 <xs:sequence>
376 <xs:element name="sequence" type="SequenceType" minOccurs="1" maxOccurs="unbounded"/>
377 </xs:sequence>
378 <xs:anyAttribute processContents="lax"/>
379 </xs:complexType>
380
381 <!-- DebugType -->
382 <xs:complexType name="DebugType">
383 <xs:sequence>
384 <xs:element name="datapatch" type="DataPatchType" minOccurs="0" maxOccurs="unbounded"/>
385 </xs:sequence>
386 <xs:attribute name="__dp" type="xs:unsignedInt" use="optional"/>
387 <xs:attribute name="__ap" type="xs:unsignedInt" use="optional"/> <!-- access port index -->
388 <xs:attribute name="address" type="NonNegativeInteger" use="optional"/> <!-- CPU debug block base address -->
389 <xs:attribute name="svd" type="xs:string" use="optional"/>
390 <xs:attribute name="Pname" type="RestrictedString" use="optional"/>
391 <xs:attribute name="Punit" type="xs:unsignedInt" use="optional"/>
392 <xs:attribute name="defaultResetSequence" type="xs:string" use="optional"/>
393 <xs:anyAttribute processContents="lax"/>
394 </xs:complexType>
395
396 <!-- SerialWireType -->
397 <xs:complexType name="SerialWireType">
398 <xs:anyAttribute processContents="lax"/>
399 </xs:complexType>
400
401 <!-- TracePortType -->
402 <xs:complexType name="TracePortType">
403 <xs:attribute name="width" type="NonNegativeInteger" use="optional"/>
404 <xs:anyAttribute processContents="skip"/>
405 </xs:complexType>
406
407 <!-- TraceBufferType -->
408 <xs:complexType name="TraceBufferType">
409 <xs:attribute name="start" type="NonNegativeInteger" use="optional"/>
410 <xs:attribute name="size" type="NonNegativeInteger" use="optional"/>
411 <xs:anyAttribute processContents="skip"/>
412 </xs:complexType>
413
414 <!-- TraceType -->
415 <xs:complexType name="TraceType">
416 <xs:sequence>
417 <xs:element name="serialwire" type="SerialWireType" minOccurs="0" maxOccurs="unbounded"/>
418 <xs:element name="traceport" type="TracePortType" minOccurs="0" maxOccurs="unbounded"/>
419 <xs:element name="tracebuffer" type="TraceBufferType" minOccurs="0" maxOccurs="unbounded"/>
420 </xs:sequence>
421 <xs:attribute name="Pname" type="RestrictedString" use="optional"/>
422 <xs:anyAttribute processContents="lax"/>
423 </xs:complexType>
424
425 <!-- Memory Type-->
426 <xs:complexType name="MemoryType">
427 <!-- Pname identifies the processor this setting belongs to -->
428 <xs:attribute name="Pname" type="RestrictedString"/>
429 <!-- id specifies the enumerated ID of memory (deprecated in 1.4.4) -->
430 <xs:attribute name="id" type="MemoryIDTypeEnum" use="optional"/>
431 <!-- name specifies an identifier being use to refer to this memory range description (added in 1.4.4) -->
432 <xs:attribute name="name" type="RestrictedString" use="optional"/>
433 <!-- start specifies the base address of the memory -->
434 <xs:attribute name="start" type="NonNegativeInteger" use="required"/>
435 <!-- size specifies the size of the memory -->
436 <xs:attribute name="size" type="NonNegativeInteger" use="required"/>
437 <!-- access: specifies the access permissions of the memory (added in 1.4.4) -->
438 <xs:attribute name="access" type="AccessType" use="optional" default="r"/>
439 <!-- alias: reference to another memory by 'name' to express that the same physical memory is mapped at another address (added in 1.4.4) -->
440 <xs:attribute name="alias" type="RestrictedString" use="optional"/>
441 <!-- !!! deprecated, do not use / ignore !!! specifies whether the memory shall be 0 initialized -->
442 <xs:attribute name="init" type="xs:boolean" use="optional" default="0"/>
443 <!-- specifies whether the memory is used as default by linker -->
444 <xs:attribute name="default" type="xs:boolean" use="optional" default="0"/>
445 <!-- specifies whether the memory shall be used for the startup by linker -->
446 <xs:attribute name="startup" type="xs:boolean" use="optional" default="0"/>
447 </xs:complexType>
448
449 <!-- Algorithm Type -->
450 <xs:complexType name="AlgorithmType">
451 <!-- Pname identifies the processor this setting belongs to -->
452 <xs:attribute name="Pname" type="RestrictedString" use="optional"/>
453 <!-- name specifies the path and filename of the Flash Programming Algorithm -->
454 <xs:attribute name="name" type="xs:string" use="required"/>
455 <!-- start specifies the base address of the memory range that gets programmed -->
456 <xs:attribute name="start" type="NonNegativeInteger" use="optional"/>
457 <!-- size specifies the size of the memory range that gets programmed -->
458 <xs:attribute name="size" type="NonNegativeInteger" use="optional"/>
459 <!-- RAMstart specifies the base address in RAM from where the algorithm is executed -->
460 <xs:attribute name="RAMstart" type="NonNegativeInteger" use="optional"/>
461 <!-- RAMsize specifies the available RAM for executing the algorithm -->
462 <xs:attribute name="RAMsize" type="NonNegativeInteger" use="optional"/>
463 <!-- if default is set the algorithm will be configured for any new project -->
464 <xs:attribute name="default" type="xs:boolean" use="optional" default="0"/>
465 <!-- style attribute: specifies the programming algorithm format (added in 1.4.4) -->
466 <xs:attribute name="style" type="AlgorithmStyleType" use="optional" default="Keil"/>
467 <!-- parameter attribute: parmeter passed on algorithm invocation (added in 1.4.4) -->
468 <xs:attribute name="parameter" type="xs:string" use="optional"/>
469 <!-- endian attribute: specifies the endianess of the algorithm (added in 1.4.4) -->
470 <xs:attribute name="endian" type="DendianEnum" use="optional" default="Little-endian"/>
471 </xs:complexType>
472
473 <!-- Book Type -->
474 <xs:complexType name="BookType">
475 <!-- Pname identifies the processor this setting belongs to -->
476 <xs:attribute name="Pname" type="RestrictedString"/>
477 <!-- name specifies the path and filename of the document -->
478 <xs:attribute name="name" type="xs:string" use="required"/>
479 <!-- title specifies the string displayed for this document -->
480 <xs:attribute name="title" type="xs:string" use="required"/>
481 </xs:complexType>
482
483 <!-- Description Type-->
484 <xs:complexType name="DescriptionType">
485 <xs:simpleContent>
486 <xs:extension base="xs:string">
487 <!-- Pname identifies the processor this setting belongs to -->
488 <xs:attribute name="Pname" type="RestrictedString"/>
489 </xs:extension>
490 </xs:simpleContent>
491 </xs:complexType>
492
493 <!-- Device Feature Type -->
494 <xs:complexType name="DeviceFeatureType">
495 <xs:attribute name="Pname" type="RestrictedString" use="optional"/>
496 <!-- <xs:attribute name="type" type="DeviceFeatureTypeEnum" use="required"/> -->
497 <xs:attribute name="type" type="xs:string" use="required"/>
498 <xs:attribute name="n" type="xs:decimal" use="optional"/>
499 <xs:attribute name="m" type="xs:decimal" use="optional"/>
500 <xs:attribute name="name" type="xs:string" use="optional"/>
501 <!-- deprecated, only for backwards compatibility -->
502 <xs:attribute name="count" type="xs:int" use="optional"/>
503 </xs:complexType>
504
505 <!-- Board Feature Type -->
506 <xs:complexType name="BoardFeatureType">
507 <!-- <xs:attribute name="type" type="BoardFeatureTypeEnum" use="required"/> -->
508 <xs:attribute name="type" type="xs:string" use="required"/>
509 <xs:attribute name="n" type="xs:decimal" use="optional"/>
510 <xs:attribute name="m" type="xs:decimal" use="optional"/>
511 <xs:attribute name="name" type="xs:string" use="optional"/>
512 </xs:complexType>
513
514 <!-- Environment Type -->
515 <xs:complexType name="EnvironmentType">
516 <xs:sequence>
517 <xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
518 </xs:sequence>
519 <!-- name identifies the environment (e.g. "uv" for uVision ) this setting belongs to -->
520 <xs:attribute name="name" type="xs:string" use="required"/>
521 <!-- Pname identifies the processor this setting belongs to -->
522 <xs:attribute name="Pname" type="RestrictedString" use="optional"/>
523 <xs:anyAttribute></xs:anyAttribute>
524 </xs:complexType>
525
526 <!-- Default Device Properties Group -->
527 <xs:group name="DefaultDevicePropertiesGroup">
528 <!-- multi-core devices have unique Pname attribute. One entry per processor and level -->
529 <xs:choice>
530 <xs:element name="compile" type="CompileType" />
531 <xs:element name="memory" type="MemoryType" />
532 <xs:element name="algorithm" type="AlgorithmType" />
533 <xs:element name="book" type="BookType" />
534 <xs:element name="description" type="DescriptionType" />
535 <xs:element name="feature" type="DeviceFeatureType" />
536 <xs:element name="environment" type="EnvironmentType" />
537 <xs:element name="debugport" type="DebugPortType" />
538 <xs:element name="debug" type="DebugType" />
539 <xs:element name="trace" type="TraceType" />
540 <xs:element name="debugvars" type="DebugVarsType" />
541 <xs:element name="sequences" type="SequencesType" />
542 </xs:choice>
543 </xs:group>
544
545 <!-- Device Properties Group -->
546 <xs:group name="DevicePropertiesGroup">
547 <!-- multi-core devices have unique Pname attribute. One entry per processor and level -->
548 <xs:sequence>
549 <xs:element name="processor" type="ProcessorType" minOccurs="0" maxOccurs="unbounded"/>
550 <xs:element name="debugconfig" type="DebugConfigType" minOccurs="0" maxOccurs="1"/>
551 <xs:group ref="DefaultDevicePropertiesGroup" minOccurs="0" maxOccurs="unbounded"/>
552 </xs:sequence>
553 </xs:group>
554
555 <xs:complexType name="DeviceType">
556 <xs:sequence>
557 <xs:group ref="DevicePropertiesGroup"/>
558 <!-- Variant Level begin-->
559 <xs:element name="variant" minOccurs="0" maxOccurs="unbounded">
560 <xs:complexType>
561 <xs:sequence>
562 <xs:group ref="DevicePropertiesGroup"/>
563 </xs:sequence>
Joachim Krech6ccd9852016-07-12 16:05:11 +0200564 <xs:attribute name="Dvariant" type="RestrictedStringDname" use="required"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +0200565 </xs:complexType>
566 </xs:element>
567 <!-- Variant Level end -->
568 </xs:sequence>
Joachim Krech6ccd9852016-07-12 16:05:11 +0200569 <xs:attribute name="Dname" type="RestrictedStringDname" use="required"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +0200570 <!-- <xs:attributeGroup ref="DefaultDeviceAttributesGroup"/> -->
571 </xs:complexType>
572
573 <!-- Dcore enumeration type -->
574 <xs:simpleType name="DcoreEnum">
575 <xs:restriction base="xs:token">
576 <xs:enumeration value="SC000"/>
577 <xs:enumeration value="SC300"/>
578 <xs:enumeration value="Cortex-M0"/>
579 <xs:enumeration value="Cortex-M0+"/>
580 <xs:enumeration value="Cortex-M1"/>
Joachim Krech98aeaab2016-10-25 21:02:23 +0200581 <xs:enumeration value="Cortex-M23"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +0200582 <xs:enumeration value="Cortex-M3"/>
Joachim Krech98aeaab2016-10-25 21:02:23 +0200583 <xs:enumeration value="Cortex-M33"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +0200584 <xs:enumeration value="Cortex-M4"/>
585 <xs:enumeration value="Cortex-M7"/>
586 <xs:enumeration value="Cortex-R4"/>
587 <xs:enumeration value="Cortex-R5"/>
588 <xs:enumeration value="Cortex-A5"/>
589 <xs:enumeration value="Cortex-A7"/>
590 <xs:enumeration value="Cortex-A8"/>
591 <xs:enumeration value="Cortex-A9"/>
592 <xs:enumeration value="Cortex-A15"/>
593 <xs:enumeration value="Cortex-A17"/>
594 <xs:enumeration value="Cortex-A53"/>
595 <xs:enumeration value="Cortex-A57"/>
596 <xs:enumeration value="Cortex-A72"/>
597 <xs:enumeration value="ARMV8MBL"/>
598 <xs:enumeration value="ARMV8MML"/>
599 <xs:enumeration value="other"/>
600 </xs:restriction>
601 </xs:simpleType>
602
Joachim Krechdfe628f2016-07-01 15:36:52 +0200603 <!-- DeviceFeatureTypeEnum -->
604 <xs:simpleType name="DeviceFeatureTypeEnum">
605 <xs:restriction base="xs:token">
606 <xs:enumeration value="Crypto"/>
607 <xs:enumeration value="NVIC"/>
608 <xs:enumeration value="DMA"/>
609 <xs:enumeration value="RNG"/>
610 <xs:enumeration value="CoreOther"/>
611 <xs:enumeration value="ExtBus"/>
612 <xs:enumeration value="Memory"/>
613 <xs:enumeration value="MemoryOther"/>
614 <xs:enumeration value="XTAL"/>
615 <xs:enumeration value="IntRC"/>
616 <xs:enumeration value="PLL"/>
617 <xs:enumeration value="RTC"/>
618 <xs:enumeration value="ClockOther"/>
619 <xs:enumeration value="PowerMode"/>
620 <xs:enumeration value="VCC"/>
621 <xs:enumeration value="Consumption"/>
622 <xs:enumeration value="PowerOther"/>
623 <xs:enumeration value="BGA"/>
624 <xs:enumeration value="CSP"/>
625 <xs:enumeration value="PLCC"/>
626 <xs:enumeration value="QFN"/>
627 <xs:enumeration value="QFP"/>
628 <xs:enumeration value="SOP"/>
629 <xs:enumeration value="DIP"/>
630 <xs:enumeration value="PackageOther"/>
631 <xs:enumeration value="IOs"/>
632 <xs:enumeration value="ExtInt"/>
633 <xs:enumeration value="Temp"/>
634 <xs:enumeration value="ADC"/>
635 <xs:enumeration value="DAC"/>
636 <xs:enumeration value="TempSens"/>
637 <xs:enumeration value="AnalogOther"/>
638 <xs:enumeration value="PWM"/>
639 <xs:enumeration value="Timer"/>
640 <xs:enumeration value="WDT"/>
641 <xs:enumeration value="TimerOther"/>
642 <xs:enumeration value="MPSerial"/>
643 <xs:enumeration value="CAN"/>
644 <xs:enumeration value="ETH"/>
645 <xs:enumeration value="I2C"/>
646 <xs:enumeration value="I2S"/>
647 <xs:enumeration value="LIN"/>
648 <xs:enumeration value="SDIO"/>
649 <xs:enumeration value="SPI"/>
650 <xs:enumeration value="UART"/>
651 <xs:enumeration value="USART"/>
652 <xs:enumeration value="USBD"/>
653 <xs:enumeration value="USBH"/>
654 <xs:enumeration value="USBOTG"/>
655 <xs:enumeration value="ComOther"/>
656 <xs:enumeration value="Camera"/>
657 <xs:enumeration value="GLCD"/>
658 <xs:enumeration value="LCD"/>
659 <xs:enumeration value="Touch"/>
660 <xs:enumeration value="Other"/>
661 <!-- deprecated, only for backwards compatibility -->
662 <xs:enumeration value="I/O"/>
663 <xs:enumeration value="D/A"/>
664 <xs:enumeration value="A/D"/>
665 <xs:enumeration value="Com"/>
666 <xs:enumeration value="USB"/>
667 <xs:enumeration value="Package"/>
668 <xs:enumeration value="Backup"/>
669 </xs:restriction>
670 </xs:simpleType>
671
672 <!-- BoardFeatureTypeEnum -->
673 <xs:simpleType name="BoardFeatureTypeEnum">
674 <xs:restriction base="xs:token">
675 <xs:enumeration value="ODbg"/>
676 <xs:enumeration value="XTAL"/>
677 <xs:enumeration value="PWR"/>
678 <xs:enumeration value="PWR"/>
679 <xs:enumeration value="PWRSock"/>
680 <xs:enumeration value="Batt"/>
681 <xs:enumeration value="Curr"/>
682 <xs:enumeration value="CoreOther"/>
683 <xs:enumeration value="RAM"/>
684 <xs:enumeration value="ROM"/>
685 <xs:enumeration value="Memory"/>
686 <xs:enumeration value="MemCard"/>
687 <xs:enumeration value="MemoryOther"/>
688 <xs:enumeration value="DIO"/>
689 <xs:enumeration value="AIO"/>
690 <xs:enumeration value="Proto"/>
691 <xs:enumeration value="USB"/>
692 <xs:enumeration value="ETH"/>
693 <xs:enumeration value="SPI"/>
694 <xs:enumeration value="I2C"/>
695 <xs:enumeration value="RS232"/>
696 <xs:enumeration value="RS422"/>
697 <xs:enumeration value="RS485"/>
698 <xs:enumeration value="CAN"/>
699 <xs:enumeration value="IrDA"/>
700 <xs:enumeration value="LineIn"/>
701 <xs:enumeration value="LineOut"/>
702 <xs:enumeration value="MIC"/>
703 <xs:enumeration value="Edge"/>
704 <xs:enumeration value="ConnOther"/>
705 <xs:enumeration value="Button"/>
706 <xs:enumeration value="Poti"/>
707 <xs:enumeration value="Joystick"/>
708 <xs:enumeration value="Touch"/>
709 <xs:enumeration value="ContOther"/>
710 <xs:enumeration value="Accelerometer"/>
711 <xs:enumeration value="Gyro"/>
712 <xs:enumeration value="Compass"/>
713 <xs:enumeration value="TempSens"/>
714 <xs:enumeration value="PressSens"/>
715 <xs:enumeration value="LightSens"/>
716 <xs:enumeration value="SensOther"/>
717 <xs:enumeration value="CustomFF"/>
718 <xs:enumeration value="ArduinoFF"/>
719 <xs:enumeration value="FreedomFF"/>
720 <xs:enumeration value="TowerFF"/>
721 <xs:enumeration value="LED"/>
722 <xs:enumeration value="Camera"/>
723 <xs:enumeration value="LCD"/>
724 <xs:enumeration value="GLCD"/>
725 <xs:enumeration value="Speaker"/>
726 <xs:enumeration value="Other"/>
727 </xs:restriction>
728 </xs:simpleType>
729
730 <!-- eraseTypeEnum -->
731 <xs:simpleType name="EraseTypeEnum">
732 <xs:restriction base="xs:token">
733 <xs:enumeration value="sector"/>
734 <xs:enumeration value="full"/>
735 <xs:enumeration value="no"/>
736 </xs:restriction>
737 </xs:simpleType>
738
739 <!-- MemoryIDTypeEnum -->
740 <xs:simpleType name="MemoryIDTypeEnum">
741 <xs:restriction base="xs:token">
742 <xs:enumeration value="IRAM1"/>
743 <xs:enumeration value="IRAM2"/>
744 <xs:enumeration value="IRAM3"/>
745 <xs:enumeration value="IRAM4"/>
746 <xs:enumeration value="IRAM5"/>
747 <xs:enumeration value="IRAM6"/>
748 <xs:enumeration value="IRAM7"/>
749 <xs:enumeration value="IRAM8"/>
750 <xs:enumeration value="IROM1"/>
751 <xs:enumeration value="IROM2"/>
752 <xs:enumeration value="IROM3"/>
753 <xs:enumeration value="IROM4"/>
754 <xs:enumeration value="IROM5"/>
755 <xs:enumeration value="IROM6"/>
756 <xs:enumeration value="IROM7"/>
757 <xs:enumeration value="IROM8"/>
758 </xs:restriction>
759 </xs:simpleType>
760
761 <!-- Dendian enumeration type -->
762 <xs:simpleType name="DendianEnum">
763 <xs:restriction base="xs:token">
764 <xs:enumeration value="Little-endian"/>
765 <xs:enumeration value="Big-endian"/>
766 <xs:enumeration value="Configurable"/>
767 <xs:enumeration value="*"/>
768 </xs:restriction>
769 </xs:simpleType>
770
771 <!-- Dfpu enumeration type -->
772 <xs:simpleType name="DfpuEnum">
773 <xs:restriction base="xs:token">
774 <!-- core has FPU (type of FPU depends on Dcore) -->
775 <xs:enumeration value="FPU"/>
776 <xs:enumeration value="1"/>
777 <!-- core has no FPU -->
778 <xs:enumeration value="NO_FPU"/>
779 <xs:enumeration value="0"/>
780 <!-- single precision FPU -->
781 <xs:enumeration value="SP_FPU"/>
782 <!-- double precision FPU -->
783 <xs:enumeration value="DP_FPU"/>
784 <!-- any -->
785 <xs:enumeration value="*"/>
786 </xs:restriction>
787 </xs:simpleType>
788
789 <!-- Dmpu enumeration type -->
790 <xs:simpleType name="DmpuEnum">
791 <xs:restriction base="xs:token">
792 <xs:enumeration value="MPU"/>
793 <xs:enumeration value="NO_MPU"/>
794 <xs:enumeration value="0"/>
795 <xs:enumeration value="1"/>
796 <xs:enumeration value="*"/>
797 </xs:restriction>
798 </xs:simpleType>
799
Joachim Krech98aeaab2016-10-25 21:02:23 +0200800 <!-- Dtz TrustZone enumeration type -->
801 <xs:simpleType name="DtzEnum">
802 <xs:restriction base="xs:token">
803 <xs:enumeration value="TZ"/>
804 <xs:enumeration value="NO_TZ"/>
805 <xs:enumeration value="1"/>
806 <xs:enumeration value="0"/>
807 <xs:enumeration value="*"/>
808 </xs:restriction>
809 </xs:simpleType>
810
811 <!-- Ddsp DSP extensions enumeration type -->
812 <xs:simpleType name="DdspEnum">
813 <xs:restriction base="xs:token">
814 <xs:enumeration value="DSP"/>
815 <xs:enumeration value="NO_DSP"/>
816 <xs:enumeration value="1"/>
817 <xs:enumeration value="0"/>
818 <xs:enumeration value="*"/>
819 </xs:restriction>
820 </xs:simpleType>
821
Joachim Krechdfe628f2016-07-01 15:36:52 +0200822 <!-- file category type -->
823 <xs:simpleType name="FileCategoryType">
824 <xs:restriction base="xs:token">
825 <xs:enumeration value="doc"/>
826 <xs:enumeration value="header"/>
827 <xs:enumeration value="include"/>
828 <xs:enumeration value="library"/>
829 <xs:enumeration value="object"/>
830 <xs:enumeration value="source"/>
831 <xs:enumeration value="sourceC"/>
832 <xs:enumeration value="sourceCpp"/>
833 <xs:enumeration value="sourceAsm"/>
834 <xs:enumeration value="linkerScript"/>
835 <xs:enumeration value="utility"/>
836 <xs:enumeration value="image"/>
837 <xs:enumeration value="other"/>
838 </xs:restriction>
839 </xs:simpleType>
840
841 <!-- file attribute type -->
842 <xs:simpleType name="FileAttributeType">
843 <xs:restriction base="xs:token">
844 <xs:enumeration value="config"/>
845 <xs:enumeration value="copy"/>
846 <xs:enumeration value="template"/>
847 <xs:enumeration value="interface"/>
848 </xs:restriction>
849 </xs:simpleType>
850
851
852 <!-- compiler toolchain enumeration -->
853 <xs:simpleType name="CompilerEnumType">
854 <xs:restriction base="xs:token">
855 <xs:enumeration value="GCC"/>
856 <xs:enumeration value="ARMCC"/>
857 <xs:enumeration value="IAR"/>
858 <xs:enumeration value="Tasking"/>
859 <xs:enumeration value="GHS"/>
860 <xs:enumeration value="Cosmic"/>
861 <xs:enumeration value="G++"/> <!-- Code Sourcery -->
862 <xs:enumeration value="*"/>
863 </xs:restriction>
864 </xs:simpleType>
865 <!-- compiler output enumeration -->
866 <xs:simpleType name="CompilerOutputType">
867 <xs:restriction base="xs:token">
868 <xs:enumeration value="exe"/> <!-- executable -->
869 <xs:enumeration value="lib"/> <!-- library -->
870 <xs:enumeration value="*"/>
871 </xs:restriction>
872 </xs:simpleType>
873
874
875
876 <xs:complexType name="FilterType">
877 <xs:attribute name="Dfamily" type="xs:string"/> <!-- deprecated as they are too weak for filtering -->
878 <xs:attribute name="DsubFamily" type="xs:string"/> <!-- deprecated as tehy are too weak for filtering -->
879 <xs:attribute name="Dvariant" type="xs:string"/>
880 <xs:attribute name="Dvendor" type="DeviceVendorEnum"/>
881 <xs:attribute name="Dname" type="xs:string"/> <!-- can contain wildcards ?* in condition -->
882 <xs:attribute name="Dcore" type="DcoreEnum"/>
883 <xs:attribute name="Dfpu" type="DfpuEnum"/>
884 <xs:attribute name="Dmpu" type="DmpuEnum"/>
885 <xs:attribute name="Dendian" type="DendianEnum"/>
886 <xs:attribute name="Pname" type="RestrictedString"/>
887 <xs:attribute name="Cvendor" type="xs:string"/>
888 <xs:attribute name="Cbundle" type="xs:string"/>
889 <xs:attribute name="Cclass" type="CclassType"/>
890 <xs:attribute name="Cgroup" type="CgroupType"/>
891 <xs:attribute name="Csub" type="CsubType"/>
892 <xs:attribute name="Cvariant" type="CvariantType"/>
893 <xs:attribute name="Cversion" type="ConditionVersionType"/>
894 <xs:attribute name="Capiversion" type="ConditionVersionType"/>
895 <xs:attribute name="Tcompiler" type="CompilerEnumType"/>
896 <xs:attribute name="Toutput" type="CompilerOutputType"/>
897 <xs:attribute name="condition" type="xs:string"/>
898 </xs:complexType>
899
900 <!-- taxonomy description type definition -->
901 <xs:complexType name="TaxonomyDescriptionType">
902 <xs:simpleContent>
903 <xs:extension base='xs:string'>
904 <xs:attribute name="Cclass" type="CclassType" use="required"/> <!-- Class the description is associated with -->
905 <xs:attribute name="Cgroup" type="CgroupType" use="optional"/> <!-- Group the description is associated with -->
906 <xs:attribute name="doc" type="xs:string" use="optional"/> <!-- link to documentation for the :Class:[Group] -->
907 <xs:attribute name="generator" type="xs:string" use="optional"/> <!-- link a generator to a taxonomy -->
908 </xs:extension>
909 </xs:simpleContent>
910 </xs:complexType>
911
912 <xs:complexType name="TaxonomyType">
913 <xs:sequence>
914 <xs:element name="description" type="TaxonomyDescriptionType" minOccurs="1" maxOccurs="unbounded"/>
915 </xs:sequence>
916 </xs:complexType>
917
918 <!-- API type definition -->
919 <xs:complexType name="ApiType">
920 <xs:sequence>
921 <xs:element name="description" type="xs:string" minOccurs="0"/>
922 <!-- list of files / content -->
923 <xs:element name="files">
924 <xs:complexType>
925 <xs:sequence>
926 <xs:element name="file" type="FileType" maxOccurs="unbounded"/>
927 </xs:sequence>
928 </xs:complexType>
929 </xs:element>
930 </xs:sequence>
931 <xs:attribute name="Cclass" type="CclassType" use="required"/>
932 <xs:attribute name="Cgroup" type="CgroupType" use="required"/>
933 <xs:attribute name="exclusive" type="xs:boolean" use="optional" default="1"/>
Joachim Krech98aeaab2016-10-25 21:02:23 +0200934 <xs:attribute name="Capiversion" type="ComponentVersionType" use="optional"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +0200935 </xs:complexType>
936
937 <xs:complexType name="ApisType">
938 <xs:sequence>
939 <xs:element name="api" type="ApiType" minOccurs="1" maxOccurs="unbounded"/>
940 </xs:sequence>
941 </xs:complexType>
942
943 <xs:complexType name="ConditionType">
944 <xs:sequence>
945 <xs:element name="description" type="xs:string" minOccurs="0"/>
946 <xs:choice minOccurs="1" maxOccurs="unbounded">
947 <xs:element name="accept" type="FilterType"/>
948 <xs:element name="require" type="FilterType"/>
949 <xs:element name="deny" type="FilterType"/>
950 </xs:choice>
951 </xs:sequence>
952 <xs:attribute name="id" type="xs:string" use="required"/>
953 </xs:complexType>
954
955 <xs:complexType name="ConditionsType">
956 <xs:sequence>
957 <xs:element name="condition" type="ConditionType" minOccurs="1" maxOccurs="unbounded"/>
958 </xs:sequence>
959 </xs:complexType>
960
961 <xs:complexType name="ComponentCategoryType">
962 <xs:attribute name="Cvendor" type="xs:string" use="optional"/>
963 <xs:attribute name="Cbundle" type="xs:string" use="optional"/>
964 <xs:attribute name="Cclass" type="CclassType" use="required"/>
965 <xs:attribute name="Cgroup" type="CgroupType" use="required"/>
966 <xs:attribute name="Csub" type="CsubType" use="optional"/>
967 <xs:attribute name="Cvariant" type="CvariantType" use="optional"/>
Joachim Krech98aeaab2016-10-25 21:02:23 +0200968 <xs:attribute name="Cversion" type="ComponentVersionType" use="optional"/>
969 <xs:attribute name="Capiversion" type="ComponentVersionType" use="optional"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +0200970 <xs:attribute name="instances" type="InstancesType" use="optional" default="1"/>
971 </xs:complexType>
972
973 <xs:complexType name="ExampleProjectType">
974 <xs:sequence>
975 <xs:element name="environment" maxOccurs="unbounded">
976 <xs:complexType>
977 <xs:attribute name="name" type="xs:string" use="required"/>
978 <xs:attribute name="load" type="xs:string" use="required"/>
979 </xs:complexType>
980 </xs:element>
981 </xs:sequence>
982 </xs:complexType>
983
984 <xs:complexType name="BoardReferenceType">
985 <xs:attribute name="name" type="xs:string" use="required"/> <!-- refers to Board Description by name -->
986 <xs:attribute name="vendor" type="xs:string" use="required"/> <!-- refers to Board Description by vendor -->
987 <xs:attribute name="Dvendor" type="DeviceVendorEnum" use="optional"/> <!-- deprecated in 1.2 -->
988 <xs:attribute name="Dfamily" type="xs:string" use="optional"/> <!-- deprecated in 1.2 -->
989 <xs:attribute name="DsubFamily" type="xs:string" use="optional"/> <!-- deprecated in 1.2 -->
990 <xs:attribute name="Dname" type="xs:string" use="optional"/> <!-- deprecated in 1.2 -->
991 </xs:complexType>
992
993 <xs:complexType name="CompatibleDeviceType">
994 <xs:attribute name="deviceIndex" type="xs:string" use="optional" />
995 <xs:attribute name="Dvendor" type="DeviceVendorEnum" use="optional"/>
996 <xs:attribute name="Dfamily" type="xs:string" use="optional"/>
997 <xs:attribute name="DsubFamily" type="xs:string" use="optional"/>
998 <xs:attribute name="Dname" type="xs:string" use="optional"/>
999 </xs:complexType>
1000
1001 <xs:complexType name="BoardsDeviceType">
1002 <xs:attribute name="deviceIndex" type="xs:string" use="optional" />
1003 <xs:attribute name="Dvendor" type="DeviceVendorEnum" use="required"/>
1004 <xs:attribute name="Dfamily" type="xs:string" use="optional"/> <!-- use Dfamiliy or DsubFamily or Dname attribute exclusively -->
1005 <xs:attribute name="DsubFamily" type="xs:string" use="optional"/> <!-- use Dfamiliy or DsubFamily or Dname attribute exclusively -->
1006 <xs:attribute name="Dname" type="xs:string" use="optional"/> <!-- use Dfamiliy or DsubFamily or Dname attribute exclusively -->
1007 </xs:complexType>
1008
1009 <xs:simpleType name="BoardBookCategoryEnum">
1010 <xs:restriction base="xs:token">
1011 <xs:enumeration value="setup"/>
1012 <xs:enumeration value="schematic"/>
1013 <xs:enumeration value="overview"/>
1014 <xs:enumeration value="manual"/>
1015 <xs:enumeration value="other"/>
1016 </xs:restriction>
1017 </xs:simpleType>
1018
1019 <xs:complexType name="BoardsBookType">
1020 <xs:attribute name="category" type="BoardBookCategoryEnum"/>
1021 <xs:attribute name="name" type="xs:string"/>
1022 <xs:attribute name="title" type="xs:string"/>
1023 </xs:complexType>
1024
1025 <xs:complexType name="DebugInterfaceType">
1026 <xs:attribute name="adapter" type="xs:string"/>
1027 <xs:attribute name="connector" type="xs:string"/>
1028 </xs:complexType>
1029
1030 <xs:group name="BoardElementsGroup">
1031 <xs:choice>
1032 <xs:element name="description" type="xs:string"/>
1033 <xs:element name="feature" type="BoardFeatureType" maxOccurs="unbounded"></xs:element>
1034 <xs:element name="mountedDevice" type="BoardsDeviceType" maxOccurs="unbounded"/>
1035 <xs:element name="compatibleDevice" type="CompatibleDeviceType" maxOccurs="unbounded"/>
1036 <xs:element name="image">
1037 <xs:complexType>
1038 <xs:attribute name="small" type="xs:string" use="optional"/>
1039 <xs:attribute name="large" type="xs:string" use="optional"/>
1040 </xs:complexType>
1041 </xs:element>
1042 <xs:element name="debugInterface" type="DebugInterfaceType" maxOccurs="unbounded"/>
1043 <xs:element name="book" type="BoardsBookType" maxOccurs="unbounded"/>
1044 </xs:choice>
1045 </xs:group>
1046
1047 <xs:complexType name="BoardType">
1048 <xs:sequence>
1049 <xs:group ref="BoardElementsGroup" minOccurs="1" maxOccurs="unbounded"/>
1050 </xs:sequence>
1051 <xs:attribute name="vendor" type="xs:string" use="required"/>
1052 <xs:attribute name="name" type="xs:string" use="required"/>
1053 <xs:attribute name="revision" type="xs:string" use="optional"/>
1054 <xs:attribute name="salesContact" type="xs:string" use="optional"/>
1055 <xs:attribute name="orderForm" type="xs:anyURI" use="optional"/>
1056 </xs:complexType>
1057
1058 <xs:complexType name="BoardsType">
1059 <xs:sequence>
1060 <xs:element name="board" type="BoardType" maxOccurs="unbounded"/>
1061 </xs:sequence>
1062 </xs:complexType>
1063
1064 <xs:complexType name="ExampleAttributesType">
1065 <xs:choice maxOccurs="unbounded">
1066 <xs:element name="category" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
1067 <xs:element name="component" type="ComponentCategoryType" minOccurs="0" maxOccurs="unbounded"/>
1068 <xs:element name="keyword" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
1069 </xs:choice>
1070 </xs:complexType>
1071
1072 <xs:complexType name="ExampleType">
1073 <xs:sequence>
1074 <!-- brief example description -->
1075 <xs:element name="description" type="xs:string"/>
1076 <!-- references the board -->
1077 <xs:element name="board" type="BoardReferenceType" maxOccurs="unbounded"/>
1078 <!-- lists environments with their load files -->
1079 <xs:element name="project" type="ExampleProjectType"/>
1080 <!-- categories, keywords and used components -->
1081 <xs:element name="attributes" type="ExampleAttributesType" />
1082 </xs:sequence>
1083 <!-- display name of the example -->
1084 <xs:attribute name="name" type="xs:string" use="required"/>
1085 <!-- relative folder where the example is stored in the package -->
1086 <xs:attribute name="folder" type="xs:string" use="required"/>
1087 <!-- archive file name with extension located in folder -->
1088 <xs:attribute name="archive" type="xs:string" use="optional"/>
1089 <!-- file name with extension relative to folder -->
1090 <xs:attribute name="doc" type="xs:string" use="required"/>
1091 <!-- version of the example -->
1092 <xs:attribute name="version" type="xs:string" use="optional"/>
1093 </xs:complexType>
1094
1095 <!-- section listing all examples contained in the package -->
1096 <xs:complexType name="ExamplesType">
1097 <xs:sequence>
1098 <xs:element name="example" type="ExampleType" maxOccurs="unbounded"/>
1099 </xs:sequence>
1100 </xs:complexType>
1101
1102 <xs:complexType name="KeywordsType">
1103 <xs:sequence>
1104 <xs:element name="keyword" type="xs:string" maxOccurs="unbounded"/>
1105 </xs:sequence>
1106 </xs:complexType>
1107
1108 <xs:simpleType name="InstancesType">
1109 <xs:restriction base="xs:unsignedInt">
1110 <xs:minInclusive value="1"/>
1111 </xs:restriction>
1112 </xs:simpleType>
1113
1114 <!-- Component file type definition -->
1115 <xs:complexType name="FileType">
1116 <xs:attribute name="condition" type="xs:string" use="optional"/>
1117 <!-- file item category: source, header, include path, etc. -->
1118 <xs:attribute name="category" type="FileCategoryType" use ="required"/>
1119 <!-- file item action attribute : config (copy to project, template, interface) -->
1120 <xs:attribute name="attr" type="FileAttributeType" use ="optional"/>
1121 <!-- description for "template" or "interface" files. Multiple items are combined when they have the same select attribute -->
1122 <xs:attribute name="select" type="xs:string" use ="optional"/>
1123 <!-- path + filename + extension -->
1124 <xs:attribute name="name" type ="xs:string" use="required" />
1125 <!-- copy file to project folder: deprecated, use attr="config" instead -->
1126 <xs:attribute name="copy" type ="xs:string" use="optional"/>
1127 <!-- simple file version: to be used by RTE copy file action to see whether the file needs updating in project -->
Joachim Krech98aeaab2016-10-25 21:02:23 +02001128 <xs:attribute name="version" type ="ComponentVersionType" use="optional"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001129 <!-- path(s) to find source files for a library, paths are delimited with semicolon (;) -->
1130 <xs:attribute name="src" type="xs:string" use ="optional"/>
1131 </xs:complexType>
1132
1133 <!-- some strings are used to construct filenames (e.g. package name). Such names can contain only subset of characters
1134 and must not contain neither spaces nor dots.
1135 -->
1136 <xs:simpleType name="RestrictedString">
1137 <xs:restriction base="xs:string">
1138 <xs:pattern value="[\-_A-Za-z0-9]+"/>
1139 </xs:restriction>
1140 </xs:simpleType>
Joachim Krech98aeaab2016-10-25 21:02:23 +02001141
Joachim Krech6ccd9852016-07-12 16:05:11 +02001142 <xs:simpleType name="RestrictedStringDname">
1143 <xs:restriction base="xs:string">
1144 <xs:pattern value="[\-_A-Za-z0-9/]+"/>
1145 </xs:restriction>
1146 </xs:simpleType>
Joachim Krech98aeaab2016-10-25 21:02:23 +02001147
1148 <xs:simpleType name="SchemaVersionType">
1149 <xs:restriction base="xs:string">
1150 <xs:pattern value="[0-9]+\.[0-9]+((\.[0-9]+)|())"/>
1151 </xs:restriction>
1152 </xs:simpleType>
1153
1154 <xs:simpleType name="ComponentVersionType">
1155 <xs:restriction base="xs:string">
1156 <xs:pattern value="[0-9]+\.[0-9]+((\.[0-9]+)|())((\-[0-9A-Za-z_\-\.]+)|([_A-Za-z][0-9A-Za-z_\-\.]*)|())((\+[\-\._A-Za-z0-9]+)|())"/>
1157 </xs:restriction>
1158 </xs:simpleType>
1159
Joachim Krechdfe628f2016-07-01 15:36:52 +02001160 <!-- version can contain one or more of alphanumeric characters and symbols '_' '-' '.'
1161 Important: version pattern shall remain the same while versions change
1162 -->
Joachim Krech98aeaab2016-10-25 21:02:23 +02001163 <xs:simpleType name="PackVersionType">
Joachim Krechdfe628f2016-07-01 15:36:52 +02001164 <xs:restriction base="xs:string">
Joachim Krech98aeaab2016-10-25 21:02:23 +02001165 <!-- major . minor . patch [[-]quality] [+build] -->
1166 <xs:pattern value="[0-9]+.[0-9]+.[0-9]+((\-[0-9A-Za-z_\-\.]+)|([_A-Za-z][0-9A-Za-z_\-\.]*)|())((\+[\-\._A-Za-z0-9]+)|())"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001167 </xs:restriction>
1168 </xs:simpleType>
1169
1170 <!-- version can contain one or more of alphanumeric characters and symbols '_' '-' '.'
1171 Allows specifing a version range: minVersion : maxVersion
1172 -->
1173 <xs:simpleType name="ConditionVersionType">
1174 <xs:restriction base="xs:string">
Joachim Krech98aeaab2016-10-25 21:02:23 +02001175 <!-- <xs:pattern value="[\.:\-_A-Za-z0-9]+"/> -->
1176 <xs:pattern value="[0-9]+.[0-9]+.[0-9]*((:[0-9]+.[0-9]+.[0-9]+)|())"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001177 </xs:restriction>
1178 </xs:simpleType>
1179
1180 <!-- PackageType creates a unique ID for a package (added in 1.4.4) -->
1181 <xs:complexType name="PackageType">
1182 <!-- vendor of the package -->
1183 <xs:attribute name="vendor" type="xs:string" use="required"/>
1184 <!-- name of the package -->
1185 <xs:attribute name="name" type="xs:string" use="required"/>
1186 <!-- version or version range of the package -->
1187 <xs:attribute name="version" type="ConditionVersionType" use="required"/>
1188 </xs:complexType>
1189
1190 <!-- Package dependency section type (added in 1.4.4) -->
1191 <xs:complexType name="PackagesType">
1192 <xs:sequence maxOccurs="unbounded">
1193 <xs:element name="package" type="PackageType"/>
1194 </xs:sequence>
1195 </xs:complexType>
1196
1197 <!-- LanguageType creates a unique language ID (added in 1.4.4) -->
1198 <xs:complexType name="LanguageType">
1199 <!-- language name e.g. C -->
1200 <xs:attribute name="name" type="xs:string" use="required"/>
1201 <!-- language version e.g. C99 -->
1202 <xs:attribute name="version" type="xs:string" use="required"/>
1203 </xs:complexType>
1204
1205 <!-- Lanuage section type (added in 1.4.4) -->
1206 <xs:complexType name="LanguagesType">
1207 <xs:sequence maxOccurs="unbounded">
1208 <xs:element name="language" type="LanguageType"/>
1209 </xs:sequence>
1210 </xs:complexType>
1211
1212 <!-- CompilerType crates a unique toolchain ID, e.g. armcc 5.4.0 (added in 1.4.4) -->
1213 <xs:complexType name="CompilerType">
1214 <xs:attribute name="name" type="CompilerEnumType" use="required"/>
1215 <xs:attribute name="version" type="ConditionVersionType" use="required"/>
1216 </xs:complexType>
1217
1218 <!-- Compiler section type (added in 1.4.4) -->
1219 <xs:complexType name="CompilersType">
1220 <xs:sequence maxOccurs="unbounded">
1221 <xs:element name="compiler" type="CompilerType"/>
1222 </xs:sequence>
1223 </xs:complexType>
1224
1225 <!-- Requirements Section: (added in 1.4.4) -->
1226 <xs:complexType name="RequirementsType">
1227 <xs:all>
1228 <xs:element name="packages" type="PackagesType" minOccurs="0"/>
1229 <xs:element name="languages" type="LanguagesType" minOccurs="0"/>
1230 <xs:element name="compilers" type="CompilersType" minOccurs="0"/>
1231 </xs:all>
1232 </xs:complexType>
1233
1234 <!-- Project target specification: (added in 1.4.4) -->
1235 <xs:complexType name="TargetType">
1236 <xs:choice maxOccurs="unbounded">
1237 <!-- build options -->
1238 <xs:element name="output" type="OutputType"/>
1239 <!-- memory options -->
1240 <xs:element name="memory" type="TargetMemoryType" minOccurs="0" maxOccurs="unbounded"/>
1241 <!-- stack setting -->
1242 <xs:element name="stack" type="StackType" minOccurs="0" maxOccurs="1"/>
1243 <!-- heap setting -->
1244 <xs:element name="heap" type="HeapType" minOccurs="0" maxOccurs="1"/>
1245 <!-- algorithm options -->
1246 <xs:element name="algorithm" type="TargetAlgorithmType" minOccurs="0" maxOccurs="unbounded"/>
1247 <!-- debug probe selection and configuration -->
1248 <xs:element name="debugProbe" type="DebugProbeType" minOccurs="0"/>
1249 </xs:choice>
1250 <!-- Board Vendor -->
1251 <xs:attribute name="Bvendor" type="xs:string" use="optional"/>
1252 <!-- Board Name -->
1253 <xs:attribute name="Bname" type="xs:string" use="optional"/>
1254 <!-- Board Version -->
1255 <xs:attribute name="Bversion" type="xs:string" use="optional"/>
1256 <!-- Device Vendor -->
1257 <xs:attribute name="Dvendor" type="xs:string" use="optional"/>
1258 <!-- Device Name -->
1259 <xs:attribute name="Dname" type="xs:string" use="optional"/>
1260 <!-- Processor Instance Name -->
1261 <xs:attribute name="Pname" type="xs:string" use="optional"/>
1262 <!-- FPU used in target build -->
1263 <xs:attribute name="Dfpu" type="DfpuEnum" use="optional"/>
1264 <!-- Endianess used in target build -->
1265 <xs:attribute name="Dendian" type="DendianEnum" use="optional"/>
1266 <!-- MPU used in target build -->
1267 <xs:attribute name="Dmpu" type="DmpuEnum" use="optional"/>
1268 </xs:complexType>
1269
1270 <!-- Debug probe specification: (added in 1.4.4) -->
1271 <xs:complexType name="DebugProbeType">
1272 <!-- Product Name of the debug probe-->
1273 <xs:attribute name="name" type="xs:string" use="required"/>
1274 <!-- Debug protocol selection -->
1275 <xs:attribute name="protocol" type="xs:string" use="required"/>
1276 <!-- Core clock configured by application -->
1277 <xs:attribute name="coreClock" type="NonNegativeInteger" use="required"/>
1278 <!-- TPIU clock configured-->
1279 <xs:attribute name="tpiuClock" type="NonNegativeInteger" use="optional"/>
1280 </xs:complexType>
1281
1282 <!-- Build settings for the project, setting RTE filter options (added in 1.4.4) -->
1283 <xs:complexType name="OutputType">
1284 <!-- Project output file name -->
1285 <xs:attribute name="name" type="xs:string" use="required"/>
1286 <!-- Project output library or executable -->
1287 <xs:attribute name="type" type="CompilerOutputType" use="required"/>
1288 <!-- Project build for debug -->
1289 <xs:attribute name="debug" type="xs:boolean" use="required"/>
1290 </xs:complexType>
1291
1292 <!-- Memory settings for the project, redefining defaults from DFP (added in 1.4.4) -->
1293 <xs:complexType name="TargetMemoryType">
1294 <xs:attribute name="id" type="xs:string" use="optional"/> <!-- only use with legacy DFPs -->
1295 <!-- defines the name of the memory for reference, allows to redefine memory from DFP -->
1296 <xs:attribute name="name" type="xs:string" use="required"/>
1297 <!-- (re-)defines the start address of the memory -->
1298 <xs:attribute name="start" type="NonNegativeInteger" use="optional"/>
1299 <!-- (re-)defines the size in bytes of the memory -->
1300 <xs:attribute name="size" type="NonNegativeInteger" use="optional"/>
1301 <!-- disables the memory with the name specified by DFP -->
1302 <xs:attribute name="remove" type="xs:boolean" use="optional" default="0"/>
1303 <!-- if true, this memory is used for the startup code -->
1304 <xs:attribute name="startup" type="xs:boolean" use="optional" default="0"/>
1305 <!-- if true, this memory is initialized with 0 -->
1306 <xs:attribute name="init" type="xs:boolean" use="optional" default="0"/>
1307 <!-- overrides access permisson configured by the DFP -->
1308 <xs:attribute name="access" type="AccessType" use="optional"/>
1309 <!-- specifies whether the memory is used as default by linker -->
1310 <xs:attribute name="default" type="xs:boolean" use="optional" default="0"/>
1311 </xs:complexType>
1312
1313 <!-- Algorithm settings for the project, redefining defaults from DFP (added in 1.4.4) -->
1314 <xs:complexType name="TargetAlgorithmType">
1315 <!-- references the filename of the algorith, allowing to redefine attributes of algorithms in DFP -->
1316 <xs:attribute name="name" type="xs:string" use="required"/>
1317 <!-- overrides the start address programmed by named algorithm from DFP -->
1318 <xs:attribute name="start" type="NonNegativeInteger" use="optional"/>
1319 <!-- overrides the size programmed by named algorithm from DFP -->
1320 <xs:attribute name="size" type="NonNegativeInteger" use="optional"/>
1321 <!-- disables the algorithm specified as default in DFP -->
1322 <xs:attribute name="remove" type="xs:boolean" use="optional" default="0"/>
1323 <!-- overrides the RAMstart for algorithm with 'name' from DFP -->
1324 <xs:attribute name="RAMstart" type="NonNegativeInteger" use="optional"/>
1325 <!-- overrides the RAMsize for algorithm with 'name' from DFP -->
1326 <xs:attribute name="RAMsize" type="NonNegativeInteger" use="optional"/>
1327 </xs:complexType>
1328
1329 <!-- element specifying the stack (added in 1.4.4) -->
1330 <xs:complexType name="StackType">
1331 <xs:attribute name="size" type="NonNegativeInteger" use="required"/>
1332 </xs:complexType>
1333
1334 <!-- element specifying the heap (added in 1.4.4) -->
1335 <xs:complexType name="HeapType">
1336 <xs:attribute name="size" type="NonNegativeInteger" use="required"/>
1337 </xs:complexType>
1338
1339 <!-- Project file type definition (added in 1.4.4) -->
1340 <xs:complexType name="ProjectFileType">
1341 <!-- path + filename + extension -->
1342 <xs:attribute name="name" type ="xs:string" use="required" />
1343 <!-- file item category: source, header, include path, etc. -->
1344 <xs:attribute name="category" type="FileCategoryType" use ="required"/>
1345 <!-- path(s) to find source files for a library, paths are delimited with semicolon (;) -->
1346 <xs:attribute name="src" type="xs:string" use ="optional"/>
1347 </xs:complexType>
1348
1349 <!-- Group section contains a list of files and (sub-)groups (added in 1.4.4) -->
1350 <xs:complexType name="GroupType">
1351 <xs:choice maxOccurs="unbounded">
1352 <xs:element name="file" type="ProjectFileType" />
1353 <xs:element name="group" type="GroupType" />
1354 </xs:choice>
1355 <xs:attribute name="name" use="required"/>
1356 </xs:complexType>
1357
1358 <!-- Files section within the project section (added in 1.4.4) -->
1359 <xs:complexType name="ProjectFilesType">
1360 <xs:choice maxOccurs="unbounded">
1361 <xs:element name="file" type="ProjectFileType" />
1362 <xs:element name="group" type="GroupType" />
1363 </xs:choice>
1364 </xs:complexType>
1365
1366 <!-- Component selection section (added in 1.4.4) -->
1367 <xs:complexType name="ComponentSelectType">
1368 <xs:sequence>
1369 <xs:element name="component" maxOccurs="unbounded">
1370 <xs:complexType>
1371 <xs:sequence>
1372 <!-- all config files -->
1373 <xs:element name="file" minOccurs="0" maxOccurs="unbounded">
1374 <xs:complexType>
1375 <!-- condition id of the condition that evaluates to true on project creation -->
1376 <xs:attribute name="condition" type="xs:string" use="optional"/>
1377 <!-- file item category: source, header, include path, etc. -->
1378 <xs:attribute name="category" type="FileCategoryType" use ="required"/>
1379 <!-- file item action attribute : config (copy to project, template, interface) -->
1380 <xs:attribute name="attr" type="FileAttributeType" use ="optional"/>
1381 <!-- path + filename + extension -->
1382 <xs:attribute name="name" type ="xs:string" use="required" />
1383 <!-- configuration file version: to be used by RTE to see whether the file requires updating or not -->
Joachim Krech98aeaab2016-10-25 21:02:23 +02001384 <xs:attribute name="version" type ="ComponentVersionType" use="required"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001385 </xs:complexType>
1386 </xs:element>
1387 </xs:sequence>
Joachim Krech98aeaab2016-10-25 21:02:23 +02001388 <xs:attribute name="Cvendor" type="xs:string" use="optional"/>
1389 <xs:attribute name="Cbundle" type="xs:string" use="optional"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001390 <xs:attribute name="Cclass" type="CclassType" use="required"/>
1391 <xs:attribute name="Cgroup" type="CgroupType" use="required"/>
Joachim Krech98aeaab2016-10-25 21:02:23 +02001392 <xs:attribute name="Csub" type="CsubType" use="optional"/>
1393 <xs:attribute name="Cvariant" type="CvariantType" use="optional"/>
1394 <xs:attribute name="Cversion" type="ComponentVersionType" use="optional"/>
1395 <xs:attribute name="Capiversion" type="ComponentVersionType" use="optional"/> <!-- only used when component implements an API -->
Joachim Krechdfe628f2016-07-01 15:36:52 +02001396 <xs:attribute name="instances" type="InstancesType" use="optional" default="1"/>
1397 </xs:complexType>
1398 </xs:element>
1399 </xs:sequence>
1400 </xs:complexType>
1401
1402 <!-- Project section: (added in 1.4.4) -->
1403 <xs:complexType name="ProjectType">
1404 <xs:all>
1405 <!-- target selection and configuration -->
1406 <xs:element name="target" type="TargetType"/>
1407 <!-- components selected for project -->
1408 <xs:element name="select" type="ComponentSelectType"/>
1409 <!-- project files not contained in components -->
1410 <xs:element name="files" type="ProjectFilesType"/>
1411 </xs:all>
1412 <!-- if no project name is provided, the filename of the GPDSC is used -->
1413 <xs:attribute name="name" type="xs:string" use="optional"/>
1414 <!-- optional link/reference to documentation about the project -->
1415 <xs:attribute name="documentation" type="xs:string" use="optional"/>
1416 </xs:complexType>
1417
1418 <!-- Create Section: (added in 1.4.4) -->
1419 <xs:complexType name="CreateType">
1420 <xs:sequence>
1421 <!-- project section -->
1422 <xs:element name="project" type="ProjectType" maxOccurs="unbounded"/>
1423 </xs:sequence>
1424 </xs:complexType>
1425
1426 <!-- release contains version as an attribute and notes as element text -->
1427 <xs:complexType name="ReleaseType">
1428 <xs:simpleContent>
1429 <xs:extension base='xs:string'>
Joachim Krech98aeaab2016-10-25 21:02:23 +02001430 <xs:attribute name="version" type="PackVersionType" use="required"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001431 <xs:attribute name="date" type="xs:date" use="optional"/>
1432 <xs:attribute name="deprecated" type="xs:date" use="optional"/>
1433 <xs:attribute name="replacement" type="xs:string" use="optional"/>
1434 </xs:extension>
1435 </xs:simpleContent>
1436 </xs:complexType>
1437
1438 <xs:complexType name="ReleasesType">
1439 <xs:sequence>
1440 <xs:element name="release" type="ReleaseType" minOccurs="1" maxOccurs="unbounded"/>
1441 </xs:sequence>
1442 </xs:complexType>
1443
1444 <!-- Generator file type definition -->
1445 <xs:complexType name="GeneratorFileType">
1446 <!-- conditions can be used to filter relevant files depending on e.g. device name
1447 or toolchain -->
1448 <xs:attribute name="condition" type="xs:string" use="optional"/>
1449 <!-- file item category: generator specific file type -->
1450 <xs:attribute name="category" type="xs:string" use ="required"/>
1451 <!-- path + filename + extension -->
1452 <xs:attribute name="name" type ="xs:string" use="required" />
1453 <!-- file version -->
Joachim Krech98aeaab2016-10-25 21:02:23 +02001454 <xs:attribute name="version" type ="ComponentVersionType" use="optional"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001455 </xs:complexType>
1456
1457 <xs:complexType name="GeneratorDeviceSelectType">
1458 <xs:attribute name="Dvendor" type="DeviceVendorEnum" use="required"/>
1459 <xs:attribute name="Dname" type="xs:string" use="optional"/>
1460 <xs:attribute name="Dvariant" type="xs:string" use="optional"/>
1461 <xs:attribute name="Pname" type="RestrictedString" use="optional"/>
1462 </xs:complexType>
1463
Joachim Krech98aeaab2016-10-25 21:02:23 +02001464 <xs:simpleType name="HostEnumType">
1465 <xs:restriction base="xs:token">
1466 <xs:enumeration value="all"/>
1467 <xs:enumeration value="win"/>
1468 <xs:enumeration value="linux"/>
1469 <xs:enumeration value="mac"/>
1470 <xs:enumeration value="other"/>
1471 </xs:restriction>
1472 </xs:simpleType>
1473
1474 <xs:simpleType name="WebGeneratorURLType">
1475 <xs:restriction base="xs:token">
1476 <xs:pattern value="http[s]{0,1}://[!-~]+"/>
1477 </xs:restriction>
1478 </xs:simpleType>
1479 <!-- exe generator argument has optional host and switch attributes -->
1480 <xs:complexType name="ExeGeneratorArgumentType">
Joachim Krechdfe628f2016-07-01 15:36:52 +02001481 <xs:simpleContent>
1482 <xs:extension base='xs:string'>
1483 <xs:attribute name="switch" type="xs:string" use="optional"/>
Joachim Krech98aeaab2016-10-25 21:02:23 +02001484 <xs:attribute name="host" type="HostEnumType" use="optional" default="all"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001485 </xs:extension>
1486 </xs:simpleContent>
1487 </xs:complexType>
1488
Joachim Krech98aeaab2016-10-25 21:02:23 +02001489 <!-- web generator argument does not have host attribute -->
1490 <xs:complexType name="WebGeneratorArgumentType">
1491 <xs:simpleContent>
1492 <xs:extension base='xs:string'>
1493 <!-- web generator argument must have switch argument -->
1494 <xs:attribute name="switch" type="xs:string" use="required"/>
1495 </xs:extension>
1496 </xs:simpleContent>
1497 </xs:complexType>
1498
1499 <!-- eclipse generator argument does not have host nor switch attribute -->
1500 <xs:complexType name="EclipseGeneratorArgumentType">
1501 <xs:simpleContent>
1502 <xs:extension base='xs:string'>
1503 </xs:extension>
1504 </xs:simpleContent>
1505 </xs:complexType>
1506
1507 <xs:complexType name="GeneratorCommandType">
1508 <xs:simpleContent>
1509 <xs:extension base='xs:string'>
1510 <xs:attribute name="host" type="HostEnumType" use="optional" default="all"/>
1511 </xs:extension>
1512 </xs:simpleContent>
1513 </xs:complexType>
1514
Joachim Krechdfe628f2016-07-01 15:36:52 +02001515 <xs:complexType name="GeneratorCommandArgumentsType">
1516 <xs:sequence>
Joachim Krech98aeaab2016-10-25 21:02:23 +02001517 <xs:element name="argument" minOccurs="0" maxOccurs="unbounded">
1518 <xs:complexType>
1519 <xs:simpleContent>
1520 <xs:extension base='xs:string'>
1521 <xs:attribute name="switch" type="xs:string" use="optional"/>
1522 </xs:extension>
1523 </xs:simpleContent>
1524 </xs:complexType>
1525 </xs:element>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001526 </xs:sequence>
1527 </xs:complexType>
1528
1529 <xs:complexType name="GpdscFileType">
1530 <xs:attribute name="name" type="xs:string" use="required"/>
1531 </xs:complexType>
1532
Joachim Krech98aeaab2016-10-25 21:02:23 +02001533 <xs:complexType name="ExeGeneratorType">
1534 <xs:sequence>
1535 <xs:element name="command" type="GeneratorCommandType" minOccurs="1" maxOccurs="4"/>
1536 <xs:element name="argument" type="ExeGeneratorArgumentType" minOccurs="1" maxOccurs="unbounded"/>
1537 </xs:sequence>
1538 <xs:attribute name="host" type="HostEnumType" use="optional" default="all"/>
1539 </xs:complexType>
1540
1541 <xs:complexType name="WebGeneratorType">
1542 <xs:sequence>
1543 <xs:element name="argument" type="WebGeneratorArgumentType" minOccurs="0" maxOccurs="unbounded"/>
1544 </xs:sequence>
1545 <xs:attribute name="url" type="WebGeneratorURLType" use="required"/>
1546 </xs:complexType>
1547
1548 <xs:complexType name="EclipseGeneratorType">
1549 <xs:sequence>
1550 <xs:element name="argument" type="EclipseGeneratorArgumentType" maxOccurs="unbounded"/>
1551 </xs:sequence>
1552 <xs:attribute name="plugin" type="xs:string" use="required"/>
1553 <xs:attribute name="class" type="xs:string" use="required"/>
1554 <xs:attribute name="method" type="xs:string" use="required"/>
1555 </xs:complexType>
1556
1557
Joachim Krechdfe628f2016-07-01 15:36:52 +02001558 <!-- Generator Type -->
1559 <xs:complexType name="GeneratorType">
Joachim Krech98aeaab2016-10-25 21:02:23 +02001560 <xs:choice maxOccurs="unbounded">
1561 <!-- deprecated - use exe, web and/or eclipse -->
1562 <xs:element name="command" type="xs:string" minOccurs="0"/>
1563 <!-- deprecated - use argument tags under exe, web and or eclipse-->
1564 <xs:element name="arguments" type="GeneratorCommandArgumentsType" minOccurs="0"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001565 <xs:element name="description" type="xs:string"/>
1566 <xs:element name="select" type="GeneratorDeviceSelectType" minOccurs="0"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001567 <xs:element name="workingDir" type="xs:string" minOccurs="0"/>
Joachim Krech98aeaab2016-10-25 21:02:23 +02001568 <xs:element name="exe" type="ExeGeneratorType" minOccurs="0" maxOccurs="5"/>
1569 <xs:element name="web" type="WebGeneratorType" minOccurs="0"/>
1570 <xs:element name="eclipse" type="EclipseGeneratorType" minOccurs="0"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001571 <xs:element name="gpdsc" type="GpdscFileType" minOccurs="0"/>
1572 <!-- list of project files / content -->
1573 <xs:element name="project_files" minOccurs="0">
1574 <xs:complexType>
1575 <xs:sequence>
1576 <xs:element name="file" type="FileType" maxOccurs="unbounded"/>
1577 </xs:sequence>
1578 </xs:complexType>
1579 </xs:element>
1580 <!-- list of tool files / content -->
1581 <xs:element name="files" minOccurs="0">
1582 <xs:complexType>
1583 <xs:sequence>
1584 <!-- tool files are under sole control of the generator -->
1585 <xs:element name="file" type="GeneratorFileType" maxOccurs="unbounded"/>
1586 </xs:sequence>
1587 </xs:complexType>
1588 </xs:element>
1589 <!-- Generator tools specific section ignored by other tools -->
1590 <xs:element name="extensions" minOccurs="0">
1591 <xs:complexType>
1592 <xs:sequence>
1593 <xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded">
1594 </xs:any>
1595 </xs:sequence>
1596 </xs:complexType>
1597 </xs:element>
Joachim Krech98aeaab2016-10-25 21:02:23 +02001598 </xs:choice>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001599 <xs:attribute name="id" type="xs:string" use ="required"/>
1600 <xs:attribute name="Gvendor" type="xs:string" use ="optional"/>
1601 <xs:attribute name="Gtool" type="xs:string" use ="optional"/>
1602 <xs:attribute name="Gversion" type="xs:string" use ="optional"/>
1603 </xs:complexType>
1604
1605 <!-- Generators Section -->
1606 <xs:complexType name="GeneratorsType">
1607 <xs:sequence>
1608 <xs:element name="generator" type="GeneratorType" minOccurs="1" maxOccurs="unbounded"/>
1609 </xs:sequence>
1610 </xs:complexType>
1611
1612 <!-- package description root point -->
1613 <xs:element name="package" nillable="true">
1614 <xs:complexType>
1615 <xs:all>
1616 <!-- name of the package (Device Support=DFP, Board Support=BSP) -->
1617 <xs:element name="name" type="RestrictedString" minOccurs="1"/>
1618 <!-- company name of the developer/maintainer of this package -->
1619 <xs:element name="vendor" type="RestrictedString" minOccurs="1"/>
1620 <!-- brief description of the content and purpose of the package -->
1621 <xs:element name="description" type="xs:string" minOccurs="1"/>
1622 <!-- download location of this PDSC and corresponding package file -->
1623 <xs:element name="url" type="xs:anyURI" minOccurs="1"/>
1624 <!-- e.g. mailto:Support@<vendor>.com or www.<vendor>.com/supportRequest -->
1625 <xs:element name="supportContact" type="xs:string" minOccurs="0"/>
1626 <!-- optional: click through license file name and relative path -->
1627 <xs:element name="license" type="xs:string" minOccurs="0"/>
1628 <!-- optional: section listing requirements (1.4.2) -->
1629 <xs:element name="requirements" type="RequirementsType" minOccurs="0"/>
1630 <!-- optional: section used for tool independant project creation (one shot) -->
1631 <xs:element name="create" type="CreateType" minOccurs="0"/>
1632 <!-- Version numbers and release history -->
1633 <xs:element name="releases" type="ReleasesType" minOccurs="1"/>
1634 <!-- keyword for Search Engine Indexing (e.g. Google) -->
1635 <xs:element name="keywords" type="KeywordsType" minOccurs="0"/>
1636 <!-- generators are tools and utilities that are used to generate software components -->
1637 <xs:element name="generators" type="GeneratorsType" minOccurs="0"/>
1638 <!-- definition of devices including references to device support files contained in package -->
1639 <xs:element name="devices" minOccurs="0">
1640 <xs:complexType>
1641 <!-- top level -->
1642 <xs:sequence>
1643 <!-- Family Level begin -->
1644 <xs:element name="family" maxOccurs="unbounded">
1645 <xs:complexType>
1646 <xs:sequence>
1647 <xs:group ref="DevicePropertiesGroup"/>
1648 <xs:element name="device" type="DeviceType" minOccurs="0" maxOccurs="unbounded"/>
1649 <!-- Sub Family Level begin-->
1650 <xs:element name="subFamily" minOccurs="0" maxOccurs="unbounded">
1651 <xs:complexType>
1652 <xs:sequence>
1653 <xs:group ref="DevicePropertiesGroup"/>
1654 <!-- Device Level begin-->
1655 <xs:element name="device" type="DeviceType" maxOccurs="unbounded"/>
1656 <!-- Device Level end -->
1657 </xs:sequence>
1658 <xs:attribute name="DsubFamily" type="xs:string" use="required"/>
1659 </xs:complexType>
1660 </xs:element>
1661 <!-- Sub Family Level end -->
1662 </xs:sequence>
1663 <xs:attribute name="Dfamily" type="xs:string" use="required"/>
1664 <xs:attribute name="Dvendor" type="DeviceVendorEnum" use="required"/>
1665 </xs:complexType>
1666 </xs:element>
1667 <!-- Family Level end -->
1668 </xs:sequence>
1669 </xs:complexType>
1670 </xs:element>
1671 <!-- devices end -->
1672 <!-- definition of boards. Can be referenced by examples -->
1673 <xs:element name="boards" type="BoardsType" minOccurs="0"/>
1674 <!-- boards end -->
1675 <!-- taxonomy section contains default descriptions used in the entire model -->
1676 <xs:element name="taxonomy" type="TaxonomyType" minOccurs="0"/>
1677 <!-- apis section contains api descriptions used in the entire model -->
1678 <xs:element name="apis" type="ApisType" minOccurs="0"/>
1679 <!-- conditions section contains all condition entries used by any component of the package -->
1680 <xs:element name="conditions" type="ConditionsType" minOccurs="0"/>
1681 <!-- examples section defining examples available within a package -->
1682 <xs:element name="examples" type="ExamplesType" minOccurs="0"/>
1683 <!-- software component definition -->
1684 <xs:element name="components" minOccurs="0">
1685 <xs:complexType>
1686 <xs:choice minOccurs="1" maxOccurs="unbounded">
1687 <!-- COMPONENT Description Root Point: -->
1688 <xs:element name="bundle" minOccurs="1" maxOccurs="unbounded">
1689 <xs:complexType>
1690 <xs:sequence>
1691 <xs:element name="description" type="xs:string"/>
1692 <xs:element name="doc" type="xs:string"/>
1693 <xs:element name="component" minOccurs="1" maxOccurs="unbounded">
1694 <xs:complexType>
1695 <xs:sequence>
1696 <!-- a component can be deprecated if it is no longer maintained-->
1697 <xs:element name="deprecated" type="xs:boolean" minOccurs="0" default="false"/>
1698 <!-- short component description displayed -->
1699 <xs:element name="description" type="xs:string"/>
1700 <!-- content to be added to generated RTE_Component.h file -->
1701 <xs:element name="RTE_Components_h" type="xs:string" minOccurs="0"/>
1702 <!-- list of files / content -->
1703 <xs:element name="files">
1704 <xs:complexType>
1705 <xs:sequence>
Joachim Krech98aeaab2016-10-25 21:02:23 +02001706 <xs:element name="file" type="FileType" minOccurs="0" maxOccurs="unbounded"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001707 </xs:sequence>
1708 </xs:complexType>
1709 </xs:element>
1710 </xs:sequence>
1711 <!-- component identity attributes Cclass Cvendor and Cversion are specified by bundle -->
Joachim Krech98aeaab2016-10-25 21:02:23 +02001712 <xs:attribute name="Cgroup" type="CgroupType" use="required"/>
1713 <xs:attribute name="Csub" type="CsubType" use="optional"/>
1714 <xs:attribute name="Cvariant" type="CvariantType" use="optional"/>
1715 <xs:attribute name="Cversion" type="ComponentVersionType" use="optional"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001716 <!-- api version for this component -->
Joachim Krech98aeaab2016-10-25 21:02:23 +02001717 <xs:attribute name="Capiversion" type="ComponentVersionType" use="optional"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001718 <!-- component attribute for referencing a condition specified in conditions section above -->
1719 <xs:attribute name="condition" type="xs:string" use="optional"/>
1720 <!-- maximum allowed number of instances of a component in a project, default - 1-->
1721 <xs:attribute name="maxInstances" type="InstancesType" use="optional"/>
1722 <!-- association of component with a generator. If the component is selected the generator information becomes active -->
1723 <xs:attribute name="generator" type="xs:string" use="optional"/>
1724 <!-- identifies this component variant to be the preferred variant [Version 1.4.0] -->
1725 <xs:attribute name="isDefaultVariant" type="xs:boolean" use="optional"/>
1726 </xs:complexType>
1727 </xs:element>
1728 </xs:sequence>
1729 <!-- bundle attributes -->
1730 <xs:attribute name="Cbundle" type="xs:string" use="required"/>
1731 <xs:attribute name="Cvendor" type="xs:string" use="optional"/>
1732 <xs:attribute name="Cclass" type="CclassType" use="required"/>
Joachim Krech98aeaab2016-10-25 21:02:23 +02001733 <xs:attribute name="Cversion" type="ComponentVersionType" use="required"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001734 <!-- association of component with a generator. If the component is selected the generator information becomes active -->
1735 <xs:attribute name="generator" type="xs:string" use="optional"/>
1736 <!-- identifies this bundle variant to be the preferred variant [Version 1.4.0] -->
1737 <xs:attribute name="isDefaultVariant" type="xs:boolean" use="optional"/>
1738 </xs:complexType>
1739 </xs:element>
1740 <xs:element name="component" minOccurs="1" maxOccurs="unbounded">
1741 <xs:complexType>
1742 <xs:sequence>
1743 <!-- a component can be deprecated if it is no longer maintained-->
1744 <xs:element name="deprecated" type="xs:boolean" minOccurs="0" default="false"/>
1745 <!-- short component description displayed -->
1746 <xs:element name="description" type="xs:string"/>
1747 <!-- content to be added to generated RTE_Component.h file -->
1748 <xs:element name="RTE_Components_h" type="xs:string" minOccurs="0"/>
1749 <!-- list of files / content -->
1750 <xs:element name="files">
1751 <xs:complexType>
1752 <xs:sequence>
1753 <xs:element name="file" type="FileType" maxOccurs="unbounded"/>
1754 </xs:sequence>
1755 </xs:complexType>
1756 </xs:element>
1757 </xs:sequence>
1758 <!-- component identity attributes -->
Joachim Krech98aeaab2016-10-25 21:02:23 +02001759 <xs:attribute name="Cvendor" type="xs:string" use="optional"/>
1760 <xs:attribute name="Cclass" type="CclassType" use="required"/>
1761 <xs:attribute name="Cgroup" type="CgroupType" use="required"/>
1762 <xs:attribute name="Csub" type="CsubType" use="optional"/>
1763 <xs:attribute name="Cvariant" type="CvariantType" use="optional"/>
1764 <xs:attribute name="Cversion" type="ComponentVersionType" use="required"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001765 <!-- api version for this component -->
Joachim Krech98aeaab2016-10-25 21:02:23 +02001766 <xs:attribute name="Capiversion" type="ComponentVersionType" use="optional"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001767 <!-- component attribute for referencing a condition specified in conditions section above -->
1768 <xs:attribute name="condition" type="xs:string" use="optional"/>
1769 <!-- maximum allowed number of instances of a component in a project, default - 1-->
1770 <xs:attribute name="maxInstances" type="InstancesType" use="optional"/>
1771 <!-- association of component with a generator. If the component is selected the generator information becomes active -->
1772 <xs:attribute name="generator" type="xs:string" use="optional"/>
1773 <!-- identifies this component variant to be the preferred variant [Version 1.4.0] -->
1774 <xs:attribute name="isDefaultVariant" type="xs:boolean" use="optional"/>
1775 </xs:complexType>
1776 </xs:element>
1777 </xs:choice>
1778 <xs:attribute name="generator" type="xs:string" use="optional"/>
1779 </xs:complexType>
1780 </xs:element>
1781 </xs:all>
Joachim Krech98aeaab2016-10-25 21:02:23 +02001782 <xs:attribute name="schemaVersion" type="SchemaVersionType" use="required"/>
Joachim Krechdfe628f2016-07-01 15:36:52 +02001783 </xs:complexType>
1784 </xs:element>
1785</xs:schema>