Start the DRM Server for Intel graphics hardware
Syntax:
drm-intel [-a ]
[-d debug_mask]
[-e ]
[-f video_string]
[-i ]
[-l ]
[-o option_value_pair]
[-p ]
[-s ]
[-t ]
[-v ]
[-w firmware_path]
Options:
- -a
-
List all available options for modules (full format) and then exit. These are the options that you
can use to specify the -o option of this drm-intel utility.
- -d debug_mask
-
Enable DRM debug messages according to the value specified by debug_mask.
Specify which DRM debug messages you want to enable based on the following masks:
- 0x01: DRM_UT_CORE messages
- 0x02: DRM_UT_DRIVER messages
- 0x04: DRM_UT_KMS messages
- 0x08: DRM_UT_PRIME messages
- 0x10: DRM_UT_ATOMIC messages
- 0x20: DRM_UT_INFO messages
- 0x80: DRM_UT_TRACE messages
- 0xFF: All messages
- -e
-
Enable the linux debugfs interface.
- -f video_string
-
Set video format as specified in video_string. This is the analog of the linux
kernel option: video=[video_string]. Specify video_string
by using the following format:
connector:XxY[M][R][-bpp][@refresh_rate][i][m][eDd]
where:
- connector is the type of connection to the display (e.g., DVI-I-1, eDP-1)
- X is width (in pixels) of the display resolution
- Y is height (in pixels) of the display resolution
- M is the option that you can specify to compute a CVT mode
- R is an option that you can specify to reduce blanking
- bpp is the number of bits per pixel to use to indicate color depth
- refresh_rate is rate of refresh of the display
- i is the option that you can specify to compute with interlaced (non-CVT) mode
- m is the option that you can specify to use margins
- e is the option that you can specify to enable output
- D is the option that you can specify to force digital output to be enabled if the display
output connector (e.g., DVI-I connector) has dual (analog/digital) interfaces
- d is the option that you can specify to disable output
- -i
-
Starts the DRM (Direct Rendering Manager) server for Intel graphics hardware and list
the modules' options (short format) with their corresponding value. If you're specifying options
with the -o option, then it must precede the -i in the command line.
For example:
# drm-intel -o enable_fbdev=1 -i
Linux kernel modules settings:
dp_aux_i2c_transfer_size: 16
dp_aux_i2c_speed_khz: 10
debug: 0
edid_fixup: 6
edid_firmware:
poll: Y
timestamp_precision_usec: 20
vblankoffdelay: 5000
assume_16bpp: 0
restrict_dma_mask: 0
force_coherent: 0
restrict_iommu: 0
force_dma_api: 0
enable_fbdev: 1
- -l
-
List all available options for modules (short format) and then exit. These are the options that you
can use to specify the -o option of this drm-intel utility.
- -o option_value_pair
-
Set the options that are specified in option_value_pair. Use the
-a or -l options of this drm-intel utility to
obtain a list of available options you can specify here. Specify option_value_pair
by using the following format:
option=value
where option is from the list you retrieve from the -a or
-l options and option is the value you want to set this option to.
For example, you can run drm-intel with the -a option:
# drm-intel -a
...
enable_ppgtt int Override PPGTT usage...
enable_hangcheck bool Periodically check GPU activity for detecting hangs...
panel_use_ssc int Use Spread Spectrum Clock with panels [LVDS/eDP] (default: auto from VBT)
...
then you can run drm-intel and specify some options such as the following:
# drm-intel -o enable_ppgtt=-1 -o enable_hangcheck=0 -o panel_use_scc=1
Note:
When you set the
DRM_CMDLINE environment variable on your target,
the options and values that you specify in
DRM_CMDLINE will be used
when
drm-intel is invoked by
screen.
Set DRM_CMDLINE to the command-line -o option. For example:
# export DRM_CMDLINE="-o enable_ppgtt=-1 -o enable_hangcheck=0 -o panel_use_scc=1"
- -p
-
Output messages via fprintf()
- -s
-
Output messages via slogf()
- -t
-
Output messages via trace_slogf()
- -v
- Display version information and then exit.
- -w firware_path
-
Set the path to the firmware folder as specified by firmware_path. Otherwise,
the path is /lib/firmware.
Description:
The drm-intel utility starts the DRM (Direct Rendering Manager) server. This service is
required only if your platform is Intel.
If not already running, screen will start drm-intel before its
initialization.
Note:
To run drm-intel as a general user rather than as root, you must:
- be running in a system that uses a security policy
- apply the corresponding policy rules by specifying the appropriate security type when you run drm-intel
- start drm-intel before you start screen
Running as a general user, rather than as root, provides a more secure runtime environment.
If there are any unpredictable applications on the system, they won't be able to
leverage drm-intel to run undesirable code as a
privileged user.
See the Security policies chapter of
this guide for more information.
If you need to manually start drm-intel, then on your target do the following:
-
Run drm-intel from a shell.
- Start screen.