# Precautions while configuring the device tree

Source: [https://docs.qualcomm.com/doc/80-88500-2/topic/14_Precautions_while_configuring_the_device_tree.html](https://docs.qualcomm.com/doc/80-88500-2/topic/14_Precautions_while_configuring_the_device_tree.html)

The following precautions must be considered during the device tree configuration:

- Edit dts file from similar (or reference) hardware. Ensure backup for the original dts file before editing.
- It is not recommended to change the platform ID. If the platform ID is changed, the configuration data table must be changed.
- If the device does not boot up to kernel, check the platform ID. The most common reason for this issue is incorrect platform ID.
- If the device starts to boot but gets kernel panic, perform the following steps:
    1. Check last panic location at the kernel panic dump.
    2. Find the driver that brings kernel panic.
    3. Delete or disable that driver from a device tree for debugging.
    4. See the schematic of the original platform and understand the difference between the original and your platform.
- Many devices are already configured in the included dtsi file but some devices must be modified for the current hardware usage. Some devices are defined but disabled by default. Enable these devices for use.

**Parent Topic:** [Kernel](https://docs.qualcomm.com/doc/80-88500-2/topic/12_Kernel.html)

Last Published: Aug 18, 2023

[Previous Topic
Device tree source file (Linux Embedded)](https://docs.qualcomm.com/bundle/publicresource/80-88500-2/topics/device_tree_source_file_linux_enabled.md) [Next Topic
Disable unwanted device tree entries](https://docs.qualcomm.com/bundle/publicresource/80-88500-2/topics/15_Disable_unwanted_device_tree_entries.md)