Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document return values of bcm_host_get_peripheral_* functions for clarity #726

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
11 changes: 11 additions & 0 deletions host_applications/linux/libs/bcm_host/include/bcm_host.h
Original file line number Diff line number Diff line change
Expand Up @@ -43,8 +43,19 @@ int32_t graphics_get_display_size( const uint16_t display_number,
uint32_t *width,
uint32_t *height);

/* These functions refer to the peripherals that all Pi's share,
* which may differ from the physical peripheral address on the
* peripheral datasheet. For example, on the BCM2711,
* bcm_host_get_peripheral_address() returns a value 0x0200_0000 bytes higher
* than the "main peripheral" physical addresses from its datasheet.
* On the BCM2711, this is because the first 0x0200_0000 bytes in the "main
* peripherals" block are reserved for BCM2711-specific addresses.
* Source:
* https://github.com/raspberrypi/linux/blob/a90998a3e549911234f9f707050858b98b71360f/arch/arm/boot/dts/bcm2711.dtsi#L34
*/
unsigned bcm_host_get_peripheral_address(void);
unsigned bcm_host_get_peripheral_size(void);

unsigned bcm_host_get_sdram_address(void);

#include "interface/vmcs_host/vc_dispmanx.h"
Expand Down