VC4: igt-gpu-tools Reference Manual

## VC4 VC4 — VC4 support library |

## Functions

uint32_t | igt_vc4_get_cleared_bo ()
int | igt_vc4_create_bo ()
void * | igt_vc4_mmap_bo ()
int | igt_vc4_get_param ()
bool | igt_vc4_purgeable_bo ()
bool | igt_vc4_is_tiled ()
bool | igt_vc4_is_v3d ()
uint32_t | igt_vc4_perfmon_create ()
void | igt_vc4_perfmon_get_values ()
void | igt_vc4_perfmon_destroy ()
void | igt_vc4_set_tiling ()
uint64_t | igt_vc4_get_tiling ()
void | vc4_fb_convert_plane_to_tiled ()
void | vc4_fb_convert_plane_from_tiled ()

## Types and Values

#define | PAGE_SIZE

## Includes

    #include <igt.h>

## Description

This library provides various auxiliary helper functions for writing VC4 tests.

## Functions

### igt_vc4_get_cleared_bo ()

    uint32_t
    igt_vc4_get_cleared_bo (int fd,
                            size_t size,
                            uint32_t clearval);

This helper returns a new BO with the given size, which has just been cleared using the render engine.

#### Parameters

fd | device file descriptor |
size | size of the BO in bytes |
clearval | u32 value that the buffer should be completely cleared with |

### igt_vc4_create_bo ()

    int
    igt_vc4_create_bo (int fd,
                       size_t size);

### igt_vc4_mmap_bo ()

    void *
    igt_vc4_mmap_bo (int fd,
                     uint32_t handle,
                     uint32_t size,
                     unsigned  prot);

### igt_vc4_get_param ()

    int
    igt_vc4_get_param (int fd,
                       uint32_t param,
                       uint64_t *val);

### igt_vc4_purgeable_bo ()

    bool
    igt_vc4_purgeable_bo (int fd,
                          int handle,
                          bool purgeable);

### igt_vc4_is_tiled ()

    bool
    igt_vc4_is_tiled (uint64_t modifier);

### igt_vc4_is_v3d ()

    bool
    igt_vc4_is_v3d (int fd);

### igt_vc4_perfmon_create ()

    uint32_t
    igt_vc4_perfmon_create (int fd,
                            uint32_t ncounters,
                            uint8_t *events);

### igt_vc4_perfmon_get_values ()

    void
    igt_vc4_perfmon_get_values (int fd,
                                uint32_t id);

### igt_vc4_perfmon_destroy ()

    void
    igt_vc4_perfmon_destroy (int fd,
                             uint32_t id);

### igt_vc4_set_tiling ()

    void
    igt_vc4_set_tiling (int fd,
                        uint32_t handle,
                        uint64_t modifier);

### igt_vc4_get_tiling ()

    uint64_t
    igt_vc4_get_tiling (int fd,
                        uint32_t handle);

### vc4_fb_convert_plane_to_tiled ()

    void
    vc4_fb_convert_plane_to_tiled (struct igt_fb *dst,
                                   void *dst_buf,
                                   struct igt_fb *src,
                                   void *src_buf);

### vc4_fb_convert_plane_from_tiled ()

    void
    vc4_fb_convert_plane_from_tiled (struct igt_fb *dst,
                                     void *dst_buf,
                                     struct igt_fb *src,
                                     void *src_buf);

## Types and Values

### PAGE_SIZE

    #define             PAGE_SIZE