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
Temperature Operating Temperature 0 - 70°C( For the LCD Screen: 0 - 60°C)
Mechanical Dimensions 140mm x 95mm x 21mm

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

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!

  • 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/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

FAQ

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

Resources

Tech Support

Please submit any technical issue into our forum.