Update on Documentation change

RE: Update on Documentation change

bjorn-spockeli — Tue, 26 Nov 2019 02:34:48 GMT

Hi Paul,

Yes, I agree that this should have been updated a long time ago. I will bump the requests for updating the documentation in our internal issue database and raise the issue with the developers responsible for the FDS module.

Best regards

Bjørn

RE: Update on Documentation change

BEplane — Fri, 22 Nov 2019 21:19:32 GMT

When will this be updated in the documentation as it was reported 4 years ago? The update is about clearly documenting what is and is not experimental and why. And the related issues.

4 years seems plenty of time to clarify this in info center, instead of leaving everyone guessing and filling the forums with the same questions over time.

RE: Update on Documentation change

bjorn-spockeli — Wed, 20 Nov 2019 14:16:56 GMT

Yes, the functionality of FDS used by the Peer Manager to store bonding information is considered production ready.

Best regards

Bjørn

RE: Update on Documentation change

BEplane — Wed, 20 Nov 2019 13:59:22 GMT

To reword what you said, am I correct in my understanding that the examples use only the production ready features?

RE: Update on Documentation change

bjorn-spockeli — Wed, 20 Nov 2019 13:45:09 GMT

Hi Paul,

Yes, this has been a recurring topic over the years and the documentation has sadly not been updated for the release of SDK v16.0.0.

One of the main reasons for this module staying in experimental for so long( and still is), is that its difficult to create tests that cover all the different use-cases that the module may be used for by our customers and being able to do the tests in a timely manner.

Hence, we have focused on providing test coverage for the essential parts from a BLE perspective. So in broad strokes, the FDS functionality that is used by the Peer Manager is extensively tested through our SDK testing suite and should be considered production ready SW. The remaining functionality/features, e.g. the FDS_THREADS feature is still considered experimental, i.e. we have not enable this in the examples that are run through the testing suite.

We've also had some issues with FDS related to flash pages being corrupted if a power loss occurred at specific times during garbage collection, i.e. deletion of discarded records. This have been fixed in SDK v16.0.0 and is stated in the SDK release notes, which I recommend that you look through.

I hope that this clarified a bit.

Best regards

Bjørn