1 /****************************************************************************** 2 * 3 * Copyright (C) 2009-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 * This is the implementation file for the MCAP Data chahnel state machine. 22 * 23 ******************************************************************************/ 24 #include <string.h> 25 26 #include "bt_target.h" 27 #include "mca_api.h" 28 #include "mca_defs.h" 29 #include "mca_int.h" 30 31 /***************************************************************************** 32 ** data channel state machine constants and types 33 *****************************************************************************/ 34 enum 35 { 36 MCA_DCB_TC_OPEN, 37 MCA_DCB_CONG, 38 MCA_DCB_FREE_DATA, 39 MCA_DCB_DEALLOC, 40 MCA_DCB_DO_DISCONN, 41 MCA_DCB_SND_DATA, 42 MCA_DCB_HDL_DATA, 43 MCA_DCB_NUM_ACTIONS 44 }; 45 #define MCA_DCB_IGNORE MCA_DCB_NUM_ACTIONS 46 47 /* action function list */ 48 const tMCA_DCB_ACTION mca_dcb_action[] = { 49 mca_dcb_tc_open, 50 mca_dcb_cong, 51 mca_dcb_free_data, 52 mca_dcb_dealloc, 53 mca_dcb_do_disconn, 54 mca_dcb_snd_data, 55 mca_dcb_hdl_data 56 }; 57 58 /* state table information */ 59 #define MCA_DCB_ACTIONS 1 /* number of actions */ 60 #define MCA_DCB_ACT_COL 0 /* position of action function */ 61 #define MCA_DCB_NEXT_STATE 1 /* position of next state */ 62 #define MCA_DCB_NUM_COLS 2 /* number of columns in state tables */ 63 64 /* state table for opening state */ 65 const UINT8 mca_dcb_st_opening[][MCA_DCB_NUM_COLS] = { 66 /* Event Action Next State */ 67 /* MCA_DCB_API_CLOSE_EVT */ {MCA_DCB_DO_DISCONN, MCA_DCB_CLOSING_ST}, 68 /* MCA_DCB_API_WRITE_EVT */ {MCA_DCB_IGNORE, MCA_DCB_OPENING_ST}, 69 /* MCA_DCB_TC_OPEN_EVT */ {MCA_DCB_TC_OPEN, MCA_DCB_OPEN_ST}, 70 /* MCA_DCB_TC_CLOSE_EVT */ {MCA_DCB_DEALLOC, MCA_DCB_NULL_ST}, 71 /* MCA_DCB_TC_CONG_EVT */ {MCA_DCB_CONG, MCA_DCB_OPENING_ST}, 72 /* MCA_DCB_TC_DATA_EVT */ {MCA_DCB_FREE_DATA, MCA_DCB_OPENING_ST} 73 }; 74 75 /* state table for open state */ 76 const UINT8 mca_dcb_st_open[][MCA_DCB_NUM_COLS] = { 77 /* Event Action Next State */ 78 /* MCA_DCB_API_CLOSE_EVT */ {MCA_DCB_DO_DISCONN, MCA_DCB_CLOSING_ST}, 79 /* MCA_DCB_API_WRITE_EVT */ {MCA_DCB_SND_DATA, MCA_DCB_OPEN_ST}, 80 /* MCA_DCB_TC_OPEN_EVT */ {MCA_DCB_IGNORE, MCA_DCB_OPEN_ST}, 81 /* MCA_DCB_TC_CLOSE_EVT */ {MCA_DCB_DEALLOC, MCA_DCB_NULL_ST}, 82 /* MCA_DCB_TC_CONG_EVT */ {MCA_DCB_CONG, MCA_DCB_OPEN_ST}, 83 /* MCA_DCB_TC_DATA_EVT */ {MCA_DCB_HDL_DATA, MCA_DCB_OPEN_ST} 84 }; 85 86 /* state table for closing state */ 87 const UINT8 mca_dcb_st_closing[][MCA_DCB_NUM_COLS] = { 88 /* Event Action Next State */ 89 /* MCA_DCB_API_CLOSE_EVT */ {MCA_DCB_IGNORE, MCA_DCB_CLOSING_ST}, 90 /* MCA_DCB_API_WRITE_EVT */ {MCA_DCB_IGNORE, MCA_DCB_CLOSING_ST}, 91 /* MCA_DCB_TC_OPEN_EVT */ {MCA_DCB_TC_OPEN, MCA_DCB_OPEN_ST}, 92 /* MCA_DCB_TC_CLOSE_EVT */ {MCA_DCB_DEALLOC, MCA_DCB_NULL_ST}, 93 /* MCA_DCB_TC_CONG_EVT */ {MCA_DCB_IGNORE, MCA_DCB_CLOSING_ST}, 94 /* MCA_DCB_TC_DATA_EVT */ {MCA_DCB_FREE_DATA, MCA_DCB_CLOSING_ST} 95 }; 96 97 /* type for state table */ 98 typedef const UINT8 (*tMCA_DCB_ST_TBL)[MCA_DCB_NUM_COLS]; 99 100 /* state table */ 101 const tMCA_DCB_ST_TBL mca_dcb_st_tbl[] = { 102 mca_dcb_st_opening, 103 mca_dcb_st_open, 104 mca_dcb_st_closing 105 }; 106 107 #if (BT_TRACE_VERBOSE == TRUE) 108 /* verbose event strings for trace */ 109 const char * const mca_dcb_evt_str[] = { 110 "API_CLOSE_EVT", 111 "API_WRITE_EVT", 112 "TC_OPEN_EVT", 113 "TC_CLOSE_EVT", 114 "TC_CONG_EVT", 115 "TC_DATA_EVT" 116 }; 117 /* verbose state strings for trace */ 118 const char * const mca_dcb_st_str[] = { 119 "NULL_ST", 120 "OPENING_ST", 121 "OPEN_ST", 122 "CLOSING_ST" 123 }; 124 #endif 125 126 /******************************************************************************* 127 ** 128 ** Function mca_dcb_event 129 ** 130 ** Description This function is the DCB state machine main function. 131 ** It uses the state and action function tables to execute 132 ** action functions. 133 ** 134 ** Returns void. 135 ** 136 *******************************************************************************/ 137 void mca_dcb_event(tMCA_DCB *p_dcb, UINT8 event, tMCA_DCB_EVT *p_data) 138 { 139 tMCA_DCB_ST_TBL state_table; 140 UINT8 action; 141 142 if (p_dcb == NULL) 143 return; 144 #if (BT_TRACE_VERBOSE == TRUE) 145 MCA_TRACE_EVENT3("DCB dcb=%d event=%s state=%s", mca_dcb_to_hdl(p_dcb), mca_dcb_evt_str[event], mca_dcb_st_str[p_dcb->state]); 146 #else 147 MCA_TRACE_EVENT3("DCB dcb=%d event=%d state=%d", mca_dcb_to_hdl(p_dcb), event, p_dcb->state); 148 #endif 149 150 /* look up the state table for the current state */ 151 state_table = mca_dcb_st_tbl[p_dcb->state - 1]; 152 153 /* set next state */ 154 p_dcb->state = state_table[event][MCA_DCB_NEXT_STATE]; 155 156 /* execute action functions */ 157 if ((action = state_table[event][MCA_DCB_ACT_COL]) != MCA_DCB_IGNORE) 158 { 159 (*mca_dcb_action[action])(p_dcb, p_data); 160 } 161 } 162 163 /******************************************************************************* 164 ** 165 ** Function mca_dcb_alloc 166 ** 167 ** Description This function is called to allocate an DCB. 168 ** It initializes the DCB with the data passed to the function. 169 ** 170 ** Returns tMCA_DCB * 171 ** 172 *******************************************************************************/ 173 tMCA_DCB *mca_dcb_alloc(tMCA_CCB*p_ccb, tMCA_DEP dep) 174 { 175 tMCA_DCB *p_dcb = NULL, *p_dcb_tmp; 176 tMCA_RCB *p_rcb = p_ccb->p_rcb; 177 tMCA_CS *p_cs; 178 int i, max; 179 180 if (dep < MCA_NUM_DEPS) 181 { 182 p_cs = &p_rcb->dep[dep]; 183 i = mca_ccb_to_hdl(p_ccb)-1; 184 p_dcb_tmp = &mca_cb.dcb[i*MCA_NUM_MDLS]; 185 /* make sure p_cs->max_mdl is smaller than MCA_NUM_MDLS at MCA_CreateDep */ 186 max = p_cs->max_mdl; 187 for (i=0; i<max; i++, p_dcb_tmp++) 188 { 189 if (p_dcb_tmp->state == MCA_DCB_NULL_ST) 190 { 191 p_dcb_tmp->p_ccb = p_ccb; 192 p_dcb_tmp->state = MCA_DCB_OPENING_ST; 193 p_dcb_tmp->cong = TRUE; 194 p_dcb_tmp->p_cs = p_cs; 195 p_dcb = p_dcb_tmp; 196 break; 197 } 198 } 199 } 200 return p_dcb; 201 } 202 203 /******************************************************************************* 204 ** 205 ** Function mca_dep_free_mdl 206 ** 207 ** Description This function is called to check the number of free mdl for 208 ** the given dep. 209 ** 210 ** Returns the number of free mdl for the given dep 211 ** 212 *******************************************************************************/ 213 UINT8 mca_dep_free_mdl(tMCA_CCB *p_ccb, tMCA_DEP dep) 214 { 215 tMCA_DCB *p_dcb; 216 tMCA_RCB *p_rcb = p_ccb->p_rcb; 217 tMCA_CS *p_cs; 218 int i, max; 219 UINT8 count = 0; 220 UINT8 left; 221 222 if (dep < MCA_NUM_DEPS) 223 { 224 p_cs = &p_rcb->dep[dep]; 225 i = mca_ccb_to_hdl(p_ccb)-1; 226 p_dcb = &mca_cb.dcb[i * MCA_NUM_MDLS]; 227 /* make sure p_cs->max_mdl is smaller than MCA_NUM_MDLS at MCA_CreateDep */ 228 max = p_cs->max_mdl; 229 for (i=0; i<max; i++, p_dcb++) 230 { 231 if ((p_dcb->state != MCA_DCB_NULL_ST) && (p_dcb->p_cs == p_cs)) 232 { 233 count++; 234 break; 235 } 236 } 237 } 238 else 239 { 240 max = 0; 241 MCA_TRACE_WARNING0("Invalid Dep ID"); 242 } 243 left = max - count; 244 return left; 245 } 246 247 /******************************************************************************* 248 ** 249 ** Function mca_dcb_dealloc 250 ** 251 ** Description This function deallocates an DCB. 252 ** 253 ** Returns void. 254 ** 255 *******************************************************************************/ 256 void mca_dcb_dealloc(tMCA_DCB *p_dcb, tMCA_DCB_EVT *p_data) 257 { 258 tMCA_CCB *p_ccb = p_dcb->p_ccb; 259 UINT8 event = MCA_CLOSE_IND_EVT; 260 tMCA_CTRL evt_data; 261 262 MCA_TRACE_DEBUG0("mca_dcb_dealloc"); 263 mca_free_buf ((void **)&p_dcb->p_data); 264 if (p_data) 265 { 266 /* non-NULL -> an action function -> report disconnect event */ 267 evt_data.close_cfm.mdl = mca_dcb_to_hdl(p_dcb); 268 evt_data.close_cfm.reason = p_data->close.reason; 269 evt_data.close_cfm.mdl_id = p_dcb->mdl_id; 270 if (p_data->close.param == MCA_INT) 271 event = MCA_CLOSE_CFM_EVT; 272 if (p_data->close.lcid) 273 mca_ccb_report_event(p_ccb, event, &evt_data); 274 } 275 mca_free_tc_tbl_by_lcid (p_dcb->lcid); 276 memset (p_dcb, 0, sizeof (tMCA_DCB)); 277 } 278 279 /******************************************************************************* 280 ** 281 ** Function mca_dcb_to_hdl 282 ** 283 ** Description This function converts a pointer to an DCB to a handle (tMCA_DL). 284 ** It returns the handle. 285 ** 286 ** Returns tMCA_DL. 287 ** 288 *******************************************************************************/ 289 tMCA_DL mca_dcb_to_hdl(tMCA_DCB *p_dcb) 290 { 291 return (UINT8) (p_dcb - mca_cb.dcb + 1); 292 } 293 294 /******************************************************************************* 295 ** 296 ** Function mca_dcb_by_hdl 297 ** 298 ** Description This function finds the DCB for a handle (tMCA_DL). 299 ** It returns a pointer to the DCB. 300 ** If no DCB matches the handle it returns NULL. 301 ** 302 ** Returns tMCA_DCB * 303 ** 304 *******************************************************************************/ 305 tMCA_DCB *mca_dcb_by_hdl(tMCA_DL hdl) 306 { 307 tMCA_DCB * p_dcb = NULL; 308 if (hdl && hdl <= MCA_NUM_DCBS && mca_cb.dcb[hdl-1].state) 309 p_dcb = &mca_cb.dcb[hdl-1]; 310 return p_dcb; 311 } 312 313 /******************************************************************************* 314 ** 315 ** Function mca_dcb_close_by_mdl_id 316 ** 317 ** Description This function finds the DCB for a mdl_id and 318 ** disconnect the mdl 319 ** 320 ** Returns void 321 ** 322 *******************************************************************************/ 323 void mca_dcb_close_by_mdl_id(tMCA_CCB*p_ccb, UINT16 mdl_id) 324 { 325 tMCA_DCB *p_dcb; 326 int i; 327 328 MCA_TRACE_DEBUG1("mca_dcb_close_by_mdl_id mdl_id=%d", mdl_id); 329 i = mca_ccb_to_hdl(p_ccb)-1; 330 p_dcb = &mca_cb.dcb[i*MCA_NUM_MDLS]; 331 for (i=0; i<MCA_NUM_MDLS; i++, p_dcb++) 332 { 333 if (p_dcb->state) 334 { 335 if (p_dcb->mdl_id == mdl_id) 336 { 337 mca_dcb_event(p_dcb, MCA_DCB_API_CLOSE_EVT, NULL); 338 break; 339 } 340 else if (mdl_id == MCA_ALL_MDL_ID) 341 { 342 mca_dcb_event(p_dcb, MCA_DCB_API_CLOSE_EVT, NULL); 343 } 344 } 345 } 346 } 347
