Ioter

What is Ioter

Ioter is a tool that allows you to emulate all Matter supported IoT devices with Linux PC and Thread RCP dongle. This tool runs All-cluster-app of Matter on Linux PC to emulate multiple instances of Matter supported various IoT nodes. Each of these IoT nodes uses underlying Thread RCP based USB Dongle(Radio) for data transmission. By using Samsungs SmartThings Station(that acts as Border Router) and SmartThings Application along with emulated IoT nodes, we can configure a Smart Home.

Ioter acts as Mate/Helper to developers, testers and device manufacturers involved in smart home devices that are compliant with Matter and Thread specifications and it is very beneficial in terms of its below offerings:

• Flexibility: Multiple types of IoT devices can be implemented using single RCP Dongle.
• Multiple devices: Devices can be implemented as many as the number of RCP dongles(up to 10).
• Low Cost: Do not need to pay for testing various IoT device types.
• Time-Saving: Time involved in searching and procuring various IoT device types is saved.
• Easy to use: Intuitive UI supports in controlling the status of various device types from the program window.
• Automation: Repeated testing through scripts can validate device stability and connection.

Overview

Supporting Things (2023-04-27)

• Light Bulb
• Door Lock
• Contact Sensor
• Temperature Sensor
• Humidity Sensor
• Light Sensor
• Window Covering
• Occupancy Sensor
• OnOff Plugin

Prepare tools

• Bluetooth enabled desktop or laptop
• Ubuntu 22.04 (Previous version has Bluetooth version problem)
• USB hub with power input (USB3.0 recommended)
• Thread RCP usb dongle. We verified with this:
  1. Nordic nrf52840 OT RCP dongle guide
• Phone with SmartThings App installed and onboarded with Samsung SmartThings Station.

How to install and excute

1. install

cd ioter
./script/setup

2. excute

cd ioter
./script/run

How to onboarding

1. If you run the ioter with run script, the thing can be executed with the start button.
2. The Power on button has the same function as the device power.
3. When you click Power on, a QR code and a paring code are created. Use this to proceed with the onboarding procedure.
4. When the connection is completed, Thing control is possible.

Known issues

Problem with specific linux kernel version (higher than 5.16 and lower than 6.1.2) The message below appears in the syslog kernel: wpan0 (unregistered): mctp_unregister: BUG mctp_ptr set for unknown type 65535

openthread/openthread#8523

Please use a stable kernel version of 5.15.0-60-generic

$ sudo apt-get install aptitude
$ sudo aptitude search linux-image
$ sudo aptitude install linux-image-5.15.0-60-generic
$ sudo grub-mkconfig | grep -iE "menuentry 'Ubuntu, with Linux" | awk '{print i++ " : "$1, $2, $3, $4, $5, $6, $7}'
  ex)
    0 : menuentry 'Ubuntu, with Linux 5.19.0-32-generic' --class ubuntu
    1 : menuentry 'Ubuntu, with Linux 5.19.0-32-generic (recovery mode)'
    2 : menuentry 'Ubuntu, with Linux 5.15.0-60-generic' --class ubuntu
    3 : menuentry 'Ubuntu, with Linux 5.15.0-60-generic (recovery mode)'
$ sudo nano /etc/default/grub
   Find line GRUB_DEFAULT=...(by default GRUB_DEFAULT=0) and sets in quotes menu path to concrete Kernel. 
   In my system first index was 1 and second was 2. I set in to GRUB_DEFAULT
   GRUB_DEFAULT="1>2"
$ sudo update-grub