diff --git a/doc/source/img/mb.2024.x.x/29bis.jpg b/doc/source/img/mb.2024.x.x/29bis.jpg new file mode 100644 index 0000000000000000000000000000000000000000..afb8d2bb416add70fe05c7867c081fa8be07a82e Binary files /dev/null and b/doc/source/img/mb.2024.x.x/29bis.jpg differ diff --git a/doc/source/source_rst/hardware/mb/mb_2024.rst b/doc/source/source_rst/hardware/mb/mb_2024.rst index 058c516ae926cb5233768ad0b24049d21a81bfaa..0669cff61beb12e5c36fa7051754f78e38b51c26 100644 --- a/doc/source/source_rst/hardware/mb/mb_2024.rst +++ b/doc/source/source_rst/hardware/mb/mb_2024.rst @@ -1,6 +1,7 @@ .. warning:: **OhmPi is a participative project open to all, it requires skills in electronics and to respect the safety rules. OhmPi must be assembled in a professional context and by people competent in electronics. The OhmPi team cannot be held responsible for any material or human damage which would be associated with the use or the assembly of OHMPI. The OhmPi team cannot be held responsible if the equipment does not work after assembly.** +.. _mb2024-build: Build measurement board v2024 ============================= @@ -15,7 +16,7 @@ it provides electrical isolation for the Vmn measurement set. This isolation all :height: 450px :alt: alternate text :figclass: align-center - + Assembly of the measurement board --------------------------------- @@ -420,17 +421,23 @@ What is an `analogue switch <https://en.wikipedia.org/wiki/Analogue_switch>`_? | | | +--------+-------------------------------------------------------------------+ + .. table:: :align: center +--------+-------------------------------------------------------------------+ - | | .. image:: ../../../img/mb.2024.x.x/29.jpg | + | | .. image:: ../../../img/mb.2024.x.x/29bis.jpg | | 29 +-------------------------------------------------------------------+ | | Place the I2C isolator add-on board | | | **make sure you have right selection** according to the red box | | | | +--------+-------------------------------------------------------------------+ + +.. note:: + If you have issues with the I2C isolator (e.g. 0x49 and 0x27 are not visible), you may need + to remove the pull-up resistor on the I2C isolator as shown above. + .. table:: :align: center @@ -445,6 +452,7 @@ What is an `analogue switch <https://en.wikipedia.org/wiki/Analogue_switch>`_? .. _mb2024-test: + Check measurement board v2024 ============================= diff --git a/doc/source/source_rst/troubleshooting.rst b/doc/source/source_rst/troubleshooting.rst index 12f7851d9d6eb2642961ea12fdddcf4db9cb6be3..16678fa7f1629374174679f3126787288e17db0f 100644 --- a/doc/source/source_rst/troubleshooting.rst +++ b/doc/source/source_rst/troubleshooting.rst @@ -26,13 +26,15 @@ Another possibility is that the MN voltage you are trying to measure is **over t In the measurement board v2024, the current sensing part is replaced by a click board. It is possible that the shunt resistance on this click board is burned due to malfunction. In this case, erroneous value of current will be given. The click board must be replaced to solve the issue. -Communication issue between components -====================================== +Communication issue between components (I2C, pull-up) +===================================================== + +If you get an I2C communication error or cannot see some I2C address with `i2cdetect`. Most components of the OhmPi communicate via I2C protocol. This protocol works with two lines (SDA and SCL) that **must be pulled-up** at rest. The pull-up resistor consist in placing a 100k (or similar values) resistor between the line and VDD (5V in this case). Check with the multimeter the voltage between SDA/SCL and the ground to see if it reaches 5V at rest. If it's not the case, you may need stronger pull-up (smaller value of pull-up resistor). .. note:: - On the measurement board v2024, the I2C isolator from Mikroe, already has pull-up that adds to the pull-up already on the ADS1115 board. If the ADS1115 of the Vmn part cannot be seen by i2cdetect, we recommend to remove the pull-up resistors on the Mikroe I2C isolator board. + On the measurement board v2024, the I2C isolator from Mikroe, already has pull-up that adds to the pull-up already on the ADS1115 board. If the ADS1115 of the Vmn part cannot be seen by i2cdetect, we recommend to remove the pull-up resistors on the Mikroe I2C isolator board (see note fig29 in :ref:`mb2024-build`)