kmstest_pipe_name ()

const char *
kmstest_pipe_name (enum pipe pipe);

kmstest_pipe_to_index ()

int
kmstest_pipe_to_index (char pipe);

kmstest_plane_type_name ()

const char *
kmstest_plane_type_name (int plane_type);

kmstest_port_name()

#define kmstest_port_name(port) ((port) + 'A')

kmstest_encoder_type_str ()

const char *
kmstest_encoder_type_str (int type);

kmstest_connector_status_str ()

const char *
kmstest_connector_status_str (int status);

kmstest_connector_type_str ()

const char *
kmstest_connector_type_str (int type);

kmstest_scaling_filter_str ()

const char *
kmstest_scaling_filter_str (int filter);

kmstest_dsc_output_format_str ()

const char *
kmstest_dsc_output_format_str (int output_format);

kmstest_dump_mode ()

void
kmstest_dump_mode (drmModeModeInfo *mode);

Prints mode to stdout in a human-readable form.

kmstest_get_pipe_from_crtc_id ()

int
kmstest_get_pipe_from_crtc_id (int fd,
                               int crtc_id);

kmstest_set_vt_graphics_mode ()

void
kmstest_set_vt_graphics_mode (void);

Sets the controlling VT (if available) into graphics/raw mode and installs an igt exit handler to set the VT back to text mode on exit. Use kmstest_restore_vt_mode to restore the previous VT mode manually.

All kms tests must call this function to make sure that the fbcon doesn't interfere by e.g. blanking the screen.

kmstest_restore_vt_mode ()

void
kmstest_restore_vt_mode (void);

Restore the VT mode in use before kmstest_set_vt_graphics_mode was called.

kmstest_set_vt_text_mode ()

void
kmstest_set_vt_text_mode (void);

Sets the controlling VT (if available) into text mode. Unlikely kmstest_set_vt_graphics_mode() it do not install an igt exit handler to set the VT back to the previous mode.

kmstest_force_connector ()

bool
kmstest_force_connector (int fd,
                         drmModeConnector *connector,
                         enum kmstest_force_connector_state state);

Force the specified state on the specified connector.

kmstest_force_connector_bigjoiner ()

bool
kmstest_force_connector_bigjoiner (int drm_fd,
                                   drmModeConnector *connector);

Enable force bigjoiner state on the specified connector and install exit handler for resetting

kmstest_force_edid ()

void
kmstest_force_edid (int drm_fd,
                    drmModeConnector *connector,
                    const struct edid *edid);

Set the EDID data on connector to edid . See also igt_kms_get_base_edid.

If edid is NULL, the forced EDID will be removed.

kmstest_get_connector_default_mode ()

bool
kmstest_get_connector_default_mode (int drm_fd,
                                    drmModeConnector *connector,
                                    drmModeModeInfo *mode);

Retrieves the default mode for connector and stores it in mode .

kmstest_get_connector_config ()

bool
kmstest_get_connector_config (int drm_fd,
                              uint32_t connector_id,
                              unsigned long  crtc_idx_mask,
                              struct kmstest_connector_config *config);

This tries to find a suitable configuration for the given connector and CRTC constraint and fills it into config .

kmstest_get_path_blob ()

drmModePropertyBlobPtr
kmstest_get_path_blob (int drm_fd,
                       uint32_t connector_id);

Finds a property with the name "PATH" on the connector object.

kmstest_probe_connector_config ()

bool
kmstest_probe_connector_config (int drm_fd,
                                uint32_t connector_id,
                                unsigned long  crtc_idx_mask,
                                struct kmstest_connector_config *config);

This tries to find a suitable configuration for the given connector and CRTC constraint and fills it into config , fully probing the connector in the process.

kmstest_free_connector_config ()

void
kmstest_free_connector_config (struct kmstest_connector_config *config);

Free any resources in config allocated in kmstest_get_connector_config().

kmstest_set_connector_dpms ()

void
kmstest_set_connector_dpms (int fd,
                            drmModeConnector *connector,
                            int mode);

This function sets the DPMS setting of connector to mode .

kmstest_get_property ()

bool
kmstest_get_property (int drm_fd,
                      uint32_t object_id,
                      uint32_t object_type,
                      const char *name,
                      uint32_t *prop_id,
                      uint64_t *value,
                      drmModePropertyPtr *prop);

Finds a property with the given name on the given object.

kmstest_unset_all_crtcs ()

void
kmstest_unset_all_crtcs (int drm_fd,
                         drmModeResPtr resources);

Disables all the screens.

kmstest_get_crtc_idx ()

int
kmstest_get_crtc_idx (drmModeRes *res,
                      uint32_t crtc_id);

Get the CRTC index based on its ID. This is useful since a few places of libdrm deal with CRTC masks.

kmstest_find_crtc_for_connector ()

uint32_t
kmstest_find_crtc_for_connector (int fd,
                                 drmModeRes *res,
                                 drmModeConnector *connector,
                                 uint32_t crtc_blacklist_idx_mask);

kmstest_dumb_create ()

uint32_t
kmstest_dumb_create (int fd,
                     int width,
                     int height,
                     int bpp,
                     unsigned *stride,
                     uint64_t *size);

This wraps the CREATE_DUMB ioctl, which allocates a new dumb buffer object for the specified dimensions.

kmstest_dumb_map_buffer ()

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

kmstest_dumb_destroy ()

void
kmstest_dumb_destroy (int fd,
                      uint32_t handle);

kmstest_wait_for_pageflip ()

void
kmstest_wait_for_pageflip (int fd);

Blocks until pageflip is completed

kmstest_get_vblank ()

unsigned int
kmstest_get_vblank (int fd,
                    int pipe,
                    unsigned int flags);

Blocks or request a signal when a specified vblank event occurs

Returns 0 on success or non-zero unsigned integer otherwise

kms_has_vblank ()

bool
kms_has_vblank (int fd);

Get the VBlank errno after an attempt to call drmWaitVBlank(). This function is useful for checking if a driver has support or not for VBlank.

igt_display_reset_outputs ()

void
igt_display_reset_outputs (igt_display_t *display);

Initialize display outputs with their connectors and pipes. This function clears any previously allocated outputs.

igt_display_require ()

void
igt_display_require (igt_display_t *display,
                     int drm_fd);

Initialize display and allocate the various resources required. Use igt_display_fini to release the resources when they are no longer required.

This function automatically skips if the kernel driver doesn't support any CRTC or outputs.

igt_display_fini ()

void
igt_display_fini (igt_display_t *display);

Release any resources associated with display . This does not free display itself.

igt_display_reset ()

void
igt_display_reset (igt_display_t *display);

Reset basic pipes, connectors and planes on display back to default values. In particular, the following properties will be reset:

For outputs:

For pipes:

For planes:

igt_display_commit2 ()

int
igt_display_commit2 (igt_display_t *display,
                     enum igt_commit_style s);

Commits framebuffer and positioning changes to all planes of each display pipe, using a specific API to perform the programming. This function should be used to exercise a specific driver programming API; igt_display_commit should be used instead if the API used is unimportant to the test being run.

This function should only be used to commit changes that are expected to succeed, since any failure during the commit process will cause the IGT subtest to fail. To commit changes that are expected to fail, use igt_display_try_commit2 instead.

igt_display_commit ()

int
igt_display_commit (igt_display_t *display);

Commits framebuffer and positioning changes to all planes of each display pipe.

igt_display_try_commit_atomic ()

int
igt_display_try_commit_atomic (igt_display_t *display,
                               uint32_t flags,
                               void *user_data);

This function is similar to igt_display_try_commit2, but is used when you want to pass different flags to the actual commit.

Useful flags can be DRM_MODE_ATOMIC_ALLOW_MODESET, DRM_MODE_ATOMIC_NONBLOCK, DRM_MODE_PAGE_FLIP_EVENT, or DRM_MODE_ATOMIC_TEST_ONLY.

user_data is returned in the event if you pass DRM_MODE_PAGE_FLIP_EVENT to flags .

This function will return an error if commit fails, instead of aborting the test.

igt_display_commit_atomic ()

void
igt_display_commit_atomic (igt_display_t *display,
                           uint32_t flags,
                           void *user_data);

This function is similar to igt_display_commit2, but is used when you want to pass different flags to the actual commit.

Useful flags can be DRM_MODE_ATOMIC_ALLOW_MODESET, DRM_MODE_ATOMIC_NONBLOCK, DRM_MODE_PAGE_FLIP_EVENT, or DRM_MODE_ATOMIC_TEST_ONLY.

user_data is returned in the event if you pass DRM_MODE_PAGE_FLIP_EVENT to flags .

This function will abort the test if commit fails.

igt_display_try_commit2 ()

int
igt_display_try_commit2 (igt_display_t *display,
                         enum igt_commit_style s);

Attempts to commit framebuffer and positioning changes to all planes of each display pipe. This function should be used to commit changes that are expected to fail, so that the error code can be checked for correctness. For changes that are expected to succeed, use igt_display_commit instead.

Note that in non-atomic commit styles, no display programming will be performed after the first failure is encountered, so only some of the operations requested by a test may have been completed. Tests that catch errors returned by this function should take care to restore the display to a sane state after a failure is detected.

igt_display_drop_events ()

int
igt_display_drop_events (igt_display_t *display);

Nonblockingly reads all current events and drops them, for highest reliability, call igt_display_commit2() first to flush all outstanding events.

This will be called on the first commit after igt_display_reset() too, to make sure any stale events are flushed.

igt_display_get_n_pipes ()

int
igt_display_get_n_pipes (igt_display_t *display);

igt_display_require_output ()

void
igt_display_require_output (igt_display_t *display);

Checks whether there's a valid pipe /output combination for the given display Skips test if a valid combination of pipe and output is not found

igt_display_require_output_on_pipe ()

void
igt_display_require_output_on_pipe (igt_display_t *display,
                                    enum pipe pipe);

Checks whether there's a valid pipe /output combination for the given display and pipe Skips test if a valid pipe is not found

igt_output_name ()

const char *
igt_output_name (igt_output_t *output);

igt_output_get_mode ()

drmModeModeInfo *
igt_output_get_mode (igt_output_t *output);

Get the current mode of the given connector

igt_output_override_mode ()

void
igt_output_override_mode (igt_output_t *output,
                          const drmModeModeInfo *mode);

Overrides the output's mode with mode , so that it is used instead of the mode obtained with get connectors. Note that the mode is used without checking if the output supports it, so this might lead to unexpected results.

igt_output_preferred_vrefresh ()

int
igt_output_preferred_vrefresh (igt_output_t *output);

igt_output_set_pipe ()

void
igt_output_set_pipe (igt_output_t *output,
                     enum pipe pipe);

This function sets a pipe to a specific output connector by setting the CRTC_ID property of the pipe . The pipe is only activated for all pipes except PIPE_NONE.

igt_output_get_plane ()

igt_plane_t *
igt_output_get_plane (igt_output_t *output,
                      int plane_idx);

Finds a driving pipe for the given output otherwise and gets the valid plane associated with that pipe for the given plane_idx . This function will terminate the execution if driving pipe is not for a given output .

igt_output_get_plane_type ()

igt_plane_t *
igt_output_get_plane_type (igt_output_t *output,
                           int plane_type);

Finds a valid plane type for the given output otherwise the test is skipped if the right combination of output /plane_type is not found

igt_output_count_plane_type ()

int
igt_output_count_plane_type (igt_output_t *output,
                             int plane_type);

Counts the number of planes of type plane_type for the provided output .

igt_output_get_plane_type_index ()

igt_plane_t *
igt_output_get_plane_type_index (igt_output_t *output,
                                 int plane_type,
                                 int index);

Get the index th plane of type plane_type for the provided output .

igt_output_from_connector ()

igt_output_t *
igt_output_from_connector (igt_display_t *display,
                           drmModeConnector *connector);

Finds the output corresponding to the given connector

igt_output_refresh ()

void
igt_output_refresh (igt_output_t *output);

This function sets the given output to a valid default pipe

igt_std_1024_mode_get ()

drmModeModeInfo *
igt_std_1024_mode_get (int vrefresh);

This function will create a standard drm mode with a given vrefresh

igt_output_set_writeback_fb ()

void
igt_output_set_writeback_fb (igt_output_t *output,
                             struct igt_fb *fb);

This function sets the given fb to be used as the target framebuffer for the writeback engine at the next atomic commit. It will also request a writeback out fence that will contain the fd number of the out fence created by KMS if the given fb is valid.

igt_modeset_disable_all_outputs ()

void
igt_modeset_disable_all_outputs (igt_display_t *display);

Modeset to disable all output

We need to do a modeset disabling all output to get the next HPD event on TypeC port

igt_pipe_get_plane_type ()

igt_plane_t *
igt_pipe_get_plane_type (igt_pipe_t *pipe,
                         int plane_type);

Finds a valid plane type for the given pipe otherwise it skips the test if the right combination of pipe /plane_type is not found

igt_pipe_count_plane_type ()

int
igt_pipe_count_plane_type (igt_pipe_t *pipe,
                           int plane_type);

Counts the number of planes of type plane_type for the provided pipe .

igt_pipe_get_plane_type_index ()

igt_plane_t *
igt_pipe_get_plane_type_index (igt_pipe_t *pipe,
                               int plane_type,
                               int index);

Get the index th plane of type plane_type for the provided pipe .

output_is_internal_panel ()

bool
output_is_internal_panel (igt_output_t *output);

igt_get_single_output_for_pipe ()

igt_output_t *
igt_get_single_output_for_pipe (igt_display_t *display,
                                enum pipe pipe);

Get a compatible output for a pipe.

igt_pipe_request_out_fence ()

void
igt_pipe_request_out_fence (igt_pipe_t *pipe);

Marks this pipe for requesting an out fence at the next atomic commit will contain the fd number of the out fence created by KMS.

igt_plane_set_fb ()

void
igt_plane_set_fb (igt_plane_t *plane,
                  struct igt_fb *fb);

Pairs a given framebuffer to a plane

This function also sets a default size and position for the framebuffer to avoid crashes on applications that ignore to set these.

igt_plane_set_fence_fd ()

void
igt_plane_set_fence_fd (igt_plane_t *plane,
                        int fence_fd);

This function sets a fence fd to enable a commit to wait for some event to occur before completing.

igt_plane_set_pipe ()

void
igt_plane_set_pipe (igt_plane_t *plane,
                    igt_pipe_t *pipe);

igt_plane_set_position ()

void
igt_plane_set_position (igt_plane_t *plane,
                        int x,
                        int y);

This function sets a new (x,y) position for the given plane. New position will be committed at plane commit time via drmModeSetPlane().

igt_plane_set_size ()

void
igt_plane_set_size (igt_plane_t *plane,
                    int w,
                    int h);

This function sets width and height for requested plane. New size will be committed at plane commit time via drmModeSetPlane().

igt_plane_set_rotation ()

void
igt_plane_set_rotation (igt_plane_t *plane,
                        igt_rotation_t rotation);

This function sets a new rotation for the requested plane . New rotation will be committed at plane commit time via drmModeSetPlane().

igt_fb_set_position ()

void
igt_fb_set_position (struct igt_fb *fb,
                     igt_plane_t *plane,
                     uint32_t x,
                     uint32_t y);

This function sets position for requested framebuffer as src to plane. New position will be committed at plane commit time via drmModeSetPlane().

igt_fb_set_size ()

void
igt_fb_set_size (struct igt_fb *fb,
                 igt_plane_t *plane,
                 uint32_t w,
                 uint32_t h);

This function sets fetch rect size from requested framebuffer as src to plane. New size will be committed at plane commit time via drmModeSetPlane().

igt_plane_rotation_name ()

const char *
igt_plane_rotation_name (igt_rotation_t rotation);

igt_wait_for_vblank ()

void
igt_wait_for_vblank (int drm_fd,
                     int crtc_offset);

See igt_wait_for_vblank_count for more details

Waits for 1 vertical blank intervals

igt_wait_for_vblank_count ()

void
igt_wait_for_vblank_count (int drm_fd,
                           int crtc_offset,
                           int count);

Waits for a given number of vertical blank intervals

In DRM, 'Pipe', as understood by DRM_IOCTL_WAIT_VBLANK, is actually an offset of crtc in drmModeRes.crtcs and it has nothing to do with a hardware concept of a pipe. They can match but don't have to in case of DRM lease or non-contiguous pipes.

To make thing clear we are calling DRM_IOCTL_WAIT_VBLANK's 'pipe' a crtc_offset.

igt_pipe_connector_valid()

#define             igt_pipe_connector_valid(pipe, output)

Checks whether the given pipe and output can be used together.

for_each_if()

#define for_each_if(condition) if (!(condition)) {} else

for_each_output()

#define             for_each_output(display, output)

This for loop iterates over all outputs.

for_each_connected_output()

#define             for_each_connected_output(display, output)

This for loop iterates over all connected outputs.

for_each_disconnected_output()

#define             for_each_disconnected_output(display, output)

This for loop iterates over all disconnected outputs.

for_each_pipe_static()

#define             for_each_pipe_static(pipe)

This for loop iterates over all pipes supported by IGT libraries.

This should be used to enumerate per-pipe subtests since it has no runtime depencies.

for_each_pipe()

#define             for_each_pipe(display, pipe)

This for loop iterates over all pipes.

Note that this cannot be used to enumerate per-pipe subtest names since it depends upon runtime probing of the actual kms driver that is being tested. Use for_each_pipe_static instead.

for_each_pipe_with_valid_output()

#define             for_each_pipe_with_valid_output(display, pipe, output)

This for loop is called over all connected outputs. This function will try every combination of pipe and output .

If you only need to test a single output for each pipe, use for_each_pipe_with_single_output(), if you only need an output for a single pipe, use igt_get_single_output_for_pipe().

for_each_pipe_with_single_output()

#define             for_each_pipe_with_single_output(display, pipe, output)

This loop is called over all pipes, and will try to find a compatible output for each pipe. Unlike for_each_pipe_with_valid_output(), this function will be called at most once for each pipe.

for_each_valid_output_on_pipe()

#define             for_each_valid_output_on_pipe(display, pipe, output)

This for loop is called over all connected output that can be used on this pipe . If there are no valid outputs for this pipe, nothing happens.

for_each_plane_on_pipe()

#define             for_each_plane_on_pipe(display, pipe, plane)

This for loop iterates over all planes associated to the given pipe . If there are no valid planes for this pipe, nothing happens.

for_each_connector_mode()

#define             for_each_connector_mode(output)

This for loop iterates over all modes associated to the given output . If there are no mode available for this output, nothing happens.

IGT_FIXED()

#define IGT_FIXED(i,f) ((i) << 16 | (f))

igt_plane_has_prop ()

bool
igt_plane_has_prop (igt_plane_t *plane,
                    enum igt_atomic_plane_properties prop);

Check whether plane supports a given property.

igt_plane_get_prop ()

uint64_t
igt_plane_get_prop (igt_plane_t *plane,
                    enum igt_atomic_plane_properties prop);

Return current value on a plane for a given property.

igt_plane_is_prop_changed()

#define             igt_plane_is_prop_changed(plane, prop)

Check whether a given prop changed for the plane .

igt_plane_set_prop_changed()

#define             igt_plane_set_prop_changed(plane, prop)

Sets the given prop for the plane .

igt_plane_clear_prop_changed()

#define             igt_plane_clear_prop_changed(plane, prop)

Clears the given prop for the plane .

igt_plane_set_prop_value()

#define             igt_plane_set_prop_value(plane, prop, value)

Sets the given prop with the value for the plane .

igt_plane_try_prop_enum ()

bool
igt_plane_try_prop_enum (igt_plane_t *plane,
                         enum igt_atomic_plane_properties prop,
                         const char *val);

igt_plane_set_prop_enum ()

void
igt_plane_set_prop_enum (igt_plane_t *plane,
                         enum igt_atomic_plane_properties prop,
                         const char *val);

This function tries to set given enum property prop value val to the given plane , and terminate the execution if its failed.

igt_plane_replace_prop_blob ()

void
igt_plane_replace_prop_blob (igt_plane_t *plane,
                             enum igt_atomic_plane_properties prop,
                             const void *ptr,
                             size_t length);

This function will destroy the old property blob for the given property, and will create a new property blob with the values passed to this function.

The new property blob will be committed when you call igt_display_commit(), igt_display_commit2() or igt_display_commit_atomic().

igt_plane_check_prop_is_mutable ()

bool
igt_plane_check_prop_is_mutable (igt_plane_t *plane,
                                 enum igt_atomic_plane_properties igt_prop);

Check if a plane supports a given property and if this property is mutable.

Returns true if the plane has the mutable property. False if the property is not support or it's immutable.

igt_output_has_prop ()

bool
igt_output_has_prop (igt_output_t *output,
                     enum igt_atomic_connector_properties prop);

Check whether output supports a given property.

igt_output_get_prop ()

uint64_t
igt_output_get_prop (igt_output_t *output,
                     enum igt_atomic_connector_properties prop);

Return current value on an output for a given property.

igt_output_is_prop_changed()

#define             igt_output_is_prop_changed(output, prop)

Check whether a given prop changed for the Output .

igt_output_set_prop_changed()

#define             igt_output_set_prop_changed(output, prop)

Sets the given prop for the output .

igt_output_clear_prop_changed()

#define             igt_output_clear_prop_changed(output, prop)

Clears the given prop for the output .

igt_output_set_prop_value()

#define             igt_output_set_prop_value(output, prop, value)

Sets the given prop with the value for the output .

igt_output_try_prop_enum ()

bool
igt_output_try_prop_enum (igt_output_t *output,
                          enum igt_atomic_connector_properties prop,
                          const char *val);

igt_output_set_prop_enum ()

void
igt_output_set_prop_enum (igt_output_t *output,
                          enum igt_atomic_connector_properties prop,
                          const char *val);

This function tries to set given enum property prop value val to the given output , and terminate the execution if its failed.

igt_output_replace_prop_blob ()

void
igt_output_replace_prop_blob (igt_output_t *output,
                              enum igt_atomic_connector_properties prop,
                              const void *ptr,
                              size_t length);

This function will destroy the old property blob for the given property, and will create a new property blob with the values passed to this function.

The new property blob will be committed when you call igt_display_commit(), igt_display_commit2() or igt_display_commit_atomic().

igt_pipe_obj_has_prop ()

bool
igt_pipe_obj_has_prop (igt_pipe_t *pipe,
                       enum igt_atomic_crtc_properties prop);

Check whether pipe supports a given property.

igt_pipe_obj_get_prop ()

uint64_t
igt_pipe_obj_get_prop (igt_pipe_t *pipe,
                       enum igt_atomic_crtc_properties prop);

Return current value on a pipe for a given property.

igt_pipe_get_prop ()

uint64_t
igt_pipe_get_prop (igt_display_t *display,
                   enum pipe pipe,
                   enum igt_atomic_crtc_properties prop);

Return current value on a pipe for a given property.

igt_pipe_has_prop ()

bool
igt_pipe_has_prop (igt_display_t *display,
                   enum pipe pipe,
                   enum igt_atomic_crtc_properties prop);

Check whether pipe supports a given property.

igt_pipe_obj_is_prop_changed()

#define             igt_pipe_obj_is_prop_changed(pipe_obj, prop)

Check whether a given prop changed for the pipe_obj .

igt_pipe_is_prop_changed()

#define             igt_pipe_is_prop_changed(display, pipe, prop)

Check whether a given prop changed for the pipe .

igt_pipe_obj_set_prop_changed()

#define             igt_pipe_obj_set_prop_changed(pipe_obj, prop)

Sets the given prop for the pipe_obj .

igt_pipe_set_prop_changed()

#define             igt_pipe_set_prop_changed(display, pipe, prop)

Sets the given prop for the pipe .

igt_pipe_obj_clear_prop_changed()

#define             igt_pipe_obj_clear_prop_changed(pipe_obj, prop)

Clears the given prop for the pipe_obj .

igt_pipe_clear_prop_changed()

#define             igt_pipe_clear_prop_changed(display, pipe, prop)

Clears the given prop for the pipe .

igt_pipe_obj_set_prop_value()

#define             igt_pipe_obj_set_prop_value(pipe_obj, prop, value)

Sets the given prop with the value for the pipe_obj .

igt_pipe_set_prop_value()

#define             igt_pipe_set_prop_value(display, pipe, prop, value)

Sets the given prop with the value for the pipe .

igt_pipe_obj_try_prop_enum ()

bool
igt_pipe_obj_try_prop_enum (igt_pipe_t *pipe,
                            enum igt_atomic_crtc_properties prop,
                            const char *val);

igt_pipe_obj_set_prop_enum ()

void
igt_pipe_obj_set_prop_enum (igt_pipe_t *pipe,
                            enum igt_atomic_crtc_properties prop,
                            const char *val);

This function tries to set given enum property prop value val to the given pipe_obj , and terminate the execution if its failed.

igt_pipe_try_prop_enum()

#define             igt_pipe_try_prop_enum(display, pipe, prop, val)

igt_pipe_set_prop_enum()

#define             igt_pipe_set_prop_enum(display, pipe, prop, val)

This function tries to set given enum property prop value val to the given pipe , and terminate the execution if its failed.

igt_pipe_obj_replace_prop_blob ()

void
igt_pipe_obj_replace_prop_blob (igt_pipe_t *pipe,
                                enum igt_atomic_crtc_properties prop,
                                const void *ptr,
                                size_t length);

This function will destroy the old property blob for the given property, and will create a new property blob with the values passed to this function.

The new property blob will be committed when you call igt_display_commit(), igt_display_commit2() or igt_display_commit_atomic().

Please use igt_output_override_mode() if you want to set IGT_CRTC_MODE_ID, it works better with legacy commit.

igt_pipe_replace_prop_blob()

#define             igt_pipe_replace_prop_blob(display, pipe, prop, ptr, length)

This function will destroy the old property blob for the given property, and will create a new property blob with the values passed to this function.

The new property blob will be committed when you call igt_display_commit(), igt_display_commit2() or igt_display_commit_atomic().

Please use igt_output_override_mode() if you want to set IGT_CRTC_MODE_ID, it works better with legacy commit.

igt_pipe_refresh ()

void
igt_pipe_refresh (igt_display_t *display,
                  enum pipe pipe,
                  bool force);

Requests the pipe to be part of the state on next update. This is useful when state may have been out of sync after a fork, or we just want to be sure the pipe is included in the next commit.

igt_enable_connectors ()

void
igt_enable_connectors (int drm_fd);

Force connectors to be enabled where this is known to work well. Use igt_reset_connectors to revert the changes.

An exit handler is installed to ensure connectors are reset when the test exits.

igt_reset_connectors ()

void
igt_reset_connectors (void);

Remove any forced state from the connectors.

kmstest_get_vbl_flag ()

uint32_t
kmstest_get_vbl_flag (int crtc_offset);

Convert an offset of an crtc in drmModeRes.crtcs into flag representation expected by DRM_IOCTL_WAIT_VBLANK. See igt_wait_for_vblank_count for details

igt_kms_get_base_edid ()

const struct edid *
igt_kms_get_base_edid (void);

Get the base edid block, which includes the following modes:

igt_kms_get_full_edid ()

const struct edid *
igt_kms_get_full_edid (void);

Get the full edid block, which includes the following modes:

igt_kms_get_base_tile_edid ()

const struct edid *
igt_kms_get_base_tile_edid (void);

Get the base tile edid block, which includes the following modes:

igt_kms_get_alt_edid ()

const struct edid *
igt_kms_get_alt_edid (void);

Get an alternate edid block, which includes the following modes:

igt_kms_get_hdmi_audio_edid ()

const struct edid *
igt_kms_get_hdmi_audio_edid (void);

Get a basic edid block, which includes the HDMI Audio

igt_kms_get_dp_audio_edid ()

const struct edid *
igt_kms_get_dp_audio_edid (void);

Get a basic edid block, which includes the DP Audio

igt_kms_get_4k_edid ()

const struct edid *
igt_kms_get_4k_edid (void);

Get a basic edid block, which includes 4K resolution

igt_kms_get_3d_edid ()

const struct edid *
igt_kms_get_3d_edid (void);

Get a basic edid block, which includes 3D mode

igt_kms_get_aspect_ratio_edid ()

const struct edid *
igt_kms_get_aspect_ratio_edid (void);

Gets the base edid block, which includes the following modes and different aspect ratio

igt_kms_get_tiled_edid ()

struct edid **
igt_kms_get_tiled_edid (uint8_t htile,
                        uint8_t vtile);

Get a basic edid block, which includes tiled display

igt_kms_get_custom_edid ()

const struct edid *
igt_kms_get_custom_edid (enum igt_custom_edid_type edid);

edid : enum to specify which edid block is required returns pointer to requested edid block

igt_watch_uevents ()

struct udev_monitor *
igt_watch_uevents (void);

Begin monitoring udev for sysfs uevents.

igt_hotplug_detected ()

bool
igt_hotplug_detected (struct udev_monitor *mon,
                      int timeout_secs);

Detect if a hotplug event was received since we last checked the monitor.

igt_lease_change_detected ()

bool
igt_lease_change_detected (struct udev_monitor *mon,
                           int timeout_secs);

Detect if a lease change event was received since we last checked the monitor.

igt_connector_event_detected ()

bool
igt_connector_event_detected (struct udev_monitor *mon,
                              uint32_t conn_id,
                              uint32_t prop_id,
                              int timeout_msecs);

Detect if a connector event is received for a given connector and property.

igt_flush_uevents ()

void
igt_flush_uevents (struct udev_monitor *mon);

Get rid of any pending uevents

igt_cleanup_uevents ()

void
igt_cleanup_uevents (struct udev_monitor *mon);

Cleanup the resources allocated by igt_watch_uevents

igt_display_has_format_mod ()

bool
igt_display_has_format_mod (igt_display_t *display,
                            uint32_t format,
                            uint64_t modifier);

igt_plane_has_format_mod ()

bool
igt_plane_has_format_mod (igt_plane_t *plane,
                          uint32_t format,
                          uint64_t modifier);

igt_vblank_after_eq ()

return
igt_vblank_after_eq (b Param1,
                     a Param2);

Compare vblank sequence numbers, handling wraparound correctly.

igt_vblank_after ()

return
igt_vblank_after (b Param1,
                  a Param2);

Compare vblank sequence numbers, handling wraparound correctly.

igt_parse_connector_tile_blob ()

void
igt_parse_connector_tile_blob (drmModePropertyBlobPtr blob,
                               igt_tile_info_t *tile);

Parses the connector tile blob to extract the tile information. The blob information is exposed from drm/drm_connector.c in the kernel. The format of the tile property is defined in the kernel as char tile[256] that consists of 8 integers that are ':' separated.

igt_connector_sysfs_open ()

int
igt_connector_sysfs_open (int drm_fd,
                          drmModeConnector *connector);

igt_reduce_format ()

uint32_t
igt_reduce_format (uint32_t format);

Reduce format to a base format. The aim is to allow grouping sufficiently similar formats into classes. Formats with identical component sizes, overall pixel size, chroma subsampling, etc. are considered part of the same class, no matter in which order the components appear. We arbitrarily choose one of the formats in the class as the base format. Note that the base format itself may not be supported by whatever device is being tested even if some of the other formats in the class are supported.

igt_require_pipe ()

void
igt_require_pipe (igt_display_t *display,
                  enum pipe pipe);

Skip a (sub-)test if the pipe not enabled.

Should be used everywhere where a test checks pipe and skip test when pipe is not enabled.

igt_dump_connectors_fd ()

void
igt_dump_connectors_fd (int drmfd);

Iterates through list of connectors and dumps their list of modes.

igt_dump_crtcs_fd ()

void
igt_dump_crtcs_fd (int drmfd);

Iterates through the list of crtcs and dumps out the mode and basic information for each of them.

igt_override_all_active_output_modes_to_fit_bw ()

bool
igt_override_all_active_output_modes_to_fit_bw
                               (igt_display_t *display);

Override the mode on all active outputs (i.e. pending_pipe != PIPE_NONE) on basis of bandwidth.

igt_get_output_max_bpc ()

unsigned int
igt_get_output_max_bpc (int drmfd,
                        char *connector_name);

igt_get_pipe_current_bpc ()

unsigned int
igt_get_pipe_current_bpc (int drmfd,
                          enum pipe pipe);

igt_assert_output_bpc_equal ()

void
igt_assert_output_bpc_equal (int drmfd,
                             enum pipe pipe,
                             char *output_name,
                             unsigned int bpc);

Assert if crtc's current bpc is not matched with the requested one.

igt_check_output_bpc_equal ()

bool
igt_check_output_bpc_equal (int drmfd,
                            enum pipe pipe,
                            char *output_name,
                            unsigned int bpc);

This is similar to igt_assert_output_bpc_equal, instead of assert it'll return True if crtc has the correct requested bpc, else False.

sort_drm_modes_by_clk_dsc ()

int
sort_drm_modes_by_clk_dsc (const void *a,
                           const void *b);

Comparator function for sorting DRM modes in descending order by clock.

sort_drm_modes_by_clk_asc ()

int
sort_drm_modes_by_clk_asc (const void *a,
                           const void *b);

Comparator function for sorting DRM modes in ascending order by clock.

sort_drm_modes_by_res_dsc ()

int
sort_drm_modes_by_res_dsc (const void *a,
                           const void *b);

Comparator function for sorting DRM modes in descending order by resolution.

sort_drm_modes_by_res_asc ()

int
sort_drm_modes_by_res_asc (const void *a,
                           const void *b);

Comparator function for sorting DRM modes in ascending order by resolution.

igt_sort_connector_modes ()

void
igt_sort_connector_modes (drmModeConnector *connector,
                          int (*comparator) (const void *, const void*));

Sorts connector modes based on the comparator .

igt_max_bpc_constraint ()

bool
igt_max_bpc_constraint (igt_display_t *display,
                        enum pipe pipe,
                        igt_output_t *output,
                        int bpc);

The "max bpc" property only ensures that the bpc will not go beyond the value set through this property. It does not guarantee that the same bpc will be used for the given mode.

So, if we really want a particular bpc set, try reducing the resolution till we get the bpc that we set in max bpc property.

igt_get_max_dotclock ()

int
igt_get_max_dotclock (int fd);

Get the Max pixel clock frequency from intel specific debugfs "i915_frequency_info".

igt_bigjoiner_possible ()

bool
igt_bigjoiner_possible (drmModeModeInfo *mode,
                        int max_dotclock);

Bigjoiner will come into the picture, when the requested mode resolution > 5K or mode clock > max_dotclock.

bigjoiner_mode_found ()

bool
bigjoiner_mode_found (int drm_fd,
                      drmModeConnector *connector,
                      int max_dotclock,
                      drmModeModeInfo *mode);

Bigjoiner will come in to the picture when the resolution > 5K or clock > max-dot-clock.