nvidia,tegra186-hsp.txt 1.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152
  1. NVIDIA Tegra Hardware Synchronization Primitives (HSP)
  2. The HSP modules are used for the processors to share resources and communicate
  3. together. It provides a set of hardware synchronization primitives for
  4. interprocessor communication. So the interprocessor communication (IPC)
  5. protocols can use hardware synchronization primitives, when operating between
  6. two processors not in an SMP relationship.
  7. The features that HSP supported are shared mailboxes, shared semaphores,
  8. arbitrated semaphores and doorbells.
  9. Required properties:
  10. - name : Should be hsp
  11. - compatible
  12. Array of strings.
  13. one of:
  14. - "nvidia,tegra186-hsp"
  15. - reg : Offset and length of the register set for the device.
  16. - interrupt-names
  17. Array of strings.
  18. Contains a list of names for the interrupts described by the interrupt
  19. property. May contain the following entries, in any order:
  20. - "doorbell"
  21. Users of this binding MUST look up entries in the interrupt property
  22. by name, using this interrupt-names property to do so.
  23. - interrupts
  24. Array of interrupt specifiers.
  25. Must contain one entry per entry in the interrupt-names property,
  26. in a matching order.
  27. - #mbox-cells : Should be 2.
  28. The mbox specifier of the "mboxes" property in the client node should
  29. contain two data. The first one should be the HSP type and the second
  30. one should be the ID that the client is going to use. Those information
  31. can be found in the following file.
  32. - <dt-bindings/mailbox/tegra186-hsp.h>.
  33. Example:
  34. hsp_top0: hsp@3c00000 {
  35. compatible = "nvidia,tegra186-hsp";
  36. reg = <0x0 0x03c00000 0x0 0xa0000>;
  37. interrupts = <GIC_SPI 176 IRQ_TYPE_LEVEL_HIGH>;
  38. interrupt-names = "doorbell";
  39. #mbox-cells = <2>;
  40. };
  41. client {
  42. ...
  43. mboxes = <&hsp_top0 HSP_MBOX_TYPE_DB HSP_DB_MASTER_XXX>;
  44. };