# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/remoteproc/ti,am3352-wkup-m3.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: TI AM33xx/AM43xx Wakeup M3 Remote Processor

maintainers:
  - Suman Anna <s-anna@ti.com>
  - Bhargav Joshi <j.bhargav.u@gmail.com>

description:
  The TI AM33xx and AM43xx family of devices use a small Cortex M3 co-processor
  (commonly referred to as Wakeup M3 or CM3) to help with various low power
  tasks that cannot be controlled from the MPU. This CM3 processor requires a
  firmware binary to accomplish this. A wkup_m3 device node is used to
  represent the Wakeup M3 processor instance within the SoC. It is added as a
  child node of the parent interconnect bus (l4_wkup) through which it is
  accessible to the MPU.

properties:
  compatible:
    enum:
      - ti,am3352-wkup-m3
      - ti,am4372-wkup-m3

  reg:
    items:
      - description: Address range for UMEM
      - description: Address range for DMEM

  reg-names:
    items:
      - const: umem
      - const: dmem

  ti,pm-firmware:
    $ref: /schemas/types.yaml#/definitions/string
    description:
      Name of firmware file to be used for loading and booting the wkup_m3
      remote processor.

  resets:
    maxItems: 1

  reset-names:
    items:
      - const: rstctrl

  ti,hwmods:
    $ref: /schemas/types.yaml#/definitions/string
    deprecated: true
    description:
      Name of the hwmod associated with the wkupm3 device.

required:
  - compatible
  - reg
  - reg-names
  - ti,pm-firmware

dependencies:
  resets: [reset-names]
  reset-names: [resets]

additionalProperties: false

examples:
  - |
    target-module@0 {
        compatible = "ti,sysc-omap4", "ti,sysc";
        reg = <0x0 0x4>;
        reg-names = "rev";
        #address-cells = <1>;
        #size-cells = <1>;
        ranges = <0x00000000 0x00000000 0x4000>,
                 <0x00080000 0x00080000 0x2000>;
 
        cpu@0 {
            compatible = "ti,am3352-wkup-m3";
            reg = <0x00000000 0x4000>,
                  <0x00080000 0x2000>;
            reg-names = "umem", "dmem";
            resets = <&prm_wkup 3>;
            reset-names = "rstctrl";
            ti,pm-firmware = "am335x-pm-firmware.elf";
        };
    };