DyNet Text Messaging

When the Comm Port 2 > Port Type is set to DyNet Text Gateway, the DDNG232 routes messages between Port 1 (DyNet 1) and Port 2 (human-readable text strings). When it receives a correctly formatted command on Port 2 from a connected third-party system, it sends a message on Port 1 to the Dynalite system.

The physical interface uses an 8-bit data packet with 1 start bit, 1 stop bit, and no parity. The default baud rate is 9600. DyNet Text Gateway settings are configurable using the System Builder Ports editor.

The third-party system must be configured to send and receive DyNet Text messages.
sb ddng232 ports 2 dynet text
DyNet Text Message Types
  1. Area preset

  2. Monitoring Dynalite network

  3. Area off

  4. Program to current preset

  5. Record and restore preset

  6. Reset preset

  7. Preset offset

  8. Preset status request and reply

  9. Linear channel/area control

  10. Channel level request/reply

  11. Panic/Unpanic

  12. Panel disable/enable

  13. Remote panel LED control

  14. Temperature control

  15. Help

The Start Byte

The asterisk (*) Start byte marks the start of each message. All ASCII messages are prefixed with a Start byte.

Commands

The command is the first character or keyword after the start byte asterisk. Commands are not case sensitive. There are two command types for each command, short and long.

Examples:
  • Short command: *P 10,6,2000↵

  • Long command: *Preset 10,6,2000↵

Delimiters

The delimiter is the value used between the arguments in the command and can be either a comma (0x2C) or a space (0x20). The delimiter between the command and the first argument must always be a space.

Defaults

If an argument is not specified in a command string, the gateway will use the argument from the previously transmitted message.

Notation
Command Description

[ ]

Delimits the field between the brackets. These brackets are not actually part of the message.

P

Character as a character

[0x20]

Single space character

[36]

Multiple ASCII string

Carriage return.

DyNet Text over RS-232 or RS-485 requires an asterisk as a synchronisation character. This character is optional when using Telnet.

Area Control

The Dynalite system stores the lighting levels for each preset scene in the load controllers. These can then be recalled from anywhere on the network using a single DyNet message.

Area Preset

Structure

  • *P [Preset]↵

    or

  • *P [Preset],[Area],[Fade]↵

    or

  • *Preset [Preset],[Area],[Fade]↵

Parameters

Preset

A multiple ASCII string number representing the area preset level the controllers should go to.

Area

A multiple ASCII string number representing the area the message is being sent to.

Fade

The amount of time in milliseconds the system takes to get to the new scene.

Argument Actual fade time

2000

2 seconds

10500

10.5 seconds

120000

2 minutes

Example

All lighting in Area 6 to go to Preset 10 over 2 seconds:
  • *P 10 6 2000 ↵

    or

  • *P 10,6,2000 ↵

    or

  • *Preset 10,6,2000 ↵

Monitoring Dynalite Network

The DDNG232 can translate any DyNet preset message from any device on the network into ASCII.

Structure

*[Preset], [Area], [Fade], [Join]↵

Parameters

Preset

A multiple ASCII string number representing the area preset level the controllers should go to.

Area

A multiple ASCII string number representing the area the message is being sent to.

Fade

The amount of time in milliseconds the system takes to get to the new scene.

Join

A hexadecimal value representing the join level of the target area.

Example

Area 12 go to Preset 3 over 2 seconds for all Join levels:
  • Preset 3, Area 12, Fade 2000, Join 0xff↵

Area Off

This message sends all channels in an area to 0%. It is not used often, as Preset 12 is 'all levels at 0%' by default and is more commonly used as an 'off' command. Dynalite wall panel button LEDs will follow this command, so any preset buttons for the area receiving the off command will also turn off their LEDs.

Structure

  • *O [Area]↵

    or

  • *O [Area],[Fade]↵

    or

  • *Off [Area],[Fade]↵

Parameters

Area

A multiple ASCII string number representing the area the message is being sent to.

Fade

The time (in milliseconds) the system takes to get to the new scene.

Argument Actual fade time

2000

2 seconds

10500

10.5 seconds

120000

2 minutes

Example

Turn all circuits in Area 3 off.

  • *O 3 ↵

    or

  • *O 3,2000 ↵

    or

  • *Off 3,2000 ↵

Program to Current Preset

This message makes it possible to save lighting level changes to an area and thus reconfigure presets. The lighting levels are saved over the current preset levels, so it is important to select the preset to be changed before changing any channel levels and sending the program preset message.

Once this message is sent, the target area’s current preset is permanently overwritten.

Structure

  • *PCP [Area]↵

    or

  • *ProgramCurrentPreset [Area]↵

Parameters

Area

A multiple ASCII string number representing the area the message is being sent to.

Example

Program current preset in Area 4:
  • *ProgramCurrentPreset 4↵

Save and Restore Preset

This message causes all load controllers to save the current preset for every logical channel in the area indicated by the area argument. The preset can then be recalled at any time.

Once the Save Current Preset message is used, the previously saved preset number is overwritten in the controller. By default, the saved preset is Preset 1.

Structure

  • *SP [Area]↵

    or

  • *SavePreset [Area]↵

Parameters

Area

A multiple ASCII string number representing the area the message is being sent to.

Example

Save Current Preset in Area 6:
  • *SavePreset [6]↵

Restore Preset

The 'Restore Preset' message causes all channels in the defined area to go to the saved preset level. If a preset has not been recorded previously the area will go to preset 1.

Structure

  • *RP [Area],[Fade]↵

    or

  • *RestorePreset [Area],[Fade]↵

Parameters

Area

A multiple ASCII string number representing the area the message is being sent to.

Fade

The amount of time in milliseconds the system takes to get to the new scene.

Argument Actual fade time

2000

2 seconds

10500

10.5 seconds

120000

2 minutes

Example

Restore Saved Preset in Area 33 over 10 seconds:
  • *RP 33,10000↵

    or

  • *RecallPreset 33,10000↵

Reset Preset

If any channels in an area are message, the load controllers will still remember the last preset that area was changed using a message other than a preset in. It is then possible to return an area to its last preset state using the Reset Preset message.

Users can make small changes to a lighting scene using channel level messages, but still return the area to its preset state when required.

Structure

  • *RsetP [Area],[Fade]↵

    or

  • *ResetPreset [Area],[Fade]↵

Parameters

Area

A multiple ASCII string number representing the area the message is being sent to.

Fade

The amount of time in milliseconds the system takes to get to the new scene.

Argument Actual fade time

2000

2 seconds

10500

10.5 seconds

120000

2 minutes

Example

Reset preset in area 10 over 5 seconds:
  • *RP 10,5000↵

    or

  • *ResetPreset 10,5000↵

Preset Offset

The Preset Offset message causes load controllers with channels within the specified area to change their internal offset value for each affected channel. This value is applied as an offset to any received preset message.

The received preset and the offset value are added together, and the load controller adjusts the appropriate channels to the resulting preset number. By default, the preset offset is 0 and any received preset is the absolute preset number.

This feature is used in areas that require different lighting levels at different times of day or night (e.g. bathrooms and corridors). Preset Offset messages are commonly transmitted to the network automatically by a device with a real-time clock.

Example:

A load controller receives "Area 4, Preset 1". The controller had previously received "Area 4, Preset Offset 3". The controller therefore sets the affected channels in Area 4 to Preset 4 (1+3).

Structure

  • *PO [Offset],[Area]↵

Parameters

Offset

The number of presets the area is offset by.

Area

A multiple ASCII string number representing the area the message is being sent to.

Example

Preset Offset of 15 in Area 44:
  • *PO 15,44↵

Request Current Preset

A third-party device can use the DDNG232 to interrogate the DyNet network for the current state of an area or even a specific channel within an area.

A typical use case would be providing live feedback to a third-party touchscreen to display the current preset for an area.

The same function is available for individual channel levels using Request Channel Level.

Structure

  • *RCP [Area],[Join]↵

    or

  • *RequestCurrentPreset [Area],[Fade]↵

Parameters

Area

A multiple ASCII string number representing the area the message is being sent to.

Join

A hexadecimal value representing the join level of the target area.

Example

Request Current Preset of Area 4:
  • *RCP 4↵

    or

  • *RequestCurrentPreset 4↵

Current Preset Reply

This is the response from the network to the Request Current Preset message.

Structure

  • Reply with Current Preset [Preset], Area [Area], Join [Join]↵

Parameters

Preset

A multiple ASCII string number representing the area preset level the controllers should go to.

Area

A multiple ASCII string number representing the area the message is being sent to.

Join

A hexadecimal value representing the join level of the requested area.

Example

Reply to Request Current Preset of Area 4:
  • Reply with Current Preset 2, Area 4, Join ffhex↵

Channel Control

There are several messages available to fade a single channel or all channels in an area to a defined percentage level with fade times from 0.1 seconds up to 22 minutes. It is also possible to stop the fade using a Stop Fade message.

Linear Channel/Area Control

Structure

  • *CL [Channel],[Level],[Area],[Fade]↵

    or

  • *ChannelLevel [Channel],[Level],[Area],[Fade]↵

Parameters

Channel

A multiple ASCII string number representing the logical channel number that the message is to control.

Level

The percentage level the channel is to go to (0-100 as a percentage of maximum output).

Area

A multiple ASCII string number representing the area the message is being sent to.

Fade

The amount of time in milliseconds the system takes to get to the new scene.

Argument Actual fade time

2000

2 seconds

10500

10.5 seconds

120000

2 minutes

Example

Area 2 Channel 3 Fade to 50% over 5 seconds:
  • *CL 3,50,2,5000↵

Area 2 Channel 3 Fade to 50% over 50 seconds:
  • *CL 3,50,2,50000↵

Area 2 Channel 3 Fade to 50% over 15 minutes:
  • *ChannelLevel 3,50,2,900000↵

Request Channel Level

Structure

  • *RCL [channel],[Area]↵

    or

  • *RequestChannelLevel [channel],[Area]↵

Parameters

Channel

A multiple ASCII string number representing the logical channel number that the level request is being sent to.

Area

A multiple ASCII string number representing the area the message is being sent to.

Example

Request Level of Channel 5 in Area 16:
  • *RCL 5,16↵

Channel Level Reply

This is the response from the network to the Request Channel Level message.

Structure

  • Reply with current level [channel], [Area], [Target Level], [Current level], [Join]

Parameters

Channel

A multiple ASCII string number representing the logical channel number that the message is to control.

Area

A multiple ASCII string number representing the area the message is being sent to.

Target Level

The percentage level the channel is at or fading to.

Current Level

The percentage level the channel is currently at.

Join

The join level of the channel being interrogated.

Example

Reply to area 2 channel 2 level request:
  • Reply with current level ch 2, area 2, TargLev 20%, CurrLev 20%, Join ffhex ↵

Device Control

Panic

Every area has a configurable Panic preset that can be called using the Panic message. When a control panel sees a Panic message for an area that it controls, it will lock the buttons for that area. This prevents a user from overriding the panic levels. When an Unpanic message is received the area goes back to its previous preset and the buttons on the control panels become active again.

The commissioning technician can modify the Panic preset level. The default output level for Panic is 100%.

Structure

Panic:
  • *Panic [Area] [Fade]↵

Un-Panic:
  • *UnPanic [Area] [Fade] ↵

Parameters

Area

A multiple ASCII string number representing the area the message is being sent to.

Fade

The amount of time in milliseconds the system takes to get to the new scene.

Argument Actual fade time

2000

2 seconds

10500

10.5 seconds

120000

2 minutes

Example

Select Panic Mode in Area 2, fade lighting to Panic preset over 1 second:
  • *Panic 2 1000↵

Restore normal operation in Area 2, fade lighting back to previous preset over 2 seconds:
  • *UnPanic 2 2000↵

Panel Disable/Enable

The disable and enable messages allow any buttons configured to an area to be disabled and enabled from a single DyNet message. It is possible on some control panels to set buttons to ignore these messages.

Structure

Disable Control Panels:
  • *DP [Area]↵

    or

  • *DisablePanel [Area]↵

Enable Control Panels:
  • *EP [Area]↵

    or

  • *EnablePanel [Area]↵

Example

Lock All Control Panels in Area 6:
  • *DP 6↵

Unlock All Control Panels in Area 6:
  • *EP 6↵

Remote Panel LED Control

In some circumstances it may be necessary to change the state of some or all button LEDs on a remote panel. To do this a DyNet message is sent to the remote panel containing the new LED illumination configuration. It is possible to change the state of specified button LEDs while leaving others in their current state.

Structure

Turn LEDs on:
  • *SetL [Device code],[box number],[led numbers] ↵

Turn LEDs off:
  • *ClrL [Device code],[box number],[led numbers] ↵

Parameters

Device Code

This indicates the device type of the panel the message was transmitted from.

Panel type Device code

Antumbra2

0xFD

Box Number

The unique address (for a specified Device Code) of the target device. Each panel has a unique box number. This ID can be provided by the Dynalite commissioning technician.

LED Number

Indicates the button LEDs the message is targeted at. Each button location has a number on the panel’s PCB. On a 5 button LSP panel the buttons are numbered 1-5. On a 7 button LSP panel the buttons are numbered 1-5, 7 and 9 as buttons 6 and 7 are located over positions 7 and 9 on the panels PCB.

Example

Turn Off LEDs 1,3,4 and turn on LED 2 on an 8 series Universal Panel, Box 2:
  • *ClrL 0xa7,2,1,3,4↵

  • *SetL 0xa7,2,2↵

Temperature Control

Commands exist to send and receive temperature control messages. Five logical commands are available, three send messages and two request messages.

Structure

Send Set Temperature Setpoint message:
  • *STmpSP [Temperature],[Area],[Join Level]↵

Send Temperature Setpoint value message:
  • *TmpSP [Temperature],[Area],[Join Level]↵

Send Request Temperature Setpoint message:
  • *RTmpSP [Area],[Join Level]↵

Send Temperature Value message:
  • *Tmp [Temperature],[Area],[Join Level]↵

Send Request Temperature message:
  • *RTmp [Area],[Join Level]↵

Parameters

Temperature

Temperature in degrees Celsius. It can be a floating-point number, e.g. 23.5°C.

Area

A multiple ASCII string number representing the area the message is being sent to.

Join

A hexadecimal value representing the join level of the target area.

Example

Request temperature setpoint in Area 4:
  • *RTmpSP 4,ffhex↵

Help

This message requests the Help function in the DDNG232 from HyperTerminal. The DDNG232 replies with details on all codes, or the specified code if one is given.

Structure

  • *?↵

    or

  • *[command]?↵

Parameters

Command

Specifies a command to provide information on.

Example

To find out the details for a preset message:
  • *Preset?↵