# Add custom machine configurations

This explains how to define a custom machine configuration and build a custom image.

To add a custom machine configuration and rebuild the workspace, do the following:

1. To add a machine, add a new machine configuration file at
`layers/meta-qcom-hwe/conf/machine/`; for example,
`layers/meta-qcom-hwe/conf/machine/test-board.conf`.
2. If the new machine is using the QCS6490 hardware system-on-chip (SoC),
in the created file, add the following content:

#@TYPE: Machine
        #@NAME: TestBoard
        #@DESCRIPTION: Machine configuration for a development board, based on Qualcomm QCS6490
        
        require conf/machine/include/qcom-qcs6490.inc
        Copy to clipboard
3. Source the setup-environment script:

MACHINE=test-board DISTRO=qcom-wayland QCOM_SELECTED_BSP=custom source setup-environment
        Copy to clipboard

Note

If you have access to `meta-qcom-extras`, add the layer to
`EXTRALAYERS ?=` `${WORKSPACE}/layers/meta-qcom-extras`
in the `conf/bblayers.conf` file.
4. To build an image for the machine added, run the following command:

bitbake qcom-multimedia-image
        Copy to clipboard

Last Published: Dec 21, 2025

[Previous Topic
Customize Qualcomm Linux](https://docs.qualcomm.com/bundle/publicresource/80-70023-27/topics/customize_qualcomm_linux.md) [Next Topic
Add custom distribution configurations](https://docs.qualcomm.com/bundle/publicresource/80-70023-27/topics/add_custom_distro_configurations.md)