1 /******************************************************************************
2  *
3  *  Copyright 2003-2012 Broadcom Corporation
4  *
5  *  Licensed under the Apache License, Version 2.0 (the "License");
6  *  you may not use this file except in compliance with the License.
7  *  You may obtain a copy of the License at:
8  *
9  *  http://www.apache.org/licenses/LICENSE-2.0
10  *
11  *  Unless required by applicable law or agreed to in writing, software
12  *  distributed under the License is distributed on an "AS IS" BASIS,
13  *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14  *  See the License for the specific language governing permissions and
15  *  limitations under the License.
16  *
17  ******************************************************************************/
18 
19 /******************************************************************************
20  *
21  *  Basic utility functions.
22  *
23  ******************************************************************************/
24 #ifndef UTL_H
25 #define UTL_H
26 
27 #include "bt_types.h"
28 #include "bt_utils.h"
29 
30 /*****************************************************************************
31  *  Constants
32  ****************************************************************************/
33 /*** class of device settings ***/
34 #define BTA_UTL_SET_COD_MAJOR_MINOR 0x01
35 #define BTA_UTL_SET_COD_SERVICE_CLASS    \
36   0x02 /* only set the bits in the input \
37           */
38 #define BTA_UTL_CLR_COD_SERVICE_CLASS 0x04
39 #define BTA_UTL_SET_COD_ALL \
40   0x08 /* take service class as the input (may clear some set bits!!) */
41 #define BTA_UTL_INIT_COD 0x0a
42 
43 /*****************************************************************************
44  *  Type Definitions
45  ****************************************************************************/
46 
47 /** for utl_set_device_class() **/
48 typedef struct {
49   uint8_t minor;
50   uint8_t major;
51   uint16_t service;
52 } tBTA_UTL_COD;
53 
54 /*****************************************************************************
55  *  External Function Declarations
56  ****************************************************************************/
57 
58 /*******************************************************************************
59  *
60  * Function         utl_str2int
61  *
62  * Description      This utility function converts a character string to an
63  *                  integer.  Acceptable values in string are 0-9.  If invalid
64  *                  string or string value too large, -1 is returned.
65  *
66  *
67  * Returns          Integer value or -1 on error.
68  *
69  ******************************************************************************/
70 extern int16_t utl_str2int(const char* p_s);
71 
72 /*******************************************************************************
73  *
74  * Function         utl_strucmp
75  *
76  * Description      This utility function compares two strings in uppercase.
77  *                  String p_s must be uppercase.  String p_t is converted to
78  *                  uppercase if lowercase.  If p_s ends first, the substring
79  *                  match is counted as a match.
80  *
81  *
82  * Returns          0 if strings match, nonzero otherwise.
83  *
84  ******************************************************************************/
85 extern int utl_strucmp(const char* p_s, const char* p_t);
86 
87 /*******************************************************************************
88  *
89  * Function         utl_itoa
90  *
91  * Description      This utility function converts a uint16_t to a string.  The
92  *                  string is NULL-terminated.  The length of the string is
93  *                  returned.
94  *
95  *
96  * Returns          Length of string.
97  *
98  ******************************************************************************/
99 extern uint8_t utl_itoa(uint16_t i, char* p_s);
100 
101 /*******************************************************************************
102  *
103  * Function         utl_set_device_class
104  *
105  * Description      This function updates the local Device Class.
106  *
107  * Parameters:
108  *                  p_cod   - Pointer to the device class to set to
109  *
110  *                  cmd     - the fields of the device class to update.
111  *                            BTA_UTL_SET_COD_MAJOR_MINOR, - overwrite major,
112  *                                                           minor class
113  *                            BTA_UTL_SET_COD_SERVICE_CLASS - set the bits in
114  *                                                            the input
115  *                            BTA_UTL_CLR_COD_SERVICE_CLASS - clear the bits in
116  *                                                            the input
117  *                            BTA_UTL_SET_COD_ALL - overwrite major, minor, set
118  *                                                  the bits in service class
119  *                            BTA_UTL_INIT_COD - overwrite major, minor, and
120  *                                               service class
121  *
122  * Returns          true if successful, Otherwise false
123  *
124  ******************************************************************************/
125 extern bool utl_set_device_class(tBTA_UTL_COD* p_cod, uint8_t cmd);
126 
127 /*******************************************************************************
128  *
129  * Function         utl_isintstr
130  *
131  * Description      This utility function checks if the given string is an
132  *                  integer string or not
133  *
134  *
135  * Returns          true if successful, Otherwise false
136  *
137  ******************************************************************************/
138 extern bool utl_isintstr(const char* p_s);
139 
140 /*******************************************************************************
141  *
142  * Function         utl_isdialchar
143  *
144  * Description      This utility function checks if the given character
145  *                  is an acceptable dial digit
146  *
147  * Returns          true if successful, Otherwise false
148  *
149  ******************************************************************************/
150 extern bool utl_isdialchar(const char d);
151 
152 /*******************************************************************************
153  *
154  * Function         utl_isdialstr
155  *
156  * Description      This utility function checks if the given string contains
157  *                  only dial digits or not
158  *
159  *
160  * Returns          true if successful, Otherwise false
161  *
162  ******************************************************************************/
163 extern bool utl_isdialstr(const char* p_s);
164 
165 #endif /* UTL_H */
166