1<?xml version="1.0" encoding="utf-8"?>
2<!--
3**
4** Copyright 2022, The Android Open Source Project
5**
6** Licensed under the Apache License, Version 2.0 (the "License")
7** you may not use this file except in compliance with the License.
8** You may obtain a copy of the License at
9**
10**     http://www.apache.org/licenses/LICENSE-2.0
11**
12** Unless required by applicable law or agreed to in writing, software
13** distributed under the License is distributed on an "AS IS" BASIS,
14** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15** See the License for the specific language governing permissions and
16** limitations under the License.
17*/
18-->
19
20<!-- Long comment describing anything that may be needed
21for this file and its maintenance -->
22<irq-device-map>
23    <!-- Small comment specific to this device -->
24    <invalid name="test.device.1">
25        <!-- These valid subsystem definitions should be ignored because of invalid parent tag -->
26        <subsystem>test.subsystem.1</subsystem>
27        <subsystem>test.subsystem.2</subsystem>
28    </invalid>
29    <device name="test.device.2">
30        <!-- Multiline comment to describe nuances
31         about why these subsystems
32         rely on this hardware device
33         to wake the CPU up from sleep
34        -->
35        <subsystem>test.subsystem.3</subsystem>
36        <!-- Small comment specific to test.subsystem.4 -->
37        <subsystem>test.subsystem.4</subsystem>
38        <subsystem>test.subsystem.5</subsystem>
39        <!-- Duplicates should be ignored -->
40        <subsystem>test.subsystem.4</subsystem>
41        <subsystem>test.subsystem.3</subsystem>
42        <subsystem>test.subsystem.5</subsystem>
43    </device>
44
45    <device name="test.device.3">
46        <!-- All child tags are invalid, mapping should be empty / non-existent for this device -->
47        <subsys>ignored</subsys>
48        <system>redundant</system>
49    </device>
50
51    <device name="test.device.4">
52        <!-- Invalid child tags should be skipped but others should be mapped -->
53        <invalid>unused</invalid>
54        <random>skipped</random>
55        <subsystem>test.subsystem.1</subsystem>
56        <subsystem>test.subsystem.4</subsystem>
57    </device>
58
59</irq-device-map>