QN9020 QPP Programming Guide v0.1

QN902x QPP Programming Guide v0.1

Copyright ©2014-2014 by Quintic Corporation

Version 0.1

QN902x QPP Programming Guide v0.1

Table of Contents

1.

2. Introduction ....................................................................................................................................................... 1 QPP Server ......................................................................................................................................................... 1

2.1 Project Example ............................................................................................................................ 1

2.2 Software Description ..................................................................................................................... 1

2.2.1 User Configuration ........................................................................................................................ 1

2.2.2 Initialization .................................................................................................................................. 1

2.2.3 Data Processing ............................................................................................................................. 1

3. API and Handler ................................................................................................................................................ 2

3.1 qpps_init() .................................................................................................................................... 2

3.2

3.3

3.4

3.5

3.6

3.7

3.8

3.9

3.10

Copyright ©2014-2014 by Quintic Corporation

QN902x QPP Programming Guide v0.1

1. Introduction

The QPP (Quintic Private Profile) is used to transfer the raw data between BLE devices.

2. QPP Server

2.1

2.2 2.2.1

2.2.2 function. This function used to create server service database, application can define the number of

Characteristic used to send data to client through notify. NOTE: char_num: Max=7 Min = 0. If char_num increases transmission speed will be faster, but more and more space will be occupied.

2.2.3 Data Processing

The application has three data processing functions, app_qpps_data_send(),

app_qpps_data_send_cfm_handler() and app_qpps_data_ind_handler(). The app_qpps_data_send() function

Copyright ©2014-2014 by Quintic Corporation

is used by the application to send a raw data. The app_qpps_data_send_cfm_handler() function is used to report to the application a confirmation. The app_qpps_data_ind_handler() function is used to handle the data sent form peer device.

The diagrams below shows the relationships between APP and Profile:

3.2 app_qpps_create_db()

Prototype:

void app_qpps_create_db (uint8_t char_num);

Parameters:

in char_num The number of Characteristic used to send data

Copyright ©2014-2014 by Quintic Corporation

QPPS_CREATE_DB_CFM

Description:

This function shall be used to add an instance of the Quintic Private Profile service into the database. This should be done during the initialization phase of the device.

Note:

Application can define the number of Characteristic used to send data to client through notify.

Parameters:

in conhdl Connection handle

in index Index of Characteristic to be sent

in length Length of data to be sent

in data Pointer to data to be sent

Copyright ©2014-2014 by Quintic Corporation

QPPS_DATA_SEND_CFM

Description:

This function is used by the application to send a raw data.

3.5 app_qpps_create_db_cfm_handler ()

Prototype:

int app_qpps_create_db_cfm_handler (ke_msg_id_t const msgid, struct qpps_create_db_cfm * param, ke_task_id_t const dest_id, ke_task_id_t const src_id)

Returns:

If the message was consumed or not.

Description:

This handler is used to inform the Application of a correct disable. The configuration that the client has set in ntf_en field must be conserved for bonded devices.

Copyright ©2014-2014 by Quintic Corporation

3.7 app_qpps_error_ind_handler ()

Prototype:

int app_qpps_error_ind_handler (ke_msg_id_t const msgid, struct qpps_error_ind * param,

ke_task_id_t const dest_id, ke_task_id_t const src_id)

3.9 app_qpps_cfg_indntf_ind_handler ()

Prototype:

int app_qpps_cfg_indntf_ind_handler (ke_msg_id_t const msgid, struct qpps_cfg_indntf_ind * param, ke_task_id_t const dest_id, ke_task_id_t const src_id)

Copyright ©2014-2014 by Quintic Corporation

Parameters:

in msgid QPPS_CFG_INDNTF_IND

in param Pointer to the struct qpps_cfg_indntf_ind

in dest_id TASK_APP

in src_id TASK_QPPS

Returns:

If the message was consumed or not.

Description:

This handler is used to inform application that peer device has changed notification configuration.

Copyright ©2014-2014 by Quintic Corporation

References

Included with QUINTIC QBlue-X.X.X Release. The QBlue-X.X.X software has been installed to the default path ‘C:\ Quintic Corporation\QBlue-X.X.X’:

[1] C:\Quintic Corporation\QBlue-X.X.X\ Documents\Software\

QN9020 Software Developer's Guide v1.1.pdf

[2] C:\Quintic Corporation\QBlue-X.X.X\ Documents\Software\

Quintic Device Database for SW Development User Manual v0.4.pdf

[3] C:\Quintic Corporation\QBlue-X.X.X\ Documents\Software\

Copyright & …… 此处隐藏：3264字，全部文档内容请下载后查看。喜欢就下载吧 ……