1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
/******************************************************************************
**
** Name: xml_erp_api.h
** $Id:
**
** Description: This module contains xml parser of MAP event report
**
** Copyright (c) 2004-2005, Broadcom Corporation, All Rights Reserved.
** WIDCOMM Bluetooth Core. Proprietary and confidential.
******************************************************************************/
#ifndef XML_ERP_API_H
#define XML_ERP_API_H
#include "bt_target.h"
#include "gki.h"
#include "xml_pars_api.h"
#ifndef XML_EVT_RPT_CARRY_OVER_LEN
#define XML_EVT_RPT_CARRY_OVER_LEN 512 /* number of bytes we can store in case we did not yet find the > */
#endif
/**********************************************************************************/
typedef struct
{
UINT16 type_len;
UINT16 handle_len;
UINT16 folder_len;
UINT16 old_folder_len;
UINT16 msg_type_len;
UINT8 *type;
UINT8 *handle;
UINT8 *folder;
UINT8 *old_folder;
UINT8 *msg_type;
} tXML_EVT_RPT_ENTRY;
/**********************************************************************************/
enum
{
XML_EVT_RPT_OK, /* parsing is ok, operation is ok */
XML_EVT_RPT_PENDING, /* parsing is ok but not enough data */
XML_EVT_RPT_END_LIST, /* found </MAP-event-report> */
XML_EVT_RPT_OUT_FULL, /* output buffer full /MAP-event-report not reached! data is dumped */
XML_EVT_RPT_ERROR, /* some parsing error occured */
XML_EVT_RPT_NO_RES, /* ran out of resources (memory) */
XML_EVT_RPT_DST_NO_RES /* ran out of destination data buffer */
} ;
typedef UINT8 tXML_EVT_RPT_RES;
typedef struct
{
tXML_EVT_RPT_ENTRY *p_entry; /* point to parser_cb->ilist.evt_rpt */
tXML_PROP *p_prop; /* GKI_BUF3_SIZE */
tXML_PROP *offset_prop; /* current filling property */
UINT16 prop_num; /* number of properties left to be filled in */
INT16 current_entry;
INT16 max_name_len; /* maximum length of name length of entry
XML parser limits to 196 bytes i think. */
UINT16 max_entry;
BOOLEAN ended;
UINT16 prop_index;
UINT16 max_num_prop;
UINT8 obj; /* the XML object - (tFTC_XML_OBJ + 1)*/
} tXML_EVT_RPT_STATE;
typedef struct
{
tXML_MUL_STATE xml;
tXML_EVT_RPT_STATE xml_user_data;
} tXML_EVT_RPT_PARSER;
/* only this value is of significance, if not ok frame is dropped by parser */
#define XML_EVT_RPT_ENTRY_OK 0
typedef UINT8 tXML_EVT_RPT_STATUS;
typedef struct
{
UINT8 *data;
UINT16 len;
BOOLEAN final; /* If TRUE, entry is last of the series */
tXML_EVT_RPT_STATUS status; /* Fields are valid when status is BTA_FTC_OK */
} tXML_EVT_RPT_LIST; /* clone of tBTA_FTC_LIST */
/**************************************************************************************
** Function XML_EvtRptInit
**
** Description Initialize xml parser state machine.
**
** Parameters p_xml_state: address of parser structure, allocate an additional space
** of size XML_EVT_RPT_CARRY_OVER_LEN right after p_xml_state
** to hold carry over data.
** p_entry : points start of output directory entry. caller needs do free this memory
** max_entry : max is 16 bit integer value which is the maximum number of folder entries.
**
** Returns void
**************************************************************************************/
MCE_API void XML_EvtRptInit( tXML_EVT_RPT_PARSER *p_xml_state,
tXML_EVT_RPT_ENTRY *p_entry,
const UINT16 max_entry );
/**************************************************************************************
** Function XML_EvtRptParse
**
** Description This function is called to parse the xml data received from OBEX
** into folder entries associated with properties value. It can also be
** used as clean up function to delete left over data from previous parse.
** This clean up function is typically used when application runs out of
** resource and decides to discard extra xml data received.
**
** Parameters p_xml_state: pointer to a xml parser initialized by XML_FolderInit().
** xml_data: valid pointer to OBEX list data in xml format.
** xml_len: length of the package, must be non-zero value.
** dst_data: valid pointer to the buffer for holding converted folder entry name.
** When dst_data is NULL, clean up all remaining data in the parser.
** dst_len: length of the dst_data buffer, its carry out value is the number
** of bytes of available buffer remains.
** num_entries: current number of entries, in the end it is the total number of entries
**
** Returns tXML_EVT_RPT_RES (see xml_flp.h)
** XML_PENDING: parsing not completed
** XML_END_LIST: found /folder-listing but no final flag detected
** XML_EVT_RPT_OUT_FULL: reached max_entry -> do not call parser anymore!!! dump data
** XML_EVT_RPT_DST_NO_RES : run out of dst buffer resource while
** some xml data still remains.
**************************************************************************************/
MCE_API extern tXML_EVT_RPT_RES XML_EvtRptParse( tXML_EVT_RPT_PARSER *p_xml_state,
UINT8 *xml_data, UINT16 xml_len,
UINT8 *dst_data, UINT16 *dst_len,
UINT16 *num_entries );
#endif
|