Pal App Manual

• 1: Pal App Manual
• 1.1: Interactive Mode (Pal App)

1 - Pal App Manual

Installation

To write the Pal App (App_PAL), install TWELITE STAGE SDK and rewrite using the TWELITE STAGE App.

Supported Hardware

• TWELITE BLUE / RED PAL with Open/Close Sensor Pal attached
• TWELITE BLUE / RED PAL with Environmental Sensor Pal attached
• TWELITE BLUE / RED PAL with Motion Sensor Pal attached
• TWELITE BLUE / RED PAL with Notification Pal attached

1.1 - Interactive Mode (Pal App)

This section explains features specific to the Pal app (App_PAL). For common features, please refer to the TWELITE APPS Manual main page.

Example Display

The screen will display as follows.

--- CONFIG/App_PAL V1-05-2/SID=0x810e0e23/LID=0x01 ---
 a: set Application ID (0x67726305)
 i: set Device ID (--)
 c: set Channels (15)
 x: set Tx Power (13)
 b: set UART baud (38400)
 B: set UART option (8N1)
 k: set Enc Key (0xA5A5A5A5)
 o: set Option Bits (0x00000001)
 t: set Transmission Interval (60)
 p: set Sensor Parameter (0x00000000)
 e: set Event Parameter(s) (0180002A0208002A0300802A0488002A0580802A0608802A0880000A1008000A)
 d: set Temperature Coefficient (0)
 D: set Temperature Offset (0)
 f: set Humidity Coefficient (0)
 F: set Humidity Offset (0)
---
 S: save Configuration
 R: reset to Defaults

Commands

Details of each command are as follows.

a: Application ID

All devices communicating must use the same value. This logically separates networks.

i: Logical Device ID

Set when it is necessary to distinguish multiple child devices.

If there is no need or it is not possible to distinguish, set to 120. If distinction is needed, children should use any value from 1 to 100, and the parent should use 0 or 121.

c: Frequency Channel

All devices communicating must use the same value. This physically separates networks.

x: Tx Power and Retry Count

Specify the radio transmission power and the number of additional packet transmissions in transparent mode and headered transparent mode.

b: UART Alternative Baud Rate

Overrides the alternative baud rate selected when the BPS pin is connected to GND at startup.

Selectable values are 9600/19200/38400/57600/115200/230400. Specifying other values may cause errors.

B: UART Option

Overrides the alternative UART settings selected when the BPS pin is connected to GND at startup.

Parity can be set to N: None, O: Odd, or E: Even. Hardware flow control cannot be set. Settings like 8N1 or 7E2 can be used, but settings other than 8N1 are unverified. Please confirm operation in advance.

k: Encryption Key

Specify the 32-bit hexadecimal encryption key used when enabling encrypted communication in option bits.

o: Option Bits

Specify a 32-bit value. Various settings linked to each bit can be enabled.

t: Transmission Interval

Specifies the data transmission interval. For notification pals, it indicates the interval for querying control information from the parent and reflecting it on LED output.

p: Sensor-specific Parameter

Depends on the hardware.

• Open/Close Sensor Pal: None
• Environmental Sensor Pal: None
• Motion Sensor Pal
• Notification Pal

e: Notification Event

Specifies the behavior when an event number is received.

For details, see Notification Event Details.

d: Temperature Coefficient

Specify the temperature data coefficient (d) in the range 0-60000.

0 disables it. Otherwise, the final temperature is multiplied by (\frac{d}{1024}).

D: Temperature Offset

Specify the temperature data offset (D) in the range -2000 to 2000.

(D) is added to the temperature multiplied by 100. The final temperature changes by (\frac{D}{100}) °C.

f: Humidity Coefficient

Specify the humidity data coefficient (f) in the range 0-60000.

0 disables it. Otherwise, the final humidity is multiplied by (\frac{f}{1024}).

F: Humidity Offset

Specify the humidity data offset (F) in the range -2000 to 2000.

(F) is added to the humidity multiplied by 100. The final humidity changes by (\frac{F}{100}) %.

Details of Option Bits

Explanation of settings linked to each bit of the option bits value.

00000001: Enable Transmission to Repeater

Enables transmission not only to the parent but also to repeaters.

You can use repeaters even without setting this option, but the parent will remove duplicated packets. In this case, there is no way to determine which repeater the packet passed through or if it was not relayed.

If this option is set, the parent can output packets received from multiple devices separately. Devices connected to the parent can analyze the output to determine which device the child was near.

00001000: Enable Encrypted Communication

Enables encrypted communication. The other party must also enable encrypted communication.

00010000: Enable UART Output on Child

Enables message output on the child device.

Details of Sensor-specific Parameters

Explanation of settings linked to the sensor-specific parameter value.

Open/Close Sensor Pal

Not used.

Environmental Sensor Pal

Not used.

Motion Sensor Pal

Specify a 32-bit value.

Each function represents the following:

SCT: Sample Count

SCT affects the number of samples transmitted.

Intermittent Transmission Mode

When ATH is 0 and t: Transmission Interval is non-zero, intermittent transmission mode is active.

If SCT value is (C_i), the sample count is represented as (16C_i+16).

Active Detection Mode

When ATH and t: Transmission Interval are both non-zero, active detection mode is active.

In active detection mode, when acceleration exceeds the threshold given by ATH, it transmits the samples immediately after, in addition to the previous 30 samples.

If SCT value is (C_a), the number of subsequent samples is (30C_a+30).

SFQ: Sampling Frequency

SFQ affects the sampling frequency of acceleration data.

ATH: Active Detection Mode

ATH affects the behavior of active detection mode.

0 disables it. Values 1-F enable it with the value as the threshold.

Notification Pal

Specify a 32-bit value.

00000000: Tap & Shake Mode

Sends data when tapped or shaken.

00000001: Dice Mode

Detects six different top faces and sends data.

Notification Event Details

The value is binary data up to 68 bytes, represented as a hexadecimal string.

One event consists of 4 bytes. The maximum number of events is 17.

Example Configuration Data

An example of the default setting is shown.

0180002A0208002A0300802A0488002A0580802A0608802A0880000A1008000A