i2c: Elaborate API return values
i2c: Elaborate API return values

Elaborate the i2c API documentation with each of the errno codes that
can be returned on failure.

Change-Id: I28a690c06b94f724053238b5eba3142fcace23f6
Signed-off-by: Marcus Shawcroft <cf6354583ee83038f2010cbcbe1b1f2adb85107d@arm.com>

bboozzoo/zephyr,ldts/zephyr,Vudentz/zephyr,runchip/zephyr-cc3220,tidyjiang8/zephyr-doc,bboozzoo/zephyr,Vudentz/zephyr,galak/zephyr,GiulianoFranchetto/zephyr,aceofall/zephyr-iotos,ldts/zephyr,runchip/zephyr-cc3200,fbsder/zephyr,runchip/zephyr-cc3200,tidyjiang8/zephyr-doc,ldts/zephyr,GiulianoFranchetto/zephyr,Vudentz/zephyr,fractalclone/zephyr-riscv,tidyjiang8/zephyr-doc,pklazy/zephyr,rsalveti/zephyr,nashif/zephyr,erwango/zephyr,runchip/zephyr-cc3220,fbsder/zephyr,kraj/zephyr,finikorg/zephyr,mbolivar/zephyr,sharronliu/zephyr,explora26/zephyr,sharronliu/zephyr,zephyrproject-rtos/zephyr,fractalclone/zephyr-riscv,GiulianoFranchetto/zephyr,tidyjiang8/zephyr-doc,rsalveti/zephyr,runchip/zephyr-cc3220,runchip/zephyr-cc3200,holtmann/zephyr,holtmann/zephyr,bigdinotech/zephyr,kraj/zephyr,mbolivar/zephyr,bigdinotech/zephyr,punitvara/zephyr,ldts/zephyr,mbolivar/zephyr,rsalveti/zephyr,punitvara/zephyr,runchip/zephyr-cc3220,fractalclone/zephyr-riscv,galak/zephyr,Vudentz/zephyr,erwango/zephyr,Vudentz/zephyr,erwango/zephyr,fbsder/zephyr,pklazy/zephyr,bigdinotech/zephyr,nashif/zephyr,punitvara/zephyr,sharronliu/zephyr,punitvara/zephyr,pklazy/zephyr,aceofall/zephyr-iotos,explora26/zephyr,fractalclone/zephyr-riscv,explora26/zephyr,bboozzoo/zephyr,kraj/zephyr,tidyjiang8/zephyr-doc,holtmann/zephyr,rsalveti/zephyr,zephyriot/zephyr,nashif/zephyr,runchip/zephyr-cc3200,bigdinotech/zephyr,explora26/zephyr,finikorg/zephyr,zephyriot/zephyr,rsalveti/zephyr,finikorg/zephyr,GiulianoFranchetto/zephyr,kraj/zephyr,bboozzoo/zephyr,mbolivar/zephyr,Vudentz/zephyr,bigdinotech/zephyr,fbsder/zephyr,GiulianoFranchetto/zephyr,bboozzoo/zephyr,aceofall/zephyr-iotos,runchip/zephyr-cc3220,mbolivar/zephyr,aceofall/zephyr-iotos,kraj/zephyr,galak/zephyr,zephyrproject-rtos/zephyr,holtmann/zephyr,pklazy/zephyr,zephyriot/zephyr,zephyriot/zephyr,nashif/zephyr,galak/zephyr,holtmann/zephyr,zephyrproject-rtos/zephyr,erwango/zephyr,sharronliu/zephyr,aceofall/zephyr-iotos,fractalclone/zephyr-riscv,sharronliu/zephyr,explora26/zephyr,finikorg/zephyr,zephyriot/zephyr,finikorg/zephyr,runchip/zephyr-cc3200,zephyrproject-rtos/zephyr,punitvara/zephyr,erwango/zephyr,zephyrproject-rtos/zephyr,pklazy/zephyr,fbsder/zephyr,galak/zephyr,ldts/zephyr,nashif/zephyr