bindings: i2c: ti,mspm0g3xxx-i2c.yaml add watchdog

describe the watchdog timer property that will reset the mcu and the
i2c lines (to high) to avoid potential SCL stuck low issues

Signed-off-by: Dimitris Karnikis <[email protected]>

Author: dkarnikis

dts/bindings/i2c/ti,mspm0g3xxx-i2c.yaml

@@ -24,3 +24,16 @@ properties:
 
   pinctrl-names:
     required: true
+
+  watchdog-timer:
+    type: phandle
+    description: |
+      The type of the phandle object should be a counter device.
+      When the system is crashing, the I2C lines (SDA/SCL) are not being
+      reset and might stay LOW. To address this issue, we need to ensure that
+      none of the user i2c driver callbacks (that are doing reads or writes)
+      are taking longer than CONFIG_I2C_MSPM0G3XXX_WATCHDOG_TIMEOUT. So we
+      fire a timer before each call. If the callback doesn't finish fast
+      enough, the watchdog callback will reset the i2c lines, NACK the i2c
+      message and panic with the CONFIG_MSPM0G3XXX_I2C_WATCHDOG_PANIC_CODE
+      error code.