Merge pull request #59 from chargebyte/everest/charge_som_recent_questions

Author: lategoodbye

docs/source/hardware.rst

@@ -209,8 +209,9 @@ The checksum is defined over:
 .. include:: safety_protocol.rst
 
 
+************************************
 EVerest Board Support Package Module
-====================================
+************************************
 
 chargebyte developed a comprehensive hardware abstraction module (HAL, or also called BSP module - board support package)
 for EVerest charging stack to support the Charge SOM platform. The module is called ``CbChargeSOMDriver`` and is
@@ -221,3 +222,27 @@ This module already implements the required communication protocol to interact w
 
 All Charge SOM boards ship with a Linux system preinstalled on eMMC, which also includes EVerest, the mentioned
 BSP module and example configuration files.
+
+**************
+I2C interfaces
+**************
+
+The i.MX93 on the Charge SOM provides several I2C interfaces:
+
++----------+------------+-------------------------------------+-----------------+
+| Hardware | Linux      | Usage                               | Clock frequency |
+|          |            |                                     |                 |
++==========+============+=====================================+=================+
+| I2C1     | i2c-0 [#]_ | on Single Channel DC Carrier Board: | 400 kHz         |
+|          |            | RTC (0x52)                          |                 |
++----------+------------+-------------------------------------+-----------------+
+| I2C2     | i2c-1      | on Charge SOM:                      | 400 kHz         |
+|          |            | Vertexcom MSE102x (0x4a, 0x72)      |                 |
++----------+------------+-------------------------------------+-----------------+
+| I2C3     | i2c-2      | on Charge SOM:                      | 400 kHz         |
+|          |            | PMIC (0x25) + EEPROM (0x50, 0x58)   |                 |
++----------+------------+-------------------------------------+-----------------+
+| I2C5     | disabled   |                                     | disabled        |
++----------+------------+-------------------------------------+-----------------+
+
+.. [#] This interface is only enabled in case of a Charge SOM Single Channel DC Carrier Board.

docs/source/troubleshooting.rst

@@ -40,6 +40,45 @@ and a `library <https://github.com/EVerest/everest-core/tree/main/lib/staging/ca
 which uses the CAN interface.
 
 
+What is the difference between CHSTOP_IN and SAFETY_ESTOPx?
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The signal CHSTOP_IN is connected to the i.MX93 SoC and could be used to gracefully stop the charging process. So it is not designed
+for timing critical use cases. Currently there is no EVerest module, which is able to handle this signal. This work is pending.
+
+In order to realize realtime emergency stop behavior use the SAFETY_ESTOPx signals, which are connected to the safety processor.
+
+
+Where can I find the device tree sources of the Charge SOM?
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The device tree sources of the Charge SOM are divided into multiple layers:
+
+.. list-table::
+   :header-rows: 1
+
+   * - Part
+     - Level
+     - Layer
+     - Filename
+   * - i.MX93
+     - 0
+     - SoC
+     - `imx93.dtsi <https://github.com/chargebyte/linux/blob/v6.6.23-2.0.0-phy-cb/arch/arm64/boot/dts/freescale/imx93.dtsi>`_
+   * - phyCORE-i.MX93
+     - 1
+     - SoM
+     - `imx93-phycore-som.dtsi <https://github.com/chargebyte/linux/blob/v6.6.23-2.0.0-phy-cb/arch/arm64/boot/dts/freescale/imx93-phycore-som.dtsi>`_
+   * - Charge SOM
+     - 2
+     - SoM
+     - `imx93-charge-som.dtsi <https://github.com/chargebyte/linux/blob/v6.6.23-2.0.0-phy-cb/arch/arm64/boot/dts/freescale/imx93-charge-som.dtsi>`_
+   * - Charge SOM Single Channel DC Carrier Board
+     - 3
+     - Board
+     - `imx93-charge-som-dc-evb.dts <https://github.com/chargebyte/linux/blob/v6.6.23-2.0.0-phy-cb/arch/arm64/boot/dts/freescale/imx93-charge-som-dc-evb.dts>`_
+
+
 How can I access the EVerest admin panel on Charge SOM?
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^