Missing mailbox messages documentation

Open

#719 opened on Jan 13, 2017 1 comment 1 reaction 1 assignee View on GitHub

@JamesH65 is already working on this.

Since Jun 29, 2018.

Assessment

This issue has not been assessed yet.

Description

While trying to develop raspberry pi drivers for bare metal development, I came across some issues implementing a proper API to interact with the GPU firmware, because of missing mailbox messages documentation (the initial message I needed was the "Set VSync" one).

Comparing the linux driver definitions and the current documentation in https://github.com/raspberrypi/firmware/wiki/Mailbox-property-interface, I could determine that the following messages are missing in the doc:

Get STC (0x3000B)
Execute QPU (0x30011)
Set Enable QPU (0x30012)
Get Customer OTP (0x30021)
Set Customer OTP (0x38021)
Get Domain State (0x30030)
Set Domain State (0x38030)
Set SDHost Clock (0x38042)
Set VSync (0x4800E)
Set Backlight (0x4800F)
VCHIQ Init (0x48010)
Get Touch Buffer (0x4000F)
Set Touch Buffer (0x4801F)
Get GPIO Virtual Buffer (0x40010)
Set GPIO Virtual Buffer (0x48020)

I may have missed some, but I really like the documentation of those messages (I would even like better to have a more complete description of their actual action, but it's mostly OK and self-explained, so that's fine), just for the sake of completeness, or even to use them (some look really interesting).

Dominant language: No language data
Stars: 5.6k
Forks: 1.7k
PR merge metrics: No merged PRs in 30d

Contributor guide

No contributing guide indexed for this repository

First steps

Read the whole issue, then the project's contributing guide.
Comment on the issue to say you are picking it up — it saves two people doing the same work.
Fork the repository and make your change on a branch.
Open a pull request that references the issue number.

Missing mailbox messages documentation

Assessment

Description

Contributor guide

First steps

More from raspberrypi/firmware

Get new issues in your inbox