AnsweredAssumed Answered

Kinetis SDK v.1.3 API Reference Manual Rev.0 - the worst documentation I've ever seen !!!

Question asked by Piotr Fyda on Feb 12, 2016
Latest reply on Feb 22, 2016 by Michael Norman

Hello Freescale (or rather NXP) !

 

I've got impression, that the chapters in Kinetis SDK v.1.3 API Reference Manual.pdf  Rev.0 are mixed following the Monte Carlo principle !

 

Some examples:

 

You open Reset Control Module (RCM) and you land in Chapter 61 and 61.1 Overview of the module (it's OK).

But §61.2 is already SAI HAL driver - what a surprise!!

Chapter 61.5,6, etc. deal with SD card SPI and so on, and so on...

 

Similarly §64 deals with Serial Peripheral Interface (SPI)  but §64.2.1 talks about Signed Integer Operands in MMAU.

 

If you need details of SPI driver enumerations, you have to go (it is of course clear to everybody) to §13 Cyclic Redundancy Check (CRC).

There you find not only DSPI drivers (§13.8, 13.9, 13.10, 13.11) - but - what a luck ! - also details on DMA drivers and DAC drivers.

 

This means, everybody should simply read briefly all 2861 pages and make notes on where you can find what.

 

Additionally, working with KDS and KSDK is a horror:

 

- KDS 3.0.0 & KSDK 1.2.0 - no support for TWRK60D100 (only Code Warrior code)
    import of "Hello word" demo (CW) into KDS resulted in endless build-errors

 

- KDS 3.0.0 & KSDK 1.2.0 - is better already, if we forget Kinetis SDK v.1.3 API Reference Manual,
   but the simple "Hello word" demo for TWRK60D100 does not work if you switch to interrupt mode due to false definitions !!

 

I'm really thinking about changing the platform.

 

I'm happy, the weekend is coming, so I can get a distance to KDS stuff...

have a great weekend

Piotr

 

PS

maybe it would be better to offer less microcontroller types but better documentation ???

Outcomes