InfernoEmbedded

Addressing

       All 1-wire devices are factory assigned a unique 64-bit address. This address is of the form:

       FamilyCode
              8 bits

       Address
              48 bits

       CRC    8 bits

       Addressing under OWFS is in hexadecimal, of form:

              01.123456789ABC

       where 01 is an example 8-bit family code, and 12345678ABC is an example 48 bit address.

       The dot is optional, and the CRC code can included. If included, it must be correct.

Author

       Alastair D'Silva (alastair@d-silva.org)

OWFS Manpage                                          2018                                    InfernoEmbedded(3)

Availability

       https://github.com/InfernoEmbedded/onewire-softdevice

Family Code

ED

Firmware Updater Properties

       These properties are available when the device has entered firmware update mode.

   firmware_bootloader_sizeread-only,integer
       The reserved size for the bootloader.

   firmware_rangeread-only,asciitext
       The range of addresses available for the application (0xNNNN-0xNNNN).

   erase_firmwarewrite-only,yes-no
       Write anything to erase the current application and prepare the device to accept a new firmware.

   update_firmwarewrite-only,binarydata
       Write the binary data for a firmware update here to reprogram the device after erasing.

   exit_firmware_updatewrite-only,yes-no
       Write anything to exit firmware update and start the application.

Generic Properties

       These properties are applicable to all Inferno Embedded softdevices.

   deviceread-only,asciitext
       The type of InfernoEmbedded Softdevice detected.

   versionread-only,integer
       The version number reported by the device.

   statusread-only,integer
       The 64 bit status register of the device.

   enter_firmware_updatewrite-only,yes-no
       Write anything to reboot the device into the bootloader for firmware update. This may also be  forced  if
       you  have  physical  access  to the device by shorting SWCLK to ground on the device's programming header
       when powering up the device.

Name

InfernoEmbedded
              - InfernoEmbedded Softdevices: RGBW Controllers, Switch Masters, Firmware Updater

Rgbw Controller Properties

       These controllers control a number of channels of RGBW lights.

   rgbw_all_offwrite-only,yes-no
       Write anything to turn off all channels

   rgbw_channelsread-only,integer
       The number of RGBW channels supported by this device.

   rgbw_channelNNread-write,asciitext
       Set the current value of channel NN, as: RRR,GGG,BBB,WWW,nnn  where:
         RRR,GGG,BBB,WWW is the red, green, blue values respectively (0-255)
         nnn is the time to fade from the current colour to the new one, in milliseconds (0-16M). On read,  this
       is time remaining for the current fade to complete.

Switch Masters

These devices have a number of indicator LEDs, switch inputs and relay outputs. Each are grouped into
ports of a certain number of channels.

switch_portsread-only,integer
The number of switch ports available.

switch_channelsread-only,integer
The number of channels available per switch port.

switch_refresh_activationswrite-only,yes-no
Write anything here to update the values of all switch ports from the device.

switch_portNread-only,asciitext
The last fetched state for the port (use switch_refresh_activations to fetch the state). Formatted as
"channel0,channel1...channelN", where each channel is '0' or '1' depending on whether it is activated.

set_switch_typewrite-only,asciitext
Sets the type of switch connected to the device. Format "port,channel,type" where port and channel are
integer IDs, and type is:
0 Toggle switch to VCC with pull-downs enabled on the device
1 Toggle switch to Gnd with pull-ups enabled on the device
2 Momentary switch to VCC with pull-downs enabled on the device
3 Momentary switch to Gnd with pull-ups enabled on the device

led_portsread-only,integer
The number of LED ports available.

led_channelsread-only,integer
The number of channels available per LED port.

led_portNread-write,asciitext
The state for the port. Formatted as "channel0,channel1...channelN", where each channel is '0' or '1'
depending on whether the LED is lit.

relay_portsread-only,integer
The number of relay ports available.

relay_channelsread-only,integer
The number of channels available per relay port.

relay_portNread-write,asciitext
The state for the port. Formatted as "channel0,channel1...channelN", where each channel is '0' or '1'
depending on whether the relay is activated.

relay_modeNread-write,asciitext
The mode for each relay on the port. Formatted as "channel0,channel1...channelN", where each channel is
one of the following modes:
0 Channel operates independently
1 Channel operates as a member of an even/odd pair
If the channels are operated as pairs, the even numbered relay is activated when the even numbered
channel is turned on, and the odd numbered relay is activated when the even numbered channel is turned
off. The odd numbered channel has no effect. This is useful when controlling devices such as roller
shutters, projector screens and air conditioning dampers, which require one relay to be activated to
open, and another to close.

relay_timeoutNread-write,asciitext
The timeout for each relay on the port. Formatted as "channel0,channel1...channelN", where each channel
is an integer (0-255) representing the number of seconds the relay will remain activated when operating
as an even/odd pair.

Synopsis

       Software-implemented devices based on https://github.com/InfernoEmbedded/onewire-softdevice

       ED  [.]XXXXXXXXXXXX[XX][/[  device  |  version  |  status | enter_firmware_update | address | crc8 | id |
       locator | r_address | r_id | r_locator | type ]]