44  * 1) Need to look at advertising and scan request PDUs. Do I allocate these
48  * advertising? (for example)
49  * 4) How to determine the advertising interval we will actually use. As of
51  * 5) How does the advertising channel tx power get set? I dont implement
66  * Advertising state machine
68  * The advertising state machine data structure.
71  *      The length of the advertising PDU that will be sent. This does not
79  *      the peer address from the set advertising parameters.
184 /* The advertising state machine global object */
227  * local resolvable private addresses. The advertising code uses its own
271  * an advertising event.
275  * @return uint8_t The number of the first channel usable for advertising.
282     /* Set first advertising channel */  in ble_ll_adv_first_chan()
296  * an advertising event.
300  * @return uint8_t The number of the final channel usable for advertising.
319  * Create the advertising legacy PDU
362     /* An invalid advertising data length indicates a memory overwrite */  in ble_ll_adv_legacy_pdu_make()
384     /* Copy in advertising data, if any */  in ble_ll_adv_legacy_pdu_make()
411  * Create the advertising PDU
430     /* only ADV_EXT_IND goes on primary advertising channels */  in ble_ll_adv_pdu_make()
542              * can happen if next aux was outside advertising set period and  in ble_ll_adv_aux_pdu_make()
673      * and is based on the peer identity address in the set advertising  in ble_ll_adv_scan_rsp_legacy_pdu_make()
770  * Called to indicate the advertising event is over.
782     /* XXX: for now, reset power to max after advertising */  in ble_ll_adv_tx_done()
812  * Called when an advertising event has been removed from the scheduler
819      * Need to set advertising channel to final chan so new event gets  in ble_ll_adv_event_rmvd_from_sched()
922     /* Set link layer state to advertising */  in ble_ll_adv_tx_start_cb()
1060     /* Set link layer state to advertising */  in ble_ll_adv_secondary_tx_start_cb()
1221      * In case duration is set for advertising set we need to check if newly  in ble_ll_adv_aux_schedule_next()
1223      * so advertising will stop after current aux.  in ble_ll_adv_aux_schedule_next()
1250      * (will be needed for periodic advertising anyway)  in ble_ll_adv_aux_schedule_first()
1305      * of advertising event, but no sooner than T_MAFS. The interval between  in ble_ll_adv_aux_set_start_time()
1306      * advertising packets is 250 usecs (8.19 ticks) on LE Coded and a bit less  in ble_ll_adv_aux_set_start_time()
1310      * last advertising packet which is not a bit problem so leave it as-is, no  in ble_ll_adv_aux_set_start_time()
1316      *      or predefined interval, but since it makes advertising code even  in ble_ll_adv_aux_set_start_time()
1346      * In case duration is set for advertising set we need to check if at least  in ble_ll_adv_aux_schedule()
1347      * 1st aux will fit inside duration. If not, stop advertising now so we do  in ble_ll_adv_aux_schedule()
1348      * not start extended advertising event which we cannot finish in time.  in ble_ll_adv_aux_schedule()
1358  * Called when advertising need to be halted. This normally should not be called
1359  * and is only called when a scheduled item executes but advertising is still
1392  * Called by the HCI command parser when a set advertising parameters command
1419     /* Make sure intervals are OK (along with advertising type */  in ble_ll_adv_set_adv_params()
1426      * directed advertising  in ble_ll_adv_set_adv_params()
1461      * (HD directed advertising ignores those parameters)  in ble_ll_adv_set_adv_params()
1507     /* Fill out rest of advertising state machine */  in ble_ll_adv_set_adv_params()
1520  * Stop advertising state machine
1532         /* Remove any scheduled advertising items */  in ble_ll_adv_sm_stop()
1540         /* Set to standby if we are no longer advertising */  in ble_ll_adv_sm_stop()
1577         /* Disable advertising */  in ble_ll_adv_sm_stop()
1594      * For high duty directed advertising we need to send connection  in ble_ll_adv_sm_stop_timeout()
1603     /* Disable advertising */  in ble_ll_adv_sm_stop_timeout()
1616      * For high duty directed advertising we need to send connection  in ble_ll_adv_sm_stop_limit_reached()
1620      * be used if HD directed advertising was terminated before timeout due to  in ble_ll_adv_sm_stop_limit_reached()
1629     /* Disable advertising */  in ble_ll_adv_sm_stop_limit_reached()
1650     /* Set the time at which we must end directed, high-duty cycle advertising.  in ble_ll_adv_scheduled()
1663  * Start the advertising state machine. This is called when the host sends
1664  * the "enable advertising" command and is not called again while in the
1665  * advertising state.
1669  * @param advsm Pointer to advertising state machine
1712     /* Set advertising address */  in ble_ll_adv_sm_start()
1739     /* Set flag telling us that advertising is enabled */  in ble_ll_adv_sm_start()
1742     /* Determine the advertising interval we will use */  in ble_ll_adv_sm_start()
1744         /* Set it to max. allowed for high duty cycle advertising */  in ble_ll_adv_sm_start()
1751     /* Set first advertising channel */  in ble_ll_adv_sm_start()
1757      * advertising event some time in the future (5 msecs). This will give  in ble_ll_adv_sm_start()
1769      * Schedule advertising. We set the initial schedule start and end  in ble_ll_adv_sm_start()
1785  * Called when the LE HCI command read advertising channel tx power command
1786  * has been received. Returns the current advertising transmit power.
1801  * Turn advertising on/off.
1851             /* Start the advertising state machine */  in ble_ll_adv_set_enable()
1945     /* check if type of advertising support scan rsp */  in ble_ll_adv_set_scan_rsp_data()
2019  * Called by the LL HCI command parser when a set advertising
2050     /* check if type of advertising support adv data */  in ble_ll_adv_set_adv_data()
2136     /* DID shall be updated when host provides new advertising data */  in ble_ll_adv_set_adv_data()
2203         /* HD directed advertising allowed only on legacy PDUs */  in ble_ll_adv_ext_set_param()
2209         /* if ext advertising PDUs are used then it shall not be both  in ble_ll_adv_ext_set_param()
2219     /* High Duty Directed advertising is special */  in ble_ll_adv_ext_set_param()
2230         /* validate intervals for non HD-directed advertising */  in ble_ll_adv_ext_set_param()
2238         /* TODO for now limit those to values from legacy advertising  in ble_ll_adv_ext_set_param()
2240          * If the primary advertising interval range is outside the advertising  in ble_ll_adv_ext_set_param()
2396  * HCI LE extended advertising enable command
2499      * Reject if connectable advertising is on  in ble_ll_adv_set_random_addr()
2512  * HCI LE extended advertising remove command
2514  * @param instance Advertising instance to be removed
2554  * HCI LE extended advertising clear command
2742          * are doing directed advertising  in ble_ll_adv_rx_req()
2819          * are doing directed advertising  in ble_ll_adv_conn_req_rxd()
2860         /* Try to start slave connection. If successful, stop advertising */  in ble_ll_adv_conn_req_rxd()
2864             /* stop advertising only if not transmitting connection response */  in ble_ll_adv_conn_req_rxd()
2875  * Called on phy rx pdu end when in advertising state.
2938  * Process a received packet at the link layer task when in the advertising
2963      * It is possible that advertising was stopped and a packet plcaed on the  in ble_ll_adv_rx_pkt_in()
2965      * as the advertising state machine is no longer "valid"  in ble_ll_adv_rx_pkt_in()
2973      * or we have received a valid connect request, dont "end" the advertising  in ble_ll_adv_rx_pkt_in()
2974      * event. In the case of a connect request we will stop advertising. In  in ble_ll_adv_rx_pkt_in()
2998  * Called when a receive PDU has started and we are advertising.
3027         /* Only accept connect requests if connectable advertising event */  in ble_ll_adv_rx_isr_start()
3037      * advertising event is over.  in ble_ll_adv_rx_isr_start()
3102  * Called when an advertising event is over.
3106  * @param arg Pointer to advertising state machine.
3125         /* stop advertising this was due to transmitting connection response */  in ble_ll_adv_done()
3139      * Check if we have ended our advertising event. If our last advertising  in ble_ll_adv_done()
3164          * Calculate start time of next advertising event. NOTE: we do not  in ble_ll_adv_done()
3193          * Move to next advertising channel. If not in the mask, just  in ble_ll_adv_done()
3195          * just transmitted on the last advertising channel  in ble_ll_adv_done()
3223     /* check if advertising timed out */  in ble_ll_adv_done()
3266     /* Schedule advertising transmit */  in ble_ll_adv_done()
3276      * event and we will reschedule the next advertising event  in ble_ll_adv_done()
3319     /* Stop advertising due to transmitting connection response */  in ble_ll_adv_sec_done()
3336     /* Check if advertising timed out */  in ble_ll_adv_sec_done()
3380  * Checks if the controller can change the whitelist. If advertising is enabled
3407  * Sends the connection complete event when advertising a connection starts.
3476  * Called when the LL wait for response timer expires while in the advertising
3492  * Reset the advertising state machine.
3506         /* Stop advertising state machine */  in ble_ll_adv_reset()
3518 /* Called to determine if advertising is enabled.
3546     /* Initialize advertising tx done event */  in ble_ll_adv_sm_init()
3569  * Initialize the advertising functionality of a BLE device. This should
3577     /* Set default advertising parameters */  in ble_ll_adv_init()