Re: [PATCH v5 1/3] dt-bindings: mailbox: add google,gs101-mbox

From: Peter Griffin
Date: Wed Dec 18 2024 - 06:24:16 EST


Hi,

On Wed, 18 Dec 2024 at 09:29, Krzysztof Kozlowski <krzk@xxxxxxxxxx> wrote:
>
> On Tue, Dec 17, 2024 at 09:40:20AM +0000, Tudor Ambarus wrote:
> > +description: |
> > + The samsung exynos mailbox controller has 16 flag bits for hardware interrupt
>
> If there is going to be any new posting:
>
> The Samsung Exynos mailbox controller, used on Google GS101 SoC, ....
>
> > + generation and a shared register for passing mailbox messages. When the
> > + controller is used by the ACPM protocol the shared register is ignored and
> > + the mailbox controller acts as a doorbell. The controller just raises the
> > + interrupt to the firmware after the ACPM protocol has written the message to
> > + SRAM.
> > +
> > +properties:
> > + compatible:
> > + const: google,gs101-mbox
> > +
> > + reg:
> > + maxItems: 1
> > +
> > + clocks:
> > + maxItems: 1
> > +
> > + clock-names:
> > + items:
> > + - const: pclk
> > +
> > + interrupts:
> > + description: IRQ line for the RX mailbox.
> > + maxItems: 1
> > +
> > + '#mbox-cells':
> > + description: |
> > + <&phandle type channel>
> > + phandle : label name of controller.
> > + type : channel type, doorbell or data-transfer.
> > + channel : channel number.
> > +
> > + Here is how a client can reference them:
> > + mboxes = <&ap2apm_mailbox DOORBELL 2>;
> > + mboxes = <&ap2apm_mailbox DATA 3>;
>
> This ordering assumes there is channel "2" in doorbel and in data, so
> two times "2" and of course the same for all others. If this is
> configuration of one channel, so "2" is either doorbell or data, then
> type should be the last.

My understanding was each channel is either configured for doorbell or
data, but Tudor can confirm. With Krzysztof's feedback addressed:

Reviewed-by: Peter Griffin <peter.griffin@xxxxxxxxxx>

regards,

Peter.