Skip to main content

Getting Started with reTerminal

pir

Introducing reTerminal, a new member of our reThings family. This future-ready Human-Machine Interface (HMI) device can easily and efficiently work with IoT and cloud systems to unlock endless scenarios at the edge.

reTerminal is powered by a Raspberry Pi Compute Module 4 (CM4) which is a Quad-Core Cortex-A72 CPU running at 1.5GHz and a 5-inch IPS capacitive multi-touch screen with a resolution of 1280 x 720. It has sufficient amount of RAM (4GB) to perform multitasking and also has sufficient amount of eMMC storage (32GB) to install an operating system, enabling fast boot up times and smooth overall experience. It has wireless connectivity with dual-band 2.4GHz/5GHz Wi-Fi and Bluetooth 5.0 BLE.

reTerminal consists of a high-speed expansion interface and rich I/O for more expandability. This device has security features such as a cryptographic co-processor with secure hardware-based key storage. It also has built-in modules such as an accelerometer, light sensor and an RTC (Real-Time Clock). reTerminal has a Gigabit Ethernet Port for faster network connections and also has dual USB 2.0 Type-A ports. The 40-pin header on the reTerminal opens it for a wide range of IoT applications.

reTerminal is shipped with Raspberry Pi OS out-of-the-box. So, all you have to do is connect it to power and start building your IoT, HMI and Edge AI applications right away!

Released DatePre-Installed OSPre-Installed STM32 FirmwareBoard VersionAdditional Information
06/15/20212021-06-02-Raspbian(modified)-32-bitV1.0v1.3Initial
08/03/20212021-06-02-Raspbian(modified)-32-bitV1.1v1.4
09/03/20212021-06-02-Raspbian(modified)-32-bitV1.6v1.6Change IO Expansion Chip from MCP23008-E to PCA9554,
Change Encryption Microchip from ATECC608A-SSHDA-B to ATECC608A-TNGTLSS-G More Info
11/02/20212021-09-14-Raspbian(modified)-32-bitV1.8v1.6

Features

  • Integrated modular design with high stability and expandability
  • Powered by Raspberry Pi Computer Module 4 with 4GB RAM & 32GB eMMC
  • 5-Inch IPS capacitive multi-touch screen at 1280 x 720 and 293 PPI
  • Wireless connectivity with dual-band 2.4GHz/5GHz Wi-Fi and Bluetooth 5.0 BLE
  • High-speed expansion interface and rich I/O for more expandability
  • Cryptographic co-processor with secure hardware-based key storage
  • Built-in modules such as accelerometer, light sensor and RTC
  • Gigabit Ethernet Port and Dual USB 2.0 Type-A ports
  • 40-Pin header for IoT applications

Specifications

SpecificationDetails
PlatformProcessorBroadcom BCM2711 quad-core Cortex-A72 (ARM v8)
Frequency64-bit SoC @ 1.5GHz
MemoryCapacity4GB
TechnologyLPDDR4 with on-die ECC
eMMCCapacity32GB
WirelessWi-Fi2.4GHz and 5.0GHz IEEE 802.11b/g/n/ac
BluetoothBluetooth 5.0, BLE
DisplayLCD5-inch 720x1280 LCD
Touch PanelCapacitive touch panel (support multi-touch)
VideoHDMI1 x Micro HDMI output (up to 4Kp60 supported)
CSI1 x 2-lane MIPI CSI camera interface
MultimediaH.265 (4Kp60 decode)
H.264 (1080p60 decode,1080p30 encode)
OpenGL ES 3.0 graphics
Built-In ModulesReal-Time ClockNXP Semiconductors PCF8563T
Low backup current; typical 0.25μA at VDD = 3.0 V and Temperature = 25 ℃
AccelerometerSTMicroelectronics LIS3DHTR
16-bit, ±2g/±4g/±8g/±16g dynamically selectable full scale
EncryptionMicrochip ATECC608A
Secure Hardware-Based Key Storage, Asymmetric Sign, Verify, Key Agreement
Light SensorLevelek LTR-303ALS-01
Digital light sensor
Internal IO
Expansion
Microchip MCP23008-E/ PCA9554
Buzzer≥85dB @10cm 2700±300Hz
External I/OGPIOsUp to 5 × UART
Up to 5 × I2C
Up to 5 × SPI
1 × SDIO interface
1 × DPI (Parallel RGB Display)
1 × PCM
1 × PWM channel
Up to 3× GPCLK outputs
Vertical expansion
interface
1 × PCIe 1-lane Host, Gen 2 (5Gbps)
1 × USB 2.0 port (highspeed)
26 x GPIOs
POE
PowerVoltage5V DC
Current3A(Minimum)
TemperatureOperating Temperature0 - 70°C( For the LCD Screen: 0 - 60°C)
MechanicalDimensions140mm x 95mm x 21mm
Weight285g

Hardware Overview

pir

pir

Block Diagram

pir

Pinout Diagram

Note: Please make sure to keep the reTerminal in the orientation as illustrated below. Here the LCD is facing right side and the back is facing left side.

pir

note

Please carefully pay attention to the orientation of the reTerminal in the above diagram. The LCD and the onboard buttons are on the right side whereas the back of reTerminal is on the left side. Also the whole device is flipped upside down.

Quick Start with reTerminal

If you want to get started with the reTerminal in the most fastest and easiest way, you can follow the guide below.

Hardware Required

You need to prepare the following hardware before getting started with reTerminal

  • reTerminal
  • Ethernet cable or Wi-Fi connection
  • Power adapter (5V/3A)
  • USB Type-C cable

Software Set Up

Log in to Raspberry Pi OS

reTerminal comes with Raspberry Pi OS pre-installed out-of-the-box. So we can turn on the reTerminal and log in to Raspberry Pi OS straight away!

  • Step 1. Connect one end of a USB Type-C cable to the reTerminal and the other end to a power adapter (5V/4A)

  • Step 2. Once the Raspberry Pi OS is booted up, press OK for the Warning window

pir

  • Step 3. In the Welcome to Raspberry Pi window, press Next to get started with the initial set up

pir

  • Step 4. Choose your country, language, timezone and press Next

pir

  • Step 5. To change the password, first click on Raspberry Pi icon, navigate to Universal Access > Onboard to open the on-screen keyboard

pir

  • Step 6. Enter your desired password and click Next

pir

Note: If you want to keep the default password as raspberry, you can leave this blank and click Next

  • Step 7. Click Next for the following

pir

  • Step 8. If you want to connect to a WiFi network, you can choose a network, connect to it and press Next. However, if you want to set it later, you can press Skip

pir

  • Step 9. This step is very important. You should make sure to press Skip to skip updating the software. However, if you want to update the software, you can follow this wiki

pir

  • Step 10. Finally press Done to finish the set up

pir

Note: The button on the top left corner can be used to turn on the reTerminal after shutting down using software

pir

Tip: If you want to experience the Raspberry Pi OS on a bigger screen, you can connect a display to the micro-HDMI port of the reTerminal and also connect a keyboard and a mouse to the USB ports of the reTerminal.

Getting Started with reTerminal (Extended)

If you want to install Raspberry Pi OS by yourself, install other OS such as 64-bit Ubuntu, log in to reTerminal via SSH over WiFi, SSH over Ethernet and USB to Serial Adapter, you can follow the guide below!

Hardware Required

You need to prepare the following hardware

  • reTerminal
  • Computer (Windows/Mac/Linux)
  • 8GB (or more) micro-SD card (optional)
  • Micro-SD card reader (optional)
  • USB to serial converter (optional)
  • Ethernet cable (optional)
  • Wi-Fi connection (optional)
  • Power adapter (5V/3A)
  • USB Type-C cable

Flash Raspberry Pi OS/ 64-bit Ubuntu OS or Other OS to eMMC

We can flash Raspberry Pi OS/ 64-bit Ubuntu OS or other OS on to the eMMC storage of the CM4 on the reTerminal. Once the necessary drivers are installed, you just have to connect the USB Type-C port of the reTerminal to your PC, and it will show as an external drive. Start by removing the reTerminal back shell.

  • Step 1. Remove the 4 rubber covers and open the reTerminal back shell unscrewing the 4 screws underneath

pir

  • Step 2. Remove the 2 screws to disassemble the heatsink

pir

  • Step 3. Flip down the boot mode switch according to the below diagram

pir

Now let's move on to software set up. Follow the steps according to your desired operating system

For Windows
  • Step 1. Download the rpiboot setup installer by click this link to install the necessary drivers and the boot tool

  • Step 2. Connect reTerminal to the PC via USB Type-C cable

Windows will now find the hardware and install the necessary drivers

  • Step 3. Search for rpiboot tool that we installed before and open it

  • Step 4. Open file explorer and you will see the eMMC of the Computer Module 4 shown as a USB mass storage device

  • Step 5. Download Raspberry Pi Imager software by visiting this link

  • Step 6. Open Raspberry Pi Imager software

pir

  • Step 7. Press CTRL + SHIFT + X on the keyboard to open Advanced options window

pir

Here you can set a hostname, enable SSH, set a password, configure wifi, set locale settings and more

  • Step 8. Click CHOOSE OS and select your preferred OS
note

If you are attempting to install Raspbian OS, we have conducted tests and found that both the 32-bit and 64-bit versions of Bullseye work well with reTerminal without encountering any black screen issue. Additionally, we have also tested the new Bookworm 64-bit version, and it functions smoothly on reTerminal.

pir

NOTE: You can select other OS such as 64-bit Ubuntu by navigating into Other general purpose OS

pir

  • Step 9. Click CHOOSE STORAGE and select the connected eMMC drive

  • Step 10. Finally, click WRITE

pir

Please wait a few minutes until the flashing process is complete.

  • Step 11. Flip the Boot Mode switch back to the original position and assemble the reTerminal shell

Now you can skip to here

For MAC
caution

You need to install homebrew before proceed the following steps. Please open a terminal and type brew -V to check if you have setup the correct homebrew environment, you should see the version of the homebrew environment you have installed.

  • Step 1. Clone the usbboot repository
git clone --depth=1 https://github.com/raspberrypi/usbboot
cd usbboot
  • Step 2. Install libusb
brew install libusb
  • Step 3. Install pkg-config
brew install pkg-config
  • Step 4. Build using make
make
  • Step 5. Run the binary
sudo ./rpiboot
  • Step 6. Connect reTerminal to the your Mac computer via USB Type-C cable

  • Step 7. Download and Install Raspberry Pi Imager Application by visiting this link

  • Step 8. Open the Raspberry Pi Imager Application

pir

  • Step 9. Press CTRL + SHIFT + X on the keyboard to open Advanced options window

pir

Here you can set a hostname, enable SSH, set a password, configure wifi, set locale settings and more

  • Step 10. Click CHOOSE OS and select your preferred OS

pir

NOTE: You can select OS such as 64-bit Ubuntu by navigating into Other general purpose OS

pir

  • Step 11. Click CHOOSE STORAGE and select the connected eMMC drive

  • Step 12. Finally, click WRITE

pir

Please wait a few minutes until the flashing process is complete.

  • Step 13. Flip the Boot Mode switch back to the original postion and assemble the reTerminal shell

Now you can skip to here

For Linux

We will use Git to obtain the rpiboot source code, so make sure Git is installed

  • Step 1. Open a Terminal window and type the following to update the packages list
sudo apt-get update
  • Step 2. Install Git by the following command
sudo apt install git pkg-config make gcc libusb-1.0-0-dev
  • Step 3. Git might produce an error if the date is not set properly. Type the following to correct this
sudo date MMDDhhmm

NOTE: Where MM is the month, DD is the date, and hh and mm are hours and minutes respectively.

  • Step 4. Clone the usbboot tool repository
git clone --depth=1 https://github.com/raspberrypi/usbboot
cd usbboot
  • Step 5. Build and install the usbboot tool
make
  • Step 6. Run the usbboot tool and it will wait for a connection
sudo ./rpiboot
  • Step 7. Connect reTerminal to the PC via USB Type-C cable

  • Step 8. Download Raspberry Pi Imager software by visiting this link

  • Step 9. Open Raspberry Pi Imager software

pir

  • Step 10. Press CTRL + SHIFT + X on the keyboard to open Advanced options window

pir

Here you can set a hostname, enable SSH, set a password, configure wifi, set locale settings and more

  • Step 11. Click CHOOSE OS and select your preferred OS

pir

NOTE: You can select OS such as 64-bit Ubuntu by navigating into Other general purpose OS

pir

  • Step 12. Click CHOOSE STORAGE and select the connected eMMC drive

  • Step 13. Finally, click WRITE

pir

Please wait a few minutes until the flashing process is complete.

  • Step 14. Flip the Boot Mode switch back to the original postion and assemble the reTerminal shell

Log in to Raspberry Pi OS/ Ubuntu OS or Other OS using SSH over Wi-Fi/ Ethernet

If you want to log in to the Raspberry Pi OS using SSH over Wi-Fi/ Ethernet, you can follow the steps below. First set up Wi-Fi/Ethernet on the reTerminal and then SSH using Windows/Mac/Linux.

Note: If you have configured WiFi and enabled SSH using Raspberry Pi Imager, you can skip steps 1 - 4

  • Step 1. If you have a Wi-Fi connection, click the Wi-Fi icon on the top right corner of the Raspberry Pi OS Desktop, select your Wi-Fi network and enter the password using the on-screen virtual keyboard

Note: The location of the Wi-Fi setting might be different for other OS

  • Step 2. If you don't have a Wi-Fi connection, you can connect an ethernet cable from your router to the ethernet port of the reTerminal

Note: Make sure the reTerminal and your computer is connected to the same network

  • Step 3. Touch on the Raspberry Pi icon at the top left corner and navigate to Preferences > Raspberry Pi Configuration and click on Interfaces tab

  • Step 4. Select Enable which is next to SSH and click OK

pir

Now let's configure the software on the computer. Please follow according to your operating system

For Windows
  • Step 1. Open Command Prompt and type the following
  • Step 2. Type yes for the prompt

pir

  • Step 3. Enter the password as follows
raspberry
  • Step 4. If you have sucessfully logged into the Raspberry Pi OS, you will see the following output

pir

For Mac/Linux
  • Step 1. Open Terminal on the computer and type the following
  • Step 2. Type yes for the following message
ECDSA key fingerprint is SHA256:XXXXXXX.
Are you sure you want to continue connecting (yes/no/[fingerprint])?
  • Step 3. When it asks for the password, type the following
raspberry
  • Step 4. If you have sucessfully logged into the Raspberry Pi OS, you will see the following output

pir

Install reTerminal drivers after flashing new Raspberry Pi OS/ Ubuntu OS or Other OS

reTerminal comes with the necessary drivers pre-installed out-of-the-box so you don't need to install any additional drivers. However, if you flash new OS by yourself, you need to install the necessary drivers separately. The hardware that need drivers include the 5-inch LCD, touch panel, accelerometer, light sensor, user LEDs, user buttons, RTC, buzzer, cryptographic co-processor.

  • Step 1. Clone the following repo
sudo apt install git -y
git clone --depth 1 https://github.com/Seeed-Studio/seeed-linux-dtoverlays
  • Step 2. Enter the repo
cd seeed-linux-dtoverlays
note

For 32bit OS you will need to add following step before execute sudo ./scripts/reTerminal.sh.After completing the installation, remember to reboot reTerminal for the changes to take effect.

echo arm_64bit=0 | sudo tee -a /boot/config.txt
sudo reboot
  • Step 3. Type the following to install the drivers
sudo ./scripts/reTerminal.sh
note

Type the following if you don't want to upgrade the kernel at the same time:

sudo ./scripts/reTerminal.sh --keep-kernel

You will see the following output if you have successfully installed the drivers

pir

  • Step 4. Reboot the reTerminal
sudo reboot

Flash Raspberry Pi OS with drivers from seeed to eMMC

  • Step 1. As with normal mirror burning steps, you need to select the device model first:

pir

  • Step 2. When choosing an operating system, you need to download the system you need, unzip it in the local folder, and then select it.

  • Download the Raspberry Pi OS by visiting the links below

VersionDescriptionTAG
2024-03-14-Raspbian-reTerminal-arm6464bit Debian12(bookworm) Linux version 6.6.20lastest
2024-03-14-Raspbian-reTerminal-armhf32bit Debian12(bookworm) Linux version 6.6.20lastest
2022-07-21-Raspbian-reTerminal-arm6464bit Debian11(Bullseye) Linux version 5.15.32-v7+release
2022-07-21-Raspbian-reTerminal-armhf32bit Debian11(Bullseye) Linux version 5.15.32-v7+release

pir

Select the OS you downloaded, it should end in .img.


pir

caution

If you install the latest bookworm version of the image. Do not going to configure by clicking the advance option button. Do not enter this interface for any initial configuration. Otherwise, unexpected driver error situations may occur!!!

pir

If you accidentally make an advanced configuration and get a screen flip error, you'll need to reinstall the driver to fix the problem.

  • Step 3. For other operations, refer to the preceding steps. After the image is installed, you do not need to install the driver to use it. (The image we provide includes the driver file)

pir

reTerminal Disassemble Guide

Please check the video below on how to disassemble reTerminal:

>

FAQ

For Frequently Asked Questions, click here to visit the FAQs for reTerminal Usage wiki

Resources

Tech Support & Product Discussion

Thank you for choosing our products! We are here to provide you with different support to ensure that your experience with our products is as smooth as possible. We offer several communication channels to cater to different preferences and needs.

Loading Comments...