bindings/mailbox/mediatek%2Cgce-props.yaml

1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
3 ---
4 $id: http://devicetree.org/schemas/mailbox/mediatek,gce-props.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
10   - Houlong Wei <houlong.wei@mediatek.com>
13   The Global Command Engine (GCE) is an instruction based, multi-threaded,
14   single-core command dispatcher for MediaTek hardware. The Command Queue
15   (CMDQ) mailbox driver is a driver for GCE, implemented using the Linux
17   and configure GCE to execute the specified instruction set in the message.
18   We use mediatek,gce-mailbox.yaml to define the properties for CMDQ mailbox
21   channel corresponding to a GCE hardware thread to send a message, specifying
22   that the GCE thread to configure its hardware. The mailbox provider can also
23   reserve a mailbox channel to configure GCE hardware register by the specific
24   GCE thread. This binding defines the common GCE properties for both mailbox
28   mediatek,gce-events:
30       GCE has an event table in SRAM, consisting of 1024 event IDs (0~1023).
32       The property mediatek,gce-events is used to obtain the event IDs.
33       Some gce-events are hardware-bound and cannot be changed by software.
35       send an event signal to GCE, setting the value of event ID 597 to 1.
38       On the other hand, some gce-events are not hardware-bound and can be
46       software driver, refer to the GCE header
47       include/dt-bindings/gce/<chip>-gce.h of each chip.
48     $ref: /schemas/types.yaml#/definitions/uint32-array