|====================================|
| ArtiADOPT Protocol Version 1.03    |
| Written by: Michel van Osenbruggen |
| CopyRight 2026 ArtiLED B.V.        |
|====================================|

Latest change                          : 19-02-2026

--------------------
| ArtiADOPT start |
--------------------

> Telnet 'IP Address' 1092
> Token 'Token' -> Authenticate (token is case sensitive)

!Note commands are case insensitive.

------------------
| ArtiADOPT end |
------------------

> Return -> Empty line ends session

|============================|
| Protocol Answer Formatting |
|============================|

-1 = TimeOut                           : No Answer -> Check Realtime Mode
 0 = Error                             : Error is just 0 -> See debug for Error
 1 = Success                           : Success is just 1

|=============|
| Error Codes |
|=============|

1                                      : Command Invalid
2                                      : Channel Invalid
3                                      : Color Invalid
4                                      : Data Invalid
5                                      : Command Failed
7                                      : Power Overload Error
8                                      : Temperature Overload Error (External via Node)
9                                      : Authentication Failed

|===================|
| Command Structure |
|===================|

> Command                              : Command + Data
# Privileged Command                   : Command + Data (requires admin rights)
* Sub Command                          : Sub Command, Values, Effects, Palettes etc.
! Future Command                       : Command not done yet, coming soon

|=============================================================|
| COMMANDS BELOW ARE FOR INSTALLERS ONLY. USE AT OWN RISK!    |
|=============================================================|

|-----------------------|
| Hub Adoption Commands |
|-----------------------|

> Adopt Node                            : Ident -> Adopts the Node on the Hub (only works when coming from Hub IP address and Hub is detected first via ArtiDISCOVERY)
> Orphan Node                           : Ident -> Removes the Node from the Hub (only works when request is coming from Hub IP address)