Skip to content

Ioter released by Samsung is an open-source implementation of the Matter Thread Emulator

License

Notifications You must be signed in to change notification settings

fuxiaoming-lumi/ioter

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

ioter_overview

Supporting Things (2023-04-27)

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

ioter-things

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
  1. excute
cd ioter
./script/run

How to onboarding

ioter-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

About

Ioter released by Samsung is an open-source implementation of the Matter Thread Emulator

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 97.0%
  • Shell 3.0%