reTerminal DM Bookworm update errors

Hi there,

And Welcome here…

So, Absolutely! Let’s break down what that script does step by step, especially in the context of a Seeed Studio reTerminal-DM running a Debian-based Linux OS like Raspberry Pi OS:

:wrench: Full Script Breakdown:

sudo rm -rf seeed-linux-dtoverlays/
  • Removes any existing seeed-linux-dtoverlays directory (if previously cloned).
  • -r = recursive, -f = force delete.
  • This ensures a fresh clone in the next step.

sudo apt install git -y
  • Installs git (if it’s not already installed).
  • -y automatically confirms the installation prompt.

git clone --depth 1 https://github.com/Seeed-Studio/seeed-linux-dtoverlays.git
  • Clones the Seeed Studio’s device tree overlay repo, but only the latest commit (--depth 1) to save time/space.

cd seeed-linux-dtoverlays
  • Changes directory into the freshly cloned repo.

sudo ./scripts/reTerminal.sh --device reTerminal-DM
  • Runs the device setup script for the reTerminal-DM model.
  • This script applies:
    • GPIO configuration
    • Display overlays
    • I2C/SPI/ADC setups
    • Kernel modules
    • Any necessary dtoverlay= lines into /boot/config.txt
  • It essentially tells the OS how to use all the reTerminal-DM hardware correctly.

sudo shutdown -r now
  • Reboots the system immediately to apply changes.

:white_check_mark: Result:

After running this, your reTerminal-DM will:

  • Have correct GPIO overlays applied.
  • Load proper drivers/modules.
  • Recognize and use built-in peripherals like the touchscreen, buttons, sensors, etc.

Check out the WiKi on the reTerminal also lots of good content there.

HTH
GL :slight_smile: PJ :v:

1 Like