diff --git a/doc/source/img/new/20231019_102427.jpg b/doc/source/img/new/20231019_102427.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..86a846193b3955a941dc3e16e071880ac1878b79
Binary files /dev/null and b/doc/source/img/new/20231019_102427.jpg differ
diff --git a/doc/source/img/new/20231019_102839.jpg b/doc/source/img/new/20231019_102839.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..c3a6b6253666c16849481bf3736ed98ebe9934ee
Binary files /dev/null and b/doc/source/img/new/20231019_102839.jpg differ
diff --git a/doc/source/img/new/20231019_103353.jpg b/doc/source/img/new/20231019_103353.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..8567b3ce6c5742abb1781434a2d23b5f2a2f202e
Binary files /dev/null and b/doc/source/img/new/20231019_103353.jpg differ
diff --git a/doc/source/img/new/20231019_123544.jpg b/doc/source/img/new/20231019_123544.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..0b444c253b77f32f83d656ed36cfb2e2d66292f7
Binary files /dev/null and b/doc/source/img/new/20231019_123544.jpg differ
diff --git a/doc/source/img/new/20231019_124640.jpg b/doc/source/img/new/20231019_124640.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..6db577a9c14d0aba375abfc7b4d6c8690ee72660
Binary files /dev/null and b/doc/source/img/new/20231019_124640.jpg differ
diff --git a/doc/source/img/new/20231019_151809.jpg b/doc/source/img/new/20231019_151809.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..e2f5adf724d3212f50415c0cc34b03cc592a6460
Binary files /dev/null and b/doc/source/img/new/20231019_151809.jpg differ
diff --git a/doc/source/img/new/20231019_152249.jpg b/doc/source/img/new/20231019_152249.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..9e2875525cdd4df9e3d47dcba3b1c7078501c825
Binary files /dev/null and b/doc/source/img/new/20231019_152249.jpg differ
diff --git a/doc/source/img/new/20231019_152251.jpg b/doc/source/img/new/20231019_152251.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..13fadb6789e524ec1a3f636f700f985e1e3287d0
Binary files /dev/null and b/doc/source/img/new/20231019_152251.jpg differ
diff --git a/doc/source/img/new/20231019_154223.jpg b/doc/source/img/new/20231019_154223.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..5bf67263f3a74c4aadbaddaf7d01518587705969
Binary files /dev/null and b/doc/source/img/new/20231019_154223.jpg differ
diff --git a/doc/source/img/new/20231019_154224.jpg b/doc/source/img/new/20231019_154224.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..7775359b036ea16c4fd62fe4ba633f99e482fb10
Binary files /dev/null and b/doc/source/img/new/20231019_154224.jpg differ
diff --git a/doc/source/img/new/20231019_154723.jpg b/doc/source/img/new/20231019_154723.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..5285a248b8544e1770b9ebe909e360339e067242
Binary files /dev/null and b/doc/source/img/new/20231019_154723.jpg differ
diff --git a/doc/source/img/new/20231019_160953.jpg b/doc/source/img/new/20231019_160953.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..3e47cca3e5236f2c9b6782bb8d345fb0eff20292
Binary files /dev/null and b/doc/source/img/new/20231019_160953.jpg differ
diff --git a/doc/source/img/new/20231019_160954.jpg b/doc/source/img/new/20231019_160954.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..f653476f8266d23e39b38bf09b531d16e0704fed
Binary files /dev/null and b/doc/source/img/new/20231019_160954.jpg differ
diff --git a/doc/source/img/new/20231019_162109.jpg b/doc/source/img/new/20231019_162109.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..55204f59ed5e86cfc32a8ce11a26e3b3eb1ea38c
Binary files /dev/null and b/doc/source/img/new/20231019_162109.jpg differ
diff --git a/doc/source/img/new/20231019_162110.jpg b/doc/source/img/new/20231019_162110.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..8a45c76b1e1953a99889617d4fff86f4e24e64f4
Binary files /dev/null and b/doc/source/img/new/20231019_162110.jpg differ
diff --git a/doc/source/img/new/20231019_163854.jpg b/doc/source/img/new/20231019_163854.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..5e3feecb6f40302c9506fd2c543424ded3d90c8c
Binary files /dev/null and b/doc/source/img/new/20231019_163854.jpg differ
diff --git a/doc/source/img/new/20231019_163855.jpg b/doc/source/img/new/20231019_163855.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..27713c5482a5ea8037a8df8a38b5aa3a19dfd9f5
Binary files /dev/null and b/doc/source/img/new/20231019_163855.jpg differ
diff --git a/doc/source/img/new/20231019_164854.jpg b/doc/source/img/new/20231019_164854.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..5f69a9dab02add32830f56011c2c52bf27e46e03
Binary files /dev/null and b/doc/source/img/new/20231019_164854.jpg differ
diff --git a/doc/source/img/new/20231019_164856.jpg b/doc/source/img/new/20231019_164856.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..b1af7157396a7c3d9231bfae9ca6bd43b0dbcb83
Binary files /dev/null and b/doc/source/img/new/20231019_164856.jpg differ
diff --git a/doc/source/img/new/20231019_165752.jpg b/doc/source/img/new/20231019_165752.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..0a416829c846ca3ab48ec7b4b5538350420c3528
Binary files /dev/null and b/doc/source/img/new/20231019_165752.jpg differ
diff --git a/doc/source/img/new/20231019_165753.jpg b/doc/source/img/new/20231019_165753.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..d18d6ba5351f41459deb9b4d5c9f52d7a8c6c526
Binary files /dev/null and b/doc/source/img/new/20231019_165753.jpg differ
diff --git a/doc/source/img/new/20231019_170109.jpg b/doc/source/img/new/20231019_170109.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..d328112f125d6ef44bf4d5f950d04e05b520edac
Binary files /dev/null and b/doc/source/img/new/20231019_170109.jpg differ
diff --git a/doc/source/img/new/20231019_170110.jpg b/doc/source/img/new/20231019_170110.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..45d79a77f24cdf3fa873a928cf327ec301603df8
Binary files /dev/null and b/doc/source/img/new/20231019_170110.jpg differ
diff --git a/doc/source/img/new/20231019_171229.jpg b/doc/source/img/new/20231019_171229.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..55c139bedad0690a753a1e03707d569dbe757674
Binary files /dev/null and b/doc/source/img/new/20231019_171229.jpg differ
diff --git a/doc/source/img/new/20231019_171231.jpg b/doc/source/img/new/20231019_171231.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..54eb77abeaa99a7c60a8ac6220ed1bf35f2af601
Binary files /dev/null and b/doc/source/img/new/20231019_171231.jpg differ
diff --git a/doc/source/img/new/20231019_172357.jpg b/doc/source/img/new/20231019_172357.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..76822e89c2150dbcb90e57b37c040204c3ab9079
Binary files /dev/null and b/doc/source/img/new/20231019_172357.jpg differ
diff --git a/doc/source/img/new/20231019_172358.jpg b/doc/source/img/new/20231019_172358.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..60611d8b2cec1ef6f0a243b28e76324c4c3c3484
Binary files /dev/null and b/doc/source/img/new/20231019_172358.jpg differ
diff --git a/doc/source/img/new/20231019_173440.jpg b/doc/source/img/new/20231019_173440.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..cdbe7164ecacc15dd4e4dfc1c9a76a5279302a13
Binary files /dev/null and b/doc/source/img/new/20231019_173440.jpg differ
diff --git a/doc/source/img/new/20231019_173711.jpg b/doc/source/img/new/20231019_173711.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..fd8bc9fe9beae9768e967d71c36e03023c865b0f
Binary files /dev/null and b/doc/source/img/new/20231019_173711.jpg differ
diff --git a/doc/source/img/new/20231019_174050.jpg b/doc/source/img/new/20231019_174050.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..4ff1cf57f521b758bd5e31f5c867fa390ad697fc
Binary files /dev/null and b/doc/source/img/new/20231019_174050.jpg differ
diff --git a/doc/source/img/new/20231019_174051.jpg b/doc/source/img/new/20231019_174051.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..be13f5d552ce8621b51940810d92b84843f36b80
Binary files /dev/null and b/doc/source/img/new/20231019_174051.jpg differ
diff --git a/doc/source/img/new/20231019_174333.jpg b/doc/source/img/new/20231019_174333.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..4b7235351e1f7f27a9a413a5b11c95c9a2b844eb
Binary files /dev/null and b/doc/source/img/new/20231019_174333.jpg differ
diff --git a/doc/source/img/new/20231019_174804.jpg b/doc/source/img/new/20231019_174804.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..950126b6fa44b2a4164bb6017299cab8b7696df4
Binary files /dev/null and b/doc/source/img/new/20231019_174804.jpg differ
diff --git a/doc/source/img/new/20231019_175448.jpg b/doc/source/img/new/20231019_175448.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..f3410b4e3405b5f48da504faa31c9576114f362c
Binary files /dev/null and b/doc/source/img/new/20231019_175448.jpg differ
diff --git a/doc/source/img/new/20231019_175449.jpg b/doc/source/img/new/20231019_175449.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..7f51e34e9d42ebbef6f01f73bb779e12fbb193eb
Binary files /dev/null and b/doc/source/img/new/20231019_175449.jpg differ
diff --git a/doc/source/img/new/20231019_180040.jpg b/doc/source/img/new/20231019_180040.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..587971e7d22bcdc825be09ad76b8aab97a229f27
Binary files /dev/null and b/doc/source/img/new/20231019_180040.jpg differ
diff --git a/doc/source/img/new/20231019_180042.jpg b/doc/source/img/new/20231019_180042.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..52e204d9a435af5d3ef118f791e5bcde4bfea4ce
Binary files /dev/null and b/doc/source/img/new/20231019_180042.jpg differ
diff --git a/doc/source/img/new/20231019_180210.jpg b/doc/source/img/new/20231019_180210.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..223d109684516789282f2627f182bd334040d9bc
Binary files /dev/null and b/doc/source/img/new/20231019_180210.jpg differ
diff --git a/doc/source/img/new/20231019_180421.jpg b/doc/source/img/new/20231019_180421.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..f10040178685ea408e959625feba2dd1c6da2f15
Binary files /dev/null and b/doc/source/img/new/20231019_180421.jpg differ
diff --git a/doc/source/img/new/20231019_180422.jpg b/doc/source/img/new/20231019_180422.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..2d825c3c550bdd5264f72943ffb363579b41c162
Binary files /dev/null and b/doc/source/img/new/20231019_180422.jpg differ
diff --git a/doc/source/img/new/20231019_180520.jpg b/doc/source/img/new/20231019_180520.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..e506af37ae39bcafc9264a0c33997e84f716473c
Binary files /dev/null and b/doc/source/img/new/20231019_180520.jpg differ
diff --git a/doc/source/img/new/20231019_180521.jpg b/doc/source/img/new/20231019_180521.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..47e1026a4565f777bd3b145866a4383697e1b30c
Binary files /dev/null and b/doc/source/img/new/20231019_180521.jpg differ
diff --git a/doc/source/img/new/20231019_180845.jpg b/doc/source/img/new/20231019_180845.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..1f06ceff8acd1240df9826b0874e1c4e99dd5e99
Binary files /dev/null and b/doc/source/img/new/20231019_180845.jpg differ
diff --git a/doc/source/img/new/20231019_180846.jpg b/doc/source/img/new/20231019_180846.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..06a2a21f68b1702202326b0e08e29049c2898596
Binary files /dev/null and b/doc/source/img/new/20231019_180846.jpg differ
diff --git a/doc/source/img/new/20231019_181102.jpg b/doc/source/img/new/20231019_181102.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..897ef81c773dbd088e7f1589bcd31ccc1ba5bade
Binary files /dev/null and b/doc/source/img/new/20231019_181102.jpg differ
diff --git a/doc/source/img/new/20231019_181408.jpg b/doc/source/img/new/20231019_181408.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..a86cff50729d13143bda849580e9fcc8be7925b2
Binary files /dev/null and b/doc/source/img/new/20231019_181408.jpg differ
diff --git a/doc/source/img/new/20231019_181409.jpg b/doc/source/img/new/20231019_181409.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..d3bcd02fc789f5a1d9a34c58356e92659fed73f8
Binary files /dev/null and b/doc/source/img/new/20231019_181409.jpg differ
diff --git a/doc/source/img/new/20231019_181410.jpg b/doc/source/img/new/20231019_181410.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..97f676d946447250022125775a6c9bdbcff85bc9
Binary files /dev/null and b/doc/source/img/new/20231019_181410.jpg differ
diff --git a/doc/source/img/new/20231019_181930.jpg b/doc/source/img/new/20231019_181930.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..f5d7c584373e5cdf02c5f7faa6f517b7bb0d534c
Binary files /dev/null and b/doc/source/img/new/20231019_181930.jpg differ
diff --git a/doc/source/img/new/20231019_181931.jpg b/doc/source/img/new/20231019_181931.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..8a1bb957f4e6dbe4a1d0f1798d950c1c2c0ee4a1
Binary files /dev/null and b/doc/source/img/new/20231019_181931.jpg differ
diff --git a/doc/source/sch.csv b/doc/source/sch.csv
new file mode 100644
index 0000000000000000000000000000000000000000..765b2405aae32a72ee1162e0b9a289d84f8a95bc
--- /dev/null
+++ b/doc/source/sch.csv
@@ -0,0 +1,99 @@
+"# Quad.",Ca,Cb,Pm,Pn,"Spac. Coef",Level,Depth,"K factor"
+1,1,16,6,11,5,5,13.11,157.08
+2,1,15,6,10,4,5,12.46,176.71
+3,1,13,5,9,4,4,10.49,125.66
+4,1,16,7,10,3,6,13.79,282.74
+5,1,14,6,9,3,5,11.82,209.44
+6,1,12,5,8,3,4,9.84,146.61
+7,1,10,4,7,3,3,7.86,94.25
+8,1,15,7,9,2,6,13.12,376.99
+9,1,13,6,8,2,5,11.16,274.89
+10,1,11,5,7,2,4,9.19,188.50
+11,1,9,4,6,2,3,7.22,117.81
+12,1,7,3,5,2,2,5.24,62.83
+13,1,12,6,7,1,5,10.46,471.24
+14,1,10,5,6,1,4,8.52,314.16
+15,1,8,4,5,1,3,6.56,188.50
+16,1,6,3,4,1,2,4.60,94.25
+17,1,4,2,3,1,1,2.62,31.42
+18,2,16,7,11,4,5,12.46,176.71
+19,2,14,6,10,4,4,10.49,125.66
+20,2,15,7,10,3,5,11.82,209.44
+21,2,13,6,9,3,4,9.84,146.61
+22,2,11,5,8,3,3,7.86,94.25
+23,2,16,8,10,2,6,13.12,376.99
+24,2,14,7,9,2,5,11.16,274.89
+25,2,12,6,8,2,4,9.19,188.50
+26,2,10,5,7,2,3,7.22,117.81
+27,2,8,4,6,2,2,5.24,62.83
+28,2,13,7,8,1,5,10.46,471.24
+29,2,11,6,7,1,4,8.52,314.16
+30,2,9,5,6,1,3,6.56,188.50
+31,2,7,4,5,1,2,4.60,94.25
+32,2,5,3,4,1,1,2.62,31.42
+33,3,15,7,11,4,4,10.49,125.66
+34,3,16,8,11,3,5,11.82,209.44
+35,3,14,7,10,3,4,9.84,146.61
+36,3,12,6,9,3,3,7.86,94.25
+37,3,15,8,10,2,5,11.16,274.89
+38,3,13,7,9,2,4,9.19,188.50
+39,3,11,6,8,2,3,7.22,117.81
+40,3,9,5,7,2,2,5.24,62.83
+41,3,14,8,9,1,5,10.46,471.24
+42,3,12,7,8,1,4,8.52,314.16
+43,3,10,6,7,1,3,6.56,188.50
+44,3,8,5,6,1,2,4.60,94.25
+45,3,6,4,5,1,1,2.62,31.42
+46,4,16,8,12,4,4,10.49,125.66
+47,4,15,8,11,3,4,9.84,146.61
+48,4,13,7,10,3,3,7.86,94.25
+49,4,16,9,11,2,5,11.16,274.89
+50,4,14,8,10,2,4,9.19,188.50
+51,4,12,7,9,2,3,7.22,117.81
+52,4,10,6,8,2,2,5.24,62.83
+53,4,15,9,10,1,5,10.46,471.24
+54,4,13,8,9,1,4,8.52,314.16
+55,4,11,7,8,1,3,6.56,188.50
+56,4,9,6,7,1,2,4.60,94.25
+57,4,7,5,6,1,1,2.62,31.42
+58,5,16,9,12,3,4,9.84,146.61
+59,5,14,8,11,3,3,7.86,94.25
+60,5,15,9,11,2,4,9.19,188.50
+61,5,13,8,10,2,3,7.22,117.81
+62,5,11,7,9,2,2,5.24,62.83
+63,5,16,10,11,1,5,10.46,471.24
+64,5,14,9,10,1,4,8.52,314.16
+65,5,12,8,9,1,3,6.56,188.50
+66,5,10,7,8,1,2,4.60,94.25
+67,5,8,6,7,1,1,2.62,31.42
+68,6,15,9,12,3,3,7.86,94.25
+69,6,16,10,12,2,4,9.19,188.50
+70,6,14,9,11,2,3,7.22,117.81
+71,6,12,8,10,2,2,5.24,62.83
+72,6,15,10,11,1,4,8.52,314.16
+73,6,13,9,10,1,3,6.56,188.50
+74,6,11,8,9,1,2,4.60,94.25
+75,6,9,7,8,1,1,2.62,31.42
+76,7,16,10,13,3,3,7.86,94.25
+77,7,15,10,12,2,3,7.22,117.81
+78,7,13,9,11,2,2,5.24,62.83
+79,7,16,11,12,1,4,8.52,314.16
+80,7,14,10,11,1,3,6.56,188.50
+81,7,12,9,10,1,2,4.60,94.25
+82,7,10,8,9,1,1,2.62,31.42
+83,8,16,11,13,2,3,7.22,117.81
+84,8,14,10,12,2,2,5.24,62.83
+85,8,15,11,12,1,3,6.56,188.50
+86,8,13,10,11,1,2,4.60,94.25
+87,8,11,9,10,1,1,2.62,31.42
+88,9,15,11,13,2,2,5.24,62.83
+89,9,16,12,13,1,3,6.56,188.50
+90,9,14,11,12,1,2,4.60,94.25
+91,9,12,10,11,1,1,2.62,31.42
+92,10,16,12,14,2,2,5.24,62.83
+93,10,15,12,13,1,2,4.60,94.25
+94,10,13,11,12,1,1,2.62,31.42
+95,11,16,13,14,1,2,4.60,94.25
+96,11,14,12,13,1,1,2.62,31.42
+97,12,15,13,14,1,1,2.62,31.42
+98,13,16,14,15,1,1,2.62,31.42
diff --git a/doc/source/source_rst/V2023.x.x/V2023_step_03.rst b/doc/source/source_rst/V2023.x.x/V2023_step_03.rst
new file mode 100644
index 0000000000000000000000000000000000000000..46f3a442611cef70a76ba0adc8ae2c92e45ec5bb
--- /dev/null
+++ b/doc/source/source_rst/V2023.x.x/V2023_step_03.rst
@@ -0,0 +1,289 @@
+
+
+.. 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.**
+
+
+
+**STEP n°3:** MUX board
+****************************************************
+The multiplexing of the channels is a mechanical multiplexing based on OMRON's manufacturing relays (G5LE-1-VD 12 VDC). Each relay is combined with
+a ZVN4206A power MOFSET. The raspberry has only 30 GPIOs, which is not enough to activate all the 64 electrodes, which represent 512 GPIOs.
+We used gpio expander I2C (MCP23017). We have associated these components with an I2C multiplexer of type type TCA9548A from adafruit.
+This combination allows to go up to 512 GPIOs and up to 128 electrodes. Each card has its own digital address between 0X70 and 0X77.
+In the following presentation for an OhmPi 64 electrodes, we will use the addresses 0X70 for channel A, 0X71 for channel B, 0X72 for channel M and 0X73 for channel N.
+0X73 for the N channel. 4 MUX board will be needed to multiplex an OhmPi 64 electrodes.
+
+**PART A** Assembly of MUX board
+======================================================
+
+
+Required components
+----------------------------------------------------
+
+.. figure:: ../../img/v2023.x.x/step_n_3/a/MUX_board_components.jpg
+ :width: 600px
+ :align: center
+ :height: 650px
+ :alt: alternate text
+ :figclass: align-center
+
+
+.. csv-table:: List of components
+ :file: ../../img/v2023.x.x/step_n_3/MUX_board_list_2_xx.csv
+ :widths: 30, 70, 70, 70, 70, 35, 35
+ :header-rows: 1
+
+
+.. table::
+ :align: center
+
+ +--------+--------------------------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/a/MUX_00.jpg |
+ | 1 +--------------------------------------------------------------------------------+
+ | |Mux board pcb |
+ | | |
+ +--------+--------------------------------------------------------------------------------+
+
+.. table::
+ :align: center
+
+ +--------+------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/a/MUX_01.jpg |
+ | 2 +------------------------------------------------------------+
+ | |Installation of the 100 kOhm resistors |
+ | | |
+ +--------+------------------------------------------------------------+
+
+.. table::
+ :align: center
+
+ +--------+------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/a/MUX_02.jpg |
+ | 3 +------------------------------------------------------------+
+ | |Installation of the MOSFET ZVN4206A |
+ | | |
+ +--------+------------------------------------------------------------+
+
+
+.. table::
+ :align: center
+
+ +--------+------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/a/MUX_03.jpg |
+ | 4 +------------------------------------------------------------+
+ | |Installation of the diode 1N4007 |
+ | | |
+ +--------+------------------------------------------------------------+
+
+.. table::
+ :align: center
+
+ +--------+------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/a/MUX_04.jpg |
+ | 5 +------------------------------------------------------------+
+ | |Installation of the relay |
+ | | |
+ +--------+------------------------------------------------------------+
+
+.. table::
+ :align: center
+
+ +--------+------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/a/MUX_05.jpg |
+ | 6 +------------------------------------------------------------+
+ | |Installation of the terminal screw |
+ | | |
+ +--------+------------------------------------------------------------+
+
+.. table::
+ :align: center
+
+ +--------+------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/a/MUX_06.jpg |
+ | 7 +------------------------------------------------------------+
+ | |Installation of generic male header |
+ | | |
+ +--------+------------------------------------------------------------+
+
+.. table::
+ :align: center
+
+ +--------+------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/a/MUX_07.jpg |
+ | 8 +------------------------------------------------------------+
+ | |Installation of Pin strip (6 pins) and pin strip (16 pins) |
+ | | |
+ +--------+------------------------------------------------------------+
+
+.. table::
+ :align: center
+
+ +--------+------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/a/MUX_08.jpg |
+ | 9 +------------------------------------------------------------+
+ | |Installation of DIP Dual In Line Socket 2*14 |
+ | | |
+ +--------+------------------------------------------------------------+
+
+.. table::
+ :align: center
+
+ +--------+------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/a/MUX_09.jpg |
+ | 10 +------------------------------------------------------------+
+ | |Installation of Adafruit TCA9548A |
+ | | |
+ +--------+------------------------------------------------------------+
+
+.. table::
+ :align: center
+
+ +--------+------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/a/MUX_10.jpg |
+ | 10 +------------------------------------------------------------+
+ | |Installation of MCP23017 |
+ | | |
+ +--------+------------------------------------------------------------+
+
+.. note::
+ This step must be duplicated 4 times for every Mux card.
+
+
+**PART B** MUX board address
+======================================================
+To build an ohmpi it is necessary to have 4 MUX boards, with 4 different addresses. It is therefore necessary to identify each board, by assigning an address, which will be allocated in the OhmPi code.
+We present here the addresses selected by default.
+
+For the A electrode board, we suggest addressing it with address 0x70:
+
+.. table::
+ :align: center
+
+ +--------+------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/b/A_0x70.jpg |
+ | 1 +------------------------------------------------------------+
+ | |Mount the jumpers and note the value of the address and the |
+ | |electrode name on the mux board (A). |
+ | +------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/b/A_0x70-a.jpg |
+ | +------------------------------------------------------------+
+ | |Zoom on the jumper |
+ | | |
+ +--------+------------------------------------------------------------+
+
+
+
+
+For the B electrode board, we suggest addressing it with address 0x71:
+
+.. table::
+ :align: center
+
+ +--------+------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/b/B_0x71.jpg |
+ | 2 +------------------------------------------------------------+
+ | |Mount the jumpers and note the value of the address and the |
+ | |electrode name on the mux board (B). |
+ | +------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/b/B_0x71-a.jpg |
+ | +------------------------------------------------------------+
+ | |Zoom on the jumper |
+ | | |
+ +--------+------------------------------------------------------------+
+
+For the N electrode board, we suggest addressing it with address 0x72:
+
+.. table::
+ :align: center
+
+ +--------+------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/b/M_0x72.jpg |
+ | 3 +------------------------------------------------------------+
+ | |Mount the jumpers and note the value of the address and the |
+ | |electrode name on the mux board (B). |
+ | +------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/b/M_0x72-a.jpg |
+ | +------------------------------------------------------------+
+ | |Zoom on the jumper |
+ | | |
+ +--------+------------------------------------------------------------+
+
+For the M electrode board, we suggest addressing it with address 0x73:
+
+.. table::
+ :align: center
+
+ +--------+------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/b/N_0x73.jpg |
+ | 4 +------------------------------------------------------------+
+ | |Mount the jumpers and note the value of the address and the |
+ | |electrode name on the mux board (B). |
+ | +------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/b/N_0x73-a.jpg |
+ | +------------------------------------------------------------+
+ | |Zoom on the jumper |
+ | | |
+ +--------+------------------------------------------------------------+
+
+**PART C** Validation of MUX board
+======================================================
+The first step is to test the Mux boards before assembling them definitively.
+To test the Mux boards, it will be necessary first to make a simplified assembly of the Mux board and the measurement board.
+
+The first thing to do is to prepare a 50 cm long flat wire with two 6-poles connectors.
+
+
+ +--------+-----------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/c/20211207_115706.jpg |
+ | 1 +-----------------------------------------------------------------+
+ | |Build a cable with 6 contacts with 6 pins connector. |
+ | | |
+ +--------+-----------------------------------------------------------------+
+
+ +--------+-----------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/c/20220124_142929.jpg |
+ | 2 +-----------------------------------------------------------------+
+ | |Prepare the measurement board and the first mux board by |
+ | |example the card with address 0x71. |
+ +--------+-----------------------------------------------------------------+
+
+ +--------+-----------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/c/20220124_143105.jpg |
+ | 3 +-----------------------------------------------------------------+
+ | |Connect the 12V power supply cables to the MUX board |
+ | |without powering the board. |
+ +--------+-----------------------------------------------------------------+
+
+ +--------+------------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/c/20220207_154111.jpg |
+ | 4 +------------------------------------------------------------------+
+ | |Connect the 12V power supply screw terminal of the mux |
+ | |board to the 12V screw terminal power supply of the |
+ | |measurement board. |
+ +--------+------------------------------------------------------------------+
+
+ +--------+------------------------------------------------------------------+
+ | | .. image:: ../../img/v2023.x.x/step_n_3/c/20220124_143823.jpg |
+ | 5 +------------------------------------------------------------------+
+ | |Connect the 6-contact cable |
+ | | |
+ +--------+------------------------------------------------------------------+
+
+
+Start your 12V power supply, the raspberry must start.
+
+Run the terminal and write:
+
+ .. code-block:: python
+
+ i2cdetect -y 1
+
+Three addresses should appear, including the address of the MUX board you have selected. This implies that your board has been detected.
+
+Open the script called "test_mux_board.py".
+
+Run the script
+
+
+
\ No newline at end of file
diff --git a/doc/source/source_rst/V2024.x.x/V2024.rst b/doc/source/source_rst/V2024.x.x/V2024.rst
new file mode 100644
index 0000000000000000000000000000000000000000..b8c92ae3325dfccbb51c03c087c3bca30b3a67bd
--- /dev/null
+++ b/doc/source/source_rst/V2024.x.x/V2024.rst
@@ -0,0 +1,326 @@
+********************************************
+OhmPi V2023 (64 electrodes and 12V)
+********************************************
+
+.. 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.**
+
+
+
+.. figure:: ../../img/v2023.x.x/image_ohmpi_2.jpg
+ :width: 400px
+ :align: center
+ :height: 350px
+ :alt: OhmPi V: 2023.0.0-rc1
+ :figclass: align-center
+
+.. note::
+ In this version, we have developed two new board types that allow the assembly of OhmPi v2023, a measurement board and a multiplexer board.
+ This new version is made up of:
+
+ 1. A measurement board for four-point measurement
+
+ 2. 4 multiplexer cards
+
+ 3. A box
+
+ The OhmPi V2023 software has been adapted to handle this new boards and also includes many new functionalities.
+
+The philosophy of OhmPi
+========================
+
+The philosophy of OhmPi V2023 is to offer a new DIY multi-electrode resistivity meter. It is a resistivity meter with 64 electrodes, which can be upgraded to 128 electrodes.
+It is limited to low-current injection, but suitable for small laboratory experiments and small field time-lapse monitoring.
+OhmPi is developed by a team that seeks to share its experience and wishes to improve and offer a more and more robust tool to the community. OhmPi 2023 is completely different version from the previous one.
+We will stop the development on the version V1.0x, to dedicate our efforts on this new version.
+
+=============================================================================================================================================================
+
+Hardware
+========
+
+Specifications
+--------------
+
++-------------------------------+-----------------------+-----------+-----------------------+-----------+
+| **Parameter** | **V1.0x** | Units | **v2023** | Units |
++===============================+=======================+===========+=======================+===========+
+|Electrodes |32 | |64 to 128 | |
++-------------------------------+-----------------------+-----------+-----------------------+-----------+
+|Operating temperature |-0 to 50 |°c |-25 to 50 |°C |
++-------------------------------+-----------------------+-----------+-----------------------+-----------+
+|Power consumption of CPU and |18.5 |W |18.5 |W |
+|control system | | | | |
++-------------------------------+-----------------------+-----------+-----------------------+-----------+
+|Voltage injection |12 |V |12 |V |
++-------------------------------+-----------------------+-----------+-----------------------+-----------+
+|Battery |9 |V |12 |V |
++-------------------------------+-----------------------+-----------+-----------------------+-----------+
+|Current |0 to 40 |mA |0 to 40 |mA |
++-------------------------------+-----------------------+-----------+-----------------------+-----------+
+|Min pulse duration |150 |ms |150 |ms |
++-------------------------------+-----------------------+-----------+-----------------------+-----------+
+|Input impedance |80 |MOhm |80 |MOhm |
++-------------------------------+-----------------------+-----------+-----------------------+-----------+
+|Data storage |micro SD card | |micro SD card | |
++-------------------------------+-----------------------+-----------+-----------------------+-----------+
+|Resolution |0.01 |Ohm |0.01 |Ohm |
++-------------------------------+-----------------------+-----------+-----------------------+-----------+
+
+Building an OhmPi V2023 step by step
+------------------------------------
+
+.. toctree::
+ :maxdepth: 2
+
+ V2024_step_01
+ V2024_step_02
+ V2024_step_03
+ V2024_step_04
+
+
+Software and operation
+======================
+
+System architecture
+-------------------
+
+The OhmPi V2023 software is designed around a new architecture whose main components are summarized in the figure below.
+
+.. figure:: ../../img/architecture.png
+
+ Software architecture of OhmPi V2023.
+
+The general system configuration is defined in the `config.py` file covered in the `Configuration file`_ section.
+The acquisition settings (i.e. injection duration, stacks...) are defined in a separate JSON file (default: ohmpi_settings.json).
+
+The central software component is the ohmpi.py file that contains the OhmPi class that interacts with the hardware. Other python files include utils and handlers (see the `Loggers`_ section for more details).
+A communication layer (I/O interface) on top of OhmPi allows for different user interfaces depending on the use cases (see `Interfaces and applications`_).
+
+Loggers
+-------
+
+Loggers have been introduced in this release. They use the excellent logging python package.
+Specific handlers have been implemented for running with ohmpi.py (one for logging to an mqtt broker (see `MQTT interface`_ for more details) and one for creating zipped rotated logs on disk).
+
+Two loggers have been defined. The first one is dedicated to log operations execution. It is named exec_logger. The second one, named data_logger, is dedicated to log data. A third one is planned to log the state of health (SOH) of the system in a future version.
+
+By default, logs are written to the console (print-like), stored locally in files (a zip is created after some time i.e. every day and/or when the size of the log exceeds a maximum size) and sent to an MQTT broker. Different logging levels may be defined for the different logs and handlers in the `Configuration file`_.
+
+Advanced users may write new handlers and edit the `setup_loggers.py` file to customize the logging mechanisms to their needs.
+
+Configuration file
+------------------
+
+The configuration of the OhmPi file `config.py` allows to configure the OhmPi.
+A default version of `config.py` is provided in the repository.
+This file should be edited to customize the configuration following the user's needs and preferences.
+
+The configuration includes setting the logging level desired for the different loggers and handlers, setting the mqtt broker(s) used for logging and control of the OhmPi and defining the options used for MQTT communication (i.e. username, password, security options...)
+
+One should make sure to understand the parameters before altering them. It is also recommended to keep a copy of the default configuration.
+
+
+
+Interfaces and applications
+---------------------------
+
+Different interfaces can be used to interact with the OhmPi.
+
+Available interfaces are:
+- `Web interface`_ (=HTTP interface): run in bash: `bash run_http_interface.sh`
+- Python API: import the OhmPi class from Python script: `from ohmpi import OhmPi` (see `Python interface`_)
+- MQTT: IoT messaging through a broker (see `MQTT interface`_)
+
+
+Web interface
+.............
+
+This is a user friendly graphical interface for new users as well as running quick and easy acquisitions.
+
+The Raspberry Pi of the OhmPi is used as a Wi-Fi Access Point (AP) and runs
+a small webserver to serve the 'index.html' interface. Using a laptop or
+a mobile phone connected to the Wi-Fi of the Raspberry Pi, one can see this
+interface, upload sequences, change parameters, run a sequence and download data.
+
+To configure the Raspberry Pi to act as an access point and run
+the webserver automatically on start, see instructions on `raspap.com <https://raspap.com/>`_ and in 'runOnStart.sh'.
+
+Once configured, the webserver should start by itself on start and once
+connected to the Pi, the user can go to `10.3.141.1:8080 <http://10.3.141.1:8080>`_
+to access the interface.
+
+.. figure:: ../../img/http-interface-pseudo-section.png
+
+ Web interface with its interactive pseudo-section.
+
+
+.. figure:: ../../img/http-interface-evolution.png
+
+ Evolution of quadrupole apparent resistivity with time.
+
+
+.. figure:: ../../img/http-interface-rs.png
+
+ Contact resistance check.
+
+
+
+Python interface
+................
+
+This interface offers a more direct access to the software components especially well suited for testing or automation on the Raspberry Pi.
+
+By importing the `OhmPi` class from the ohmpi.py, one can control the OhmPi using interactive IPython.
+Typically, it involves using the terminal or an Python IDE such as Thonny on the Raspberry Pi. One can also connect using
+ssh and run the Python interface (see PuTTY on Windows or ssh command on macOS/Linux).
+
+To access the Python API, make sure the file ohmpi.py is in the same
+directory as where you run the commands/script. The file ohmpi.py can
+be found on the OhmPi gitlab repository. We recommend downloading the
+entire repository as ohmpi.py import other .py files and default configuration
+files (.json and .py).
+
+
+.. code-block:: python
+ :caption: Example of using the Python API to control OhmPi
+
+ import os
+ import numpy as np
+ import time
+ os.chdir("/home/pi/OhmPi")
+ from ohmpi import OhmPi
+
+ ### Define object from class OhmPi
+ k = OhmPi() # this loads default parameters from the disk
+
+ ### Default parameters can also be edited manually
+ k.settings['injection_duration'] = 0.5 # injection time in seconds
+ k.settings['nb_stack'] = 1 # one stack is two half-cycles
+ k.settings['nbr_meas'] = 1 # number of time the sequence is repeated
+
+ ### Update settings if needed
+ k.update_settings({"injection_duration":0.2})
+
+ ### Set or load sequence
+ k.sequence = np.array([[1,2,3,4]]) # set numpy array of shape (n,4)
+ # k.set_sequence('1 2 3 4\n2 3 4 5') # call function set_sequence and pass a string
+ # k.load_sequence('ABMN.txt') # load sequence from a local file
+
+ ### Run contact resistance check
+ k.rs_check()
+
+ ### Run sequence (synchronously - it will wait that all
+ # sequence is measured before returning the prompt
+ k.run_sequence()
+ # k.run_sequence_async() # sequence is run in a separate thread and the prompt returns immediately
+ # time.sleep(2)
+ # k.interrupt() # kill the asynchron sequence
+
+ ### Run multiple sequences at given time interval
+ k.settings['nb_meas'] = 3 # run sequence three times
+ k.settings['sequence_delay'] = 100 # every 100 s
+ k.run_multiple_sequences() # asynchron
+ # k.interrupt() # kill the asynchron sequence
+
+ ### Single measurement can also be taken with
+ k.switch_mux_on([1, 4, 2, 3])
+ k.run_measurement() # use default acquisition parameters
+ k.switch_mux_off([1, 4, 2, 3]) # don't forget this! risk of short-circuit
+
+ ### Custom or adaptative argument, see help(k.run_measurement)
+ k.run_measurement(nb_stack=4, # do 4 stacks (8 half-cycles)
+ injection_duration=2, # inject for 2 seconds
+ autogain=True) # adapt gain of ADS to get good resolution
+
+
+
+MQTT interface
+..............
+
+This is an interface designed for an advanced remote usage of the OhmPi such as remote automation, data consumption by multiple processes and interaction with other sensors in the scope of a monitoring. It is based on the MQTT protocol, designed for the Internet of Things (IoT), to interact with the OhmPi.
+
+This option allows interacting remotely with a single OhmPi, a network of OhmPis, as well as auxiliary instruments and sensors. The communication is based on a publish/subscribe approach and involves a MQTT broker.
+
+An example of MQTT broker that can be used is `Mosquitto <https://mosquitto.org/>`_. Depending on the monitoring needs, an MQTT broker can be set up locally on the Raspberry Pi, on a local network or any remote server reachable through the net. A local Mosquitto broker can be set up and enabled to run as a service on the OhmPi using the bash script install_local_mqtt_broker.sh.
+
+MQTT messages include logging messages from the OhmPi and commands sent to the OhmPi. These messages can be examined easily using a third party software such as `MQTT Explorer <http://mqtt-explorer.com/>`_.
+
+Commands sent on the broker are received by the ohmpi.py script that runs on the OhmPi (make sure ohmpi.py starts on reboot) and further processed.
+MQTT commands are sent in JSON format following the Python API with kwargs as illustrated below:
+
+.. code-block:: json
+ :caption: Updating acquisition settings.
+
+ {
+ "cmd_id": "3fzxv121UITwGjWYgcz4xw",
+ "cmd": "update_settings", Depending on the experiment needs, MQTT brokers can be set up locally on the Raspberry Pi or on a local or remote server.
+ "kwargs": {
+ "config": {
+ "nb_meas": 2,
+ "nb_electrodes": 10,
+ "nb_stack": 2,
+ "injection_duration": 2,
+ "sequence_delay": 100
+ }
+ }
+ }
+
+
+.. code-block:: json
+ :caption: Check contact resistances
+
+ {
+ "cmd_id": "3fzxv121UITwGjWYgcz4xw",
+ "cmd": "rs_check",
+ }
+
+.. code-block:: json
+ :caption: Running a sequence.
+
+ {
+ "cmd_id": "3fzxv121UITwGjWYgcz4Yw",
+ "cmd": "run_sequence",
+ }
+
+.. code-block:: json
+ :caption: Running same sequence multiple times (nb_meas).
+
+ {
+ "cmd_id": "3fzxv121UITwGjWYgcz4Yw",
+ "cmd": "run_multiple_sequences",
+ }
+
+.. code-block:: json
+ :caption: Interrupt current acquisition.
+
+ {
+ "cmd_id": "3fzxv121UITwGjWYgcz4xw",
+ "cmd": "interrupt",
+ }
+
+Custom processing of messages and tailor-made dashboards for monitoring experiments may be designed using a browser-based flow editor such as `Node-red <http://mqtt-explorer.com/>`_.
+This may help designing complex IoT experiments and monitoring systems in which OhmPi is a component.
+
+Examples incorporating execution commands and data outputs from OhmPi can be found in the OhmPi examples. Once Node-RED is installed on the OhmPi, these examples can be accessed separately by running a command in the console such as :
+
+.. code-block:: console
+ node-red basic_ohmpi_flows_node-red.json
+
+These examples may require installing some additional node packages in order to work properly. This can be done in the `Palette Manager <https://nodered.org/docs/user-guide/editor/palette/manager> within Node-RED.
+
+.. figure:: ../../img/node-red_flow.png
+
+ Example flow in node-red to interact with an OhmPi.
+
+
+.. figure:: ../../img/node-red_interface_control.png
+
+ Example of a dashboard UI created with node-red to interact with an OhmPi - control tab.
+
+.. figure:: ../../img/node-red_interface_data.png
+
+ Example of a dashboard UI created with node-red to interact with an OhmPi - data visualization tab.
+
+
+For more documentation dedicated to node-red, please refer to the Node-red `cookbooks <https://cookbook.nodered.org/>`_.
diff --git a/doc/source/source_rst/hardware/mb.rst b/doc/source/source_rst/hardware/mb.rst
index 1cd14a78e7bf8572084333aa43e1b70d5e3763a3..6fc211416b21309c7ae353b946935d8d46d3b618 100644
--- a/doc/source/source_rst/hardware/mb.rst
+++ b/doc/source/source_rst/hardware/mb.rst
@@ -10,8 +10,9 @@ The characteristics of each measurement board are described in the following tab
Specifications
--------------
-
-
+ +----------------------------------+-----------------------+
+ | **Parameters** |**v2023.0.1** |
+ +----------------------------------+-----------------------+
.. table::
:align: center