1#
2# Copyright (c) 2024 Nordic Semiconductor ASA
3#
4# SPDX-License-Identifier: Apache-2.0
5#
6
7description: |
8  Nordic Split Channels
9
10  Some of Nordic's peripherals support split ownership feature that allows to
11  be used by independent owners. As an example the configuration of the
12  Global Real Time Counter (GRTC) is shown below:
13    owned-channels = <0 1 2 3 4 5 6 7 8 9 10 11>;
14    child-owned-channels = <7 8 9 10 11>;
15
16  Which means that channels 0-11 will be assigned to the particular CPU.
17  Other CPUs cannot use those and another set must be defined for them.
18  In addition, `child-owned-channels` property allows to use channels
19  7-11 only by child subprocessor. If the CPU you're configuring has no
20  subprocessor(s) assigned, the `child-owned-channels` property
21  should not be defined.
22
23properties:
24  owned-channels:
25    type: array
26    description: |
27      List of channels in a split-ownership peripheral that are to be owned
28      for use by the compiled CPU.
29
30  nonsecure-channels:
31    type: array
32    description: |
33      List of channels in a split-ownership, split-security peripheral that
34      are to be configured as nonsecure. In Trustzone systems, this property
35      is only evaluated for secure peripherals, as nonsecure channels are
36      implicitly specified through the owned-channels property. This property
37      is ignored in non-Trustzone systems.
38
39  child-owned-channels:
40    type: array
41    description: |
42      List of channels in a split-ownership peripheral that are officially
43      owned by the compiled CPU but intended to be used by its child
44      subprocessor(s).
45