ioBroker.artnetdmx

Tests:

artnetdmx adapter for ioBroker

With this adapter you can control DMX lights via an ARTNET node.
It was created to allow easy handling of dimmable, tunable white, rgb, rgbw, or rgbtw lights.
Each channel on the light device can be configured, even fade times can be set per device and you can override the device fade times and set light values directly via the 'valuesObject' state which is present on each light device

Art-Net™ Designed by and Copyright Artistic Licence Holdings Ltd"

Getting started

• Set the artnet settings in the adapter to connect to a ARTNET node device

  • Connection settings

    Field	Description
    Node IP	The ip of your artnet node (artnet to dmx)
    Port	The port of the artnet node default: 6454
    Local IPv4 network interface	The interface which should be used for network connection

  • Artnet/DMX Settings

    Field	Description
    Universe	the dmx universe which should be talked to default: 0
    Net	the dmx net which should be talked to default: 0
    Subnet	the dmx subnet which should be talked to default: 0
    Frames [per sec]	The FPS with which the dmx values are updated default (maxium fps): 44 This rate only applies if there are value changes pending, otherwise the values are beeing refreshed periodically with the Refresh period [ms] period
    Refresh period [ms]	The period where all dmx values are beeing sent in a bulk, even if there is no value change on a channel This is needed because there are artnet nodes wich do rely on refreshing the whole dmx channel values every x seconds
    Default fade time [ms]	The default fadeing time which is used when setting a channel value

• Define devices in the adapter settings
  In the device page of the admin gui you can add, change or delete devices. Changes in this list will be mirrored in the object tree. So if you delete a device here, it's corresponding states will be removed from the object tree. (on saving the state/restarting the adapter)

  • Device settings

    Field	Description
    Name	The name of the device
    Id	The id of the device The id will be autogenerated after you filled in a name and it was empty before, but it can be changed manually ATTENTION! Changeing an id will result in deleting and recreating the device in the iobroker object tree
    Type	The type of the device. Choosing a type will enable/disable channel selections acording to the type of the device
    Ch. main	The channel number (warmwhite)
    Ch. white	The channel number for white (coldwhite)
    Ch. red	The channel number for red
    Ch. green	The channel number for green
    Ch. blue	The channel number for blue
    Fade time	The fade time which is beeing used when changing the values of the channels to their new values default: -1 If default value is used (-1) the fade time defined on the settings page will be used

Changelog

WORK IN PROGRESS

• (ChriD) lowerd cpu load of adapter by stopping the buffer update when no buffer actions are pending

1.0.5 (2023-02-07)

• (ChriD) fixed problem that on adapter (re)start the artnet buffer was not consideering the on/off and brightness value

1.0.4 (2023-01-24)

• (ChriD) Umlauts in id's are now beeing converted instead of being removed
• (ChriD) Added Save/Load configuration buttons

1.0.3 (2023-01-08)

• (ChriD) Standard channel values when creating a new device will be set to 255 instead of 0
• (ChriD) valuesObject may now be a real object instead a parsable json string

1.0.2 (2022-12-30)

• (ChriD) updated readme
• (ChriD) fixed on/off problem which raised du to code rework
• (ChriD) fixed problem that on adapter (re)start the artnet buffer was not correct

1.0.1 (2022-12-20)

• (ChriD) changed some log levels
• (ChriD) fixed some unecessary double state ACK
• (ChriD) fixed triggering state change event on "unchanged" states

1.0.0 (2022-12-12)

• (ChriD) initial version

License

MIT License

Copyright (c) 2023 ChriD [e-mail]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.