Cefn Hoile / nRF51822

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependencies:   nrf51-sdk

Dependents:   microbit-dal

Fork of nRF51822 by Lancaster University

nordic-sdk/components/libraries/bootloader_dfu/bootloader.h@370:295f76db798e, 2015-07-06 (annotated)

Committer:
rgrover1
Date:
Mon Jul 06 10:13:26 2015 +0100
Revision:
370:295f76db798e
Parent:
362:6fa0d4d555f6
Child:
371:8f7d2137727a
Synchronized with git rev 9f72c4ba

Author: Rohit Grover

Release 0.3.7

=============



This is a minor set of enhancements mostly around reduce our global static

memory footprint.



Enhancements

~~~~~~~~~~~~



* Reduce the maximum number of CHARACTERISTICS and DESCRIPTORS that can be

  handled. This has memory implications for static global memory. It should

  be possible to re-architect our solution for add_characteristic() to not

  require these limits; hopefully we'll get there soon.



* Move nRF51GattServer::getInstance() into a .cpp file; same for nRF51Gap::getInstance().



* Reduce max bonds to managed by device-manager to 4; this has memory implications for static global memory.



* Reduce pStorage command queue size to 2; this has memory implications for static global memory.



* Replace uses of deprecated Gap::addr_type_t with Gap::AddressType_t.



* Some UUID-related types have moved into UUID class. Minor changes were needed to work around build errors.



Bugfixes

~~~~~~~~



* None.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
rgrover1 370:295f76db798e 1 /* Copyright (c) 2013 Nordic Semiconductor. All Rights Reserved.
rgrover1 370:295f76db798e 2 *
rgrover1 370:295f76db798e 3 * The information contained herein is property of Nordic Semiconductor ASA.
rgrover1 370:295f76db798e 4 * Terms and conditions of usage are described in detail in NORDIC
rgrover1 370:295f76db798e 5 * SEMICONDUCTOR STANDARD SOFTWARE LICENSE AGREEMENT.
rgrover1 370:295f76db798e 6 *
rgrover1 370:295f76db798e 7 * Licensees are granted free, non-transferable use of the information. NO
rgrover1 370:295f76db798e 8 * WARRANTY of ANY KIND is provided. This heading must NOT be removed from
rgrover1 370:295f76db798e 9 * the file.
rgrover1 370:295f76db798e 10 *
rgrover1 370:295f76db798e 11 */
rgrover1 370:295f76db798e 12
rgrover1 370:295f76db798e 13 /**@file
rgrover1 370:295f76db798e 14 *
rgrover1 370:295f76db798e 15 * @defgroup nrf_bootloader Bootloader API.
rgrover1 370:295f76db798e 16 * @{
rgrover1 370:295f76db798e 17 *
rgrover1 370:295f76db798e 18 * @brief Bootloader module interface.
rgrover1 370:295f76db798e 19 */
rgrover1 370:295f76db798e 20
rgrover1 370:295f76db798e 21 #ifndef BOOTLOADER_H__
rgrover1 370:295f76db798e 22 #define BOOTLOADER_H__
rgrover1 370:295f76db798e 23
rgrover1 370:295f76db798e 24 #include <stdbool.h>
rgrover1 370:295f76db798e 25 #include <stdint.h>
rgrover1 370:295f76db798e 26 #include "bootloader_types.h"
rgrover1 370:295f76db798e 27 #include "dfu_types.h"
rgrover1 370:295f76db798e 28
rgrover1 370:295f76db798e 29 /**@brief Function for initializing the Bootloader.
rgrover1 370:295f76db798e 30 *
rgrover1 370:295f76db798e 31 * @retval NRF_SUCCESS If bootloader was succesfully initialized.
rgrover1 370:295f76db798e 32 */
rgrover1 370:295f76db798e 33 uint32_t bootloader_init(void);
rgrover1 370:295f76db798e 34
rgrover1 370:295f76db798e 35 /**@brief Function for validating application region in flash.
rgrover1 370:295f76db798e 36 *
rgrover1 370:295f76db798e 37 * @param[in] app_addr Address to the region in flash where the application is stored.
rgrover1 370:295f76db798e 38 *
rgrover1 370:295f76db798e 39 * @retval true If Application region is valid.
rgrover1 370:295f76db798e 40 * @retval false If Application region is not valid.
rgrover1 370:295f76db798e 41 */
rgrover1 370:295f76db798e 42 bool bootloader_app_is_valid(uint32_t app_addr);
rgrover1 370:295f76db798e 43
rgrover1 370:295f76db798e 44 /**@brief Function for starting the Device Firmware Update.
rgrover1 370:295f76db798e 45 *
rgrover1 370:295f76db798e 46 * @retval NRF_SUCCESS If new application image was successfully transferred.
rgrover1 370:295f76db798e 47 */
rgrover1 370:295f76db798e 48 uint32_t bootloader_dfu_start(void);
rgrover1 370:295f76db798e 49
rgrover1 370:295f76db798e 50 /**@brief Function for exiting bootloader and booting into application.
rgrover1 370:295f76db798e 51 *
rgrover1 370:295f76db798e 52 * @details This function will disable SoftDevice and all interrupts before jumping to application.
rgrover1 370:295f76db798e 53 * The SoftDevice vector table base for interrupt forwarding will be set the application
rgrover1 370:295f76db798e 54 * address.
rgrover1 370:295f76db798e 55 *
rgrover1 370:295f76db798e 56 * @param[in] app_addr Address to the region where the application is stored.
rgrover1 370:295f76db798e 57 */
rgrover1 370:295f76db798e 58 void bootloader_app_start(uint32_t app_addr);
rgrover1 370:295f76db798e 59
rgrover1 370:295f76db798e 60 /**@brief Function for retrieving the bootloader settings.
rgrover1 370:295f76db798e 61 *
rgrover1 370:295f76db798e 62 * @param[out] p_settings A copy of the current bootloader settings is returned in the structure
rgrover1 370:295f76db798e 63 * provided.
rgrover1 370:295f76db798e 64 */
rgrover1 370:295f76db798e 65 void bootloader_settings_get(bootloader_settings_t * const p_settings);
rgrover1 370:295f76db798e 66
rgrover1 370:295f76db798e 67 /**@brief Function for processing DFU status update.
rgrover1 370:295f76db798e 68 *
rgrover1 370:295f76db798e 69 * @param[in] update_status DFU update status.
rgrover1 370:295f76db798e 70 */
rgrover1 370:295f76db798e 71 void bootloader_dfu_update_process(dfu_update_status_t update_status);
rgrover1 370:295f76db798e 72
rgrover1 370:295f76db798e 73 /**@brief Function getting state of SoftDevice update in progress.
rgrover1 370:295f76db798e 74 * After a successfull SoftDevice transfer the system restarts in orderto disable SoftDevice
rgrover1 370:295f76db798e 75 * and complete the update.
rgrover1 370:295f76db798e 76 *
rgrover1 370:295f76db798e 77 * @retval true A SoftDevice update is in progress. This indicates that second stage
rgrover1 370:295f76db798e 78 * of a SoftDevice update procedure can be initiated.
rgrover1 370:295f76db798e 79 * @retval false No SoftDevice update is in progress.
rgrover1 370:295f76db798e 80 */
rgrover1 370:295f76db798e 81 bool bootloader_dfu_sd_in_progress(void);
rgrover1 370:295f76db798e 82
rgrover1 370:295f76db798e 83 /**@brief Function for continuing the Device Firmware Update of a SoftDevice.
rgrover1 370:295f76db798e 84 *
rgrover1 370:295f76db798e 85 * @retval NRF_SUCCESS If the final stage of SoftDevice update was successful.
rgrover1 370:295f76db798e 86 */
rgrover1 370:295f76db798e 87 uint32_t bootloader_dfu_sd_update_continue(void);
rgrover1 370:295f76db798e 88
rgrover1 370:295f76db798e 89 /**@brief Function for finalizing the Device Firmware Update of a SoftDevice.
rgrover1 370:295f76db798e 90 *
rgrover1 370:295f76db798e 91 * @retval NRF_SUCCESS If the final stage of SoftDevice update was successful.
rgrover1 370:295f76db798e 92 */
rgrover1 370:295f76db798e 93 uint32_t bootloader_dfu_sd_update_finalize(void);
rgrover1 370:295f76db798e 94
rgrover1 370:295f76db798e 95 #endif // BOOTLOADER_H__
rgrover1 370:295f76db798e 96
rgrover1 370:295f76db798e 97 /**@} */