TOOTHPIC RF Solutions, TOOTHPIC Datasheet - Page 101

• Manufacturer Part Number: TOOTHPIC
• Description: MODULE, BLUETOOTH, DATA ACQUISITION
• Manufacturer: RF Solutions

Specifications of TOOTHPIC

• Svhc: No SVHC (15-Dec-2010)

FxPE_Ack: Event is generated if remote device acknowledges messages sent by ToothPIC. Acknowledge
messages are only generated if the MTF_AckPlease server flag is set. This flag is specified as the option
Request Acknowledge in FlexiPanel Designer.
FxPE_Disco: Event is generated after a verified FlexiPanel compatible device is electing to disconnect. If
the disconnect is at ToothPIC’s request (through the FxPC_Finish command), this message will not be
received. In either case, a BMTE_Disco event will be generated and then BlueMatik is placed into slave
mode again ready for another FlexiPanel device to connect.
FxPE_Disco / FxPE_PingFail: If the Bluetooth connection is lost due to the remote device powering
down or going out of range, the FxPE_Disco event usually occurs with *pData result code 0x00. However,
it is possible that a FxPE_PingFail may occur instead; for example if the FlexiPanel client software closes
(or hangs) but the underlying Bluetooth connection still exists or hasn’t finished closing. In either case,
ToothPIC should enter a failsafe mode immediately if operating machinery, etc.
FxPE_PingReply: Pings provide a failsafe method of ensuring that the FlexiPanel server, the Bluetooth
connection and the remote client are all functioning correctly. If this feature selected in the FlexiPanel server
settings in FlexiPanel Designer, the server will send a ‘ping’ message to the client every few seconds. If the
client replies, a FxPE_PingReply event is generated and confirming all is functioning correctly. If no reply is
received by the time the next ‘ping’ is due to be sent, a FxPE_PingFail is generated. Most malfunctions
would generate a FxPE_PingFail within a few seconds; a hardware or software malfunction in the RTC
clock loop would result in neither FxPE_PingReply or FxPE_PingFail events being generated.
FxPE_ClntUpdate: Event is generated for each control that FlexiPanel client updates, each time it is
updated. For button and image controls, this message indicates that the button has been pressed.
FxPE_MsgResp: Event is generated if the user pressed a button on a message box. The data value is the 1-
based index of the button pressed. For example, if the message box is of Yes/No/Cancel style, the data value
is 1 for Yes, 2 for No and 3 for Cancel.
FxPE_NewDialog: Generated after a new dialog has just been sent to the client. The main use for this
message is to follow up the new dialog information with specific control properties information, such as control
visibility. See the HappyTerminal Firmware Solution for an example of its use.
Get_CtlNm( pData ) macro
The macro Get_CtlNm(unsigned char * pData), where CtlNm represents a control name, is defined
for each relevant control in the header file generated by FlexiPanel Designer. It retrieves the value of the
control and stores it at pData. Refer to the header file comments immediately preceding the macro definition
for notes on usage, particularly regarding buffer size requirements.
SetUp_CtlNm( pRData, pData ) macro
The macro SetUp_CtlNm( rom unsigned char * pData , unsigned char * pData), where
CtlNm represents a control name, is defined for each relevant control in the header file generated by
FlexiPanel Designer. It sets the value of the control to the value pointed to by pRData or pData (whichever is
non zero). It then executes a FxPE_ClntUpdate command to update the client with the new value. Refer to
the header file comments immediately preceding the macro definition for notes on usage.
Set_CtlNm( pRData, pData ) macro
The macro SetUp_CtlNm( rom unsigned char * pData, unsigned char * pData), where
CtlNm represents a control name, is defined for each relevant control in the header file generated by
FlexiPanel Designer. It sets the value of the control to the value pointed to by pRData or pData (whichever is
non zero). However, it does not send a message to update the client with the value. You would only use this
in preference to SetUp_CtlNm if you wished changes on several controls to appear to be simultaneous.
Page 101
9-Apr-06
Toothpick 3.0.00007
DS380-8
© FlexiPanel Ltd
Patents apply and/or pending
www.FlexiPanel.com