Skip to content

Commit adcd7ec

Browse files
author
Cruz Monrreal
authored
Merge pull request #6742 from pan-/ble-update-cordio-porting-guide
BLE: Update cordio porting guide
2 parents 5b5c8dd + 2c8b9ab commit adcd7ec

File tree

1 file changed

+0
-47
lines changed

1 file changed

+0
-47
lines changed

features/FEATURE_BLE/targets/TARGET_CORDIO/doc/PortingGuide.md

Lines changed: 0 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -37,37 +37,6 @@ property of the target.
3737
}
3838
```
3939

40-
### Include prebuilt libraries
41-
42-
Last, the target shall also include the cordio libraries into the build.
43-
44-
Four prebuilt libraries are provided:
45-
* `wscore`: which contains the base component used by the Cordio stack.
46-
* `wsstack`: The BLE stack itself, if contains the GAP and GATT layer as well as
47-
the Security manager implementation.
48-
* `wssec`: The low level implementation of the security layer.
49-
* `wshci`: The HCI layer.
50-
51-
The `wssec` and `wshci` libraries are delivered in feature folders. It allows
52-
vendors to override those library if necessary. This can be required if the port
53-
use specific crypto routine or require an highly modified HCI layer.
54-
55-
To include the default library in the target, the features have to be added in
56-
this list of the features of the target:
57-
* `WSSEC`: Include the default `wssec` library.
58-
* `WSHCI`: Include the default `wshci` library.
59-
60-
The target should also compile the sources of the BLE Cordio port. It is
61-
achieved by adding the string `CORDIO` in the list of the `extra_labels`
62-
property of the target.
63-
64-
```json
65-
"TARGET_NAME": {
66-
"extra_labels": ["target extra labels ...", "CORDIO"],
67-
"features": ["target features ...", "BLE", "WSHCI", "WSSEC"]
68-
}
69-
```
70-
7140
## CordioHCIDriver implementation:
7241

7342
A port shall include an HCI driver for the BLE module used by the target and
@@ -520,22 +489,6 @@ ble::vendor::cordio::CordioHCIDriver& ble_cordio_get_hci_driver() {
520489
}
521490
```
522491

523-
## Examples
524-
525-
Implementation examples might be found for:
526-
* [ST BlueNRG module](../../TARGET_NUCLEO_F401RE/BlueNrgHCIDriver.cpp): It uses
527-
a custom transport driver and a vendor specific is sent right after the answer
528-
to the reset command to switch the controller to link layer mode only.
529-
* [EM9301 module](../../TARGET_Maxim/TARGET_MAX32620HSP/EM9301HCIDriver.cpp):
530-
it uses a custom transport driver and doesn't doesn't send the command *Set
531-
Event Mask Page 2* to the controller during the reset sequence because this
532-
command is not supported by the controller.
533-
* [PAN1326](../../TARGET_Maxim/TARGET_MAX32630FTHR/CC2564HCIDriver.cpp): It
534-
uses the H4 transport driver. The reset sequence start by sending a
535-
*service pack* then once the service pack has been transferred it continue
536-
with the regular reset sequence.
537-
538-
539492

540493

541494

0 commit comments

Comments
 (0)