From 524845bc11aaa67b2bc529435acf9c548b47cd4f Mon Sep 17 00:00:00 2001
From: Ton Huisman <tonhu2004@hotmail.com>
Date: Sat, 18 Jan 2025 15:13:05 +0100
Subject: [PATCH 01/13] [P137] Add predefined settings for M5StickC Plus

---
 src/_P137_AXP192.ino                       |  3 +++
 src/src/PluginStructs/P137_data_struct.cpp |  9 +++++++++
 src/src/PluginStructs/P137_data_struct.h   | 11 ++++++-----
 3 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/src/_P137_AXP192.ino b/src/_P137_AXP192.ino
index 02b214217a..e96fb80eb9 100644
--- a/src/_P137_AXP192.ino
+++ b/src/_P137_AXP192.ino
@@ -9,6 +9,7 @@
 
 /**
  * Changelog:
+ * 2025-01-18 tonhuisman: Add predefined config settings for M5Stack StickC Plus units
  * 2022-12-27 tonhuisman: Add predefined config settings for LilyGO T-Beam LoRa units
  * 2022-12-07 tonhuisman: Re-order device configuration to use PLUGIN_WEBFORM_LOAD_OUTPUT_SELECTOR
  *                        Enable PluginStats feature
@@ -181,6 +182,7 @@ boolean Plugin_137(uint8_t function, struct EventStruct *event, String& string)
           toString(P137_PredefinedDevices_e::M5Stack_StickC),
           toString(P137_PredefinedDevices_e::M5Stack_Core2),
           toString(P137_PredefinedDevices_e::LilyGO_TBeam),
+          toString(P137_PredefinedDevices_e::M5Stack_StickCPlus),
           toString(P137_PredefinedDevices_e::UserDefined) // keep last and at 99 !!
         };
         const int predefinedValues[] = {
@@ -188,6 +190,7 @@ boolean Plugin_137(uint8_t function, struct EventStruct *event, String& string)
           static_cast<int>(P137_PredefinedDevices_e::M5Stack_StickC),
           static_cast<int>(P137_PredefinedDevices_e::M5Stack_Core2),
           static_cast<int>(P137_PredefinedDevices_e::LilyGO_TBeam),
+          static_cast<int>(P137_PredefinedDevices_e::M5Stack_StickCPlus),
           static_cast<int>(P137_PredefinedDevices_e::UserDefined) }; // keep last and at 99 !!
         constexpr size_t optionCount = NR_ELEMENTS(predefinedValues);
         addFormSelector(F("Predefined device configuration"), F("predef"),
diff --git a/src/src/PluginStructs/P137_data_struct.cpp b/src/src/PluginStructs/P137_data_struct.cpp
index 5350174fad..188cdf1848 100644
--- a/src/src/PluginStructs/P137_data_struct.cpp
+++ b/src/src/PluginStructs/P137_data_struct.cpp
@@ -73,6 +73,14 @@ void P137_CheckPredefinedParameters(struct EventStruct *event) {
         P137_CONFIG_DISABLEBITS = 0b1111111000;   // NC pins disabled
         break;
       }
+      case P137_PredefinedDevices_e::M5Stack_StickCPlus: // M5Stack StickC Plus
+      {
+        P137_REG_DCDC2_LDO2     = (P137_valueToSetting(-1, P137_CONST_MAX_DCDC2) << 16) | P137_valueToSetting(2800, P137_CONST_MAX_LDO);
+        P137_REG_DCDC3_LDO3     = (P137_valueToSetting(-1, P137_CONST_MAX_DCDC) << 16) | P137_valueToSetting(3000, P137_CONST_MAX_LDO);
+        P137_REG_LDOIO          =  P137_valueToSetting(2800, P137_CONST_MAX_LDOIO);
+        P137_CONFIG_DISABLEBITS = 0b1111110000;     // NC pins disabled
+        break;
+      }
       case P137_PredefinedDevices_e::UserDefined: // User defined
       {
         P137_REG_DCDC2_LDO2     = (P137_valueToSetting(-1, P137_CONST_MAX_DCDC2) << 16) | P137_valueToSetting(3300, P137_CONST_MAX_LDO);
@@ -137,6 +145,7 @@ const __FlashStringHelper* toString(const P137_PredefinedDevices_e device) {
     case P137_PredefinedDevices_e::M5Stack_StickC: return F("M5Stack StickC");
     case P137_PredefinedDevices_e::M5Stack_Core2: return F("M5Stack Core2 (Default)");
     case P137_PredefinedDevices_e::LilyGO_TBeam: return F("LilyGO T-Beam");
+    case P137_PredefinedDevices_e::M5Stack_StickCPlus: return F("M5Stack StickC Plus");
     case P137_PredefinedDevices_e::UserDefined: return F("User defined");
   }
   return F("*Undefined*");
diff --git a/src/src/PluginStructs/P137_data_struct.h b/src/src/PluginStructs/P137_data_struct.h
index ee49529161..066f58b83f 100644
--- a/src/src/PluginStructs/P137_data_struct.h
+++ b/src/src/PluginStructs/P137_data_struct.h
@@ -78,11 +78,12 @@ enum class P137_GPIOBootState_e: uint8_t { // Will be applied by subtracting 1 !
 };
 
 enum class P137_PredefinedDevices_e : uint8_t {
-  Unselected     = 0u,
-  M5Stack_StickC = 1u,
-  M5Stack_Core2  = 2u,
-  LilyGO_TBeam   = 3u,
-  UserDefined    = 99u // Keep as last
+  Unselected         = 0u,
+  M5Stack_StickC     = 1u,
+  M5Stack_Core2      = 2u,
+  LilyGO_TBeam       = 3u,
+  M5Stack_StickCPlus = 4u,
+  UserDefined        = 99u // Keep as last
 };
 
 int16_t                    P137_settingToValue(uint16_t data,

From 5a6eb0bad15fc0b2f163cb7617d52a31cfa63d13 Mon Sep 17 00:00:00 2001
From: Ton Huisman <tonhu2004@hotmail.com>
Date: Sat, 18 Jan 2025 16:36:03 +0100
Subject: [PATCH 02/13] [P137] String deduplication improvement

---
 src/src/PluginStructs/P137_data_struct.cpp | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/src/PluginStructs/P137_data_struct.cpp b/src/src/PluginStructs/P137_data_struct.cpp
index 188cdf1848..65c2f6901c 100644
--- a/src/src/PluginStructs/P137_data_struct.cpp
+++ b/src/src/PluginStructs/P137_data_struct.cpp
@@ -119,7 +119,7 @@ const __FlashStringHelper* toString(const P137_valueOptions_e value,
     case P137_valueOptions_e::DCDC2: return displayString ? F("DCDC2 Voltage") : F("dcdc2voltage");
     case P137_valueOptions_e::DCDC3: return displayString ? F("DCDC3 Voltage") : F("dcdc3voltage");
   }
-  return F("*Undefined*");
+  return F("Undefined");
 }
 
 // **************************************************************************/
@@ -133,7 +133,7 @@ const __FlashStringHelper* toString(const P137_GPIOBootState_e value) {
     case P137_GPIOBootState_e::Input: return F("Input");
     case P137_GPIOBootState_e::PWM: return F("PWM");
   }
-  return F("*Undefined*");
+  return F("Undefined");
 }
 
 // **************************************************************************/
@@ -148,7 +148,7 @@ const __FlashStringHelper* toString(const P137_PredefinedDevices_e device) {
     case P137_PredefinedDevices_e::M5Stack_StickCPlus: return F("M5Stack StickC Plus");
     case P137_PredefinedDevices_e::UserDefined: return F("User defined");
   }
-  return F("*Undefined*");
+  return F("Undefined");
 }
 
 // **************************************************************************/

From 836afae465d85593f39a22375fa69b9710bd8a82 Mon Sep 17 00:00:00 2001
From: Ton Huisman <tonhu2004@hotmail.com>
Date: Sun, 19 Jan 2025 13:47:45 +0100
Subject: [PATCH 03/13] [P137] Update documentation

---
 docs/source/Plugin/P137.rst                   |   2 ++
 .../Plugin/P137_PredefinedDeviceOptions.png   | Bin 19882 -> 23044 bytes
 2 files changed, 2 insertions(+)

diff --git a/docs/source/Plugin/P137.rst b/docs/source/Plugin/P137.rst
index 4ef35bfe2c..87f9ae9db8 100644
--- a/docs/source/Plugin/P137.rst
+++ b/docs/source/Plugin/P137.rst
@@ -65,6 +65,8 @@ Hardware outputs AXP192
 
 * *LilyGO T-Beam* Settings for the LilyGO T-Beam series of GPS/LoRa devices with optional OLed display.
 
+* *M5Stack StickC Plus* Settings for the M5Stack StickC Plus hardware. (Not applicable for the M5Stack StickC Plus 2, as that unit doesn't have an AXP192 power management controller).
+
 * *User defined* To be able to configure are available output pins the User defined option is available, f.e. when using a custom designed, or not yet supported, hardware setup.
 
 When available, new predefined devices will be added. The User defined option will stay the last option.
diff --git a/docs/source/Plugin/P137_PredefinedDeviceOptions.png b/docs/source/Plugin/P137_PredefinedDeviceOptions.png
index 4502c4b397a8aa79d2c062382db4e3c7ecd4d08c..baac03ca6953488d336bf45b1417ed4fb8cebd00 100644
GIT binary patch
literal 23044
zcmb4rbzIZ`_b)Iy1t#4&I;B$@i6KfVozjv+x>UNA9v}=<dUT0^lypgh#ONB*afhGJ
z_xHW`{&g>p!S>kpe!b88yiPrz=e&6j)=?wEr@==<LnG2qSAL3yh7pZ=-GPgZ`m64h
zbpHXi)e|*k)HCYmLa8|z^@QiHZtRJMM%;D(i=M_qOpAI`)l0?5OWD@b`n99Gm!q32
znzh4gHy2wXd?86bK_Nb2LE%SCyi7tOQX+y<f?`DYD*9j%VSN!kAz>jVJ|;CcH+yGW
zCZ)f}1m2R#p`kIMX(%f`^E2CPoq5eW;9dNF8uU_~!?@E=&+vxsxt;clBT_GYTaK|=
zbxjxc(ij}Rr>R@LU01GO2(}2B*rV50R;bV3K{N^9b0uYbBzq5;M^YPHy(URGG1@1k
zmb73cKM$@622ii8tn4Ql-MaWDyh9IT!o7b$L$KGd|Gr|vwL%9n|MMmkE&2hbBI*GK
zqpAG!DF_t8f~oj&`shgLX4|m6An)!PaZ(?ARWC@`S^p|t<?ht&P89}&3BOR(#so(&
zm3)zsk@@7i6!;-MJ>9|A_ruW8kOftg+az5K1tsMc<J}SC*5;;q6dy?G{uE6d3>r4-
zsfsjFmJNnKE8it`Ut@qCKbUxQ<Ry~8*8h#LQ*fTg%*beDd;~0aFXwiqAN_;kEK90=
zThG|vMp*0Q3Z!As^7oW+1JL^~J8k^Wdw5XXPIq}K=tuK^&J@Bz*m+|SVii;r_Pb|^
z78)8_*^YF5&T)`=0%=F`KVOg63e;MvS=aB8gPcjbtc^x}J{a?zkZeDznola?ZoQ&^
zJ~T!Aibemf+zt}+`S?#vIpR!izqKjwy7d6OstY~q_s!Y{0@b3f{X|56!v=gpqi}E>
z+#4SJnr<WL40lN_s?Yw~iAz*F+2+z9s1>fndV6Ym*gL{RM0vfJ!9e|VsoNkyWJw7r
z%TPe-7W`(zNkULU3#)n01zuJje6~G8fDPI(6az(B@Prj+g>_FL?Mia2n+kH#yQM$X
z&7SaWuO5_!Y=yC`eGUZ2N<FU!*m!bEjBuYUpn+7^{dmCM`fasR%G0OCmK+Il7;UHV
z;|jh2_cYAz`iVNU?l)yqib(~ed8vUp+&e9fuMi*0OZZCAL3W?Z!~$b5P|q&li3jBS
z?@SNe(W4cYOz0QMey(}Yew*I+C<}H&QbT{y1Axdcfnd6GhK#ms*y6LE3w~dyOxNP3
z@&cE#NZha9PHv&@vY|8A<(582_xhB0=#y+#ylS6UBN@4NZz4&rl)Mv|IOL|AAyC!S
zqc;cGidByEttlV(>}<pZZ@BumC)M`Pj!87&de`*5jpj<}v&F$;W8E-{IqeL9_mfXG
zOR`6;DSsY@z{Y<$txTEM#dx}21iIGmxm?KUtZ^>uBSwQ2X2n2tzeuxm8b*I;oa2QS
zWZ1<eB(Z+T7p=3Nu=T97_wE-iD@oZ~QzKg+);~zCw%yqIl(atPjjJtN@0t7c7>3}i
zuw<zG@Pz!@daT0p3E~O-!{?>SyPMRD#=VawL%37p@yOz|)oRh91@)B0IwDx;r)ydd
zSRZS14=(tp{*c5=&6l;Ur&MI?KM}r*khcbghOK)oE`EN$=7#Qf*cAG4-hPD%535+;
zTdL_>YHeuY4-XHu-E70+s>EfVpVeQP!CI-^1FV{>HrqMVJi&nIF>0PLnF=}WA@+Xz
zSrr9C3^vTKet*ba)+W0JV4Me3di(@xlH2R`Z<mISXW4c(%%6~8*uH!W1#Pe9%@wC0
zJkj}|we8l$wIhxcgEE7j&p|i6{4?m!Gxh?qiTkp0({n6R>&K5W;^()FT4lQ4fpbS2
z6x6te$$hgujGq?IznmKqExh(<(~%R7Gsi)XF3X0c9phMZuVr}?1@2hSBR@^_$R}WK
z@K)A3V(hV4mT6p&FEMh);Y10W&!m?^d-HDU(oXw3bYhorjuZbl0)Vy)Ei!<;j_Cou
zHw<^3^4H;QX2GZS!KyqwJV!paIrT?v!I!Y$<9Gl{VLQ-G?}*|;t#V^R7lLpVvTEhG
z)LN?_w1bF4t*UwZ^qQF7y<c6EEQo93v$?Q>fb+#U@<ny&0gjKo;a7jEgq74fnlOh}
zxN*(n!yx^2B(-m4Dz39jvZSMD6GI1m6od}*Xd&6W35GcB0cLYCGLI3b$UWU!l4xhi
z$KTTn**M}bqiyUzVs=}oaUJ9N1e61EGT~8VGnP2gx_apxhriL2eW2H73<YH^Qf!Js
zcMubvb{rNn$=GlRY@O8o+;0@SEd5bZy)6H*ui$!(v-v1RhiLu*IGf|eVgz6>r<WBy
zZi;0oT~SDl_E9Uv#m~a1;Om}XEeeVYk-5hO3mggeS`Y&fN963{bia#UOdZ>5EVPh{
zi>P69$CQ4S0;+oXSd&6og)5s_w#X9(GUtrL1mdARRXluv7%)^bR>f;~rC*mTh2L;_
zPb4EgXfEY7h~+!+&w+z{b~g5EG%y~3=45qg)Ha$h+mMUC(z<gv<&84+AKZdJi-5i8
z;<meVyo^GJ*aaV3NtK?&!_j@V9Fs4u+*3BzCag_3870efX18oTJNQ3VXs6&i@PmBZ
zbAKM=9P2zeNE2`bP|xR*VFM8E*$&}w&mM}xuT%RTju71CWaws-9_1=6mWqHj)o*yA
z(}UY)Cv>1^t=_79R7W-3BFJSk?{+J1yXAIG_f|P87~!%HDs)1{c-!!T-JfCjAx5HO
z6m?sK<7j<*%C`17ULO=k2jr`DQn1nTTWFKlHJyF)6>~+vJ<4w&;FV5IlZ@S<yB9x#
z=#7mZ^l2_F8A7Sn-R4;QhU#V+pugUekEfC`kq@D%2)Nkb07ay~a6Bl?0hu;*I?s0W
z%ZT((0hgUKDHN*8kT&V<Nxn2*U8nt&l`XeqAJ_h9zp#H3plUqczl;&jtMr{33S!dA
zTXl&A^;i43FwOFx<iY9`^y=c4R2Lg@O!EBe?2O<cy>{w9{SRamgxXyn0JFUOnH@&5
zXc5}s8eGOxbqb>g3-m=Hi4nN@Ob;TU%xd%to_&{57Tr8fU+u1xUQMZPUA+Vmn|aPe
z9V1OKRoY+n$-~YThQ?3(4s<u?gW7IN?Vx`C{<BSpC83<Hx7%kV+V&?y0ZcD<A^vak
z5jhv<XQBBdfUV>$k?{uGcXc`0*%G-Tkbtw!wNsLIr+#UBx#8AM`dw+!4@n$`ZT*Zv
z^;NPTD`b3zCRUmmXKxtCd{>9*vpH+7LtDnjc8;;?V8#e*q_#kNu-261yqJb$xg*1m
zrZVidCyc6j-qQVb<kM`rR~+MOU+X;?D(E^cBg%~n`LzeOuJ>>Fie|6rFXxbNJUo(a
zHxq8vbybiD!nbI^x$(h}g54KoFTl9P??YIHFxGu@s|(X?U5J1;s|%uao+QQZRdrhZ
zO|S+S<2KosHHwqGM@$QZg9Xr7UFpa32SF~uB{?+sQ%ib&?PxF^MZFg(5?FbrkD(F?
zGwE2-D=mW_5JjOP7nPiAPkpAP+f+;y>fZ6|e1=;8w;O;f!cQvhRA^!@M2Si#D_nr=
ztu^eWjB)yp(?U}8mOeB+3^p2X(UlNcvwdpBJ`*e?5G^k`(;xu5Fo_;V1##a^<1p*E
zC|5fUJt`ou8?9HF=DJ^`OgFAqHzBHeic;lq^^ffJ;+1L8qYH@EYF!9`t6odmFLdSG
zd-do=6otNIOV0KB*7$##`w`aIC`t6*j7~2ddcIe`)c*h*%S!~R9@Mj|2yh#vZ^<^(
z&NVDf%5lvu27uv?^Tdncahol1$7(%(kY=*wCv|dtp6jKBGjz2HIKYB<^bqZdo-Z*=
zQMnjBY|9+8dBzp-ib?YL(CF>$yq;kZS|DIOE+M6IC%D3PPJFiSjyPgy4>6Z_nbm$l
zD<Clt!T{g>NY~72;ymM_`SD2Fwq|L#bE~od$tm@kk{g45>FB6xRq_(gw<}yeU$S{G
z+@UKb;p&@n))k&_zfPva0@IDn(BSaVylz3=1=HebDE7#~7|y7DjsVQ#c*=3!Q|01U
zH63HHg~Dji(3@O?0k^py1JjZmQfJG$8yG!rk(KLibk=gsj#|y4{Yx!h#k8R>vsbm+
zT;-~HZyRk*#g4t>2j1+T(?ra&@19GOt*2e*HZSera{oEw!cfQaJEpoi;|UepIS@tL
z3($H|PAl5O9{-#$dJ5d+N(eM2suW5ueDswn``1z*l1}CBMfKORaF#FVK|eybEO6+&
zBwcqUqq!in$T!pMU^P913c1(qAMDku<Jf+^yAd9C4JlZ(SrPnf$h5TPtGhRTVHaND
zTju3|k%!9}w@3lXb2jx53P+?vLH%<()g4n<D%9CC)ksaL?UVUBTK5i)i7jeQ^v<=E
zc?v~kXIQ6>b_yo`_$bLaG}XUF>Ma`dRDmb4zPIynpYFU*5<)WF`vLUhnT+s~%z8q;
z@ppsO7x_EcUdvZ2=uekvKCQ3N@B9i4c)5{x?wz{+A(2OMR6ri_0lQx3;*T$g2)Ix!
z)`(3Zwf+Y=<hY%TW*Qi8V=Bf2%lqM0Xd|5^<+r~7P58DU9g6FqWylSB3~mSEnvIwy
z5mwR#*eaxVG*bq8c}+~`-t^rSOYfWkt}M=r`R;Q4C&_^A7aOz!QRozb=)iorWV!_>
zXM#8brG*bf1#}il8_PW5HMP4hE<4`7eH*xvan}bu4<5M+4HTT`8)#1ms*F{dq5zh$
zgD|LQQNZDbU9yZoJ%Hym02ZONQ_+5#d3#xLCq+(d+cQ2aCn2#(t*Zt-H?v?Qthc(5
zJ+L1*UkzjJ;f^;Jj@JNV@?xL>Mt>sVM@MKc`ZQKIuS6>S_)E`Lv$rd`_1BAwj|Li8
zEl0yxEUFssff6KHv6`C6<ZjnqzVKCTCVo_PO_ST=($d?Nw%TjCv!?NHN!Gxg&lPQ#
zpV^ICD!$>O;1MXDFdD*~1mJ&TW1}qJ^Ak&%x~0h0-b=rH@|9cnn>TL+=aK14b3v8Y
zSw4KL(Qty;nwpxE0rOkocvDy26c3#r->-0E?(s~E0*Ei%9+zyX1yTq&8V<fiGBGuM
z<B%>hXl-sL=yYc^z18-equ{lr`~9n{@VyMypb$ajuNSC8n-Iz9U=!>?QFWX4pc@k$
zN8&Dhef?+LX=D~4X@XM}U^6{BJryJDbelOoI4tH}jV36h3zwkq(7N2x4gM_e`L)`E
z2QyZ9zpueB&w><+t9WK4d>F|Ku)`&j+^jZl^;Z!vZ<`1`Z#`QqTv@Ta{L+5Ov)6t-
z&`x;SBY!J254aso2*NxIS@#Y_8vl6cL>nwY(Rz1#<^SwnVcfL!QlZ^fXtDRA!je1q
zZKy$6ioath1vW2`h?CtJk*2n`DPPL+ii#cY7~Nc%d>j&nkq_oUGoH7<V+1Uy+Rz8u
zYwK;}9~BlBiptCD($dmOQFy$ty2p!?+D0t{_d5Z7!%e;R*az?_`?U`&>mqoQjBH?C
zIPl_7=;q8^Yb5w4Pvj);u0Y{#YnalKDrzZOa>IRhh3cd`Tn*mXSZbXTsUlqs3a!d{
z6jOeXi82Q-5_W)Tudsxsx)&^yosFNLf2{dVO7rgOPVxZDjVfxT-X&gzF2yh6XnR`|
zWpbu;?enD$zBWQc6t-WrkS|G5ICek7M(~LzF4@c=Q<56l-I2L!s{&D{V8EQ6(HgC(
zgux7#13@f5ubsByfKkSJGZPA$FOc`4P5mSTDmjr!HZ&#nCS)&f*~PMb7o3mT_|-K&
zLic6<Pjr5g%C~~QCkVA!?zhH!Z>&E=_+BQbrmjx)ZjX}O%smPPs2`#fl(l>Rbv+eH
ztOb5h^_B7c9;_y#^CYaN*0ey_MKk?8Jo1<P4$W^5s09Q&1qsihB~?AX{=S<R3-5;O
zsZfh#HRfTV)GN(P{WVikbRk<T*#SK%d~bcd2)kP?fuT0o7m0%}W{Z_;K7N<Dl?mA`
zk~(B>6{z=J6XCAaPtUC`>5PNx|2mj%FCHbi-g8^pd(lG^CugYrT%KTepwiX6Fy>EY
zdpqBk<1g2m)^RRwg)VnJm(zPUe5WOnsz<9$yr8C?hwLD$XZM!rYa$GO<OzfJ4r`|<
zN`5HRncPF0Ihckx#Rz%=&^`@}BIwu4CKb&SvfgIMxK<F&qN@PB768gl=+SPaE(bKA
zYDoi+`E8qLRnLuf4N(NdX1peLsa<;FxtOA!?{Y_cLmV+Bl<K5xa)qx$i=loR8?Cz;
zKbo%Qg^@E3@BnZhQZ|V-v0-*Y1n=`}-&2qc4-aqE49g)gUVGLrl4d2T@{H<5Dd_1q
z;S3c?E2$NyB=l48H0$f6$0#FSNkfn#22kEy+Y8UNxscRUDa=`}dF&ZPA9t`pP<7dw
zL$&=3_Aw34&~&dz5z(6DW5=E8jsyE`U%|rc>Y=_JhasL7VZ3@GaH@A&k0T0)www-$
zHtHRJWCLA}FRip&9?9Z`6gwwa(7X21ePIJdEzbVdk%x5@#KMgC)$T9%U)iJcrE?yE
zxYcFkrJcxu3p&FG*F~*c4w5c>(j6tMr{DUv8d_w!QLr!xB(FW8_ag_kCy}FLlrFml
z()PcgrGK5BV2Dt-P?pXRI}C*-sd29Rc65dr{dklb-=F*<OYQyT#{;mz#f^2qK%KY6
zk5HzAtKVr$jCv=-eC>>7p;oIc=nsGh+zrQJ+Fqrp3UAZ}A(1DutnP7cV{~86<?H!*
ztu7^b?;V1<51QKZnx-48dn9Lw2Ds{oa1hl~{5`X!F$e8UXJzA^=_vB%c(22WsX#_d
zb`c@f7JD5|j3C`!OYu&o|LWC$t8igUGoDMmw_K;M+021-fL));knsmL9QA)ldy4?i
z*j!{~v;L7O2-KhDzA`~v1kGcD`d4pc$VMFaj$IxCZJV1BkNylCwKiJ5RTz!uj#3cX
zDNd&i@BUWBhZx2Bt5yx{6q$5%0TR%*qrGgVpCTm!n@l$$K?<WgY8-~wNk3vm=1&F%
zN$;*no}AW6&GD*PSWZ61*^zF(-e>@~#gLAOZm&;vIMpc7VurwLkFOy1=A8=Ea9Wq`
zdX*nlgR=?}c*;`{CI=zJS$UPf6j6AAR*Ff`n{uPQFsn=7?~!8$cBHP~>Ann21iSO`
z_HQ9jP{6YiG|n-6G$_6=2iYCOz4sq=VXE~iLZ3key$ap6(JqJn4CbS?&BS<;(`L-*
z_&tAt3Qs&Pdf@m3TKDeIXKITs$FBwOjGPu9f7mNJDOH9K$;H%c5Ga*Hcos%C*i<Z%
z;erttPs_320k8tUvHW&_a8|IqD=v`S7Vkxc@|+69)~v>E32-OHp6c(4Uw5ND6UHJv
zTw*l~^r8{9GybuhXe)C%Y&*`8b;yBY9HG)I)DFi+*n;9zk%~#voX2qF!<S}<O<m+t
zvQp5(O9uK~S8qn(oy?4$U0hTbF$yXK+?>qhxX>tcxmrpIw}um~Wtjv~azDP{_y2Re
zy&P%<B_gY&meQ?3DHUecDQZMC`(2&Nd2F{f)Sb%8GakgjTW(r@(4!q%kn+|rK6Qt(
z$<ERC@K~d-CWBA3&i_T$hLN|we<s!QpG^Rhc>bmlDvTbx^eS=7oZ>3gYi-QW73N3?
zMEW53P33(il4ijRh42ENiGX8K;?H(@KD0?7dBis5%MCX*b0Yz^4)HkpimLfoOudii
zMW=JjNgtniBpLhyn}mrDhq))4H5iAsSKKAo;*)N1(#Yy$2cM@VEn9v`&hZ>lVp=OG
zemAY6)boXs$IHxIRwJ>|whqziRxHrQWl+Sd@ND`iy(U)-0`#(!pIO{XdvDWT48##C
zHlw=YLmXb|bdl4l;rUfcQtxim_KC%_Bke^jzWh;o$AB9SyhO<E<6;CZ@m}!I-i3LK
zpN7C6$Yc-^jN4VM>YC$k7P!B(d3=!A)cw9-<>WE!Y;9cXr1@xmdB#sM3+R?VlP>;c
zbqP<J+S+Af>(!B*J<tYdzSH!A_UV`wpJn?Hm$`<dXZcbw7<nvKYdb^66h`-b=Vrg?
zqasL!rC03Sq8>ea<tGF)^Hh+}__@MrZK(ZB-H^A}_GX}Y%P9robXNG}<`5YNYm~-P
zK}aVP6^QAwzR6|#cF}Y0!nQoSK|0NM(t1=et(|E-d32<=W-Vo@HbO;X314<t(Zl#;
zPr1L=)+^*C?A&Ix2~S|s@7YpIe7RG*-0~A~{Pd>fw{QuvO|-I?HHNO<TPA_OL;J7a
zD3GBcrHFugcg_o=%0$tZRT73?kf35%Hp!{aiTdy2u&%TWkIN2{pk=JJc^|0~Bd#3(
z!jwmvXi=CdJ`;L9_-nMj{RXa_8+3U@BJmSP8h(!C@U9D&#kiZg@K)DvXnjaF<j57q
z9@`vKhFbG_y~RhZ4=quW7HV~F%T&feBvLlCy`B!z>$dCu@dZBx&}6Hx7tdI|_CeY-
zpkla7Z(U1JEB(8Pr%QO~b+_u~$5c8nBuRh(Z8GcUg7U8%-kZhpHz)ciG9TIrc-TX{
zJ$rq%vcgPHPv1S_phi<h%@p^rMW{=1N`b4c$oM-98+<dqHrk+f_$<LcceA<#$z#zH
zRJ?rhFu|%VM^EKGFr#ar{oFB7)RUJ_g5?bBoH$syG(S$OwKd7e`8306?t>leo<*#H
zN7$KR2mX36?a*GQR@?e=b}sH~P{riL>80ExHOoT@VHuMU_*7vcp*tzKscuek@Tlry
zp<d&QTZxClgxss$HKQE0oD}prGebGBt%OvuK32>JLws)YmV)UPvr*$Oe)=e!FhZY*
z`K`s32sn7Doa-YeEm_=oBRk9QHgfqibfYJ4Y|}m%dbdN_euyC)FpdrS?*7FNJU_RP
zpR>m|TW(Nd!lhsI^=pv9B%+M3Ht<cBkB^UoA^NAC)>c^;qSULaS#Rto*iBNw<y(QZ
znHtlT3qu=T*cc=yB^;d&qTl-<C8C7o&D+;agl|w(p_G(d5i*9y|MZ%@_4k(jSuw?o
zke3Fk@Y?p&I3L&%Ro4QjTwN=-&1K|e7%k1^_y3^b8y+58TU9&hK9DcCLj(tIW7(V+
z6M-XE3<jYMHAT?M7X^cH-m^xgMYWR;ZU1<>#7#|4){SAOiA~-PYIA>>S&!gJ!+-we
zIZ+xm@8B?BZQ18jA+LVxScv(m5y7XbNyHvsn%d;2FV7|pObKJIyxhGW+ao^sUmAxO
zn86&ZF11m;6~#b)yb#C&4M<hI`mj0YA?VnX+(~-w+0%|%K@lZg2ANL@!B=lCyW0Uk
zRB;*T`Sr7Fc`22_r`q3S4?j>iI94gd5cJ1vpB1T?n3)y-)=V-0DwK1FyqFYpR2VY>
ztpAAeDSh^IV`+Nw^ihtFw{4_Bgtyt302$coNx*zD`dDvPmYBewl=|mD@cvXuke?Qe
z6x4=^Y96Jkp?t6DC3p>Ms^={Z{LAfGOF72o?g^o6z~RTBt2y1x;6QwEgk{6oU=3rI
z(-U~z3+Q^JB=^t3k@;QG!J$ff2Orn;4FsYT+To!Wx|)pL6GfXB(`|(r@`DGTKjxKm
z=f>~v7<|BASloxYe=?A!FJ3&oy6{V@>+Lb}dv;igK5_kGoXMnMP&2L0HyP?soXZF5
z&&_{>GCXkJ6ATN6C+dWu1$Pc~o;@Przeg2weCp~>?qcnW5t|*IdY6N0=41aT4S;<2
zTh${znm`1f3^oz$$La9ubv6fQDkrDI>sQIeu!o{UCKm7z$_(_xdX+gMbsAFzUf_mf
zkgE>*=GUROvM@Q%AS9B4P6_3*^o5S@MA1IVLYe+S#P>)P#)i33718Ak_F{<h^e#H+
zm$m`V+ksycX3Sv721seNU+tEfov{Lh2|L{@GVb)7>qJ$aAjw6=Wp&2M3q^(GG*_*6
zg=q3DjIs;1GN>~>6+F1A(YwPKxF+PS6GhP+ne_k#{ni|>F(@FZdI<6`6@us%gV!nj
zlYFyPPC#<;8Z;E#e)Tu`F$>WHFBB{H3q5#244YWfPCK-shDHUP<en#Q)%4L+sG_b=
zrHTP1hl7WYR_Je#b|X|mPL&)V2rDk0430pEjtKQ`Id1e0$h>NBPzCaVXlVU-1#z)e
z$q^d`qg|LxvyRSq_ZV1wB6V<(w^oY&_~q~ie4u#))PbQX@IEA<cINT@&Nx2=Ciunu
z-jBb{+y8#d9XHH38s3LRAMnSs1J%cT^Na4w6vYomN7w8P`yUQ=uVXnlf64rj(a;~K
zAbUv2e<Y=xOC0ZNH7Z^zI3Xm+pFygMLqp&%%L2&HvC=8mg<JGG(Z*b2f50VNeH0y#
z64R*hW4`zM4*6M$f&8b{6p^NemSP0T`NNLYF)YlUsCy~uE%ve~>Mi~J?khWe>V?Kr
zp5|cC@!QA}>%P5d{?U5!at!#8AO$Wcu7Rx47nSZ58}B6aBOoC3!hZ0Fi2dkgA3HbK
zI}u+oo{^ew4sK>uJCxK+)}UuwCpqIA*lFH@FnHr!hGk`v@61QWcKvd2ZGXb>On&RE
z9Q|P&uRWy~<R&&3>2$rwrg&5gz6Vu-yeP-#V-_L+lDpZCiq~ZCoE030+txorn*(<^
zLjqGa44?dG&op^F;dL@<-9-=+laGcL(+!<7u}sG$4D#|-k0;L|Z|D32PYr4d6m-xT
z<iFc##|oNAtYtkt83c{?LIX}&<ON0{K?Ok#r#?2#sQ&e<D{rj#YW|{0jCFxGyOOQX
zJTlBz>=_zRv5yI)f^vJ4$5uh$H3Z0PWNYhvP|>7Wnd<YX?tY50)OxgN6k3gxG<YtS
z?&uk49BP&{Wf%i54oQFoLi&9@Q}W9{t06_dPX5d?BtGBcxfY`c+UX~jr^*UVQlpxl
ztg^#z^dQ%KFZRer*kXUI94SVLG?7E9QrsA%_ipg<UHecV_1mSuH$B%Usmw>o<$j`i
zy3*~%;^ry`{y(yenQ%2zFu%#9hipE!q5z@H@A~`Yz`zrFhYRn}cGdsP0>~D7Km6%K
zP4WBzuiL>G<Lx1i0Mk9n&XhE8F%)<BQmr_tsgXczP&g{bAnE*#xzl8IVF-39JJ{oY
zF}Q*bU~RV>julLYM2xoeMIx;fY$R;H#fBVwOqf21i0}X1hL~yFnGtep2H#1xw+OSo
z7oZ|DZ;e+a&v8V!x#5$eM?aXDPJZyQhm6cK-0B3sou@5d1xp|(|7K-0iTKl-?ciQ%
z?h=gqfR5w&byh#5C$YY{)1raAy*)$iYFC{>X<^0~(`j42@52Ym%e`j^1pcY0;PIw;
z+^aW)v2$@}N@^i~e!%sPZ#_L<&LQ63W%l;v6?t19U){{#mY-4Y><v>tFfWm~*6gt%
zcyGRQPT%b_Bk84gpAD@waDSqxi@gvQ9Btyd9&Yd}BN>Si#VT1a@5tdY8WADkn7iV>
zlb_AIal+Ae_1b>!AMrb`U%nlB^jK-JD#!RkMUD)rHSbRp=eMOAHSb??{KZR&HS`+8
zwaD2_8X-d*^=6Xpi{GVRaB#x*6$LTL=H|O;jNFke>VyqyiM5X(BBZc93|}>e{XmKk
z#L9g4vnYl^`i<5L(S;a@Y?j}UqAxwMerPJ$W`c|h-$(dKFFiZY%zJEUCDP+a-c0Lp
z^S2_FOZ#gCAF<v$LQAH(J}*0}J%ngR-JK0q{vrht6OTdBI(`XBG+qsQgm+@e2RZ|E
z8EjN88o`tJ66@a55Q-=q0F%>PZ{L$?#o~d37q&cvUz~o|=b`tU4ij~vIHu<~e*&?*
zi4-RE2e^wpoIO#}jgBYU2OU4nMvw{~H@O7SbWtl6GK8-EiHO^>GSe@~7sQrxB6rJb
zCM|TC_gTHvCb;);?t4(eTxAOFRZO?6Vg=LDXi}4|-h_*acA>3@S;doz66sr>r$X7}
zeLKq#8R+e#@a{jY9$@%%H)9`R7!ToDlBB^A?s8JJX-^L}8KgN<Ie7NNG<Fkfunc!E
zYXo8JD9GBX|0DWQB(}1zC|H*oX7t0(k$TvTfiw=qr%k|)!&Hd}zKwH%UR$iA4LCuh
zaJoqW0%TfLiNM6z%_K3LOHqkP=8@UhAzRoHteF1%xHtr0VW+l$F<#9OI|DBbv0WC&
zjgHrDr9p^p0hZ@AW->z@EN$3|hy~}brl7q$4<Mh7m!3PTl0l4#64;`cMzzpU4m+w#
z%V<7RYBR0p4|t~+OVqWb^?=ai6jNLPRmJ`(y+%uRp-#;VEuh8STlGNU5gmD7{OEjA
zg(wzmX1qYMbT(W^X=tkCu^$B*3=NdQWe5w<F0Lep6l<+&_UxeBzWmgBj0fJWbZ!dF
zN<)vjnxFvgITU2SMl}RPl1n-g_H-EAN0&?LO%r45Jb8)G3t|V$-~4p}{XVqupJWf-
zkOA3umB)t&mB@fM-mkgF^It#X!}`t!!d4T<%ElVUL~0rHWc;S0pnn6M!vsq6WjT{j
zwLL+t57{MhOBo;P7*!?+CB-c^(c#3gdfnT4KjZVK)F#By4)5Ipdbd6x`lWGUFO+4f
zTZmAll0{L-p)p?9DE@Jiev7e1DyBGr{UGeUc5Xn5j{o9JJQIH%-JlkrduSkil0k6(
zV4n(DXmn9~v(=@yBg6V`?4RZHZQN1Iza3-}g3FDD6$HxYoVnQvxo_$~gufd7>cfhb
zMC0<%k$k)rre_ssg=vE)ky4n~W{rwoUm=acbZMMJtT-T_r(#;NoxU^sG~K(U2sU1S
zC>5HLBXvT}JZe7WF_=*k`-5G2=#HvF)p*b9FFj>h?q0O6%5k*({jlE|I3^lkt;SVx
zv}j|*Yb2rkY4JlGRnx2xD>Yl>F{NuABPzS2{hdGh&q7~#pe12^?Z^yR&IKv?HSt7w
zNI_(F$J#psGT^#Ul6CJ-b?Y)kP8Ve%85VohmDd}2$@T`9&ga620r7%gan-i#N!1L%
zsH?93YgtrnS}VPuWqh6kBYgiB$NTfafj1tIcD!K!-AC~PD(!AD3w|`|*G&f5B7t#M
zXc5_^n_s147G4)?+dn}|TgQ*j#;+X2?mlcZ;Wu4&b?_nkXxVT_2>$ukKv9bBt0pwr
z3oB?%THoGI=08`Zcxa>>59x2z!NDhUYMy%uP+<(ifKtIk4vXpOZlckISJ2k{62_8x
zN<Gya$(FYkp67^Z_6?ya_8b>yxi2`I`IuV(;XJmUL)LLg$_>Nx{_!ks^}~8=M$_D&
zVia50H#qO~?*^pv4nQZlK$+6H!#}UINk}%K#Y`UdF+My+Vv3|umgjpk{|sbpEA@R#
zwxxzk0lImxqFdyW)W}J;D$T|d8}t{U{j<Ufq){tvf~dy#eJrp~RxHY}9qA8KCWxjW
z;{!E`SHCbjgd_3j8K+9y>b0fQ$etT~a0s--{!dYa-o7J=p>oBmf~|5<jwl{}>WmRx
z_T8%DFL2?YewJyB{S`G&;n7oLoag8N`jZ;@SsnK?V}Y^Eu&(a+oF_L2!Ak_as3Esj
zJJd7*in1#iW((I883>sa10Bclw#eyWji(eUeLmP5@qvVkr4zs<9;xb+$OAwq>YWlb
z#Y2hW^Dni8OKgm>zdT@Tf_|)%8<nH!Dc4=gGV*h=vb9c&Mv92uoRG?1cB-8i-dzuy
zDcrO0k4(X-6-NZ2EIkTWj0hjasyxfTH5UgpxSAL6yaz>P>&nRHcZLVfE_?<%)~ZKt
zanS@GvIkzyEsY%By?u0F=Cq+lU)=LAaw&u$<Mhzaw9wv!Zpo5qhh~#v6#g32(HZL;
zZig=2T-Kiqw`1JPeDxoh)rCKb)(}2p2E#k}$$=N65|?qjh)WmVKQ}Zk&->xkEz0`j
zDJR_slFjM%TiKg-#^7Bn8&rS84B5kN5Q*}<`WhRQNemnBv)`*Nfh}A^WI$n32=tk$
z-_5#o`n1G^fBg7ZSX)PH9APd~9DKKDfAZvhI4|&iIPZTyh95L*4>AGI8$yjnp+=wj
zN{ugnuTb6eFfwc{^ZWx$sQ<Ml);^1|pTb~o05IVZXsX1d6zpM}R%}mj;_j6x=P!st
zJeCat|8bEd8$pzdJY~LzVSxrlG@x8MH78*GXLwVcjwivuiC2?CUc%ttGKZiUrSPXV
z;I--VM(D>=n)Z71m{zv?c=^vFV3aepWfZmP&dtri^|(i^JkpBs2Tp8!{!Sm7|2uuS
zjS>%K?9e8RXv*u$Hgb9kUtizS7o{WHs_!WbrX2ktW!nGGWz2#ML8mBaTTGNp-8Y<{
zkc4B-#i8p-ie35DvODwbLbJ|n-_A_3TGa1=U5HfuCGk5S2I|-CJT3Ak3!zto{|QAX
z0$OxnIhB%Z;m>;^(DBZd6}V-j<3t_H&<xgF7@d{IU6$Sthquj8qpA{aK~40xRQU5Z
z8x79tg7ob;5_&-zOv}P>JZ~;nab17`hB~iAf75&-5u2uZKP1T29Jc7Vx17gXp>14U
z5hzUoEotX02q<uM56-lH-fE`X@?$uRrALw=n(pcaSj!X!vef&rXrP$1!1FhZXkaI!
zgqt7&ul1~Mir17d4T!_(N|>7K>(xx>q~XR31%LVt?4c5(YjGQ*rzB$|50oMaqES;J
z_6wtLSM<NfT+b8Lr`hA`kX>a?H1g<#9)7LvKCO6SAZ@ev<cu%OYC=prm}ogm^xycR
zmK@49C@kTP5iRqlK=J5OQ@1bs3)8^3sElom`4ViQmBwXn_o)iHHR_yJP{nwoBlS#-
z_bAt0Q^;emBv69ZQdjlstm<k@TP$n2`Colq2YOHh%)(18CL9QY8BJ@GFjHfZHQuy@
zMB>|22>Q4O#dMT#IYTJX3!LS7CmaD?JTq$Blt11>>)IZiLtB8aON()$uV)t`pSB8=
z$+`b;cBGJON1csoQ#H#~p+`?+1D`WZjt_G;yiQzLT7tEj#QB__N?~_DuyKd|%z;P9
z%_Ln}xTl9i+p#Jz{KQmEA$%vXP7r(8c)@o3^N}}QSO%dQ!c8GI=ZD)wXPy4*lfgXI
z(`|~%7HsCX7E4ZZ5$l^4xz&Bvj}eI%5wl|Sz(0s@z6#PLf}OH1l)ydK*AnGNZSd)H
zTUi#hFe`D3D#Lq9UM`uC%`rW6i$fs^z=QLv2_IgIOCgP|GNY$9J~Yq#L|y1`*=I_Q
z&G8K@I8;<j-u?})ADaXws&GjiN&daOX_Cpl7J*FMORwX@G}l0sDoK#c)M;?S8j)#y
z*T!|G$1VAy)kL0Q1zI>~IsXZD|D3aw2iofdWChDeOQZC1R8oN7Kp2w~Ua;AaLyPkr
zjd>muz6P>6efO*rTeFN$Lfz=d<(SS{cwx6e<03^zI=GtX#_=hh8WAkKA}80a;-+R+
z3@;iokZy4HL+(x<i@6~MF+dQl(GYnx{9jK>PP7GUhIgUtcY0S;Vf3s11Qg{$+{?$n
zlY`*9Hv&xJzEZyg>1+~2HSE!qm$P3-j74U2U3TG8kS#yJNce=RaxAJKjhToU85jRI
z9H-5K>$Bma?PX6FC_qiqylyksJJ}%+#Fb|XbhG~9ynr2e?ISy5Qs>n!>+5O-A<P)z
zwtgx?6b9b>!4A;q6$UM!;=>k#Kg`PdhSGO7PN%6E>bIe&K*s%4f$5*}M|7P;@$F73
z68j96BQH6dh96yuI7Gf$+)tWA@9y$%Z?Pr!9`;_`4=-3cb#MP~7*imtCe#eXiKf87
zP6<iDRDo!%89<fhCC2HvcT1iRUF#qJ)U3$C=k&?rGwi=maspy~itNz-t{anBLLW7K
zc=7#e&EDEr%!9#$Z$Y&BCdD>onoR%{)z0XC_kW$l5&9APJu`UiexSKx-D4W$Ly0Pp
z-nqi|<3JqH_k7Yfsx)}~a(?Ox@B7y<VniP1V7_M)Y*;^mawf{Hu_dY!FFe|t92W4!
z1uD6)&rPQ)emC^oS;cJe-+Le_(?8qd%y6ROviedtu(d0gpDmSRD2*KGG3~jOW&N;+
zH~uAR2t-H#GdibSKUGM2u$ASXn9qb~j9nCj*$u|o>kQMj5B-J%T*Z|kBlbETS{TI!
zu6b<FqceFVJPFglO*Ek@O7V^vVCNkcm}Mf2-c`66JN~Ipyz_0-3^4m?e3rS;dFZyw
zJ8`dQwgYF>rY#_V%z0fsztzk&^Q&0oRrmjCVB3M<h=X)?=Y>bKel5*^ni>C_uoEMA
z!^sp#gLXDXTbreR`+V5(N%(KB`zx|tB1mx*`}+gXF|vCe#}xov5k;n!w~N7-1`CTq
zZ3*0$X0W>LDvq46qxpIJjd-j*<iE4rmoVzW?;>~ssMVt^B^>{opVfPXnb1)@Kvc?q
z#dxPaV3CRge5p=YrVBrS)S;l`RN!<?P-Gr{L#;`i+~p?g|F9VzKl=gE`QFiDW}4ui
z1Tn%sutv&%LkG*4FxB6s1MjEF0pJrJHv05D{(#u_VO@aY*^^^8MH6h+`+}j;4JFV8
zlnUg~bkmP;jhNrc@miEK_QP#zKE4wR7-(0jBQ#-F{|Sh`ZonmozNW$>i1rCYT~^de
zP!*QS8L1@QILd`2rfge(=$7lFsK1&<*oqk#HGPb}+W*P9K5ki5$GKTxMDWOCHrqgq
z8}>x38a~~t6Unq$u8EzP*xFw2cF!wyj-mES80tWfHdeJ6E&Od}c%DkHr+`-L5uLbM
zA$nuy5p6<(qnCPder+M~cI~*M<J{hmijX4<)#Q3D5%()>MPDu95R{(vHV-a16g_O%
zPVi+>HPxapDnViQZdo{UCWnX;1Q6OcDH1lcuIVU0TCCaOX=-Zv#1j;K!G1U7dHJf@
z`595Nz(gJ5bI0VZ{q!Zqub6LJdy$oOITIqB3rNH(MntJVBD!jQ2lKu34;-l@n((4e
z%XkMBjt=f_4_ZV1-az4s9SvC;8pGr5r^?-!n+oB7x35*8_Z=6*+{pb6!=s;1qGSo)
z;m`96Z2sO&)p_2@z(_x;cY;s1Fam>p&W8wXvcEJ_Iqa49R`b+B1mr)<93Ll7J5?57
zctpAJ*jIT9fr#^habD{O8aPS}@7RBK{wyQ&-9e4=O_3h+CI?&iTR7q4dh}@d+oObk
zB|=%)bV#o2#!$E#exv8IBgdq~2SO)8TgrLx^hvB59)!`C3V&HAAz?F7`t1V!?95{E
zUK!u4fxNGekE5IJBe^AwPb)`8;%%p+%=8QsrRDK+hLj}+b1}|i(<H<vLIEAb7ry%;
z5(|sD{VC&nJECemoHSGw&oXjFzO`)-U>Zg2*V!B<rYmlWDIDR*pNCQ=q747deJMpV
zA|79&*&5WH=%;N+iSYW7^Nl%yjDf3Rm9*UfuKQ^IVv8$>jsYC#_Mwi)mfP*?_>Wnd
zva<5A%*)2MHpL=TH^z_~-hJ3mqtuMg;p@u_HYoiZ|0VT#=C5tf+Q-k+f?~#%mm8m#
zefHX>%VMA9<#K!7#5X%r#$_Q>kRpOrP0Bl))ZK7otBnFE?0<DP$TW(jg7+R(JFBg_
zkE|{CDW-;(UKvmjH(cj6`Y0wX5y+tKDvA6iw~9eTB6UE_KwS_T%1m=K_Nb=M-r}40
zY4aP@%_@9F_B)qs@kcqA3^p&t<z?SEuq84?t)ve^9k8Lv3B7pt0L9laJF@!<5IqlR
z(WCE*LHJ8uptj>geT89fuS9iz4i?_Tvd5}2iz0l6we*+k%h24cy(6PzV&F!gk?$?9
zEkh|L5$o%=+!TfmkD_|KS8+jxlOA7qc;MAfMGf){{iF{P#>=zd-7F8E2Ms*wAISEJ
z6BBzF@ws}Bk#2meu_;l8=%)Xxv8b>1nd<6eu=qb3@Ff67qOut7H#Vs8gVZ@%FxOB@
zvTjphK-BBS%|ax}HwQ1XZ!CnquBhlibU523USYm9+J(v>*E?76`c`dI{2$!?ll>HX
zf~k|wl=i1f%V~UIPm8sqx*{<i+SxhSz0!na+7-hbeeBXV?9vb$4!N@O6)!98N?urq
zJQMqwM|sW}4twOLza_~y<e82%1v52$uQV!hiTbswFV)^sY%g$*O(}x4(12Fm^kAYr
zxkJeWn>nOl^}8UEokDtOw@pxn?W<(-v6mPslArNA-RJH-;M=tM5fQJz*2N@y4n5=3
zKwmY*-yCTM(+)YI&Vec1gfVk(;PuUF&8DW$_*_P2$5{9T*>tqV*3KhNC)U`sxg6H=
zQpm|seH)$CT_L2WRoEF1^w|h(MNiQp{~KDVg1b)W@^0*+IIUuSl#+M+))r{Ek1NxF
zNvge4na7Ep+imYDAI)=AQ<tA1f%_QiH9s2W!o$90X1?%|1&r>KQpAHb4T*8b>SOyu
z+NW21+3RQ>8@6?A#^6-_)u0T(_@1k=*UQNZRV~!$MPP0T{m(jZhDC!s5%_0CXayC}
zybWsq0paCef^ln**6-v5Z-Q%eciWn9aU0Ep^lPiNrA_DHFUv<ZX1U7_)ftuYF}`VF
zg$aRPsnZo!jlxdWj#&Lq4w+>qf|L{TWQv4z#ATH{38VdO^g4dabgsZL9((TsP1mId
z^U@{{Qc}pVB_^xL2{VxdaCo&2`}5+~%Y3she%?3pAq6=>`$^bQP*-*A_(a<Wudt)V
z8X^@&Ta&uO3Ls=1kn2l1g6LD#^f`=frU~}CNOYcYh$=7g)95}K=-6je6`L#vuGdQI
zO_Xg~{NA!s@52w8Cyji%fvAS#P4m(XKekG|<w8)Lxwz#~-6QBUCpWmIO`>oW1?bCC
z9j$F6qa#&JY?w@W$7Z*&(;zfWFN$6{>hB4RRb#X^YG8R0zPHA|<=}WUp)CT6PZ-@y
z={Y&<_<#cBdE@qZfvS1Iw^*`%hwpM@<44)T3ox{E&CGspZG6wh?k?rR3M0qIg@_8%
zC}uyC=bS(Yc{7}zf5PaN1fT#PJy!HaF@+gyGt8<&R1ni!N!T5gkw#k4yU_^Q)u`1R
zK<K)I^bAEn9e~tu(1kF4nF`??pMHbc`|7#T@5<CF5H<-ZTlH_g`<LI{4`@-q92;mZ
z1LMK&_K)-F&w{tLXg%@7%FN3!d{D2hBKx^PWBqAH{|@bF5SFjZ9$k2WF-&5RHEgx;
z<OH>shecssy7KwDau*SDHzy*OzXxzm&P&m|FT%oFi`Y%fHfrC=4E`KPb^Ih$t!J^R
zAZ$tK9?#G>HmLw>go8r@W5=H}{OiQw7TeTK1IeMRHq;^eBp}Vo6blOM&kqu3MC(bS
zLj(4D^9DIZUe5Z!+Ax4Oq{c~VvlkW(B=<&%4a&_M(+f<f8(=rlN2{0kvh3oYzVT3y
zpD#nNd(2;>;^m8%v8cJ0*{)HK%tHl_pXlAXHHsdk=+P-D_z!x3Ha`q5V&lii>!kL%
z!V9>^=N~5-Ob<L;C>`w>#mg~&F<OIY$iQl9P7XzRf1ZKDXk?ct*efsJL2)!NiUntW
zVPU}(ph6H%<0Es}C-R5aVr)QuS;i5Ln!B>cumC{kDrL>S>Q30=CV()2D_1rsvofY@
z=0#B^TpOrTt`f9b5jzY~ObX1xj|I_yUwq6cnkl8u%*iNxZ23NV;0wI2TGgrhp~=Rd
z_v7RKvyjK=^XH%nz3fkpZ8KdN{y}W8T*hK;S)?|PzQ4=r<}dv;)r&21|Ld;vQR{V1
z!g%h33<x)G+1RCBn$PLBm)C1mO2g@s>+UDNr-?Ysw>ZBLDBf^Ui+-{_Yz#)-MU%hG
zDN6H8CKx@M*^kUM7v@a`T-OG9m{BWigj-3x+_j)VRdlF=&q<-ZPQa|NM4{@t{;*6z
z$#UE@;CPcUft#P7$B6f-hu+@mpZ5VN@59=TV1=T^7NfD;vstJqVi~z27(NA~ys&tU
zjQ=MlAwLlUc{%%ZJG-CSf`!&HVZ9;e9~tBf40>e!y4rcbba@4(Ggv0PsNsd(FERf9
zIv)&&$tsWl&|_b1VF&erWlu)MQCHgN5Fw8M+$geB7))efLR5a*60GHooyfkwsKXOJ
zF4oc9x(@UKF@~@N^q_1;0O?1EC`Yuuiqzy$G0D^yED4EM^l+W}`uxSy#0Ge!IsuC3
zJkZ+6dIChbt}rN`XC#IpL8SYeM1JU~9E*JztP~<I?<5o?6JLd{;wduFAf?**Tc1Hg
z6ncJ0ngEI){e`)7)S}$&5NI{H*!!A3v_Sk%Kyw^{;zA-J74yJy3MCmks9$Y0LP4*s
zZMa;w#Ty)Jk)Vc<@rzEtLo=0$<U!Vq*D*7>h^5i@s^y9gIx0}0Ngb5i<F)7+uZsp)
zVTvRQD3G@8q(e8`ek3R+jl2I`{Y8n<Ewcl(B}^A;dT7+5O?0?(wRq?WtPt4B&MR!F
z(N2qVpl6X^_D^Tb9Aph91s%U*(UnEgs07i)2SydN?MV7BpVC#hh?30Jk<3hy%+{HK
zHs3mmGt>=MI^-6WgnIZ3WBd@pinR;;z3C^q*V6FViPm;@wp8y1{Bi`<OenPvVe#r=
z1E}^2AD*y-R1-N}pqwP24M;?cQ4OUeZhBHH*Y9-8QhM;oz()feV>!Ia{G0baC|dJu
z<i18b=kOO97(jd$kyxcQc?CD+%d%%b{(|(QUm>f|;~mrVP{}ect?zQv&OkLZ-7Hr~
zA7e#DLTdI$0wWpQqZ7>g>Q~ynyG5F>P`0+|HX1!cSPJkwSjU0zBxdL3>5oVhsxiTe
z?Hv3Ka-0;`o0}A~(p+ZCN@M&39@|p}^dLRmlu3v6BKD(gzTp~U=LP|~_Zw80!Y$7i
z@2POWQb6Z{e^6mw(fO{XHzuc=7kI8P=T&5X5m}n(n#;(KsLNKkMpl0j(VvWbx9*l0
zh{_ukMW*&?NVsO!wb%!I7Z;cDp`rLTs^(^CculMJoayt=2K~>t+@3;el(V?Yd}gkB
zOI>Jbci_bewI#<dtw1lixf7ouOboX!_=K8eGX0b}VF<5|ii0;p2|w`4^ja2vMBXRA
z*hJgqK7we+9df?=S~6m>|92S6T^w@hvMkKX0Z51fgcc|cXwF!oxc15?UB^Q22Qtx3
zAF#Ad+#Sy?SGe<Jk~*7i+%hol)f@c7XNL%4D0;xC7*U`p{JHJnm+d@k!p0RRxEt-u
zQAzSkygM1GPo3dXlMh=Dc&N%s3A!j9D}Iz`B;ozJ+Gp^Un&WQg7IIHd<3Wv&Y_weD
zjKA$6WiwMLe7}KWsHvl`4bmG{Y`vLF?*6fpc>%C<wHOMt8r{<hfZ`Orhv%Bl6Q%K^
zy1zVW0>^pze|Pu&L^~w+Zp_3@+U8LD-Pa&_QAeGVO1>o_8yX{V;k#!<K@g972&1F>
z?3VK~Ec@_ao61R~)>ew8jlA!p025-6@*s@A;-@-`u4MZd<t9%o$7A28!WO8kIedeG
z8d_PIx<}ze(Mv%Ck#QDBe|ThxZXTnr)|8}-g!np!2-Ge9SoS5I2@oUt9G_O7v?Ce#
zFx-O&4UJmr{{I5FE+aly-6OfC6>Irbmmim&0r3Q_I?G|G5&Ef%HnH)+(e9BrS6YK9
zVA$oezo$*WR1tUgCIBwfR~vz^Z_nBf{-NeY!V7Y^YM~BGLl|JKS0Q&oSnn;4b}CLX
zyT$8}?<idCE+di6`|dPx>6=ipoRqDPR?=~MJ|@Mh)feKqrZ&i_xPwP^UpX-URQzMZ
zsM3e=W>f9ojs+@eKM7~ynORXzBg=W>I;V;!+AHo69yr-+E^1R^?ddZ1NwnHj8n+3M
zjLvFvaIl+&s?PIncJ2RrJP)=?nR3T<KitY#W4N^Ed@c~@_{lTOu>JU!1OIQgOTBv`
zzuz(jZT@>XC{&ybr5X^hktQC{oi1nIlv58nD6$<%`pa_E@ZRUqUd7~TJkJrhcvey9
zZ@1tp)BoWf8lev6tM-aj(`Ku_S(@mmVH<xHVGH#EC;-(Zpc)eUmlQ_b_khaG^!G%A
zd)>b*Bf|$msxjeBI6-tAjPO%?TS7Q2Ffb2GC5V_BXMS(b<^IcomhsQ&YIbXYFTwD?
zgv#rj0$S5%qL_NFdk(3==38PqIu5E)C7A8<FQL-I4v2yiO56|4tT?08dEbGT<);?>
zWc%$O4@516@=a8?A~262y8U9%ttDiB9*c%y&G!+>|KHfdM_)5U;F33wEpk?J*dt#G
zGeLaX-o0TNf!--@b1%4rkMX_SHPGHIiBk_k6nVn`_r@rHr@#8hZo}&CP^1AeQAtM;
z`vx<76Fgi~G)T=OcwQEwZ&sgTZ|Rp9kXY-owpO&mG`{XzUi~m?^3l=UaENt^CoEle
zihbBSVrBn7T|ke%5N1Ar&QjR#5pe%IssqMP`OMfLN}y*f)X@m96Nbrt(ManmJ51;h
z4dp9$<9@g9iL9R4`JG^MSxM<`aN+fGw=Gtx^N{F2ji7%P9MTSBkr#W6>NATDO-&iR
zMbY-lDq(m^kr>IOvSS+xc~NnKm?l}Hjk}_^6L5g|;)x?#z;21Dg~?>NP?p%kO2TWg
za1Q;7AClUaXcE3p>v%_2g=1qsO)$TnI>Ot02&D>pgV$$&>*ZG?7H&CBb{_`E6q2m-
zvAXB{l!sjK|GR-(_FzIq3?)*fkO(=vCuIMtkTZ{ma(x@PCCZvI#;&BpgzWo1_9Vu>
zCE2%-eM#0RWJ@UP*cy8jLe^x-HVm?6Dm#f8WY2q#bI$K~&L8jl{xP5VZ|0uozUF%F
z=X-sx>ro9mqL(dDjw;N6$cH*hYQa?`D!WJ2p2b9l{IVIydBG$QS^i9Stb={e8<Uor
zhZTgjK$6Q89cF)#wxHXDU=14?N5ZUmGW;BnNl2%#Ub5upD+uY*G!pBJ3Sc?}Nl1iq
zMBuCPRPAcE>nUxh^>EWS>oULuNK9K#Ma#%oW%-vOUx@!f+p+&QDf}}qQLS)2B_b7-
zGmwjrNOzGpS2Z}ltn~5=X+>m4<t~nV<VLr1j|`Y4AbI~$^>1K{cOuUYYchrpHz(X`
zIWLrD^Y6$Ofkj;gzS#AvQ{%gyN%KoFo<lxX*rf<?&ixr?<JFsD-ASS<faoXIjPdTh
zpvCy~B9flijAU?r8MVPA#C6&AP9?R*!VMB53E%+Kv1SM9)cYdt6?%VtoATzv?jT#4
zl*6RswMN1pyBmb9835!j7$Fu>YRuzB9zY;GxB6#XBv5M}lgE-%G6^yHu^@*n5pr8f
z+!V3bMly*J{W9s9j(gRT6;eV|Q$U;G%}j5-k2<t{M-e;QKr&7hZSe0ar9ocU0uJcX
zk)JM9T!r=8Ug=JHncQVgbmJnVgUibSBH;M@TA)J_I=YMwQ50??*_)QCQG;$!$Z5tG
zHJCO3kT?md{~2%w(qi)OjpZWMKL>F`yhS?YQb0-6?i6&iKO6r6Ohqf~_(Q}!?YKrR
zo7pG%XU`K)#9;QgTuF3(NZSsb3rk|J^+K<ta+(d+to-o#8Z*eJG5X!s{&+-5IJh#c
z4_eQfk$q+n@?hcS+j{7*H0wBbW2NWh(Z<c33x-U7*Wr3CU4k@_O!=GDmWX@g|IAkH
z>g0uhdDGbi5TpURWQCmxqWEZ1qB(gj4Gz@cI$RrHFJ)PSj;!XV^Wpbsq!=GqwBIFD
zhridCSd#l3sQ!~=T<G4Vsg&{5tt4Nn=bv0JG3iMDE6uVpCk0(1@MLTyNVQ|cumgr<
zLT<0p=G{GuQ5s@TJ2}=hC(oEBQae0oaj88Ocm?~bV{Ow8pRiHHvTdCvD=LtzW-Sra
z5TP$2YFmb;?~Asv%iFVlW`5@yZSgHzAMhIq*Z)DY#g+7+`~tzfeiqg!PMhh6;n7bL
zNBl6ow)1}7cN(%N;X{_ssG*oy?6~A<a&`b)l}@Z?@#1-cy2+~R+1dK<dX5DiG>I&I
z5))-6Go~RbIN^Am-WmN$H&&@BY?WJp@QH`@^FCI|!eVCNz<;_6(%r4)4M{4<I`%GT
zOmlr$%DddMJNw|To1s4|L}d-KK?{>%Pgpnf`NLKwf%m8@B4?_Loys3p+MZ)+RYKlW
z$am*Q;HOq^+tPKsv`Qm<f9LKI^_AL_$y#@x>CLR)`&3&8RTE9|yYg|EO)^X%o=muH
zPn`6gTqCUPEd2O7Gk>8yvcU~;^uF~__OBZwxbEUesyx|rr{_WuN;J+hOlYo&2cN1O
ziS>wQ7sxELvN0<-VfHe0`B)D9PaB$Y!yB6OUCo7kW#>5dQ6Y{$q_el8^qqBdbq&qE
zg$GAFrA!#-l#9N}J{8#C^$zI~M2RlO^*IZ?9_{?@h3ol)^xo)l^AM75^w#M`8E}jI
zem-<h<)5oTWj2U@OIH2~tB-sFzXhKp!$K=r9s}Z=>r&pgB}(>0!>5>~w(h-(Y-!%R
zg6V#Lzdea9mi6&9A0z<29R>ddzOToMjprCW`8G1QeSO3G4Tg;xJ4k)or7CW8GgiM!
zD7(al!NoKNl-?dkgXImYorl_sa~3Q95gAoOEe6^vlU|U=`dw|MM;yhq?os`<#*;b4
z-ztP!(Rzf9&1W%CSp!eqe!7w0C9%O3<7_Pe3m3~o$9c;b(D(%R6g<+P{8?YUXQu4%
zXd_FOip+Bdv^P{fFKMdQVFkdeu2IW%b?M*$X!?@C4S3-QDWR$=yX)oOO=6!~x>~Pg
zR#d%+UX3u~nwXi@o1M+Ca8W}|&+zM&80HUnnV}}X7%&<TFPHF+q>{$f;cj*GmMSAo
zZje(sGdnfX#L6|E2gjSeO2Unj)K3gIcFJpi>`Ad)n<;3{mM;~4K6ai#h+~8zk<#mI
zUYmyn@l4k$B?BX)b2S1P6}SMD_fm9UU!Ng=<&X<?;#$`QL}lrmv5B#heNl0F2!2Vt
zHhb5*kw)irh{?3Eahh|Wb8^}QFE({doHv!PrrDyPF=9fL!|ds+yoC&qk^N7%orX|Z
zs&60!Uz;mEwkf1YgI;jZkOyJXo{N1`WtJD~Rr?{nn5D`X6?rT()?i!w+&P8QGfycB
zIOi`j^mAUlTyX|e1Ekc22I&k(G}@K1oSBz#f;yE(P}O1R_HB_xpQwH5)LfbFr@dCk
zSq4IlHE+~e7kJl;Mc8w)hC9c^<wJ4L0Fl*(tN7m#G1cr-Iz0%wpYq}0V+L#+{#lNd
zC1w)GIp%LPgq<nGtg=*yCRKRoM_GG5Nc`ou>y$402t!^W+#~$|Fjvvd0hR#6Ayd<@
zxs>Efj?R7(_}g~mADssi6E79uVmvbpg=9=j3%{Gk^jf^H32ieN0$nT2Mm{WT5eH_c
zYnvm_&m>a2<C;Yto2vDv1b+I6V<il035KHuj5O|>qNe^&hRUr=!Pk@N2s0#-Dp3+5
zSEGrs6_Yr4o+Ag?DThMg<Eg}DTnb98Yvq+Ago#&alq=3*^uC{8#w%t@Y2Dw_Zi=G!
z6NZa>H%joZONz1@Q~)OF&E|hOCY4bzV#H;P13WA;f^HtFryDJ?t4c}>CumthGc%_J
zlQnt<*d42^VO+byx^Zt!^&92R4_B@a3Jzgxl0O?u7Wa<~E$|xM%ybD&PGeXG1(GCN
zO*Vr~3E>+fl=xT75au5_a<3krZz&X1ILT5t{2_X9v?aLQ9;vZy=kt`C8N%R%7u&*M
zNUm=_$tMBK)Az^xqc;a7)}FE4;;;l>M6j}Mj)Gp5lsdhEs2Cc2mD7XQIvPAnz;oBe
zj@rP76`rvEeXai+2h50ITvjC$WKDePng`|pFLHf=!70Sy4t(Yc!%i^(@i*;xUwfz?
zE;*&4vTYG!YY-IkFUW-a!=oo0!6lb*Bf85ex(a!^ipNh|_VC2=AudXuIpZt>*N5?M
zNH9_R=O7FaodiBU(;BWg-qsij4n4qp?0lYgjRh`3)0}+^v@ISS4$E|2h5b?nl@6X~
z;mYRZFWrF*-R1z~uBufDSOPW8P}^4_29m=;$__CpAthipKYaHsnUjTysqmZfU8_<m
zF}dPZsWvcOEc@}nO3_+f!4_@&nP2Uj$G)P7dDC>VSSWOwtdkCu{x%LI#)vw%3}i|-
zhW#2;T`9jp9haQk{}%$PN9M-?OOQtHIX^)5BuRCQpyhg{bZl*PS4ueaYLNA+e9lNF
z$@+4EGdqcPNKi>5NA9J~ki&q@jJ?RD1v-SJ?7)GMOdUc46X@^9{1^oYw_h)>O0{#r
z$lSuLp!PfE^{s=CE6(!kav(JYKOcwbV7BeNR`-*$f<h+ltpY_eP|Q<5kz2<Vk%d7@
zRibi18`le&T;A~+8!uIyeq?^rOEqK0hyx7~gl6AmQbh1gLSq-00|(OKLG42viyB!h
zLr&1*1@NA7)RW09T3XyzUVpprd;V1S8a)cqc5Rt8R7T5|5;{<v-~3W7oE;mSe;0@2
z0-&xygYshM0Dmyo%{>R`j%=doYWH_l$(l_X5lW?QZipuDlk1zXC5Naw*Curwzj*=E
zm;Mj&m8>TJT~G=m#7$^T0%lycuE>EhLX58Lh*jdg-iNbEDys~J2zo@z*SbwCa_#oj
zc;2C;drXRCN)^^w3Nx!Jk125^^^WY|8r=4&*Cv-@bq)^jL)AC1b$}xatrQhRy6Xnm
z-JYtR>S0S%fS{6|B1d<_THtH*Jd9Ry+9HHnXKT(GGCGh^8+()TVmcJ+96rt?GK91B
z0GM)%hP%mFPw{tGIbYWIWH{N=Ul*k5<!%ie?wiHoaZ+2}VvO>%-Etg{FQs=(Ptcf-
z7R0aay$mF)<SVNIF7u?xcBqSoLozaefGM*z$tj(g?S4|hf}G`(o?ae~6n9ibf3Ok_
zi^X&Xb}KE1+0;}Jmt82Aw%=BVfS)LnNY%!j_<4|3#pP|#hfR4=LOpzM=b^`*bnJM#
z&mdZFX7W|9dJS#zr5Eyj=LZ&(ThBoPRg+OUfgckuJ+{rwE8Yl7;Ha1Hc4Zyts9RU5
z+lj2JV5F>hfp1$UTMC~JIwVo7nkM2>v`9vkGp5DWH0tH|{t_6YO<11i50ax*)VSa;
zui~$I8Z_RDO4a*@rDyG@$T@6_d&M8JDWspNyE{qN6l6~so-d^<Vx{+6)hs_a!WW;%
z9BmzD!}lNfXz&mCC?GiU=8gvNl;UdiZx0KAW)RA4=py7J&cZa{5hC2$dbV8F$Lia=
z7Kc07cgY8ot@$BQSV|AwrVk#Ltsgvm0mjo`Fuj9$y~$TP_Zf0Et!%oc&%;4lq3CT~
z*}Usf{qO^%CucGJCnZpw(*_PvI3EqLX3aI{kxuYrQdf_#eA#1O>m>H*$~`u}2bJ#=
zXzT(<-cwwrBE4-ZGkFh98Y_~hnt6tEli!8)tz~Y9YsdDluy2Py+#_tD{IfKOqiF2T
zk-Fkd++^x1olXL9d?P|@l^675v{>*GPActYCI3N|?rPz;lZi1(^DM0cYDL%G@YA<>
zS4r-zQB}QvU)H1|3$)2*qav3g?NmH>s%;s1HQ30vy-q5=?!dCBqPS*Z;G!F^cgsR-
zV^y%;?i!&J5w#?jv8UboVS@p@%3k9fpvyXc#gzn%Qd6s()hCg`b-U1lSj|IA){vtb
zs$c&exxD0YulL#KXbNE2nx6jYv8#iCQ<l<x$KP(xU!`6>G@LdFL$M^WR{x19DHltr
zLyV3`!oF3yY!VKYjn#>Uw%(Dso9F@+8M$Hu%Y|mEGQC^GD>+^j4w&&VG8sfSn^&XC
zjx6d+B4*vweCNHE|NQ{fZXUU30h3`L1E!caf}(#$pJu>Uxo}}Q7O1qF*!61c2gKlo
z8ad>|@Dm#h5b&Q$R4r{z2{}G!`zzwL9~V#_r<OweS*YVoO1%*@fv5P=gW=t~IEytm
zYTudSDQbW2ff$#Wx1#R1N2(6$yndIk9N@oa4el$Kh@ntCycK~5(kMj}#z?^)wNYuy
zVk#d$2MqJH4{vUnYfu+stYA_LY*qRGoOk4|Qin1Eb$W+krigV9TlGcsle`lmDnd~t
zmQyhGN#)9^D;s;o+epPf>Q8_RyZMX^@SICAEjZV~=@@RajFW;wWCLYy@*o2;wF}_5
zX^)1a3;Zo1MW{S0*xg{LFO+3dfM&Dv^EA_uz?Dq&E6!ZzC*G_G14&6<!8FG!t)FS!
zS+hqJL)}@vtk>kY1|?#qd}OdDEOb^HjGXS<^?LS3oW-qIBOldJi#()>h1OsFs#Xw1
zqeL10l5K438;o^Sgdd%|R_S=j_$@k@6f!4wo9_9}uW34e`HuSp$DieEs5a*n)1w2v
zW(QpSx@Nxhn0D*^kn#92C)m5UnEfvHRA<BWVr%AunXUzqtC+?WpB%l&2l4!66!2pn
z=BtJFNh@TCqi^R!m&xXh*&=U&L4aMf<tp1snw9Jj1V9gSH9CQKISoA`4@sr!WZgMA
zJkx8pO*W8_4<uXn;}gt+bycA-FY_>)Lc1k;qmNNd#`jpS3?)BIaf0zw$f>(Cy3b!@
z8L41Dvr}!Cl=SO&T}y*JV*aj$5quY=cwF+Af+CmSbJ9)*lQ5x<HIGr=&qna2F>KE$
zAIPl$L+M6HchLft?NCA~+2j7)-9ETK7&>$!5P90sS%2sC2#^yGnIO{9&0s(XcyjTF
z&dqQyfdPeSR&9Q4X}Oiw$(ZR&I%nbjdcSuSoSE-}sZ?Hcw@5n$TlOM8fBxL`=Xh3u
zRITlWbgQm4dg<sD)N3M0<SA2iw-C|P>?7hri7NwI_7RvTCnkgKsgdQDC@BevSJ<Ab
zq@sk@(igUnR`UrRSqs2y9N@V5j|$EUi>FfKASq}N)k>wlh!JV)A=(D>?krKJ{Lqzx
zL<P*WJz-`|i<|eo?@XQ5y_UI7pt1a9lDN}-c86d>7MDGPgA)=HbC^2`L^{BWZsG1~
z1gPvUzT>|I?DrHN-6o>b(K?G0V#30CwyEs5YSuvin>E2d*Z6}FT0$a3zVr}j(`dr?
z_Q2oimn`onHW}k^bKOj4Kqu$vuYO{SA=KOn6NZeVKJ!eydvm{hZjLCH0G!M|T?UW(
zPpOr@kgL&Vu*ofCqkqbDy3}fAW`bIHOXWDx@lXHO0x+_T{RK0>{U+h(T=VY#Hqjyc
z#P&k>)r4DY1z_aQ@JH|%0zD<LjTip@NDq3*dhr$Pkc|d|^kqSQ{^gU-Q2ZyJ?KP{D
zjFA04E0-->AN*d&c}41j$ny$LlN+rkAtuMO4>oFlgdUHFHZ%TC58Y4CspI!(wFp7W
zR3GK|yX^bF=*Dk+G4FaT=KXYk>~%=drPAXSR4!%&rR(hJsrUDa06q7x^Tck=xFQ2A
zP6t?Uq*BwJZjnz4lBqGTv(lhky&(2TF)+lC_JO^9R9bqvZ<PZhWz<CQS(}W&t4JgC
z;2^oYsA$US%F0Tbytw$-o5176X`$EcL9B}xGTz&nwN6(xr3Lc0I%b=Optnqa%QvKj
z=4P9AogH`AuJ(+!rS0ZOfK$hSc}i|qx?uoYzf&gc-i_mv`?PT=dd9OtU|uuP4K*Fr
JO69u|{{y2~_ksWb

literal 19882
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
S2j_x-&)(L_rsA|u;{O5dL5vju


From 03394acb620f83610a9300b894ed2047a8a7a931 Mon Sep 17 00:00:00 2001
From: Ton Huisman <tonhu2004@hotmail.com>
Date: Tue, 21 Jan 2025 20:56:09 +0100
Subject: [PATCH 04/13] [P137] Bugfix: commands axp,ldo2,x .. axp,dcdc3,x
 weren't working as intended

---
 src/_P137_AXP192.ino                       |  1 +
 src/src/PluginStructs/P137_data_struct.cpp | 16 +++++++++++-----
 2 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/src/_P137_AXP192.ino b/src/_P137_AXP192.ino
index e96fb80eb9..c53784ff2c 100644
--- a/src/_P137_AXP192.ino
+++ b/src/_P137_AXP192.ino
@@ -9,6 +9,7 @@
 
 /**
  * Changelog:
+ * 2025-01-21 tonhuisman: Bugfix: commands axp,ldo2,x to axp,dcdc3,x weren't working as intended
  * 2025-01-18 tonhuisman: Add predefined config settings for M5Stack StickC Plus units
  * 2022-12-27 tonhuisman: Add predefined config settings for LilyGO T-Beam LoRa units
  * 2022-12-07 tonhuisman: Re-order device configuration to use PLUGIN_WEBFORM_LOAD_OUTPUT_SELECTOR
diff --git a/src/src/PluginStructs/P137_data_struct.cpp b/src/src/PluginStructs/P137_data_struct.cpp
index 65c2f6901c..400b1f29fa 100644
--- a/src/src/PluginStructs/P137_data_struct.cpp
+++ b/src/src/PluginStructs/P137_data_struct.cpp
@@ -70,7 +70,7 @@ void P137_CheckPredefinedParameters(struct EventStruct *event) {
         P137_REG_DCDC2_LDO2     = (P137_valueToSetting(-1, P137_CONST_MAX_DCDC2) << 16) | P137_valueToSetting(3300, P137_CONST_MAX_LDO);
         P137_REG_DCDC3_LDO3     = (P137_valueToSetting(3300, P137_CONST_MAX_DCDC) << 16) | P137_valueToSetting(3300, P137_CONST_MAX_LDO);
         P137_REG_LDOIO          =  P137_valueToSetting(3300, P137_CONST_MAX_LDOIO);
-        P137_CONFIG_DISABLEBITS = 0b1111111000;   // NC pins disabled
+        P137_CONFIG_DISABLEBITS = 0b1111111000;          // NC pins disabled
         break;
       }
       case P137_PredefinedDevices_e::M5Stack_StickCPlus: // M5Stack StickC Plus
@@ -78,7 +78,7 @@ void P137_CheckPredefinedParameters(struct EventStruct *event) {
         P137_REG_DCDC2_LDO2     = (P137_valueToSetting(-1, P137_CONST_MAX_DCDC2) << 16) | P137_valueToSetting(2800, P137_CONST_MAX_LDO);
         P137_REG_DCDC3_LDO3     = (P137_valueToSetting(-1, P137_CONST_MAX_DCDC) << 16) | P137_valueToSetting(3000, P137_CONST_MAX_LDO);
         P137_REG_LDOIO          =  P137_valueToSetting(2800, P137_CONST_MAX_LDOIO);
-        P137_CONFIG_DISABLEBITS = 0b1111110000;     // NC pins disabled
+        P137_CONFIG_DISABLEBITS = 0b1111110000;   // NC pins disabled
         break;
       }
       case P137_PredefinedDevices_e::UserDefined: // User defined
@@ -268,7 +268,10 @@ bool P137_data_struct::plugin_write(struct EventStruct *event,
 
   if (isInitialized() && equals(cmd, F("axp"))) { // Command trigger
     cmd = parseString(string, 2);                 // sub command
-    const int subcommand_i          = GetCommandCode(cmd.c_str(), P137_subcommands);
+    const int subcommand_i = GetCommandCode(cmd.c_str(), P137_subcommands);
+
+    if (subcommand_i < 0) { return success; } // fail fast
+
     const P137_subcommands_e subcmd = static_cast<P137_subcommands_e>(subcommand_i);
 
     const String var3   = parseString(string, 3);
@@ -277,7 +280,8 @@ bool P137_data_struct::plugin_write(struct EventStruct *event,
     const bool   state3 = !empty3 && (event->Par2 == 0 || event->Par2 == 1);
     success = true;
 
-    if ((event->Par2 >= 0) && (event->Par2 <= P137_CONST_100_PERCENT) && !empty3 && empty4) {
+    if ((event->Par2 >= 0) && (event->Par2 <= P137_CONST_100_PERCENT) && !empty3 && empty4 &&
+        (subcmd >= P137_subcommands_e::ldo2perc) && (subcmd <= P137_subcommands_e::dcdc3perc)) {
       // percentage 0..100, 0 turns off
 
       switch (subcmd) {
@@ -331,7 +335,9 @@ bool P137_data_struct::plugin_write(struct EventStruct *event,
           success = false;
           break;
       }
-    } else if ((event->Par2 >= 0) && (event->Par3 <= P137_CONST_MAX_LDO) && (event->Par2 < event->Par3) && !empty3 && !empty4) {
+    } else
+    if ((event->Par2 >= 0) && (event->Par3 <= P137_CONST_MAX_LDO) && (event->Par2 < event->Par3) && !empty3 && !empty4 &&
+        (subcmd >= P137_subcommands_e::ldo2map) && (subcmd <= P137_subcommands_e::dcdc3map)) {
       // map range <low>,<high>
 
       switch (subcmd) {

From 478da66a3b02c3d61d812f244b6a62fd20311ccc Mon Sep 17 00:00:00 2001
From: Ton Huisman <tonhu2004@hotmail.com>
Date: Fri, 31 Jan 2025 22:07:18 +0100
Subject: [PATCH 05/13] [N001] Use a non-TLS client for SMTP on port 25

---
 src/src/NotifierStructs/N001_data_struct.cpp | 54 +++++++++++---------
 1 file changed, 31 insertions(+), 23 deletions(-)

diff --git a/src/src/NotifierStructs/N001_data_struct.cpp b/src/src/NotifierStructs/N001_data_struct.cpp
index 908ee77062..b5602d7193 100644
--- a/src/src/NotifierStructs/N001_data_struct.cpp
+++ b/src/src/NotifierStructs/N001_data_struct.cpp
@@ -25,30 +25,38 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
   bool myStatus = false;
   bool failFlag = false;
 
+  WiFiClient *client = nullptr;
+
 # if FEATURE_EMAIL_TLS
 
   // values are based on the NPLUGIN_001_PKT_SZ
-  BearSSL::WiFiClientSecure_light client(4096, 4096);
-  client.setUtcTime_fcn(getUnixTime);
-  client.setCfgTime_fcn(get_build_unixtime);
-  client.setTrustAnchor(Tasmota_TA, Tasmota_TA_size);
 
-  client.setInsecure();
+  BearSSL::WiFiClientSecure_light secureClient(4096, 4096);
+
+  if (notificationsettings.Port != 25) { // Port 25 is a standard WiFiClient, all else is a secure client...
+    secureClient.setUtcTime_fcn(getUnixTime);
+    secureClient.setCfgTime_fcn(get_build_unixtime);
+    secureClient.setTrustAnchor(Tasmota_TA, Tasmota_TA_size);
+    secureClient.setInsecure();
+    client = &secureClient;
+  } else {
+    client = new WiFiClient();
+  }
 
 # else // if FEATURE_EMAIL_TLS
 
   // Use WiFiClient class to create TCP connections
-  WiFiClient client;
+  client = new WiFiClient();
 # endif // if FEATURE_EMAIL_TLS
 
   # ifdef MUSTFIX_CLIENT_TIMEOUT_IN_SECONDS
 
   // See: https://github.com/espressif/arduino-esp32/pull/6676
-  client.setTimeout((notificationsettings.Timeout_ms + 500) / 1000); // in seconds!!!!
-  Client *pClient = &client;
+  client->setTimeout((notificationsettings.Timeout_ms + 500) / 1000); // in seconds!!!!
+  Client *pClient = client;
   pClient->setTimeout(notificationsettings.Timeout_ms);
   # else // ifdef MUSTFIX_CLIENT_TIMEOUT_IN_SECONDS
-  client.setTimeout(notificationsettings.Timeout_ms); // in msec as it should be!
+  client->setTimeout(notificationsettings.Timeout_ms); // in msec as it should be!
   # endif // ifdef MUSTFIX_CLIENT_TIMEOUT_IN_SECONDS
 
   # ifndef BUILD_NO_DEBUG
@@ -61,14 +69,14 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
   }
   # endif // ifndef BUILD_NO_DEBUG
 
-  if (!connectClient(client, notificationsettings.Server, notificationsettings.Port, notificationsettings.Timeout_ms)) {
+  if (!connectClient(*client, notificationsettings.Server, notificationsettings.Port, notificationsettings.Timeout_ms)) {
     if (loglevelActiveFor(LOG_LEVEL_ERROR)) {
 # if FEATURE_EMAIL_TLS
       addLog(LOG_LEVEL_ERROR, strformat(
                F("Email: Error connecting to %s:%u Error code: %d"),
                notificationsettings.Server,
                notificationsettings.Port,
-               client.getLastError()));
+               secureClient.getLastError()));
 
 # else // if FEATURE_EMAIL_TLS
       addLog(LOG_LEVEL_ERROR, strformat(
@@ -176,7 +184,7 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
     }
 
 # if FEATURE_EMAIL_TLS
-    client.setDomainName(notificationsettings.Domain);
+    secureClient.setDomainName(notificationsettings.Domain);
 
 # endif // if FEATURE_EMAIL_TLS
 
@@ -201,7 +209,7 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
                      // exit using break;
                      // However this is way too complex using both a failFlag and break
                      // and not even consistently.
-        if (!NPlugin_001_MTA(client, EMPTY_STRING, 220, clientTimeout)) {
+        if (!NPlugin_001_MTA(*client, EMPTY_STRING, 220, clientTimeout)) {
           # ifndef BUILD_NO_DEBUG
 
           if (loglevelActiveFor(LOG_LEVEL_DEBUG)) {
@@ -220,7 +228,7 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
           const String astr = strformat(F("EHLO %s"), notificationsettings.Domain);
 
           if (!NPlugin_001_MTA(
-                client,
+                *client,
                 astr,
                 250,
                 clientTimeout)) {
@@ -239,12 +247,12 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
 
           bool done = false;
 
-          while (client.available() && !done) {
+          while (client->available() && !done) {
             if (timeOutReached(timer)) {
               failFlag = true;
               break;
             }
-            done    = safeReadStringUntil(client, replyStr, '\n', NPLUGIN_001_PKT_SZ);
+            done    = safeReadStringUntil(*client, replyStr, '\n', NPLUGIN_001_PKT_SZ);
             catStr += replyStr;
           }
 
@@ -269,7 +277,7 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
           }
           # endif // ifndef BUILD_NO_DEBUG
 
-          if (!NPlugin_001_Auth(client, notificationsettings.User, notificationsettings.Pass, clientTimeout)) {
+          if (!NPlugin_001_Auth(*client, notificationsettings.User, notificationsettings.Pass, clientTimeout)) {
             # ifndef BUILD_NO_DEBUG
 
             addLog(LOG_LEVEL_DEBUG, F("Email: User/Pass Fail"));
@@ -286,7 +294,7 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
 
           const String astr = strformat(F("MAIL FROM:<%s>"), email_address.c_str());
 
-          if (!NPlugin_001_MTA(client, astr, 250, clientTimeout)) {
+          if (!NPlugin_001_MTA(*client, astr, 250, clientTimeout)) {
             # ifndef BUILD_NO_DEBUG
             addLog(LOG_LEVEL_DEBUG, F("Email: Addr Fail"));
             # endif // ifndef BUILD_NO_DEBUG
@@ -313,7 +321,7 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
               addLog(LOG_LEVEL_INFO, concat(F("Email: To "), emailTo));
             }
 
-            if (!NPlugin_001_MTA(client, strformat(F("RCPT TO:<%s>"), emailTo.c_str()), 250, clientTimeout))
+            if (!NPlugin_001_MTA(*client, strformat(F("RCPT TO:<%s>"), emailTo.c_str()), 250, clientTimeout))
             {
               break;
             }
@@ -323,14 +331,14 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
         }
 
         if (!failFlag) {
-          if (!NPlugin_001_MTA(client, F("DATA"), 354, clientTimeout)) {
+          if (!NPlugin_001_MTA(*client, F("DATA"), 354, clientTimeout)) {
             failFlag = true;
             break;
           }
         }
 
         if (!failFlag) {
-          if (!NPlugin_001_MTA(client, strformat(F("%s%s\r\n.\r\n"), mailheader.c_str(), body.c_str()), 250, clientTimeout)) {
+          if (!NPlugin_001_MTA(*client, strformat(F("%s%s\r\n.\r\n"), mailheader.c_str(), body.c_str()), 250, clientTimeout)) {
             failFlag = true;
             break;
           }
@@ -341,13 +349,13 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
           myStatus = true;
         }
 
-        NPlugin_001_MTA(client, F("QUIT"), 221, clientTimeout); // Sent successfully, close SMTP protocol, ignore failure
+        NPlugin_001_MTA(*client, F("QUIT"), 221, clientTimeout); // Sent successfully, close SMTP protocol, ignore failure
         break;
       }
     }
 
     //    client.PR_9453_FLUSH_TO_CLEAR();
-    client.stop();
+    client->stop();
 
     if (myStatus == true) {
       addLog(LOG_LEVEL_INFO, F("Email: Connection Closed Successfully"));

From 042ed7132f040926ede86ee5c526fb42d2fe8b50 Mon Sep 17 00:00:00 2001
From: Ton Huisman <tonhu2004@hotmail.com>
Date: Fri, 31 Jan 2025 22:41:37 +0100
Subject: [PATCH 06/13] [MQTT] Don't subscribe to empty topics

---
 src/_P037_MQTTImport.ino           |  5 +++--
 src/src/ESPEasyCore/Controller.cpp | 12 ++++++++----
 2 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/src/_P037_MQTTImport.ino b/src/_P037_MQTTImport.ino
index 3acc31a90f..3d5980a3d5 100644
--- a/src/_P037_MQTTImport.ino
+++ b/src/_P037_MQTTImport.ino
@@ -761,9 +761,10 @@ bool MQTTSubscribe_037(struct EventStruct *event)
   for (uint8_t x = 0; x < VARS_PER_TASK; x++) {
     String subscribeTo = P037_data->getFullMQTTTopic(x);
 
-    if (!subscribeTo.isEmpty()) {
-      parseSystemVariables(subscribeTo, false);
+    parseSystemVariables(subscribeTo, false);
+    subscribeTo.trim();
 
+    if (!subscribeTo.isEmpty()) {
       if (MQTTclient.subscribe(subscribeTo.c_str())) {
         if (loglevelActiveFor(LOG_LEVEL_INFO)) {
           addLog(LOG_LEVEL_INFO, strformat(F("IMPT : [%s#%s] subscribed to %s"),
diff --git a/src/src/ESPEasyCore/Controller.cpp b/src/src/ESPEasyCore/Controller.cpp
index d01eed6780..451219d831 100644
--- a/src/src/ESPEasyCore/Controller.cpp
+++ b/src/src/ESPEasyCore/Controller.cpp
@@ -560,11 +560,15 @@ bool MQTTConnect(controllerIndex_t controller_idx)
   String subscribeTo = ControllerSettings->Subscribe;
 
   parseSystemVariables(subscribeTo, false);
-  MQTTclient.subscribe(subscribeTo.c_str());
+  subscribeTo.trim();
 
-  if (loglevelActiveFor(LOG_LEVEL_INFO))
-  {
-    addLogMove(LOG_LEVEL_INFO, concat(F("Subscribed to: "),  subscribeTo));
+  if (!subscribeTo.isEmpty()) {
+    MQTTclient.subscribe(subscribeTo.c_str());
+
+    if (loglevelActiveFor(LOG_LEVEL_INFO))
+    {
+      addLogMove(LOG_LEVEL_INFO, concat(F("Subscribed to: "),  subscribeTo));
+    }
   }
 
   updateMQTTclient_connected();

From db9a08cc6f58ca8634a335ea5a8cf9a39dd6423e Mon Sep 17 00:00:00 2001
From: Ton Huisman <tonhu2004@hotmail.com>
Date: Fri, 31 Jan 2025 23:02:22 +0100
Subject: [PATCH 07/13] [N001] Allso apply to port 2525

---
 src/src/NotifierStructs/N001_data_struct.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/src/NotifierStructs/N001_data_struct.cpp b/src/src/NotifierStructs/N001_data_struct.cpp
index b5602d7193..9d0f2d91f0 100644
--- a/src/src/NotifierStructs/N001_data_struct.cpp
+++ b/src/src/NotifierStructs/N001_data_struct.cpp
@@ -33,7 +33,7 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
 
   BearSSL::WiFiClientSecure_light secureClient(4096, 4096);
 
-  if (notificationsettings.Port != 25) { // Port 25 is a standard WiFiClient, all else is a secure client...
+  if ((notificationsettings.Port != 25) && (notificationsettings.Port != 2525)) { // Port 25 or 2525 is a standard WiFiClient, all else is a secure client...
     secureClient.setUtcTime_fcn(getUnixTime);
     secureClient.setCfgTime_fcn(get_build_unixtime);
     secureClient.setTrustAnchor(Tasmota_TA, Tasmota_TA_size);

From 93601daa49e193eee185757328ce432f7c4b82fd Mon Sep 17 00:00:00 2001
From: Ton Huisman <tonhu2004@hotmail.com>
Date: Fri, 31 Jan 2025 23:15:14 +0100
Subject: [PATCH 08/13] [N001] And clean up object after use

---
 src/src/NotifierStructs/N001_data_struct.cpp | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/src/NotifierStructs/N001_data_struct.cpp b/src/src/NotifierStructs/N001_data_struct.cpp
index 9d0f2d91f0..25e878e60a 100644
--- a/src/src/NotifierStructs/N001_data_struct.cpp
+++ b/src/src/NotifierStructs/N001_data_struct.cpp
@@ -33,7 +33,8 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
 
   BearSSL::WiFiClientSecure_light secureClient(4096, 4096);
 
-  if ((notificationsettings.Port != 25) && (notificationsettings.Port != 2525)) { // Port 25 or 2525 is a standard WiFiClient, all else is a secure client...
+  // Port 25 or 2525 is a standard WiFiClient, all else is a secure client...
+  if ((notificationsettings.Port != 25) && (notificationsettings.Port != 2525)) {
     secureClient.setUtcTime_fcn(getUnixTime);
     secureClient.setCfgTime_fcn(get_build_unixtime);
     secureClient.setTrustAnchor(Tasmota_TA, Tasmota_TA_size);
@@ -356,6 +357,7 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
 
     //    client.PR_9453_FLUSH_TO_CLEAR();
     client->stop();
+    delete client;
 
     if (myStatus == true) {
       addLog(LOG_LEVEL_INFO, F("Email: Connection Closed Successfully"));

From 91d27bdeb9e9a761d0b4d787d3b7362eed5b8797 Mon Sep 17 00:00:00 2001
From: Ton Huisman <tonhu2004@hotmail.com>
Date: Sat, 1 Feb 2025 15:26:38 +0100
Subject: [PATCH 09/13] [N001] Documentation update about port 25 and 2525
 (ESP32 with TLS)

---
 docs/source/Notify/N001.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/source/Notify/N001.rst b/docs/source/Notify/N001.rst
index c5bea31931..1ad5d16887 100644
--- a/docs/source/Notify/N001.rst
+++ b/docs/source/Notify/N001.rst
@@ -79,7 +79,7 @@ From the *Notifications* page, press *Edit* on an available *Nr* option. Next, C
 * SMTP Server Settings
 
   * **Domain :** Mail provider domain.
-  * **Server :** Mail server address (DNS or IP number). Must support non-secure SMTP.
+  * **Server :** Mail server address (DNS or IP number).
   * **Port :** Server port number. (see note below)
   * **Timeout :** Maximum allowed time for server reply. Increase value if server timeouts occur.
 
@@ -114,6 +114,8 @@ ESP8266 simply doesn't have enough free memory available to setup a SSL connecti
 
 Only SSL port 465 is supported, as for using port 587 (typically named "TLS") extra steps are required to make a connection.
 This may be added later.
+
+ESP32: (With TLS enabled in the build) To use the basic SMTP protocol (not SMTPS), configure port ``25`` or ``2525``. For other port numbers, a secure SMTP connection will be attempted.
 |
 
 Email Server Requirements with SSL

From 130418da86735ee53aa72b7d6e696eb6dff4c6a1 Mon Sep 17 00:00:00 2001
From: Ton Huisman <tonhu2004@hotmail.com>
Date: Sat, 1 Feb 2025 17:04:09 +0100
Subject: [PATCH 10/13] [P139] Update predefined settings for LilyGO T-Beam S3

---
 lib/AXP2101/src/AXP2101_settings.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/AXP2101/src/AXP2101_settings.cpp b/lib/AXP2101/src/AXP2101_settings.cpp
index c44ae79cd9..a43f18db27 100644
--- a/lib/AXP2101/src/AXP2101_settings.cpp
+++ b/lib/AXP2101/src/AXP2101_settings.cpp
@@ -525,7 +525,7 @@ AXP2101_settings AXP2101_deviceSettingsArray[] =
 /* M5Stack Core2 v1.1 */ { 3300,   0,      3300,   0,      0,      0,      0,      0,      0,     0,      0,      0,      0,      0,       AXP_pin_s::Protected, AXP_pin_s::Disabled, AXP_pin_s::Protected, AXP_pin_s::Disabled, AXP_pin_s::Disabled, AXP_pin_s::Disabled,  AXP_pin_s::Default,   AXP_pin_s::Default,  AXP_pin_s::Default,   AXP_pin_s::Default,  AXP_pin_s::Default,  AXP_pin_s::Default,  AXP_pin_s::Disabled, AXP_pin_s::Disabled, AXP2101_chargeled_d::Off },
 /* M5Stack CoreS3     */ { 3300,   0,      3300,   0,      0,      1800,   3300,   3300,   3300,  0,      0,      0,      0,      0,       AXP_pin_s::Protected, AXP_pin_s::Disabled, AXP_pin_s::Protected, AXP_pin_s::Disabled, AXP_pin_s::Disabled, AXP_pin_s::Protected, AXP_pin_s::Protected, AXP_pin_s::Default,  AXP_pin_s::Protected, AXP_pin_s::Default,  AXP_pin_s::Default,  AXP_pin_s::Default,  AXP_pin_s::Disabled, AXP_pin_s::Disabled, AXP2101_chargeled_d::Off },
 /* LilyGo TBeam v1.2  */ { 3300,   0,      2500,   0,      0,      0,      3300,   3300,   0,     0,      0,      0,      0,      0,       AXP_pin_s::Protected, AXP_pin_s::Disabled, AXP_pin_s::Protected, AXP_pin_s::Disabled, AXP_pin_s::Disabled, AXP_pin_s::Disabled,  AXP_pin_s::Default,   AXP_pin_s::Default,  AXP_pin_s::Disabled,  AXP_pin_s::Disabled, AXP_pin_s::Disabled, AXP_pin_s::Disabled, AXP_pin_s::Disabled, AXP_pin_s::Default,  AXP2101_chargeled_d::Off },
-/* LilyGo TBeamS3     */ { 3300,   0,      0,      0,      0,      0,      0,      0,      0,     0,      0,      0,      0,      0,       AXP_pin_s::Protected, AXP_pin_s::Disabled, AXP_pin_s::Default,   AXP_pin_s::Default,  AXP_pin_s::Default,  AXP_pin_s::Default,   AXP_pin_s::Default,   AXP_pin_s::Default,  AXP_pin_s::Default,   AXP_pin_s::Default,  AXP_pin_s::Default,  AXP_pin_s::Disabled, AXP_pin_s::Disabled, AXP_pin_s::Disabled, AXP2101_chargeled_d::Off },
+/* LilyGo TBeamS3     */ { 3300,   500,    500,    1800,   3300,   1800,   3300,   3300,   3300,  1800,   3300,   3300,   2300,   2300,    AXP_pin_s::Protected, AXP_pin_s::Disabled, AXP_pin_s::Default,   AXP_pin_s::Default,  AXP_pin_s::Default,  AXP_pin_s::Default,   AXP_pin_s::Default,   AXP_pin_s::Default,  AXP_pin_s::Default,   AXP_pin_s::Default,  AXP_pin_s::Disabled, AXP_pin_s::Disabled, AXP_pin_s::Disabled, AXP_pin_s::Disabled, AXP2101_chargeled_d::Off },
 /* LilyGo TPCie v1.2  */ { 3300,   900,    900,    1100,   1200,   1800,   2800,   3300,   2900,  1800,   2800,   500,    1900,   1300,    AXP_pin_s::Protected, AXP_pin_s::Disabled, AXP_pin_s::Protected, AXP_pin_s::Default,  AXP_pin_s::Default,  AXP_pin_s::Default,   AXP_pin_s::Default,   AXP_pin_s::Default,  AXP_pin_s::Default,   AXP_pin_s::Default,  AXP_pin_s::Default,  AXP_pin_s::Disabled, AXP_pin_s::Disabled, AXP_pin_s::Disabled, AXP2101_chargeled_d::Off },
 /* Userdefined        */ { 3300,   0,      0,      0,      0,      0,      0,      0,      0,     0,      0,      0,      0,      0,       AXP_pin_s::Default,   AXP_pin_s::Default,  AXP_pin_s::Default,   AXP_pin_s::Default,  AXP_pin_s::Default,  AXP_pin_s::Default,   AXP_pin_s::Default,   AXP_pin_s::Default,  AXP_pin_s::Default,   AXP_pin_s::Default,  AXP_pin_s::Default,  AXP_pin_s::Default,  AXP_pin_s::Default,  AXP_pin_s::Default,  AXP2101_chargeled_d::Off },
 };

From c4f3a53007d974b45eb7d9c5c176947a454703f6 Mon Sep 17 00:00:00 2001
From: Ton Huisman <tonhu2004@hotmail.com>
Date: Sat, 1 Feb 2025 17:36:33 +0100
Subject: [PATCH 11/13] [N001] Add pointer null-checks, close client also when
 connection fails

---
 src/src/NotifierStructs/N001_data_struct.cpp | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/src/src/NotifierStructs/N001_data_struct.cpp b/src/src/NotifierStructs/N001_data_struct.cpp
index 25e878e60a..584f74967b 100644
--- a/src/src/NotifierStructs/N001_data_struct.cpp
+++ b/src/src/NotifierStructs/N001_data_struct.cpp
@@ -41,13 +41,17 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
     secureClient.setInsecure();
     client = &secureClient;
   } else {
-    client = new WiFiClient();
+    client = new (std::nothrow) WiFiClient();
+
+    if (!client) { return false; }
   }
 
 # else // if FEATURE_EMAIL_TLS
 
   // Use WiFiClient class to create TCP connections
-  client = new WiFiClient();
+  client = new (std::nothrow) WiFiClient();
+
+  if (!client) { return false; }
 # endif // if FEATURE_EMAIL_TLS
 
   # ifdef MUSTFIX_CLIENT_TIMEOUT_IN_SECONDS
@@ -355,11 +359,7 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
       }
     }
 
-    //    client.PR_9453_FLUSH_TO_CLEAR();
-    client->stop();
-    delete client;
-
-    if (myStatus == true) {
+    if (myStatus) {
       addLog(LOG_LEVEL_INFO, F("Email: Connection Closed Successfully"));
     } else {
       if (loglevelActiveFor(LOG_LEVEL_ERROR)) {
@@ -367,6 +367,10 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
       }
     }
   }
+
+  client->stop();
+  delete client;
+
   return myStatus;
 }
 

From 3a07319f90f106d634efc3b720166946d04009be Mon Sep 17 00:00:00 2001
From: Ton Huisman <tonhu2004@hotmail.com>
Date: Sat, 1 Feb 2025 17:51:09 +0100
Subject: [PATCH 12/13] [N001] Only delect object if created via new

---
 src/src/NotifierStructs/N001_data_struct.cpp | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/src/src/NotifierStructs/N001_data_struct.cpp b/src/src/NotifierStructs/N001_data_struct.cpp
index 584f74967b..38cee7e007 100644
--- a/src/src/NotifierStructs/N001_data_struct.cpp
+++ b/src/src/NotifierStructs/N001_data_struct.cpp
@@ -22,8 +22,9 @@
 
 bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, String& subject, String& body)
 {
-  bool myStatus = false;
-  bool failFlag = false;
+  bool myStatus     = false;
+  bool failFlag     = false;
+  bool deleteClient = true;
 
   WiFiClient *client = nullptr;
 
@@ -39,7 +40,8 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
     secureClient.setCfgTime_fcn(get_build_unixtime);
     secureClient.setTrustAnchor(Tasmota_TA, Tasmota_TA_size);
     secureClient.setInsecure();
-    client = &secureClient;
+    client       = &secureClient;
+    deleteClient = false;
   } else {
     client = new (std::nothrow) WiFiClient();
 
@@ -369,7 +371,8 @@ bool NPlugin_001_send(const NotificationSettingsStruct& notificationsettings, St
   }
 
   client->stop();
-  delete client;
+
+  if (deleteClient) { delete client; }
 
   return myStatus;
 }

From 381737af0f7e8405c2e712964579b6681f3a9f47 Mon Sep 17 00:00:00 2001
From: Ton Huisman <tonhu2004@hotmail.com>
Date: Mon, 3 Feb 2025 22:26:45 +0100
Subject: [PATCH 13/13] [Build] Add Powermanagement plugins to ESP32 Climate
 builds

---
 src/src/CustomBuild/define_plugin_sets.h | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/src/CustomBuild/define_plugin_sets.h b/src/src/CustomBuild/define_plugin_sets.h
index 0f695283d5..be1d53aea2 100644
--- a/src/src/CustomBuild/define_plugin_sets.h
+++ b/src/src/CustomBuild/define_plugin_sets.h
@@ -1989,6 +1989,12 @@ To create/register a plugin, you have to :
   #ifndef USES_P135
     #define USES_P135 // SCD4x
   #endif
+  #if !defined(USES_P137) && defined(ESP32)
+    #define USES_P137   // AXP192
+  #endif
+  #if !defined(USES_P139) && defined(ESP32)
+    #define USES_P139   // AXP2101
+  #endif
   #ifndef USES_P144
     #define USES_P144   // Dust - PM1006(K) (Vindriktning)
   #endif