This page is a work document about STM32 I2C driver
RM0008 Reference manual ( page 726 )
We're implementing a "Master" driver.
The I2C peripheral on STM32 is very "timing sensitive".
It has been experienced that we can not rely on "events" like described in the reference manual and need to implement our own state machine in order to be able to deal with the timing sensitivity of the hardware.