edit

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 Raspberry Pi compatible 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!

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 Raspberry Pi compatible header for IoT applications

Specifications

Specification Details
Platform Processor Broadcom BCM2711 quad-core Cortex-A72 (ARM v8)
Frequency 64-bit SoC @ 1.5GHz
Memory Capacity 4GB
Technology LPDDR4 with on-die ECC
eMMC Capacity 32GB
Wireless Wi-Fi 2.4GHz and 5.0GHz IEEE 802.11b/g/n/ac
Bluetooth Bluetooth 5.0, BLE
Display LCD 5-inch 720x1280 LCD
Touch Panel Capacitive touch panel (support multi-touch)
Video HDMI 1 x Micro HDMI output (up to 4Kp60 supported)
CSI 1 x 2-lane MIPI CSI camera interface
Multimedia H.265 (4Kp60 decode)
H.264 (1080p60 decode,1080p30 encode)
OpenGL ES 3.0 graphics
Built-In Modules Real-Time Clock NXP Semiconductors PCF8563T
Low backup current; typical 0.25μA at VDD = 3.0 V and Temperature = 25 ℃
Accelerometer STMicroelectronics LIS3DHTR
16-bit, ±2g/±4g/±8g/±16g dynamically selectable full scale
Encryption Microchip ATECC608A
Secure Hardware-Based Key Storage, Asymmetric Sign, Verify, Key Agreement
Light Sensor Levelek LTR-303ALS-01
Digital light sensor
Internal IO
Expansion
Microchip MCP23008-E
Buzzer ≥85dB @10cm 2700±300Hz
External I/O GPIOs Up 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
Power Recommended 5V@4A DC
Mechanical Dimensions 140mm x 95mm x 21mm

Hardware Overview

pir

pir

Block Diagram

pir

Pinout Diagram

pir

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/4A)
  • 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!

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

You will see the Raspberry Pi OS boot in to Desktop

pir

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

pir

Update Packages and Raspberry Pi OS

Now we will update all the packages and also the Raspberry Pi OS to the latest version

  • Step 1. Open the on-screen virtual keyboard by touching on the Raspberry Pi icon at the top left corner and navigating to Universal Access > Onboard

pir

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

pir

  • Step 3. 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

  • Step 4. Open a terminal window by touching on the Raspberry Pi icon at the top left corner and navigating to Accessories > Terminal

  • Step 5. Update all packages and the Raspberry Pi OS to the latest versions

sudo apt update
sudo apt full-upgrade
  • Step 6. Reboot reTerminal
sudo reboot

Now your Raspberry Pi OS and all the necessary packages are up to update!

Note: 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/4A)
  • 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 and also the remaining 4 screws to take apart the entire case

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 and run this installer 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

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
For Mac/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
  • 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. Enter the following to install libusb
sudo apt install libusb-1.0-0-dev
  • Step 6. Build and install the usbboot tool
make
  • Step 7. Run the usbboot tool and it will wait for a connection
sudo ./rpiboot
  • Step 8. Connect reTerminal to the PC via USB Type-C cable

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

  • Step 10. Open Raspberry Pi Imager software

pir

  • Step 11. 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 12. 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 13. Click CHOOSE STORAGE and select the connected eMMC drive

  • Step 14. Finally, click WRITE

pir

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

  • Step 15. 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
ssh pi@raspberrypi.local
  • 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
ssh pi@raspberrypi.local
  • 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
git clone --depth 1 https://github.com/Seeed-Studio/seeed-linux-dtoverlays
  • Step 2. Enter the repo
cd seeed-linux-dtoverlays
  • Step 3. Type the following to install the drivers
sudo ./scripts/reTerminal.sh

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

pir

  • Step 4. Reboot the reTerminal
sudo reboot

Q1: How can I flash Raspberry Pi OS which is originally shipped with reTerminal?

If you have flashed to a different OS and want to switch back to the default Raspberry Pi OS which is shipped with reTerminal, you can follow the steps below

Note: reTerminal is originally shipped with 32-bit OS. However, you can download a 64-bit version as well

  • Step 2. Extract the .zip file

  • Step 3. Open Raspberry Pi Imager software

pir

  • Step 4. 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 5. Click CHOOSE OS and select Use custom

pir

  • Step 6. Navigate to the previously extracted image, select it and click open

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

  • Step 8. Finally, click WRITE

Q1: How can I flash OS if I replace the CM4 with non-eMMC version

If you want to use a Compute Module 4 without eMMC on the reTerminal, then you need to insert a micro-SD and flash the OS of your choice. Follow the steps below according to your operating system.

  • Step 1. Insert a micro-SD card to the computer using a micro-SD card reader connected to the computer, or by using a built-in card reader on a laptop

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

Note: You can choose to download for either Windows, Mac or Ubuntu

  • Step 3. Open Raspberry Pi Imager software

pir

  • Step 4. 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 5. 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 6. Click CHOOSE STORAGE and select the connected micro-sd card

  • Step 7. Finally, click WRITE

pir

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

  • Step 8. Eject the micro-SD card from computer and insert it into the reTerminal.

pir

Note: You need to open the shell of the reTerminal to access the micro-sd card slot

Q2: How can I log in to Raspberry Pi OS/ Ubuntu OS or other OS using a USB to serial converter

If you have a USB to Serial Converter, you can use the following steps to log in to Raspberry Pi OS

Connect jumper wires from a USB to Serial Converter to the UART pins on the 40-pin GPIO header of the reTerminal as follows

pir

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

For Windows
  • Step 1. Connect the USB to Serial Converter to the PC

  • Step 2. Open Device Manager by typing Device Manager in the windows search box

  • Step 3. Click on the drop-down arrow from Ports (COM & LPT) and find the name of the connected serial port (ex: COM4)

pir

  • Step 4. Download and install Putty by visiting this link

Note: Putty is an SSH and telnet client where you can use it to connect to the reTerminal via SSH. You can skip this step if you already have Putty installed

  • Step 5. Open Putty to connect the PC to the reTerminal

  • Step 6. Select Serial under the Connection Type

  • Step 7. Configure the settings as follows:

    • Serial line: COM4 (choose your COM port)
    • Speed: 9600

pir

  • Step 8. Click Open

  • Step 9. On the Putty window, enter the login details as follows

- Username: pi
- Password: raspberry
  • Step 10. If you have sucessfully logged into the Raspberry Pi OS, you will see the following output

pir

For Mac/Linux
  • Step 1. Connect the USB to Serial Converter to the PC

  • Step 2. Open a terminal window on Mac/Linux

  • Step 3. Type the following to update the packages list

sudo apt-get update
  • Step 4. Type the following to install minicom
sudo apt-get install minicom
  • Step 5. Type the following in the terminal to view the connected serial devices
dmesg | grep tty

Ex:
[ 1562.048241] cdc_acm 1-3:1.0: ttyACM0: USB ACM device

  • Step 6. Connect to the serial device by typing the following
minicom -D /dev/ttyACM0 -b 9600

Note: The baud rate is set to 9600

  • Step 7. After the hardware connections mentioned above, turn on the power from the wall power socket to power on the reTerminal

Now you have successfully logged into Raspberry Pi OS.

Q3: I cannot wake up the reTerminal LCD after sleep

Open a terminal window after connecting through SSH or VNC and enter the following commands

DISPLAY=:0 xset dpms force off
DISPLAY=:0 xset dpms force on

This will reinitialize the LCD on the reTerminal

Resources

Tech Support

Please submit any technical issue into our forum.