Porting From Earlier BLE-Stack Versions
www.ti.com
82
SWRU271H–October 2010–Revised April 2019
Submit Documentation Feedback
Copyright © 2010–2019, Texas Instruments Incorporated
General Information
5. BIM for OAD enabled projects: Apply the DMA VLEN initialization to DMAExecCrc in
\Projects\ble\util\BIM\app\bim_main.c, see line 347 of 1.5.0 code:
// Use LEN for transfer count
HAL_DMA_SET_VLEN( dmaCh0_p, HAL_DMA_VLEN_USE_LEN );
6. After making the above modifications, open your updated project with IAR Embedded Workbench for
8051 v10.30.1. IAR will prompt you to confirm that your project is being updated. Select Yes to
continue and Save the project after the conversion is complete.
Congratulations! Your 1.4.2 project should now build cleanly using the updated libraries and files from
1.5.0. If any issues are found during the porting process, visit the Bluetooth E2E forum for support.
9.3 Porting From Earlier BLE-Stack Versions
This section explains necessary steps to port a BLE-Stack v1.x.x project running on a certain stack
version to a newer one, and how to port between CC2540 and CC2541 projects.
9.3.1 Porting BLEv1.4.1 Projects to BLEv1.4.2
BLE v1.4.2 is a BLE-Stack maintenance release to the v1.4.1 release with all bug fixes applied in the
protocol stack libraries. Refer to the release notes for a detailed list of changes in this release. Compared
to the previous BLE v1.4.1 release, there are no API or SDK source code changes in BLE v1.4.2.
Therefore, no application or project file porting is required when upgrading a project running BLE v1.4.1 to
v1.4.2.
All documentation and examples from BLE v1.4.1 apply to BLE v1.4.2.:
1. If the current project is based on a BLE-Stack SDK release prior to BLE v1.4.1 (for example, BLE
v1.4.0), then follow the below porting instructions to first port your project to BLE v1.4.1. The following
steps apply to projects already running BLE v.1.4.1.
2. Copy all library files from the BLE v1.4.2 SDK to the existing BLE v1.4.1 SDK installation. The libraries
are located at: $1.4.2_INSTALL$\Projects\ble\Libraries Where the default $1.4.2_INSTALL$ path is
C:\Texas Instruments\BLE-CC254x-1.4.2.2. The entire v1.4.2 'Libraries' folder can be copy/pasted to
the v1.4.1 installation.
3. Rebuild the project to link to the updated BLE v1.4.2 protocol stack libraries.
9.3.2 Porting BLEv1.4.0 Projects to BLEv1.4.1
9.3.2.1 Project Porting Directions
1. Move (or Copy) the project files from $1.4.0_INSTALL$\Projects\ble\$PROJECT$ to
$INSTALL\Projects\ble\$PROJECT$ where $1.4.0_INSTALL$ is the top level installation directory of
the 1.4.0 stack, $INSTALL$ is the top level installation directory of the 1.4.1 stack, and $PROJECT$ is
your project folder.
2. If you modified any files from anywhere outside of the application folder, such as in the profiles at
$1.4.0_INSTALL$\Projects\Profiles, you will need to merge your changes with the new 1.4.1 version.
3. Open your project (now in the 1.4.1 folder) with IAR 9.10.3.
4. When prompted, choose yes to convert for use with new version.
5. In the Project options, in the Preprocessor options under the C/C++ Compiler tab, add “CC254x” to the
controller include path: $PROJ_DIR$\..\..\..\..\Components\ble\controller\CC254x\include
6. For any profiles, add the CC254x include path. Do not delete the original paths as they are still
needed. Using SimpleBLEPeripheral as an example, add the following paths:
$PROJ_DIR$\..\..\Profiles\SimpleProfile\CC254x $PROJ_DIR$\..\..\Profiles\Roles\CC254x However, do
not delete the original paths: $PROJ_DIR$\..\..\Profiles\SimpleProfile $PROJ_DIR$\..\..\Profiles\Roles
7. Replace the .c files that were affected by the changes in step 6 by deleting the old reference and
adding the new file. For example, delete peripheral.c from the SimpleBLEPeripheral project (under the
PROFILES group). Then add peripheral.c from $INSTALL$\Projects\ble\Profiles\Roles\CC254x.
8. Compile and save your project.
To Next Page
Loading...
Need help?
General
