Elvis Wiki - User contributions [en]

BWAPP for macOS (M1 Chip): Setup

2023-12-20T16:57:41Z

ATomic:

== Summary ==

bWAPP (Buggy Web Application) is an intentionally insecure web application designed for educational and training purposes. It was created to provide security professionals, developers, and students with practical experience in the field of web application security. bWAPP contains a variety of security vulnerabilities and weaknesses from the TOP 10 OWASP, allowing users to practice and understand the most critical web application security risks.

== Requirements ==

* Operating system: KaliLinux / beeBox

To install bWAPP, KaliLinux is recommended as the operating system, as Ubuntu 22.04LTS has compatibility problems with the latest bWAPP version and is therefore not recommended. Another alternative is beeBox, but this article will only deal with the installation of bWAPP on KaliLinux.

== Description ==

=== Step 1: Install bWAPP in Kali ===

1. Visit [https://sourceforge.net/projects/bwapp/files/bWAPP/ bWAPP Download Page] - Download the newest version v2.2

2. Open the command prompt and use following commands (install apache & mysql before)

a) We have our downloaded zip file --> '''cd Downloads'''

b) Unzip file --> '''sudo unzip -d /var/www/html bWAPP_latest.zip'''

c) To check our apache web folder go to the directory --> '''cd /var/www/html'''

d) Change the folder permission of bWAPP --> '''sudo chmod -R 777 bWAPP'''

e) Start apache service --> '''sudo service apache2 start'''

f) Start mysql service --> '''sudo service mysql start'''

=== Step 2: Configure settings for mySQL ===
a) Login to mysql --> '''sudo mysql'''

b) Modify the settings.php file for mySQL --> '''cd /var/www/html/bWAPP/admin'''

c) Under $db_username & $db_password set your credentials for the mySQL login

d) Now login to mysql --> '''mysql -h $your_dbservername -u $your_dbusername'''

e) Create a user --> '''CREATE USER '$your_dbusername'@'$your_db_servername' identified by '';'''

f) Now grant the user all privileges over the database --> '''grant all privileges on bWAPP.* to '$your_dbusername'@'$your_db_servername' identified by '';'''

g) Now open the browser and navigate to /localhost/bWAPP/install.php and click on "install here"

=== Step 3: Blank page redirect: Solution ===

If bWAPP could not be installed or you were redirected to a blank page, you must follow the steps below to make bWAPP work:

a) Look at your apache errorlogs --> '''sudo cat /var/log/apache2/error.log'''

b) You should get the error that "bWAPP" is an unknown database, it's because install.php can't execute it's code and can't create the bWAPP database for you. To get around this problem you need to create the bWAPP database manually as well as the content / tables inside from the install.php file with copy/paste.

c) Create the database manually --> '''create database bWAPP;'''

d) Open install.php file and copy every SQL command into SQL

If you now try to install bWAPP over /localhost/bWAPP/install.php the output should be that a bWAPP database already exists. So you can go to "Login" and login. Happy hacking :)!

== References ==

* http://www.itsecgames.com/
*

[[Category:Documentation]]

BWAPP for macOS (M1 Chip): Setup

2023-12-20T16:57:06Z

ATomic:

== Summary ==

bWAPP (Buggy Web Application) is an intentionally insecure web application designed for educational and training purposes. It was created to provide security professionals, developers, and students with practical experience in the field of web application security. bWAPP contains a variety of security vulnerabilities and weaknesses from the TOP 10 OWASP, allowing users to practice and understand the most critical web application security risks.

== Requirements ==

* Operating system: KaliLinux / beeBox

To install bWAPP, KaliLinux is recommended as the operating system, as Ubuntu 22.04LTS has compatibility problems with the latest bWAPP version and is therefore not recommended. Another alternative is beeBox, but this article will only deal with the installation of bWAPP on KaliLinux

== Description ==

=== Step 1: Install bWAPP in Kali ===

1. Visit [https://sourceforge.net/projects/bwapp/files/bWAPP/ bWAPP Download Page] - Download the newest version v2.2

2. Open the command prompt and use following commands (install apache & mysql before)

a) We have our downloaded zip file --> '''cd Downloads'''

b) Unzip file --> '''sudo unzip -d /var/www/html bWAPP_latest.zip'''

c) To check our apache web folder go to the directory --> '''cd /var/www/html'''

d) Change the folder permission of bWAPP --> '''sudo chmod -R 777 bWAPP'''

e) Start apache service --> '''sudo service apache2 start'''

f) Start mysql service --> '''sudo service mysql start'''

=== Step 2: Configure settings for mySQL ===
a) Login to mysql --> '''sudo mysql'''

b) Modify the settings.php file for mySQL --> '''cd /var/www/html/bWAPP/admin'''

c) Under $db_username & $db_password set your credentials for the mySQL login

d) Now login to mysql --> '''mysql -h $your_dbservername -u $your_dbusername'''

e) Create a user --> '''CREATE USER '$your_dbusername'@'$your_db_servername' identified by '';'''

f) Now grant the user all privileges over the database --> '''grant all privileges on bWAPP.* to '$your_dbusername'@'$your_db_servername' identified by '';'''

g) Now open the browser and navigate to /localhost/bWAPP/install.php and click on "install here"

=== Step 3: Blank page redirect: Solution ===

If bWAPP could not be installed or you were redirected to a blank page, you must follow the steps below to make bWAPP work:

a) Look at your apache errorlogs --> '''sudo cat /var/log/apache2/error.log'''

b) You should get the error that "bWAPP" is an unknown database, it's because install.php can't execute it's code and can't create the bWAPP database for you. To get around this problem you need to create the bWAPP database manually as well as the content / tables inside from the install.php file with copy/paste.

c) Create the database manually --> '''create database bWAPP;'''

d) Open install.php file and copy every SQL command into SQL

If you now try to install bWAPP over /localhost/bWAPP/install.php the output should be that a bWAPP database already exists. So you can go to "Login" and login. Happy hacking :)!

== References ==

* http://www.itsecgames.com/
*

[[Category:Documentation]]

BWAPP for macOS (M1 Chip): Setup

2023-12-20T16:54:13Z

ATomic:

== Summary ==

bWAPP (Buggy Web Application) is an intentionally insecure web application designed for educational and training purposes. It was created to provide security professionals, developers, and students with practical experience in the field of web application security. bWAPP contains a variety of security vulnerabilities and weaknesses from the TOP 10 OWASP, allowing users to practice and understand the most critical web application security risks.

== Requirements ==

* Operating system: KaliLinux / beeBox

To install bWAPP, KaliLinux is recommended as the operating system, as Ubuntu 22.04LTS has compatibility problems with the latest bWAPP version and is therefore not recommended. Another alternative is beeBox, but this article will only deal with the installation of bWAPP on KaliLinux

== Description ==

=== Step 1: Install bWAPP in Kali ===

1. Visit [https://sourceforge.net/projects/bwapp/files/bWAPP/ bWAPP Download Page] - Download the newest version v2.2

2. Open the command prompt and use following commands (install apache & mysql before)

a) We have our downloaded zip file --> '''cd Downloads'''

b) Unzip file --> '''sudo unzip -d /var/www/html bWAPP_latest.zip'''

c) To check our apache web folder go to the directory --> '''cd /var/www/html'''

d) Change the folder permission of bWAPP --> '''sudo chmod -R 777 bWAPP'''

e) Start apache service --> '''sudo service apache2 start'''

f) Start mysql service --> '''sudo service mysql start'''

=== Step 2: Configure settings for mySQL ===
a) Login to mysql --> '''sudo mysql'''

b) Modify the settings.php file for mySQL --> '''cd /var/www/html/bWAPP/admin'''

c) Under $db_username & $db_password set your credentials for the mySQL login

d) Now login to mysql --> '''mysql -h $your_dbservername -u $your_dbusername'''

e) Create a user --> '''CREATE USER '$your_dbusername'@'$your_db_servername' identified by '';'''

f) Now grant the user all privileges over the database --> '''grant all privileges on bWAPP.* to '$your_dbusername'@'$your_db_servername' identified by '';'''

g) Now open the browser and navigate to /localhost/bWAPP/install.php and click on "install here"

=== Step 3: Blank page redirect: Solution ===

If bWAPP could not be installed or you were redirected to a blank page, you must follow the steps below to make bWAPP work:

a) Look at your apache errorlogs --> '''sudo cat /var/log/apache2/error.log'''

b) You should get the error that "bWAPP" is an unknown database, it's because install.php can't execute it's code and can't create the bWAPP database for you. To get around this problem you need to create the bWAPP database manually as well as the content / tables inside from the install.php file with copy/paste.

c) Create the database manually --> '''create database bWAPP;'''

d) Open install.php file and copy every SQL command into SQL

== References ==

* http://www.itsecgames.com/
*

[[Category:Documentation]]

BWAPP for macOS (M1 Chip): Setup

2023-12-20T16:50:51Z

ATomic:

== Summary ==

bWAPP (Buggy Web Application) is an intentionally insecure web application designed for educational and training purposes. It was created to provide security professionals, developers, and students with practical experience in the field of web application security. bWAPP contains a variety of security vulnerabilities and weaknesses from the TOP 10 OWASP, allowing users to practice and understand the most critical web application security risks.

== Requirements ==

* Operating system: KaliLinux / beeBox

To install bWAPP, KaliLinux is recommended as the operating system, as Ubuntu 22.04LTS has compatibility problems with the latest bWAPP version and is therefore not recommended. Another alternative is beeBox, but this article will only deal with the installation of bWAPP on KaliLinux

== Description ==

=== Step 1: Install bWAPP in Kali ===

1. Visit [https://sourceforge.net/projects/bwapp/files/bWAPP/ bWAPP Download Page] - Download the newest version v2.2

2. Open the command prompt and use following commands (install apache & mysql before)

a) We have our downloaded zip file --> '''cd Downloads'''

b) Unzip file --> '''sudo unzip -d /var/www/html bWAPP_latest.zip'''

c) To check our apache web folder go to the directory --> '''cd /var/www/html'''

d) Change the folder permission of bWAPP --> '''sudo chmod -R 777 bWAPP'''

e) Start apache service --> '''sudo service apache2 start'''

f) Start mysql service --> '''sudo service mysql start'''

=== Step 2: Configure settings for mySQL ===
a) Login to mysql --> '''sudo mysql'''

b) Modify the settings.php file for mySQL --> '''cd /var/www/html/bWAPP/admin'''

c) Under $db_username & $db_password set your credentials for the mySQL login

d) Now login to mysql --> '''mysql -h $your_dbservername -u $your_dbusername'''

e) Create a user --> '''CREATE USER '$your_dbusername'@'$your_db_servername' identified by '';'''

f) Now grant the user all privileges over the database --> '''grant all privileges on bWAPP.* to '$your_dbusername'@'$your_db_servername' identified by '';'''

g) Now open the browser and navigate to /localhost/bWAPP/install.php and click on "install here"

=== Step 3: Blank page redirect: Solution ===

If bWAPP could not be installed or you were redirected to a blank page, you must follow the steps below to make bWAPP work:

a) Look at your apache errorlogs --> '''sudo cat /var/log/apache2/error.log'''

b) You should get the error that "bWAPP" is an unknown database, it's because install.php can't execute it's code and can't create the bWAPP database for you. To get around this problem you need to create the bWAPP database manually as well as the content / tables inside from the install.php file with copy/paste.

c) Create the database manually --> '''create database bWAPP;'''

d) Open install.php file and copy every SQL command into SQL

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== Courses ==

* [[A course where this documentation was used]] (2017, 2018)
* [[Another one]] (2018)

== References ==

* https://wikipedia.org
* https://google.com

[[Category:Documentation]]

BWAPP for macOS (M1 Chip): Setup

2023-12-20T16:50:00Z

ATomic:

== Summary ==

bWAPP (Buggy Web Application) is an intentionally insecure web application designed for educational and training purposes. It was created to provide security professionals, developers, and students with practical experience in the field of web application security. bWAPP contains a variety of security vulnerabilities and weaknesses from the TOP 10 OWASP, allowing users to practice and understand the most critical web application security risks.

== Requirements ==

* Operating system: KaliLinux / beeBox

To install bWAPP, KaliLinux is recommended as the operating system, as Ubuntu 22.04LTS has compatibility problems with the latest bWAPP version and is therefore not recommended. Another alternative is beeBox, but this article will only deal with the installation of bWAPP on KaliLinux

== Description ==

=== Step 1: Install bWAPP in Kali ===

1. Visit [https://sourceforge.net/projects/bwapp/files/bWAPP/ bWAPP Download Page] - Download the newest version v2.2

2. Open the command prompt and use following commands (install apache & mysql before)

a) We have our downloaded zip file --> '''cd Downloads'''
b) Unzip file --> '''sudo unzip -d /var/www/html bWAPP_latest.zip'''
c) To check our apache web folder go to the directory --> '''cd /var/www/html'''
d) Change the folder permission of bWAPP --> '''sudo chmod -R 777 bWAPP'''
e) Start apache service --> '''sudo service apache2 start'''
f) Start mysql service --> '''sudo service mysql start'''

=== Step 2: Configure settings for mySQL ===
a) Login to mysql --> '''sudo mysql'''
b) Modify the settings.php file for mySQL --> '''cd /var/www/html/bWAPP/admin'''
c) Under $db_username & $db_password set your credentials for the mySQL login
d) Now login to mysql --> '''mysql -h $your_dbservername -u $your_dbusername'''
e) Create a user --> '''CREATE USER '$your_dbusername'@'$your_db_servername' identified by '';'''
f) Now grant the user all privileges over the database --> '''grant all privileges on bWAPP.* to '$your_dbusername'@'$your_db_servername' identified by '';'''
g) Now open the browser and navigate to /localhost/bWAPP/install.php and click on "install here"

=== Step 3: Blank page redirect: Solution ===

If bWAPP could not be installed or you were redirected to a blank page, you must follow the steps below to make bWAPP work:

a) Look at your apache errorlogs --> '''sudo cat /var/log/apache2/error.log'''

b) You should get the error that "bWAPP" is an unknown database, it's because install.php can't execute it's code and can't create the bWAPP database for you. To get around this problem you need to create the bWAPP database manually as well as the content / tables inside from the install.php file with copy/paste.

c) Create the database manually --> '''create database bWAPP;'''
d) Open install.php file and copy every SQL command into SQL

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== Courses ==

* [[A course where this documentation was used]] (2017, 2018)
* [[Another one]] (2018)

== References ==

* https://wikipedia.org
* https://google.com

[[Category:Documentation]]

BWAPP for macOS (M1 Chip): Setup

2023-12-20T16:48:51Z

ATomic:

== Summary ==

bWAPP (Buggy Web Application) is an intentionally insecure web application designed for educational and training purposes. It was created to provide security professionals, developers, and students with practical experience in the field of web application security. bWAPP contains a variety of security vulnerabilities and weaknesses from the TOP 10 OWASP, allowing users to practice and understand the most critical web application security risks.

== Requirements ==

* Operating system: KaliLinux / beeBox

To install bWAPP, KaliLinux is recommended as the operating system, as Ubuntu 22.04LTS has compatibility problems with the latest bWAPP version and is therefore not recommended. Another alternative is beeBox, but this article will only deal with the installation of bWAPP on KaliLinux

== Description ==

=== Step 1: Install bWAPP in Kali ===

1. Visit [https://sourceforge.net/projects/bwapp/files/bWAPP/ bWAPP Download Page] - Download the newest version v2.2

2. Open the command prompt and use following commands (install apache & mysql before)

a) We have our downloaded zip file --> '''cd Downloads'''
b) Unzip file --> '''sudo unzip -d /var/www/html bWAPP_latest.zip'''
c) To check our apache web folder go to the directory --> '''cd /var/www/html'''
d) Change the folder permission of bWAPP --> '''sudo chmod -R 777 bWAPP'''
e) Start apache service --> '''sudo service apache2 start'''
f) Start mysql service --> '''sudo service mysql start'''

=== Step 2: Configure settings for mySQL ===
a) Login to mysql --> '''sudo mysql'''
b) Modify the settings.php file for mySQL --> '''cd /var/www/html/bWAPP/admin'''
c) Under $db_username & $db_password set your credentials for the mySQL login
d) Now login to mysql --> '''mysql -h $your_dbservername -u $your_dbusername'''
e) Create a user --> '''CREATE USER '$your_dbusername'@'$your_db_servername' identified by '';'''
f) Now grant the user all privileges over the database --> '''grant all privileges on bWAPP.* to '$your_dbusername'@'$your_db_servername' identified by '';'''
g) Now open the browser and navigate to /localhost/bWAPP/install.php and click on "install here"

=== Step 3: Blank page redirect: Solution ===

If bWAPP could not be installed or you were redirected to a blank page, you must follow the steps below to make bWAPP work:

* Look at your apache errorlogs --> '''sudo cat /var/log/apache2/error.log'''

* You should get the error that "bWAPP" is an unknown database, it's because install.php can't execute it's code and can't create the bWAPP database for you. To get around this problem you need to create the bWAPP database manually as well as the content / tables inside from the install.php file with copy/paste.

* Create the database manually --> '''create database bWAPP;'''
* Open install.php file and copy every SQL command into SQL
== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== Courses ==

* [[A course where this documentation was used]] (2017, 2018)
* [[Another one]] (2018)

== References ==

* https://wikipedia.org
* https://google.com

[[Category:Documentation]]

BWAPP for macOS (M1 Chip): Setup

2023-12-20T16:48:20Z

ATomic:

== Summary ==

bWAPP (Buggy Web Application) is an intentionally insecure web application designed for educational and training purposes. It was created to provide security professionals, developers, and students with practical experience in the field of web application security. bWAPP contains a variety of security vulnerabilities and weaknesses from the TOP 10 OWASP, allowing users to practice and understand the most critical web application security risks.

== Requirements ==

* Operating system: KaliLinux / beeBox

To install bWAPP, KaliLinux is recommended as the operating system, as Ubuntu 22.04LTS has compatibility problems with the latest bWAPP version and is therefore not recommended. Another alternative is beeBox, but this article will only deal with the installation of bWAPP on KaliLinux

== Description ==

=== Step 1: Install bWAPP in Kali ===

1. Visit [https://sourceforge.net/projects/bwapp/files/bWAPP/ bWAPP Download Page] - Download the newest version v2.2

2. Open the command prompt and use following commands (install apache & mysql before)

a) We have our downloaded zip file --> '''cd Downloads'''
b) Unzip file --> '''sudo unzip -d /var/www/html bWAPP_latest.zip'''
c) To check our apache web folder go to the directory --> '''cd /var/www/html'''
d) Change the folder permission of bWAPP --> '''sudo chmod -R 777 bWAPP'''
e) Start apache service --> '''sudo service apache2 start'''
f) Start mysql service --> '''sudo service mysql start'''

=== Step 2: Configure settings for mySQL ===
a) Login to mysql --> '''sudo mysql'''
b) Modify the settings.php file for mySQL --> '''cd /var/www/html/bWAPP/admin'''
c) Under $db_username & $db_password set your credentials for the mySQL login
d) Now login to mysql --> '''mysql -h $your_dbservername -u $your_dbusername'''
e) Create a user --> '''CREATE USER '$your_dbusername'@'$your_db_servername' identified by '';'''
f) Now grant the user all privileges over the database --> '''grant all privileges on bWAPP.* to '$your_dbusername'@'$your_db_servername' identified by '';'''
g) Now open the browser and navigate to /localhost/bWAPP/install.php and click on "install here"

=== Step 3: Blank page redirect: Solution ===

If bWAPP could not be installed or you were redirected to a blank page, you must follow the steps below to make bWAPP work:

* Look at your apache errorlogs --> '''sudo cat /var/log/apache2/error.log'''

* You should get the error that "bWAPP" is an unknown database, it's because install.php can't execute it's code and can't create the bWAPP database for you. To get around this problem you need to create the bWAPP database manually as well as the content / tables inside from the install.php file with copy/paste.

* Create the database manually --> '''create database bWAPP;'''
* Open install.php file and copy every SQL command into SQL
== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== Courses ==

* [[A course where this documentation was used]] (2017, 2018)
* [[Another one]] (2018)

== References ==

* https://wikipedia.org
* https://google.com

[[Category:Documentation]]

BWAPP for macOS (M1 Chip): Setup

2023-12-20T16:41:16Z

ATomic:

== Summary ==

bWAPP (Buggy Web Application) is an intentionally insecure web application designed for educational and training purposes. It was created to provide security professionals, developers, and students with practical experience in the field of web application security. bWAPP contains a variety of security vulnerabilities and weaknesses from the TOP 10 OWASP, allowing users to practice and understand the most critical web application security risks.

== Requirements ==

* Operating system: KaliLinux / beeBox

To install bWAPP, KaliLinux is recommended as the operating system, as Ubuntu 22.04LTS has compatibility problems with the latest bWAPP version and is therefore not recommended. Another alternative is beeBox, but this article will only deal with the installation of bWAPP on KaliLinux

== Description ==

=== Step 1: Install bWAPP in Kali ===

1. Visit [https://sourceforge.net/projects/bwapp/files/bWAPP/ bWAPP Download Page] - Download the newest version v2.2

2. Open the command prompt and use following commands (install apache & mysql before)

a) We have our downloaded zip file --> '''cd Downloads'''
b) Unzip file --> sudo unzip -d /var/www/html bWAPP_latest.zip
c) To check our apache web folder go to the directory --> cd /var/www/html
d) Change the folder permission of bWAPP --> sudo chmod -R 777 bWAPP
e) Start apache service --> sudo service apache2 start
f) Start mysql service --> sudo service mysql start

=== Step 2: Configure settings for mySQL ===
a) Login to mysql --> sudo mysql
b) Modify the settings.php file for mySQL --> cd /var/www/html/bWAPP/admin
c) Under $db_username & $db_password set your credentials for the mySQL login
d) Now login to mysql --> mysql -h $your_dbservername -u $your_dbusername
e) Create a user --> CREATE USER '$your_dbusername'@'$your_db_servername' identified by '';
f) Now grant the user all privileges over the database --> grant all privileges on bWAPP.* to '$your_dbusername'@'$your_db_servername' identified by '';
g) Now open the browser and navigate to /localhost/bWAPP/install.php and click on "install here"

=== Step 3: Blank page redirect: Solution ===

If bWAPP could not be installed or you were redirected to a blank page, you must follow the steps below to make bWAPP work:

* Look at your apache errorlogs --> sudo cat /var/log/apache2/error.log

* You should get the error that "bWAPP" is an unknown database, it's because install.php can't execute it's code and can't create the bWAPP database for you. To get around this problem you need to create the bWAPP database manually as well as the content / tables inside from the install.php file with copy/paste.

* Create the database manually --> create database bWAPP;
* Open install.php file and copy every SQL command into SQL
== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== Courses ==

* [[A course where this documentation was used]] (2017, 2018)
* [[Another one]] (2018)

== References ==

* https://wikipedia.org
* https://google.com

[[Category:Documentation]]

BWAPP for macOS (M1 Chip): Setup

2023-12-20T16:33:11Z

ATomic:

== Summary ==

bWAPP (Buggy Web Application) is an intentionally insecure web application designed for educational and training purposes. It was created to provide security professionals, developers, and students with practical experience in the field of web application security. bWAPP contains a variety of security vulnerabilities and weaknesses from the TOP 10 OWASP, allowing users to practice and understand the most critical web application security risks.

== Requirements ==

* Operating system: KaliLinux / beeBox

To install bWAPP, KaliLinux is recommended as the operating system, as Ubuntu 22.04LTS has compatibility problems with the latest bWAPP version and is therefore not recommended. Another alternative is beeBox, but this article will only deal with the installation of bWAPP on KaliLinux

== Description ==

=== Step 1: Install bWAPP in Kali ===

1. Visit [https://sourceforge.net/projects/bwapp/files/bWAPP/ bWAPP Download Page] - Download the newest version v2.2

2. Open the command prompt and use following commands (install apache & mysql before)

a) We have our downloaded zip file --> cd Downloads
b) Unzip file --> sudo unzip -d /var/www/html bWAPP_latest.zip
c) To check our apache web folder go to the directory --> cd /var/www/html
d) Change the folder permission of bWAPP --> sudo chmod -R 777 bWAPP
e) Start apache service --> sudo service apache2 start
f) Start mysql service --> sudo service mysql start

=== Step 2: Configure settings for mySQL ===
a) Login to mysql --> sudo mysql
b) Modify the settings.php file for mySQL --> cd /var/www/html/bWAPP/admin
c) Under $db_username & $db_password set your credentials for the mySQL login
d) Now login to mysql --> mysql -h $your_dbservername -u $your_dbusername
e) Create a user --> CREATE USER '$your_dbusername'@'$your_db_servername' identified by '';
f) Now grant the user all privileges over the database --> grant all privileges on bWAPP.* to '$your_dbusername'@'$your_db_servername' identified by '';
g) Now open the browser and navigate to /localhost/bWAPP/install.php and click on "install here"

=== Step 3: Blank page redirect: Solution ===

If bWAPP could not be installed or you were redirected to a blank page, you must follow the steps below to make bWAPP work:

* Look at your apache errorlogs --> sudo cat /var/log/apache2/error.log

** You should get the error that "bWAPP" is an unknown database, it's because install.php can't execute it's code and can't create the bWAPP database for you. To get around this problem you need to create the bWAPP database manually as well as the content / tables inside from the install.php file with copy/paste.

* Create the database manually --> create database bWAPP;
* Open install.php file and copy every SQL command into SQL
== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== Courses ==

* [[A course where this documentation was used]] (2017, 2018)
* [[Another one]] (2018)

== References ==

* https://wikipedia.org
* https://google.com

[[Category:Documentation]]

BWAPP for macOS (M1 Chip): Setup

2023-12-20T16:32:49Z

ATomic:

== Summary ==

bWAPP (Buggy Web Application) is an intentionally insecure web application designed for educational and training purposes. It was created to provide security professionals, developers, and students with practical experience in the field of web application security. bWAPP contains a variety of security vulnerabilities and weaknesses from the TOP 10 OWASP, allowing users to practice and understand the most critical web application security risks.

== Requirements ==

* Operating system: KaliLinux / beeBox

To install bWAPP, KaliLinux is recommended as the operating system, as Ubuntu 22.04LTS has compatibility problems with the latest bWAPP version and is therefore not recommended. Another alternative is beeBox, but this article will only deal with the installation of bWAPP on KaliLinux

== Description ==

=== Step 1: Install bWAPP in Kali ===

1. Visit [https://sourceforge.net/projects/bwapp/files/bWAPP/ bWAPP Download Page] - Download the newest version v2.2

2. Open the command prompt and use following commands (install apache & mysql before)

a) We have our downloaded zip file --> cd Downloads
b) Unzip file --> sudo unzip -d /var/www/html bWAPP_latest.zip
c) To check our apache web folder go to the directory --> cd /var/www/html
d) Change the folder permission of bWAPP --> sudo chmod -R 777 bWAPP
e) Start apache service --> sudo service apache2 start
f) Start mysql service --> sudo service mysql start

=== Step 2: Configure settings for mySQL ===
a) Login to mysql --> sudo mysql
b) Modify the settings.php file for mySQL --> cd /var/www/html/bWAPP/admin
c) Under $db_username & $db_password set your credentials for the mySQL login
d) Now login to mysql --> mysql -h $your_dbservername -u $your_dbusername
e) Create a user --> CREATE USER '$your_dbusername'@'$your_db_servername' identified by '';
f) Now grant the user all privileges over the database --> grant all privileges on bWAPP.* to '$your_dbusername'@'$your_db_servername' identified by '';
g) Now open the browser and navigate to /localhost/bWAPP/install.php and click on "install here"

=== Step 3: Blank page redirect: Solution ===

If bWAPP could not be installed or you were redirected to a blank page, you must follow the steps below to make bWAPP work:

* Look at your apache errorlogs --> sudo cat /var/log/apache2/error.log

** You should get the error that "bWAPP" is an unknown database, it's because install.php can't execute it's code and can't create the bWAPP database for you. To get around this problem you need to create the bWAPP database manually as well as the content / tables inside from the install.php file with copy/paste.

* Create the database manually --> create database bWAPP;
* Open install.php file and copy every SQL command into SQL
== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== Courses ==

* [[A course where this documentation was used]] (2017, 2018)
* [[Another one]] (2018)

== References ==

* https://wikipedia.org
* https://google.com

[[Category:Documentation]]

BWAPP for macOS (M1 Chip): Setup

2023-12-20T16:32:36Z

ATomic:

== Summary ==

bWAPP (Buggy Web Application) is an intentionally insecure web application designed for educational and training purposes. It was created to provide security professionals, developers, and students with practical experience in the field of web application security. bWAPP contains a variety of security vulnerabilities and weaknesses from the TOP 10 OWASP, allowing users to practice and understand the most critical web application security risks.

== Requirements ==

* Operating system: KaliLinux / beeBox

To install bWAPP, KaliLinux is recommended as the operating system, as Ubuntu 22.04LTS has compatibility problems with the latest bWAPP version and is therefore not recommended. Another alternative is beeBox, but this article will only deal with the installation of bWAPP on KaliLinux

== Description ==

=== Step 1: Install bWAPP in Kali ===

1. Visit [https://sourceforge.net/projects/bwapp/files/bWAPP/ bWAPP Download Page] - Download the newest version v2.2

2. Open the command prompt and use following commands (install apache & mysql before)

a) We have our downloaded zip file --> cd Downloads
b) Unzip file --> sudo unzip -d /var/www/html bWAPP_latest.zip
c) To check our apache web folder go to the directory --> cd /var/www/html
d) Change the folder permission of bWAPP --> sudo chmod -R 777 bWAPP
e) Start apache service --> sudo service apache2 start
f) Start mysql service --> sudo service mysql start

=== Step 2: Configure settings for mySQL ===
a) Login to mysql --> sudo mysql
b) Modify the settings.php file for mySQL --> cd /var/www/html/bWAPP/admin
c) Under $db_username & $db_password set your credentials for the mySQL login
d) Now login to mysql --> mysql -h $your_dbservername -u $your_dbusername
e) Create a user --> CREATE USER '$your_dbusername'@'$your_db_servername' identified by '';
f) Now grant the user all privileges over the database --> grant all privileges on bWAPP.* to '$your_dbusername'@'$your_db_servername' identified by '';
g) Now open the browser and navigate to /localhost/bWAPP/install.php and click on "install here"

=== Step 3: Blank page redirect: Solution ===

If bWAPP could not be installed or you were redirected to a blank page, you must follow the steps below to make bWAPP work:

* Look at your apache errorlogs --> sudo cat /var/log/apache2/error.log

* You should get the error that "bWAPP" is an unknown database, it's because install.php can't execute it's code and can't create the bWAPP database for you. To get around this problem you need to create the bWAPP database manually as well as the content / tables inside from the install.php file with copy/paste.

* Create the database manually --> create database bWAPP;
* Open install.php file and copy every SQL command into SQL
== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== Courses ==

* [[A course where this documentation was used]] (2017, 2018)
* [[Another one]] (2018)

== References ==

* https://wikipedia.org
* https://google.com

[[Category:Documentation]]

BWAPP for macOS (M1 Chip): Setup

2023-12-20T16:32:20Z

ATomic:

== Summary ==

bWAPP (Buggy Web Application) is an intentionally insecure web application designed for educational and training purposes. It was created to provide security professionals, developers, and students with practical experience in the field of web application security. bWAPP contains a variety of security vulnerabilities and weaknesses from the TOP 10 OWASP, allowing users to practice and understand the most critical web application security risks.

== Requirements ==

* Operating system: KaliLinux / beeBox

To install bWAPP, KaliLinux is recommended as the operating system, as Ubuntu 22.04LTS has compatibility problems with the latest bWAPP version and is therefore not recommended. Another alternative is beeBox, but this article will only deal with the installation of bWAPP on KaliLinux

== Description ==

=== Step 1: Install bWAPP in Kali ===

1. Visit [https://sourceforge.net/projects/bwapp/files/bWAPP/ bWAPP Download Page] - Download the newest version v2.2

2. Open the command prompt and use following commands (install apache & mysql before)

a) We have our downloaded zip file --> cd Downloads
b) Unzip file --> sudo unzip -d /var/www/html bWAPP_latest.zip
c) To check our apache web folder go to the directory --> cd /var/www/html
d) Change the folder permission of bWAPP --> sudo chmod -R 777 bWAPP
e) Start apache service --> sudo service apache2 start
f) Start mysql service --> sudo service mysql start

=== Step 2: Configure settings for mySQL ===
a) Login to mysql --> sudo mysql
b) Modify the settings.php file for mySQL --> cd /var/www/html/bWAPP/admin
c) Under $db_username & $db_password set your credentials for the mySQL login
d) Now login to mysql --> mysql -h $your_dbservername -u $your_dbusername
e) Create a user --> CREATE USER '$your_dbusername'@'$your_db_servername' identified by '';
f) Now grant the user all privileges over the database --> grant all privileges on bWAPP.* to '$your_dbusername'@'$your_db_servername' identified by '';
g) Now open the browser and navigate to /localhost/bWAPP/install.php and click on "install here"

=== Step 3: Blank page redirect: Solution ===

If bWAPP could not be installed or you were redirected to a blank page, you must follow the steps below to make bWAPP work:

* Look at your apache errorlogs --> sudo cat /var/log/apache2/error.log

**You should get the error that "bWAPP" is an unknown database, it's because install.php can't execute it's code and can't create the bWAPP database for you. To get around this problem you need to create the bWAPP database manually as well as the content / tables inside from the install.php file with copy/paste.

* Create the database manually --> create database bWAPP;
* Open install.php file and copy every SQL command into SQL
== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== Courses ==

* [[A course where this documentation was used]] (2017, 2018)
* [[Another one]] (2018)

== References ==

* https://wikipedia.org
* https://google.com

[[Category:Documentation]]

BWAPP for macOS (M1 Chip): Setup

2023-12-20T16:31:40Z

ATomic:

== Summary ==

bWAPP (Buggy Web Application) is an intentionally insecure web application designed for educational and training purposes. It was created to provide security professionals, developers, and students with practical experience in the field of web application security. bWAPP contains a variety of security vulnerabilities and weaknesses from the TOP 10 OWASP, allowing users to practice and understand the most critical web application security risks.

== Requirements ==

* Operating system: KaliLinux / beeBox

To install bWAPP, KaliLinux is recommended as the operating system, as Ubuntu 22.04LTS has compatibility problems with the latest bWAPP version and is therefore not recommended. Another alternative is beeBox, but this article will only deal with the installation of bWAPP on KaliLinux

== Description ==

=== Step 1: Install bWAPP in Kali ===

1. Visit [https://sourceforge.net/projects/bwapp/files/bWAPP/ bWAPP Download Page] - Download the newest version v2.2

2. Open the command prompt and use following commands (install apache & mysql before)

a) We have our downloaded zip file --> cd Downloads
b) Unzip file --> sudo unzip -d /var/www/html bWAPP_latest.zip
c) To check our apache web folder go to the directory --> cd /var/www/html
d) Change the folder permission of bWAPP --> sudo chmod -R 777 bWAPP
e) Start apache service --> sudo service apache2 start
f) Start mysql service --> sudo service mysql start

=== Step 2: Configure settings for mySQL ===
a) Login to mysql --> sudo mysql
b) Modify the settings.php file for mySQL --> cd /var/www/html/bWAPP/admin
c) Under $db_username & $db_password set your credentials for the mySQL login
d) Now login to mysql --> mysql -h $your_dbservername -u $your_dbusername
e) Create a user --> CREATE USER '$your_dbusername'@'$your_db_servername' identified by '';
f) Now grant the user all privileges over the database --> grant all privileges on bWAPP.* to '$your_dbusername'@'$your_db_servername' identified by '';
g) Now open the browser and navigate to /localhost/bWAPP/install.php and click on "install here"

=== Step 3: Blank page redirect: Solution ===

If bWAPP could not be installed or you were redirected to a blank page, you must follow the steps below to make bWAPP work:

* Look at your apache errorlogs --> sudo cat /var/log/apache2/error.log

You should get the error that "bWAPP" is an unknown database, it's because install.php can't execute it's code and can't create the bWAPP database for you. To get around this problem you need to create the bWAPP database manually as well as the content / tables inside from the install.php file with copy/paste.

* Create the database manually --> create database bWAPP;
* Open install.php file and copy every SQL command into SQL
== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== Courses ==

* [[A course where this documentation was used]] (2017, 2018)
* [[Another one]] (2018)

== References ==

* https://wikipedia.org
* https://google.com

[[Category:Documentation]]

BWAPP for macOS (M1 Chip): Setup

2023-12-20T14:58:00Z

ATomic:

BWAPP for macOS (M1 Chip): Setup

2023-12-20T14:56:08Z

ATomic:

BWAPP for macOS (M1 Chip): Setup

2023-12-20T14:55:50Z

ATomic:

BWAPP for macOS (M1 Chip): Setup

2023-12-20T14:53:51Z

ATomic:

BWAPP for macOS (M1 Chip): Setup

2023-12-20T14:48:30Z

ATomic:

BWAPP for macOS (M1 Chip): Setup

2023-12-20T14:42:22Z

ATomic:

BWAPP for macOS (M1 Chip): Setup

2023-12-20T14:25:40Z

ATomic:

BWAPP for macOS (M1 Chip): Setup

2023-12-20T14:05:45Z

ATomic:

BWAPP for macOS (M1 Chip): Setup

2023-12-19T16:36:02Z

ATomic: Created page with "== Summary == bWAPP (Buggy Web Application) is an intentionally insecure web application designed for educational and training purposes. It was created to provide security professionals, developers, and students with practical experience in the field of web application security. bWAPP contains a variety of security vulnerabilities and weaknesses, allowing users to practice and understand various attack techniques. == Requirements == * Operating system: KaliLinux or B..."

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-10T18:08:32Z

ATomic:

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: [https://wiki.elvis.science/index.php?title=Raspberry_Pi_3,_Model_B%2B,_WLAN,_BT Raspberry Pi 3 (with an microSD card)] ,[https://store.google.com/de/product/nest_hub_2nd_gen?hl=de&pli=1 Google Nest Hub (2.Gen)],[https://www.tp-link.com/de/home-networking/smart-bulb/lb110/ TP-Link LB 110 smart bulb]

== Project Process ==

=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and was launched in the winter of 2022. So not a lot of devices still support Webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol called thread build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the Webthings Gateway using a Raspberry Pi 3. The first batch of devices consisted of a Tradfri Zigbee lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via Wi-Fi and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there exists an add-on for Webthings to support Zigbee, we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like Google, Apple or Samsung. That meant we had to get devices of those big players as a gateway. We decided on the Google Nest Hub. If we wanted to connect something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on Wi-Fi devices.

===Third Phase===
We then found devices that supposedly should work with Matter as well as Webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option in the little remaining time.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. The TP-Link LB110. We were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the Webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyze for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

=== Conclusion ===
Unfortunately because ot the circumstances we were not able to get the wanted results. Our goal was to find smart things that could be included in both protocols. This is not feasible until today & in the end it turned out that our TP-Link light bulb does not support Thread or Matter. We researched and came to the conclusion that Smart Things only support either Thread/Matter or the common protocols like Zigbee/Wi-Fi/Z-Wave and not both.

In the end, it turned out that we could only add Smart Things that supported Wi-Fi to the WebThings gateway. A Zigbee dongle for support & a suitable add-on didn't help. Matter didn't have a device that was also compatible with WebThings, so we couldn't make the comparison we wanted.

However considering that we are a team of IT students with some knowledge and that both protocols should unify existing smart homes within a single protocol, it is fair to say that there is at this point in time no best solution because both of them have great issues. Webthings appeals more to open source enthusiasts that want to tinker with their smart home devices whereas Matter is a more plug and play approach to the smart home ecosystem. It however lacks the customizability of its opponent.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

* We filtered the messages by source & destination addresses to clearly show the handshakes and to show the sending of application data.

* In this first picture we can see how the bulb wants to establish a TCP connection with an Amazon server for cloud-based functionality. Such smart home devices, rely on cloud services for remote control and management. After Application Data is sent between the smart bulb and the Amazon server, the bulb wants to finish the connection.

[[File:Screen1.png|800px|thumb|center|Communication from the Smart Bulb to the Amazon Server]]

* This capture shows that the amazon server answers to the SYN from the bulb with an SYN ACK and then application data is exchanged.

[[File:Screen2.png|800px|thumb|center|Communication from WebThings Cloud back to the Smart Bulb]]

* Here we can see the communication initiated by the control panel device to the Google Network, where afterwards application data is exchanged. Afterwards the connection is getting closed by the google network which can be seen in the last capture.

[[File:Screen3.png|800px|thumb|center|Communication from the Control Panel Device to the Google Network]]

* Here we can see the opposite site, where the Google Network answers with an SYN ACK and since then messages are exchanged until the google network wants to finish the session.

[[File:Screen4.png|800px|thumb|center|Communication from WebThings Cloud back to the Control Panel Device]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-07T11:38:30Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==

=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and was launched in the winter of 2022. So not a lot of devices still support Webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol called thread build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the Webthings Gateway using a Raspberry Pi 3. The first batch of devices consisted of a Tradfri Zigbee lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via Wi-Fi and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there exists an add-on for Webthings to support Zigbee, we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like Google, Apple or Samsung. That meant we had to get devices of those big players as a gateway. We decided on the Google Nest Hub. If we wanted to connect something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on Wi-Fi devices.

===Third Phase===
We then found devices that supposedly should work with Matter as well as Webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option in the little remaining time.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. The TP-Link LB110. We were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the Webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyze for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

=== Conclusion ===
Unfortunately because ot the circumstances we were not able to get the wanted results. However considering that we are a team of IT students with some knowledge and that both protocols should unify existing smart homes within a single protocol, it is fair to say that there is at this point in time no best solution because both of them have great issues. Webthings appeals more to open source enthusiasts that want to tinker with their smart home devices whereas Matter is a more plug and play approach to the smart home ecosystem. It however lacks the customizability of its opponent.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

* We filtered the messages by source & destination addresses to clearly show the handshakes and to show the sending of application data.

* In this first picture we can see how the bulb wants to establish a TCP connection with an Amazon server for cloud-based functionality. Such smart home devices, rely on cloud services for remote control and management. After Application Data is sent between the smart bulb and the Amazon server, the bulb wants to finish the connection.

[[File:Screen1.png|800px|thumb|center|Communication from the Smart Bulb to the Amazon Server]]

* This capture shows that the amazon server answers to the SYN from the bulb with an SYN ACK and then application data is exchanged.

[[File:Screen2.png|800px|thumb|center|Communication from WebThings Cloud back to the Smart Bulb]]

* Here we can see the communication initiated by the control panel device to the Google Network, where afterwards application data is exchanged. Afterwards the connection is getting closed by the google network which can be seen in the last capture.

[[File:Screen3.png|800px|thumb|center|Communication from the Control Panel Device to the Google Network]]

* Here we can see the opposite site, where the Google Network answers with an SYN ACK and since then messages are exchanged until the google network wants to finish the session.

[[File:Screen4.png|800px|thumb|center|Communication from WebThings Cloud back to the Control Panel Device]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-07T11:21:30Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==

=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the Webthings Gateway using a Raspberry Pi 3. The first batch of devices consisted of a Tradfri Zigbee lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via Wi-Fi and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there exists an add-on for Webthings to support Zigbee, we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like Google, Apple or Samsung. That meant we had to get devices of those big players as a gateway. If we wanted to connect something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on Wi-Fi devices.

===Third Phase===
We then found devices that supposedly should work with Matter as well as Webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the Webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

* We filtered the messages by source & destination addresses to clearly show the handshakes and to show the sending of application data.

* In this first picture we can see how the bulb wants to establish a TCP connection with an Amazon server for cloud-based functionality. Such smart home devices, rely on cloud services for remote control and management. After Application Data is sent between the smart bulb and the Amazon server, the bulb wants to finish the connection.

[[File:Screen1.png|800px|thumb|center|Communication from the Smart Bulb to the Amazon Server]]

* This capture shows that the amazon server answers to the SYN from the bulb with an SYN ACK and then application data is exchanged.

[[File:Screen2.png|800px|thumb|center|Communication from WebThings Cloud back to the Smart Bulb]]

* Here we can see the communication initiated by the control panel device to the Google Network, where afterwards application data is exchanged. Afterwards the connection is getting closed by the google network which can be seen in the last capture.

[[File:Screen3.png|800px|thumb|center|Communication from the Control Panel Device to the Google Network]]

* Here we can see the opposite site, where the Google Network answers with an SYN ACK and since then messages are exchanged until the google network wants to finish the session.

[[File:Screen4.png|800px|thumb|center|Communication from WebThings Cloud back to the Control Panel Device]]

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-07T11:19:38Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==

=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the Webthings Gateway using a Raspberry Pi 3. The first batch of devices consisted of a Tradfri Zigbee lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via Wi-Fi and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there exists an add-on for Webthings to support Zigbee, we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like Google, Apple or Samsung. That meant we had to get devices of those big players as a gateway. If we wanted to connect something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on Wi-Fi devices.

===Third Phase===
We then found devices that supposedly should work with Matter as well as Webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

* We filtered the messages by source & destination addresses to clearly show the handshakes and to show the sending of application data.

* In this first picture we can see how the bulb wants to establish a TCP connection with an Amazon server for cloud-based functionality. Such smart home devices, rely on cloud services for remote control and management. After Application Data is sent between the smart bulb and the Amazon server, the bulb wants to finish the connection.

[[File:Screen1.png|800px|thumb|center|Communication from the Smart Bulb to the Amazon Server]]

* This capture shows that the amazon server answers to the SYN from the bulb with an SYN ACK and then application data is exchanged.

[[File:Screen2.png|800px|thumb|center|Communication from WebThings Cloud back to the Smart Bulb]]

* Here we can see the communication initiated by the control panel device to the Google Network, where afterwards application data is exchanged. Afterwards the connection is getting closed by the google network which can be seen in the last capture.

[[File:Screen3.png|800px|thumb|center|Communication from the Control Panel Device to the Google Network]]

* Here we can see the opposite site, where the Google Network answers with an SYN ACK and since then messages are exchanged until the google network wants to finish the session.

[[File:Screen4.png|800px|thumb|center|Communication from WebThings Cloud back to the Control Panel Device]]

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T13:32:00Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==

=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

* We filtered the messages by source & destination addresses to clearly show the handshakes and to show the sending of application data.

* In this first picture we can see how the bulb wants to establish a TCP connection with an Amazon server for cloud-based functionality. Such smart home devices, rely on cloud services for remote control and management. After Application Data is sent between the smart bulb and the Amazon server, the bulb wants to finish the connection.

[[File:Screen1.png|800px|thumb|center|Communication from the Smart Bulb to the Amazon Server]]

* This capture shows that the amazon server answers to the SYN from the bulb with an SYN ACK and then application data is exchanged.

[[File:Screen2.png|800px|thumb|center|Communication from WebThings Cloud back to the Smart Bulb]]

* Here we can see the communication initiated by the control panel device to the Google Network, where afterwards application data is exchanged. Afterwards the connection is getting closed by the google network which can be seen in the last capture.

[[File:Screen3.png|800px|thumb|center|Communication from the Control Panel Device to the Google Network]]

* Here we can see the opposite site, where the Google Network answers with an SYN ACK and since then messages are exchanged until the google network wants to finish the session.

[[File:Screen4.png|800px|thumb|center|Communication from WebThings Cloud back to the Control Panel Device]]

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T13:30:57Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==

=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

* We filtered the messages by source & destination addresses to clearly show the handshakes and to show the sending of application data.

* In this first picture we can see how the bulb wants to establish a TCP connection with an Amazon server for cloud-based functionality. Such smart home devices, rely on cloud services for remote control and management. After Application Data is sent between the smart bulb and the Amazon server, the bulb wants to finish the connection.

[[File:Screen1.png|800px|thumb|center|Communication from the Smart Bulb to the Amazon Server]]

* This capture shows that the amazon server answers to the SYN from the bulb with an SYN ACK and then application data is exchanged.

[[File:Screen2.png|800px|thumb|center|Communication from WebThings Cloud back to the Smart Bulb]]

* Here we can see the communication initiated by the control panel device to the Google Network, where afterwards application data is exchanged. Afterwards the connection is getting closed by the google network which can be seen in the last capture.

[[File:Screen3.png|800px|thumb|center|Communication from the Control Panel Device to the Google Network]]

* Here we can see the opposite site, where the Google Network answers with an SYN ACK and since then messages are exchanged until the google network wants to finish the session.

[[File:Screen4.png|800px|thumb|center|Communication from WebThings Cloud back to the Control Panel Device]]

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T13:17:00Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==

=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

* We filtered the messages by source & destination addresses to clearly show the handshakes and to show the sending of application data.

* In this first picture we can see how the bulb wants to establish a TCP connection with an Amazon server for cloud-based functionality. Such smart home devices, rely on cloud services for remote control and management. After Application Data is sent between the smart bulb and the Amazon server, the bulb wants to finish the connection.

[[File:Screen1.png|800px|thumb|center|Communication from the Smart Bulb to the Amazon Server]]

* This capture shows that the amazon server answers to the SYN from the bulb with an SYN ACK and then application data is exchanged.

[[File:Screen2.png|800px|thumb|center|Communication from WebThings Cloud back to the Smart Bulb]]

* Here we can see the communication initiated by the control panel device to the Google Network, where afterwards application data is exchanged. Afterwards the connection is getting closed by the google network which can be seen in the last capture.

[[File:Screen3.png|800px|thumb|center|Communication from the Control Panel Device to the Google Network]]

* Here we can see the opposite site, where the Google Network answers with an SYN ACK and since then messages are exchanged until the google network wants to finish the session.

[[File:Screen4.png|800px|thumb|center|Communication from WebThings Cloud back to the Control Panel Device]]

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T12:55:13Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==

=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

*

[[File:Screen1.png|800px|thumb|center|Communication from the Smart Bulb to the WebThings Cloud]]

[[File:Screen2.png|800px|thumb|center|Communication from WebThings Cloud back to the Smart Bulb]]

[[File:Screen3.png|800px|thumb|center|Communication from the Control Panel Device to the WebThings Cloud]]

[[File:Screen4.png|800px|thumb|center|Communication from WebThings Cloud back to the Control Panel Device]]

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T12:50:33Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==

=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

[[File:Screen1.png|800px|thumb|center|Communication from the Smart Bulb to the WebThings]]

[[File:Screen2.png|800px|thumb|center|Communication from WebThings Cloud back to the Smart Bulb]]

[[File:Screen3.png|800px|thumb|center|Communication from the Control Panel Device to the WebThings Cloud]]

[[File:Screen4.png|800px|thumb|center|Communication from WebThings Cloud back to the Control Panel Device]]

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T12:50:10Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==

=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

[[File:Screen1.png|800px|thumb|center|Communication from the Smart Bulb to the WebThings]]

[[File:Screen2.png|800px|thumb|center|Communication from WebThings Cloud back to the Smart Bulb]]

[[File:Screen3.png|800px|thumb|center|Communication from the Control Panel Device to the WebThings Cloud]]

[[File:Screen4.png|800px|thumb|center|Communication from WebThings Cloud back to the Control Panel Device]]

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T12:49:45Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==

=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

[[File:Screen1.png|700px|thumb|center|Communication from the Smart Bulb to the WebThings]]

[[File:Screen2.png|700px|thumb|center|Communication from WebThings Cloud back to the Smart Bulb]]

[[File:Screen3.png|700px|thumb|center|Communication from the Control Panel Device to the WebThings Cloud]]

[[File:Screen4.png|700px|thumb|center|Communication from WebThings Cloud back to the Control Panel Device]]

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T12:49:20Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==

=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

[[File:Screen1.png|500px|thumb|center|Communication from the Smart Bulb to the WebThings]]

[[File:Screen2.png|500px|thumb|center|Communication from WebThings Cloud back to the Smart Bulb]]

[[File:Screen3.png|500px|thumb|center|Communication from the Control Panel Device to the WebThings Cloud]]

[[File:Screen4.png|500px|thumb|center|Communication from WebThings Cloud back to the Control Panel Device]]

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T12:48:13Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==

=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

[[File:Screen1.png.png|500px|thumb|center|Communication from the Smart Bulb to the WebThings Cloud]

[[File:Screen2.png|500px|thumb|center|Communication from WebThings Cloud back to the Smart Bulb]

[[File:Screen3.png|500px|thumb|center|Communication from the Control Panel Device to the WebThings Cloud]

[[File:Screen4.png|500px|thumb|center|Communication from WebThings Cloud back to the Control Panel Device]

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T12:47:29Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==

=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

[[File:Screen1.png|500px|thumb|center|Communication from the Smart Bulb to the WebThings Cloud]

[[File:Screen2.png|500px|thumb|center|Communication from WebThings Cloud back to the Smart Bulb]

[[File:Screen3.png|500px|thumb|center|Communication from the Control Panel Device to the WebThings Cloud]

[[File:Screen4.png|500px|thumb|center|Communication from WebThings Cloud back to the Control Panel Device]

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

File:Screen4.png

2023-07-06T12:46:31Z

ATomic:

File:Screen3.png

2023-07-06T12:39:28Z

ATomic:

File:Screen2.png

2023-07-06T12:38:08Z

ATomic:

File:Screen1.png

2023-07-06T12:36:35Z

ATomic:

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T12:02:21Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==

=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T11:59:58Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==

=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T11:58:48Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==
=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T11:58:08Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==
=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T11:57:19Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==
=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T11:56:43Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==
=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

* Control Panel device: 192.168.137.193 /24
* TP-Link Smart Bulb: 192.168.137.92 /24
* WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T11:56:22Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==
=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

Control Panel device: 192.168.137.193 /24
TP-Link Smart Bulb: 192.168.137.92 /24
WebThings Gateway: 192.168.137.219 /24

==== The Captures ====

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T11:53:11Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==
=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

We also tried to sniff the traffic between the Control Panel device, the Smart Bulb & the WebThings Gateway, so we can analyze how the way of communication looks like. Actually we wanted to compare the packet sizes with the packets of Matter, but since this did not work, we simply analyzed them.

====IP-Table====

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T11:46:27Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==
=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

===Wireshark Captures===

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]

WebThings vs. Matter: A Comparative Protocol Analysis

2023-07-06T11:45:35Z

ATomic:

== Summary ==

This documentation compares the two latest IoT-Unify protocols for smart homes: Matter & WebThings. The response time, the data rates & the features of the two protocols will be compared.

== Requirements ==

* Operating system: WebThingsOS
* Packages: Webthings TP Link Kasa Add On
* Hardware: Raspberry Pi 3 (with an microSD card), Google Nest Hub (2.Gen), TP-Link LB 110 smart bulb

== Project Process ==
=== Overview ===
At first, we did a lot of research regarding the hardware. Our intention was to create a Smart Home Scenario using Webthings and Matter respectively. We soon realized that it wouldn't be that easy to find hardware that is supported by both protocols. The reason for this is, that the development of Webthings has been discontinued in 2020 and is now only supported through open source. Matter on the other hand is brand new and launched in the winter of 2022. So not a lot of devices still support webthings and not a lot of devices are already compatible with Matter. Especially because Matter utilizes a new protocol build on the same stack as Zigbee using IEEE 802.15.4.

=== First Phase ===
Our first attempt was to set up the webthings gateway using a Raspi3. The first batch of devices consisted of a Tradfri Zigbee Lamp and an Amazon Echo Dot. We tried to connect to the Amazon Echo Dot via WIFI and failed because of compatability issues. The Tradfri bulb also yielded no better results. Although there is an add on for Webthings to support Zigbee we could not find/connect the smart bulb.

===Second Phase/Matter===
After a lot of reasearch we felt confident to try out the matter protocol. We found out that there is no such thing as an open source matter gateway but that it is build into the devices of big tech companies like google, apple or samsung. That meant we had to get a devices of those big players as a gateway. If we wanted to connect to something using Zigbee with Matter we would have had to get another supported Gateway supporting the Zigbee Protocol. All of that made us reconsider testing Zigbee altogether and we decided that we would rather focus on wifi devices.

===Third Phase===
We then found devices that supposedly should work with matter as well as webthings. All our cards were on the EVE devices. The Smart Plug, Motion Sensor and Window Intrusion Sensor. But that also didn't work out. The problem was that, altough all of those devices support both protocols, from the factory they are only usable via the Apple HomePod. In Order to get them to work with other devices you first need to update the Firmware using an Apple HomePod. So that was also not an option.

===Fourth Phase===
We finally found a device that worked with both Smart Home Protocols. Namely the TP-Link LB110 we were reliefed to say the least. Finally we could start testing to find out the differences between the two protocols. But thats when things started to get a little bit weird. Our idea was to use a laptop as the router/gateway in order to sniff the packets being sent via wireshark. We used the Hotspot function of Windows. No problem there with the webthings gateway. But as soon as we connected the bulb and the Google Nest Hub the Hotspot lost its connection to the internet. Because of that the bulb and the Nest Hub, which both need a connection to the internet did not work anymore. Also when removed from the network the connection did not come back. We tried it on 2 different laptops and both now do not have functioning hotspots anymore.

=== Fifth Phase ===
So there aren't any captures we can analyzed for Matter. Also we are not quite sure if the Nest Hub even utilizes the Matter Protocol when not using Thread.

== Description ==

=== WebThings ===

* Install the latest gateway Image [https://webthings.io/gateway/'''latest gateway Image'''] from WebThings. Flash the downloaded Image on the microSD card using [https://etcher.balena.io '''Etcher'''] for example.
* Boot your Raspberry Pi. After booting up the gateway, it will create an Wi-Fi hotspot with the name "WebThings Gateway XXXX". Use an personal computer to connect to the network.

[[File:wifi_ssid.png|500px|thumb|center|Connection of local device to the gateway]]

* After establishing a connection to the gateway, a page will appear which shows nearby WiFi networks. Connect to your home network.

[[File:connect_wifi.png|500px|thumb|center|Connection of gateway to local network]]

* Now you should be able to access the gateways UI via http://192.168.2.1 or http://gateway.local .
* After navigating to the local gateway page, you will be given the option to register a free subdomain

[[File:choose_subdomain.png|500px|thumb|center|Register Subdomain]]

* You will be led to an Page to create an user account

[[File:create_user_account.png|500px|thumb|center|Create user account]]

* After all the steps you will be redirected to an empty "Things" screen of the gateway where you can start to add devices.

[[File:things_screen.png|500px|thumb|center|List of all available devices]]

* When clicking on the "+" the WebThings Gateway will search for Smart Things that are in the same WLAN network and nearby. Here the bulb was immediately detected and so we added it to our WebThings network.

[[File:Screenshot_(3).png|500px|thumb|center|Connecting with the TP-Link bulb]]

* Here we can see that we added the bulb successfully to our network. That's the overview page of all Smart Things that are implemented. If we want to control a Smart Thing we need to click on it.

[[File:Screenshot_(4).png|500px|thumb|center|Overview page of all included Smart Things]]

* After we clicked on the bulb, we get options to change the brightness of the bulb, turn it on or off & view the power consumption.

[[File:Screenshot_(5).png|500px|thumb|center|Control panel of the bulb]]

== Matter ==

Make sure to read

* War and Peace
* Lord of the Rings
* The Baroque Cycle

== Used Hardware ==

[[Device to be used with this documentation]]
[[Maybe another device to be used with this documentation]]

== References ==

* https://github.com/WebThingsIO/tplink-adapter
* https://matter-smarthome.de/en/overview-products-compatible-with-matter/
* https://github.com/WebThingsIO/wiki/wiki/Supported-Hardware
* https://webthings.io/docs/gateway-getting-started-guide.html

[[Category:Documentation]]