[feature-nrf528xx] Update analogin_api.c for NRF52 SDK 14.2

[marcuschangarm]

Use new SDK API and fixed return value to be normalized to 16 bit as per the Mbed HAL specification.

[0xc0170]

/morph build

[0xc0170]

Why are we adding doxygen docs to implementation (analogin HAL has it defined already, duplication not needed)

[mbed-ci]

Build : FAILURE

Build number : 1274
Build artifacts/logs : http://mbed-os.s3-website-eu-west-1.amazonaws.com/?prefix=builds/6223/

[marcuschangarm]

Why are we adding doxygen docs to implementation (analogin HAL has it defined already, duplication not needed)

For consistency. It would be weird to have comments on the internal functions in the implementation and not all of them.

[marcuschangarm]

/morph build

[mbed-ci]

Build : SUCCESS

Build number : 1287
Build artifacts/logs : http://mbed-os.s3-website-eu-west-1.amazonaws.com/?prefix=builds/6223/

Triggering tests

/morph test
/morph uvisor-test
/morph export-build
/morph mbed2-build

[mbed-ci]

Exporter Build : SUCCESS

Build number : 951
Build artifacts/logs : http://mbed-os.s3-website-eu-west-1.amazonaws.com/?prefix=builds/exporter/6223/

[mbed-ci]

Test : SUCCESS

Build number : 1076
Test logs :http://mbed-os-logs.s3-website-us-west-1.amazonaws.com/?prefix=logs/6223/1076

[cmonr]

@0xc0170 I merged this in to keep things rolling, and its only targeting a feature branch.

@marcuschangarm will update the comment to remove the duplicate doxygen in a future PR.