/      日本語

Input to the PAL App (Notification PAL) (Parent and Repeater App)

Commands to control the LED of the Notification PAL
You can control the LED of the Notification PAL.
:0190010004000169[CR][LF]
 ^1^2^3^^^^^^^4^5
No.BytesMeaningExample DataNotes
11Destination Logical Device ID01

Specify the logical device ID of the destination TWELITE PAL.
Valid values range from 0x01 to 0x64.

21Command Type90
31Number of Command Parameters01Specify the number of command parameters. For example, set to 1 if specifying one command parameter, or 2 if specifying two.
4Number of Commands x 4Command Parameters00040001

Specify parameters such as events and LED colors.
See the command parameters section for details.

51Checksum69

Calculate the sum of bytes 1 to 4 within 8 bits and take the two’s complement. In other words, the sum of all data bytes plus the checksum byte equals zero within 8 bits.
The checksum byte is represented by two ASCII characters.
For example, in 00A01301FF123456, the sum 0x00 + 0xA0 + … + 0x56 = 0x4F, and its two’s complement is 0xB1 (i.e., 0x4F + 0xB1 = 0).
The checksum can be omitted by using ‘X’ as the checksum.

62Footer[CR][LF]Specify [CR] (0x0D) [LF] (0x0A). However, if the checksum is omitted with ‘X’, the footer can also be omitted.

Command Parameters

Combine 4-byte command parameters to specify commands.

0x00: Send Event ID

The TWELITE PAL has predefined behaviors for each received event ID. This parameter sends an event ID to the destination TWELITE PAL to trigger the configured behavior.

No.BytesContentNotes
11Command Parameter ID0x00
21Destination PAL ID

Specify the destination PAL ID.
0x04: Notification PAL
0xFF: All TWELITE PALs

31UnusedFixed at 0x00
41Event IDSpecify event ID from 0 to 16

0x01: Send LED Color, Blinking Pattern, and Brightness

Send the LED color, blinking pattern, and brightness to the destination Notification PAL.

No.BytesContentNotes
11Command Parameter ID0x01
21Color

0: Red
1: Green
2: Blue
3: Yellow
4: Purple
5: Cyan
6: White
7: Warm White

31Blinking Pattern

0: Always on
1-3: Blinking patterns (higher value means faster blinking)

41Brightness

0: Off
0x01–0x0F: Brightness (higher value means brighter)

0x02: Send Lighting Duration

Send the lighting duration of the Notification PAL’s LED.

No.BytesContentNotes
11Command Parameter ID0x02
21UnusedFixed at 0xFF
31UnusedFixed at 0x00
41Lighting DurationSpecified in seconds (0 means always on)

0x03: Specify LED Color in RGBW

Send the LED lighting color of the Notification PAL in RGBW.

No.BytesContentNotes
11Command Parameter ID0x03
21UnusedFixed at 0xFF
32LED Lighting Color

Specify 4 bits each for RGBW in order from LSB.

Higher value means brighter.

0x04: Specify Blinking Parameters

Send the blinking cycle and duty of the Notification PAL’s LED.

No.BytesContentNotes
11Command Parameter ID0x04
21UnusedFixed at 0xFF
31Blinking Time Ratio

Specify from 0x00 to 0xFF.

Higher value means longer ON time per cycle.

0x7F means ON for half of the cycle.

41Blinking Cycle

Specify from 0x00 to 0xFF.

Each increment increases the blinking cycle by about 0.04s.

0x17 corresponds to a 1-second cycle.

Command Examples

Example 1: Send Event

Command example to send event 1 to the NOTICE PAL with logical device ID 1.

:0190010004000169
 ^1^2^3^4^5^6^7^8
No.BytesMeaningExample DataExplanation of Example DataNotes
11Destination Logical Device ID01Logical device ID of the destination is 0x01
21Command Type900x90 commandFixed at 90
31Number of Commands01One command
41Command ID00Command 00
51Destination PAL ID04Sent to Notification PAL
61Unused00
71Event ID01Event 10x00 to 0x10
81Checksum69

Example 2: Send LED Lighting Color to Notification PAL

Command to send LED lighting color with brightness 8 and slow blinking white to the NOTICE PAL with logical device ID 1.

:019001010601085E
 ^1^2^3^4^5^6^7^8
No.BytesMeaningExample DataExplanation of Example DataNotes
11Destination Logical Device ID01Logical device ID of the destination is 0x01
21Command Type900x90 commandFixed at 90
31Number of Commands01One command
41Command Parameter ID01Command parameter ID 0x01
51Color06White
61Blinking Pattern01Blinking
71Brightness08Brightness 8Range 0x00 to 0x0F
81Checksum5E

Example 3: Send LED Lighting Color and Lighting Duration to Notification PAL

Command to light up purple and turn off after 1 second for the NOTICE PAL with logical device ID 1.

:0190020104000802FF00015E
 ^1^2^3^4^5^6^7^8^9^a^b^c
No.BytesMeaningExample DataExplanation of Example DataNotes
11Destination Logical Device ID01Logical device ID of the destination is 0x01
21Command Type900x90 commandFixed at 90
31Number of Commands02Two commands
41Command Parameter ID01Command parameter ID 0x01
51Color04Purple
61Blinking Pattern00Always on
71Brightness08Brightness 8Range 0x00 to 0x0F
81Command Parameter ID02Command parameter ID 0x02
91UnusedFF
a1Unused00
b1Lighting Duration01Turns off after 1 second
c1Checksum5E

Example 4: Send Detailed Lighting Color to Notification PAL

Command to light up purple for the NOTICE PAL with logical device ID 1.

:01900103FF0F0459
 ^1^2^3^4^5^^^6^7
No.BytesMeaningExample DataExplanation of Example DataNotes
11Destination Logical Device ID01Logical device ID of the destination is 0x01
21Command Type900x90 commandFixed at 90
31Number of Commands01One command
41Command Parameter ID03Command parameter ID 0x03
51UnusedFF
62LED Lighting Color0F04Lights blue at 15 and red at 4 brightness

Specify 4 bits each for RGBW in order from LSB (0–15).

Higher value means brighter.

71Checksum59

Example 5: Send LED Lighting Color and Lighting Duration to Notification PAL

Command to light up purple and turn off after 1 second for the NOTICE PAL with logical device ID 1.

:0190020104000802FF00015E
 ^1^2^3^4^5^6^7^8^9^a^b^c
No.BytesMeaningExample DataExplanation of Example DataNotes
11Destination Logical Device ID01Logical device ID of the destination is 0x01
21Command Type900x90 commandFixed at 90
31Number of Commands02Two commands
41Command Parameter ID01Command parameter ID 0x01
51Color04Purple
61Blinking Pattern00Always on
71Brightness08Brightness 8Range 0x00 to 0x0F
81Command Parameter ID02Command parameter ID 0x02
91UnusedFF
a1Unused00
b1Lighting Duration01Turns off after 1 second
c1Checksum5E