From a426bd1e994e2046ef774e3e4ec221b9c3be6033 Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Sun, 30 Sep 2018 17:39:35 +0000
Subject: [PATCH 01/22] Update circuit-protection.md

---
 low-voltage-system/circuit-protection.md | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/low-voltage-system/circuit-protection.md b/low-voltage-system/circuit-protection.md
index d50ff4c..4ed30b4 100644
--- a/low-voltage-system/circuit-protection.md
+++ b/low-voltage-system/circuit-protection.md
@@ -1,9 +1,9 @@
 # Index
-1. [ESD and ESO](https://gitlab.com/projectofst/manual-09/blob/you-shall-not-merge/low-voltage-system/circuit-protection.md#1-esd-and-eso)
-2. [Microcontroller Pin Protection](https://gitlab.com/projectofst/manual-09/blob/you-shall-not-merge/low-voltage-system/circuit-protection.md#2-microcontroller-pin-protection)
-3. [General Overvoltage Protection](https://gitlab.com/projectofst/manual-09/blob/you-shall-not-merge/low-voltage-system/circuit-protection.md#3-general-overvoltage-protection)
-4. [General Overcurrent Protection](https://gitlab.com/projectofst/manual-09/blob/you-shall-not-merge/low-voltage-system/circuit-protection.md#4-general-overcurrent-protection)
-5. [Generalized Solution](https://gitlab.com/projectofst/manual-09/blob/you-shall-not-merge/low-voltage-system/circuit-protection.md#5-generalized-solution)
+1. ESD and ESO
+2. Microcontroller Pin Protection
+3. General Overvoltage Protection
+4. General Overcurrent Protection
+5. Generalized Solution
 
 
 # 1. ESD and ESO
@@ -107,9 +107,8 @@ specific.
 * TVS:
    + Very similar to the zener;
    + Faster than zeners;
-   + Can only sustain the harsh voltage for a short time;
+   + Can only sustain the harsh voltage for a short time (good for ESD);
    + Not precise enough to act as a regulator;
-   + Good content:
    + [TVS versus Zener.](files/zener-vs-tvs.pdf)
 
 
-- 
GitLab


From 6c8ec843105c378700fa05e522f746b7c46f69a6 Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Mon, 1 Oct 2018 12:30:22 +0000
Subject: [PATCH 02/22] Replace series-resistor.png

---
 low-voltage-system/files/series-resistor.png | Bin 6920 -> 14198 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/low-voltage-system/files/series-resistor.png b/low-voltage-system/files/series-resistor.png
index 01565a41097e8f1c0703e0393bce573e7b926ed7..47f22111a7d0f1acbf3f541c13c31e146cf36a48 100644
GIT binary patch
literal 14198
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

literal 6920
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
YnV&3n0pjukf4Cr{3uXr8de`p%8+P1X4FCWD

-- 
GitLab


From ab0564e32fa0d3c9417bb3cab727d36006aceca0 Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Mon, 1 Oct 2018 12:30:42 +0000
Subject: [PATCH 03/22] Replace series-resistor.png

-- 
GitLab


From ea52e9f1337b5c0fe878c44629b9427a9fc029fc Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Mon, 1 Oct 2018 12:36:30 +0000
Subject: [PATCH 04/22] Update circuit-protection.md

---
 low-voltage-system/circuit-protection.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/low-voltage-system/circuit-protection.md b/low-voltage-system/circuit-protection.md
index 4ed30b4..e018a48 100644
--- a/low-voltage-system/circuit-protection.md
+++ b/low-voltage-system/circuit-protection.md
@@ -41,7 +41,7 @@ methods of circuit protection apply.
  
 | **Fig.1** - Example of what the I/O pins **might** look like.|  |
 |:---:|---|
-|![image](files/basic-input.png)|This representation is a **general** and **simplified** aproach of what the inside hardware of the MCUs pin might look like. Understanding the general concept of an I/O pin helps us understand the problems and the solutions related with I/O protection.<br>The MCU can drive an output (high or low) and an input is buffered through some high impedance device.<br>An MCU can only source or sink so much current through the input/output pins. The exact value is specified in the datasheet.|
+|![image](files/basic-input.png)|This representation is a **general** and **simplified** aproach of what the inside hardware of the MCUs pin might look like.<br>Understanding the general concept of an I/O pin helps us understand the problems and the solutions related with I/O protection.<br>The MCU can drive an output (high or low) and an input is buffered through some high impedance device.<br>An MCU can only source or sink so much current through the input/output pins.<br> The exact value is specified in the datasheet.|
 
 Imagine you have a pushbutton connected to ground and you configure your pin to 
 be an input. If the output state were to be accidentally configured as an output
@@ -61,7 +61,7 @@ Including a series resistor.
 
 |**Fig.2** - Example of a series resistor being used for input protection.||
 |:---:|---|
-|![image](files/series-resistor.png)|To protect the I/O pin a series resistor (Rs) can be inserted between the external input (the pushbutton) and the MCU pin. This limits the current which is sourced or sunk by the MCU.<br>You'll need to look at the maximum current capability of your pin to determine the right value for Rs.<br>Consider the maximum current for a 5V MCU pin is 10mA. Ohm's law says to limit 5V to 10mA you need a 500Ω resistor (pick nominal 470Ω).|
+|![image](files/series-resistor.png)|To protect the I/O pin a series resistor (Rs) can be inserted between the external input (the pushbutton) and the MCU pin.<br>This limits the current which is sourced or sunk by the MCU.<br>You'll need to look at the maximum current capability of your pin to determine the right value for Rs.<br>Consider the maximum current for a 5V MCU pin is 10mA.<br>Ohm's law says to limit 5V to 10mA you need a 500Ω resistor (pick nominal 470Ω).|
 
  If you can be absolutely certain the code is correct and will not be
  inadvertently used in any way you did not intend, the series resistor could be
-- 
GitLab


From 0a323efda53308a25b268b119e2e77cb76d3beeb Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Mon, 1 Oct 2018 12:37:41 +0000
Subject: [PATCH 05/22] Update circuit-protection.md

---
 low-voltage-system/circuit-protection.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/low-voltage-system/circuit-protection.md b/low-voltage-system/circuit-protection.md
index e018a48..d920693 100644
--- a/low-voltage-system/circuit-protection.md
+++ b/low-voltage-system/circuit-protection.md
@@ -76,7 +76,7 @@ component used in parallel:
 
 | **Fig. 3** - Diode overvoltage protection example: diode clamp.|  |
 |:---:|---|
-|![image](files/diode-overvoltage-protection.jpg)|This a common protection method inside ICs against ESD.<br>If the signal voltage has a high voltage spike the diode D1 will conduct to the Vcc, bringing the signal down to 5V, protecting the IC input from the overvoltage.<br>In real world application, the VDD and VSS supply are very far away. When ESD happens, the spike will jump out from the VDD (or VSS) trace and interfere with other components. To minimize this unwanted characteristic, always add a bulk cap between VDD and VSS; nearest to D1 and D2.<br>Including a small resistor between the signal and the D1 D2 juction limits the current adding further protection.|
+|![image](files/diode-overvoltage-protection.jpg)|This a common protection method inside ICs against ESD.<br>If the signal voltage has a high voltage spike the diode D1 will conduct to the Vcc, bringing the signal down to 5V, protecting the IC input from the overvoltage.<br>In real world application, the VDD and VSS supply are very far away.<br> When ESD happens, the spike will jump out from the VDD (or VSS) trace and interfere with other components.<br>To minimize this unwanted characteristic, always add a bulk cap between VDD and VSS; nearest to D1 and D2.<br>Including a small resistor between the signal and the D1 D2 juction limits the current adding further protection.|
 
 <br>
 
-- 
GitLab


From 68a93ae92dec755bc9ee735699ef08a82109c6af Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Tue, 2 Oct 2018 08:57:17 +0000
Subject: [PATCH 06/22] Upload New File

---
 low-voltage-system/files/zener-diode-clamp.png | Bin 0 -> 21906 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 low-voltage-system/files/zener-diode-clamp.png

diff --git a/low-voltage-system/files/zener-diode-clamp.png b/low-voltage-system/files/zener-diode-clamp.png
new file mode 100644
index 0000000000000000000000000000000000000000..7845d4636552ce188e9c52970fea644e3bcddfd1
GIT binary patch
literal 21906
zcmd3OWmHsc*e(qcB3%*=Auu!&k_ICoA>G{#lF}haNjC!0BHi5$0@B?r-3{lN_pGzl
z`ThO+TuX6=nZ5VyC+@563H~H2j)O^#iGYBBBPk)KfPjFchJb*mjDZH8;eHmC4t}6G
zypvSI0Dn9%jDo;pL<a@&cL>Ep&v)RzG<_@c76G9w0_#p66+C`oC!y|ufbg^v{ueP0
z`ji4ZN#+Psb5yi7adgrDY>eRI;=*QbW9eY1Z)ePA``I+*K!_XxLFq(N?5&ck&i=xa
z#<;PEp5r(|c_~T%cToz=Op?)1a;2b$*cVz{#!|KaAg6@%l62YYtM#h6mdwT>P<(u%
zsL05EA?<@lFRwHwx7q!jz0*C1izCk#om;0g({yu}S@->=Q_Yrh&A5kKQCTsuY@f#C
zZi<8Gk8JkCBDaON8wt8v-=0#=UvH%!-kj|acmx=Y{hKIQ0M8#h97lN9vNvC~TesX_
z99*qMxR|DURu^bgSsW<`$RNfC1rf%+Oml6gblc82$V>OaJWw|s|0RFWcshhNL`R`g
zthIBo=x%%YaC?Y;Sy-{;bz9d%?cK=e$AYQ`fhcfH7HjW1PwS%({Oqh4`9M)u=de|O
zu|J1?DKUO?zPm-`b+xi=^*%wzEuZ4`XCph6T3$?%kf5OTrrU!Cc73~mCGW?Dh0g=5
zZAoJLV{)QS5ke;tcEr@)-VfB6sa)U`M1>y{*ley(HrkS6yOMb<=UtXONq%(ooGCTA
zo%?YI<Byf=dR-ga#jAA$;%IO5$N5*Zb9^~5N<lg&)C<<EwaZB1(D&0U)$=Wo&kEd~
zsmK#N?j+EzvY7BIc@|}5F`6B$S#70m#{jwB9ucQ@^1Qvk86wmpYGP8%t!?v1Z+N`h
z5^WRqHk&EWN#QgM)HV*1aF&lKx0v|7EZuK#yxL_mS*YHo?op&!Q(c%L7J*HC2<^*7
zsF^mvav7HwM>P#F?2UY3lc4SV1b*DADP8Xcr+?#p_cyyGZNj^AU_7jXD}p4Nua0}D
zwL^(n@n!35%KI4Ni)_Jx?IOhXzY@sWxh#G$wX4oJUh8QXlNDs;hiWl@W;e(ZkB}wR
zTB+Mgb8y)F^JGX&>@#%^4*ZI>Qw5y-+$ZxDazdJpp|$<RWrjWVL#cx3rn`a{(}t{L
zir6R2{#`_UrTQIy+)PlnuDhcST<|fnM_p#k^T0>@EgnI2kR2n7IV47>sZyx6QrvJL
z;L=0sQfu3CKN&Kc?sa26l`E6745dpkI}os672~s+uZ{Lnlcs!1{;F5`w^H8_mbMP6
znr+j0yyaZAwH-sWx2(vuk;`sT4Voz=+8PYtXF1{XSSc!I46I*wj?3WISf8tQK}wKV
zGM9ak(a}s5R6fSDltCMe%%)WfREpr2<^A|z(;0-<mJ|fWxG*FK;bRCs&UHBdY7m%c
z-^qE(X{7hb#praIT7Ro`J=e?cZ3@C6<!Gh!JR517xxx6I$gXNf52mggW@!j%Kp=`d
z-@Kjwob#Nuzk90XVq;wq)!t;0rd>pk(E#|MCbwI`68iE!%Initj@y4Tc!{><gBFUl
z8<wTT%7dHc7Tph<z<)6VkXZ1dFe@E*6fRf3QEM=K6vO=X-&5_?kaW+Bq;u?>^%yxn
zcUbl_##Vg1d>U$xqqlu&*3UyFR(cB%LWOh1#4u46{i#xWc)EiL!y7S67r$&#*0`Pj
z1Ba*c=8P{=uVCPJ2#^1|;`34LL~{{E4O?U&o>h@tTMQGaYrkxD;U(mn$rgzP^NnP>
zW!3kfb-{ndwR&N&yxo%K8)kljD35qP#Q0&Y`@7TONxl!@7TLG;su4$&pFsj%up_ac
zK``G4<Gg`H4@b+OGJj-OAU%P!hEUq|>WzqkS1)lm2e6YG=D&=W(C-aJfbtsVOz=XY
zOGq0?JEG;|b?6>9JbbzsejRIYo59bX<>>eFyc56A`!%&5J!UpOstyEF$6S4>4Cx;Y
zU2pmEwAACUKrHqHNtA~|@}CB971ykJ$Sg~@%y>oBcu^ivzraiX1=B|_eHLhyipx-t
zW5Meq>2uSi&t!?0c<7%&fWi-!%s?3B@yxdHw^rR}yR&c84qQ6$<LCXrDIHCHp!NUn
zA_olIb*-DPH*LTsI7jpI-)vPufo_YJU2d8h<eJ44xzLeYF&}dUCdN!o5;m@vp<ZE9
zY`fH4{MH}MnW}omB&F{Da%pM5tcR*tDvsGX9e%M)FOgZ|ITLbG{r?e)(Iw!~T^B0z
zyGnhfDU?eWi5~=)8+8{OgQ#L&GCfZ4QS393;h2i1bsUFfoW%LR3D%T}GDGo8u;kG%
zLnNAe>kvX;x&20SFLT2BL=0XnKbXuj)~`YTj@R-Vr85RtgSzWlK12;s+~()-{nga_
zmr7Bx<y3L%oLQC=u5N*~7#&Gh0}V?NqgP;1Y{?I-()Ka`X3|R8Q~|Ji{VZ)#E>J0U
zIb1Au-k)_&cQXhM3X&-9%|{rxY?i7atyC$}IPgJ!%GhUO4h9cw(0)HKOMf+4%vPG`
zhrES?)f_!&U?C4q1L{xahLX=jt^Hb9=-WP%^X(B@egZr^ynO!GM0%V&YQ)k63JB~F
zu*9N17x!v|H_$CHfjN(d7n}%|1Rh>g(Eo;qQ79re+q5-~JEP0ebe@={;5zYZR{|;K
z!vzn_YF@k#tlb&QYXDmS?^U6M!T<fe>&;HyKCOD8rcGTJykgo6{dn!1F2VKRZ&$Ct
z3ZHK{Y^L~euOB1BYY(;t7qIF5_o1Ws(>zZ4mdz;r3I_R>g!l<0r4i%TE2}K0W{Hd#
zYH&sGIIfr=kQ_e4?yzOE)Pscvba6<Z^3CBRO3&-vQ1)iVBy@CD+;7i6OV}~UUx8A;
zkegy-(F0y?53lHys;?|4bET8;f5geIb$?%gk!TbC2wqQXdAvV7NYM3qGW272EH7dX
zlv;o8;CCfDP4kL!!W$Perqq{v6~kzkxfi#GEe&A1sRI)Q_3}>t;qKaIO4|izh%W94
z0YfdQI)mXY4>y)IUBsHx_MD&4K7xVmwk&C?erpG7ov5~+1NZSYs#^3I02jtHm5w&1
zX<u>+v>Tj{QipiVN9p+S@t9JN3WKMz#Bo(YVS>M01}~&<f~no{_>~FsaZZ9x`Kfiy
z!epxV!}Wg)jV(I#6)bTc48rEcyu<J^3pczR<mZ#~Skw};YM@-^R-27v;@oJ<B){sz
zp%UWfk8vbCCCor#;k>5O69$FuAWEF7Yz^RsdMviu)`{QB14FRSaY%*hUias!ssIHn
z7p}7EG*0hVj>)zqWxwZ9BXd3OB3URm9`NIi3ONNux<Q=Ub3B}H(bdr9Uw$3~PH}DS
z^1m}*bgEL4M;X3_^<3H1f15+8mdI`p?BZe3$3{5lNF|7EzB?JPIa%*J=%%oBtXcAE
zaNkTa9sPImW5>{SE7fI>^QcJ;z>*Yx`%G>1;bfixs+b@n@%x)|f7+;Vt|7fLPlS&v
zU)uMZZx4zcwuXw~E7>$F2V3Q0!xGK1D}?AE*|OMP^!_X+mD+u;%%-I2qI}I2ob}^>
zRT@|1il)}obKH*7;SXoA@jyHP8}nbbQV*6MA8IVea=!~6wIVNo+ifDsPV6mCC4PIc
z@9#dDFl4xV3(&^aa+=dN-5@iAjzhy<d1%9KaRZCmX|K<7kE6D>q;&z~(&&LIY?U%&
zz09B3Drg=VOZ{<BR`=FeY}J+1%|VC9>tXLb2guA>2d?OJ=oGpt0DQLn%l~FAOIV*+
zCG*+Z%;{i1=l|Or;p+kR!wVs=(?Py{%heUj?(Y<)qP8j4)%M!;j`j=nPSCpgjpN9{
z8&J3Qg~CEnk=mzwIP_W(+_A^QuG8h5nem!8K^?AIw#fQE*%T(|^pEg)aF7J7pTAXL
zBUW)f{qfGUp`T$o(=;f(n1Abs!+fRr*gTl-EsGOX5&*YHp+fW!efvS-w&^)OIyd?O
zN(BX$1f$Z%7paKnezaU4NOV2Q3N&kqi6*1Tq+U(*T#%u-cntSO(Xy_=BAs_~66ygY
zn4LP})^S}y6}-4JT;4h%l@&VfjP5A~m^n@ejjPQ=l&s>g`IhbK;Jl2TJSie8LS*(k
zwdf)eSMCS(4{QpIX0KSHOSqnvCZg#(p({$N>Uvgb2i&&Z1HfG=5G9}WVTJ;YtQZvY
zevy~>sF<^!f!}=A0Ydv62UV>;b-kL65V`3M$K_u}m;$v$@F{IAM6LaD$veH0Nq;y^
zn01X%r+n~O{~M)=lOD}8EO&sz=1(>T_7n4Ia<2`no6aYR&3t=~z(Sj`7lPj&RL46J
zorwL}Dl8FN1yYmYG|J~i?}IVM4tM4OUaE<<_nmr)^KQ*kyS~QAFifH_47rfQ;zKQF
z3z+%VzazsCJ{qj#J$t;FYSCCAhPACEBS(#9qV0g9S7Vra9*9k*aN_atYrZ8%@5!C?
zSLwu-Ps^8dqZ#kNEt`2-p-?pc#W;=d-6I-H3NDTP@dm4p3fYzl5@5CYC#h{j;QhC!
zRSZ9O<`dmsQeboSHkz!0>)`VfjB<qG>ji*$?aZtFt_Ul@dOYuFvnM7c(^W<5euLfH
z9^4V{d2*sCBaz!ZZuh6h9uPIiTt_^A{*~vGFKh}eV!Y6iK@u{>H|b_D-SP=BuxV68
zH1qyBby5YxSbywQ({kPOhL}ZOhPJ6$3{$-k0lLtHu;cC2N1uRV>aDk@ms29~rPqy`
zMJ2BZ;0@lKjub;u+sJXdsC%hN1la<N3U+E0JcY|n$4cBkUluudQlHj0_Mi#v=q1n9
zcpMdAFp0HXZ>H=wyTT#&C79ak&zxtB6HqS&T)N3jjmAH$fNhCg{mYsv-ibGCA#R<o
z2qGO;%~*Db6?U)nBa%rrFnL+@en*aC{H?+5eoalZFW`fKlku7p>35QHY;Sd>`~|?j
z@Mr;Dweht)w7n8iM(OF9D3DDZDFG2uWwf|#BVxsrA~3q;<FsJpowKT_v^~zPsN-N{
zrD}OpAD8aB)eg2f_T$psqF4B}YOUO15UJEg<f<4!qUHPWeH<;+NYjXnrI^&r>#84G
zqPEsE%@+X3f<_4orhC%6m0hNr9ON4IJ7Z;oMr*v-w*F?VVLf3$K@M~uZxSdK*IpTP
zVql4kcC~!Vw6`c!t4ny2-j;a~8s{EN*RPlAG^wtV(53vEgevI>oTd5NJNhmcTg3pK
z((#idvVH_HGoZ3=fJZ9s0a_+Idz2s`fyA*GL)Q@7#*FMoi}vKglS0tBkf`i-IfV72
znswL7`AWyPxsaE->FoqRh$tIpu9b?G#AWGNw8mwhNyxjK`$4Z5Y60iTH;!TU^Tr-`
zRvtHe)`yOgdaQC>KJ%IRWxB`b(Pd1n<uMCJoj?sbW-@d&tGM^c=ONJI(syDIMGmJn
zDV%>YjE;v(EiIORfBJf|Q6aIFYtnSk;1g?(d$m7#N#`j-KU%2HeJi2MM65~Iepq+X
z58bcx1PgWc&2yqh((NvorzGS~R!5a^o2#i<PdWsLWUlNjKGrXVedJ!X<8ehfRMS5B
zZ?G}lD62mHR=4vB)hVdPmP~}7p&xTGw!}zujud*=fZ23uh9@E7nE8tAzEI0-wY6nW
zPM3v>t{|*QH`Bo3riQbt)gdJ`z%jjJXPMKrO!2+`Su=!NIyW@AOWLAY?1aqvQ?6XP
z&7gw|;QkE}Gm%DSPn2eNyxDT^7BeC8(6I(|MfWqp`t8h6EAmKX?fe_Ou8u`>BWyGr
za>9Aq)k2YBlB&~2NXPZEKW_ZL%@V)+cwW8a$ha@fPRM3G9ERQ4b6#kKqYB9Q^s|yz
zMIL4?k=vYq+fjtjE`$h~cpGcZcBh8fN~iI@reZO^mkbn0=dqkbG2K~#d@HOyjHAcT
z2@9RC>)(<o5K`gJ?-joNT-NLPZ#<uuNShet!AmL%A&`lWSk;wK>*O$(FaD4ZHW@T@
zR5nvyPF&}YnA)@4@RxSP@Mrwj?>QYx>pE&m>r^-o;jf4W$G`I}niXl$xiNnpMmSy3
zU}n4i`ZIt;AW31#I@OI4$rXtr7x~HWX(yVo{9YxDAy@3Z7uyY0JtAnt-leqftN{0<
z$YfVh_or2%zx~h(k?(WM8ewGgkMpcs%zZ&Yny6Z&VO*snl$Y3k>g|7m?}crY1K^I*
zLBw0;a4t3D9@H^Vz5FWv$RD)(u}%nmC`ja1V?t)JP*}CDRVO~H&)ib3C)6|6<wR41
z5Xm5_%z!FH07w39>N7G)TscM^F2RAh7%(xh6AZ=Oai$N!SRePJpz@MQZJCts%hQCD
z%to^%`z(Gt!Y`^{FF01zxRgs=kcK!+Y#(R@?CO0`<2<JJ=XnUwTOhH-ilV9|WvI>r
zn37V(&{*j@;x7H_6^s!AiAFb*7Ir;aE<CV%^XAiRng*l{f>WyY1cnR~SQ|wT8mhNg
zW`IECGs<`d#VdkSpHGXbX0!A^*Rv;jd)hUUB|cY)|DDKu_CrNi6s`E|B<d@(Y|ebZ
zTXNxW>yUjzA6)2U^;<ecW6aX&z^_f{Pku6fji}*d+tETQEhuT8{fBe%a~<H+&)8KK
z8+AoEhst}~t;E`pq+b43gSjaCweC2_7UL3r6||=SinwWw+<k|<tydU3PF)TyKny_#
zH%ZF>dlIPN`^$wMrK)Co&Z>|dfGgZq0!XBC@7>O}^^*z>BZMdGS4Jfq51THX(VyG-
zP;eOq8JB2OTbb+Lf+cBQ|4B@2wEH2WF+vGNMR_=dj~(ED-EM1gwz_rv8iOv(%RJHh
zKFTlaQEg4ZWy7;PQ(9~B?79a6PXE@!MIWw~x%2a7-e2U)_)A<XrUahNyX_WL_kCfY
z^1idz^ytbxM5l7qv$Nf)v{{%<^}5*sQd!`QUL5|Ir_c;Wa<5j7AkC+ruAmUieP{q&
z;ESED1!ifv9AZ2;oKKu5&|%7xVmvQqdW3KHD%zS9bjHyOVt=)q2tFp5aQxD3Y4%)?
zV1X05Ux4ZG&KMC4K%)9Gr<CheN_4ELodUohDm;Mk7rcbSWdQVsfezDue_rD4WSZ&}
z&tse8xE01dR7$1yM^+|<cd&XuQGt$|jHC|0p@WO#jBiv@1?Nb*r+>JIr|kg@-OmCH
z)Cf1U|Db-C&E*egPwjrq(xS@UDV0Yjo_Ou)u;>yo?q9rRz|`zwUdlPI^+ePxhtP!D
zAW#ZAI|5Mu85FGV6dZa!`;WCoebLK#AGyGGj85%QTA-L04r{;b`FqG51$Ohkhqdjv
zs`E+BhBRS!v~)N*WgH1k+g!4qtFHPPGARkvMwfY_I}|MzglYR8$^}`$eIs8bK+gS#
zi#sxTEzo9+8or!vUQ~@MuxnPcTww;s9W%eHZeJ0#1X8R@OjqR#;gae(8$qZ+fl_`n
z59A(bu-50_a9e`{0eiRZDZ7%h1PH^fIy_{)LJoES*#Q5{s7k{QD&-)zXMj@L{Edw3
zGA_J1{F~w5H1*jMD3%2ZIZ{VNyKA>!B3^Q~f4@8ig2hb8ACAS{>$x=dgF5(fcc#i!
z{z~>Aqy3MQ!u%h9c-`Nin(i{T_KN`Zc0&$P<$~zFPghIChe8xJeSq^E0M)4+Bp(Uo
z;=Sra>5C)dHmPm7-?u#g)J&s9ENDqwM)mRG{-ald3SP*19UwdN+IDTI&W4t`rCaIV
z&Fc=jp6AMTw%2a!QQ}fm?*pe^K_I*8^^W<d8z@mCwFdnWSVqYe3hmrh(;O*eA&}a4
z6()m)zE^<YnpLS;H8)MDXwGc)ex?MP@}$|1CEYzhgrbgv+~gP);*Lk-`oYH5Y+5RE
zf2QaHQ1>inR|=SJC6xXJ4c-r@>CPTqM5=0(dSBKohING%>BuMaUS7+P74AVhv5Ade
z6XuOI-onxJEo0MbFx#w&^fI}ASn0QX=;ry?{A&V9bNyJYdck=v`jWu7bX06`!X(9-
zc!zaFs}xMgyE5idFk}a-q3qSmzdvvE6RVZ6b6m!`*r7&K8TBuEKYH?gUYBT4%Tr~@
z5gY$X1eL*)YNOSb@kHWNX$}F3*f(mg>3=^w$U3Rq_w+q~+W;BA7W&w)31+MngYQlo
zVEuERIXiLcW{@YPX8irk$hrEAX0+Clzay>fB?h^=UMk4<h68nS%0_EHIA}d3#iqXR
zKOF*0NEL%OlOgp`q++f2sl<o(ok-F|Zf6S+9Y$i~r=`R!YI+o+1fP!4J=ebTu_#Nn
zb}jm&Xp`u;W;6h(`B9)Q)F>pDKOj!4?RY+`M}v7B`j_FWW_k2`5%GJ3fDE86mlc%S
zHeWMbS-I6Fy282I@d!0T48FJ*S_!Snw$TZxShgKUU>GT9I})=WLHQ9J_On<LDXZgz
zdYh4_?QK#7<b{@9x1m!zy6;!1N-jWCoX1$xb^vm;j}i<@GtZ%Z!28ow9^#ASdZTx|
zxfvySHK6;jO3rIVIv+ztRA;JNOj36$v<e#vc|%nIxVy5Z-yh|9;{<J!OJjv~**9m?
zh7s10)*Dh~uu$TI$A`m5Eg*&XyYq=@cZxn7<2ICHWcgB4#_E3Ah>L|C09BzHN8<SA
z&tCZeTeU#X;TBWCTd?*L4#C>v*E7L5OIlxghg-lXd^zthNed+-5A6=O4Sq)O7xe)w
zva->zwQ#|q2kKfzwEaXX*Ja=Ha?Jq7HS9?^r;6yIj`rCC<+8?+hV}B=|Fg7Ij9-n-
zLj6qlU!!NW?00BP0sg|p<-UbPUD0PcD|H>p6i`JBURMXVvk`IYI2{Jp2SE5I764<X
zZzDn^U5F@9EwM?@TcQ}=0vpcEmLaQF?O$#0`*V7K+&QVE`$o3yU(&5NfW*#j;eS~T
zez{k*;t!=lPL2CgvBAl~q3txGY>sOOiGDQmUG|6Gs6~wj3DowZsqo`d+v!VPe9y)t
z=^5|v3pK7E;I1Yr4?|`V=(=&Fm-7SKr?>wE7K$?1)juPnKdl_33s#YYaos}#z9}6&
z72I2f%lZuh!503XbixW{-{#4t&O1$Mn~n_`6=E#U%(i(qSHf%6?iLc4(w$bh)~f+p
zGf3)Sh&q=UioTZGSNoASMK64*b$eP;mAO4c$2N_|JjB<<5~Gd8QP3#3bk6!$IV1Ns
zOgVX4M@<wCvZwRgo<+5PP{&zAa0bT602lp0ruYV20|=G!hVEP8k%Wc~H0)QWqyW=R
zvN{b*uH3d!&S!?bd+uGly-$_d2;^4cD0Zm)QyPs?dFyX<CYD0N7X$C^|I<UrWRTJw
zEwZE4t1RMhSbnNgsR~Q;xT73Nn?|!Tv*wo8eM0ztGW2@u`9RngEt+S4qcTk+X?hLF
zIl>VAsW|voz7kjwD2x6)x|dcysgd{^O6Vugfl#)9GKQcpjeFD6dI(`8jB4*vVvu~o
z5sqJZWs)}2ef3`bYfGGo)2iTMqajHg3!_1op=%*p0d_vMVT4#@+{?erN@S>NT1DKH
zofH`U-u2T3&m0%x+uwcHvZ_ze>zHyf4l%H8`S<mPkh<|})WQpY4Gp94JIC|4=#-Uh
zddr->S8)PbYR}HT++jc4zTR?Sv7o?6Th(_PaY;BF$@(_I-rbR=5BIPP|8-^BoIoLU
zzL(<Z*CtkmR^OYp`(a^*VOe4Me*`!fy5F~cXeub_%7qGHC1A>bKqThjKv8YXh&SoW
z(S;0OO6g~aFcTxbSHG5K8ncxaWmxr(7(HUQ@T=yvo}IRbtmORN>q1rOx(P+)stl%U
zcy=s`)#ruws}BiTZBHpDXkBzsZbtC$Wq9%{^XLhk4T17omUewK|L7+-4)pJjU<)jq
zh}=(*(Xbg$t;E^-8An%e{2@9>g;P52thIbRqu-X@bL@_Uf@;3<g&<ghs&)}|=GwRy
zm(cf5KzE>%NI7#aPTV?nt7TY}H+$CW<=wshigGBx5bQH09E+^aJAZEkORQux8UUTa
z*#j>5v9kBlTLp8wUsyrSMF0KD@^g<dRDPMd)h3OK6^tp<olh69<!9Wzqb1{gcif|L
z*q)Moc*Gpw+bmZYk7am_toYS<LzN-AO)AhCCrA5a_wq=}l$`sH=RqnI%FaHqmUTfx
z6|yd@um^WC+cmE)16t(7PN+-l*|J-u-l|Y<Aq$}Yb=!pN^X73eY!6M%+o`C+D`8$Q
z0FKRETn8Mg+BZ!U+oAZ_qM&v(m(c}SxV%+whaoEOjy%h1?1owTs0rPAG8vdd^7W{v
zv)ycBo$JY)C3OXc8|+FTvwSqqU*+781zY3-<;u1Tv(wRbJOJDTy@}Fc>9P3S!t;U+
z-$H><e@0uqbA5A{e!Y1^<5z1mB*iS7Omt)|$mK?<vSW9?t`0APGPOJYX1urFq32U^
z!J!tJ_hZ+UmL?7@33f4b@?B4NJy(@CX1X8R#TF`qo#`97NKxorr^^TiE2Rc>1nf6I
z6K<^UCi(pmKTQ@Js6RbJ7x+f^qjhCc;$oP{`_Hy}(EmmCqHPHLD+&izF$MY#Of7jL
zP~R)=l`A`wb<dR+Sl?YK_)LS-PzNsg@i@EFfhqdi&Ea(00#2@`5zD?TqPLCUVgz@x
zV^*ET!<kzl+X%xsa-#R+;cI=_xWv%YH+FIVZpjdYb>)Dzf*Yw&<OdLpxm{(moiHSI
zK1RO_LIQn7F@EtH65#KQs$~?_r(gYYiu0k=Ad=sQm%ERcCdYsO;!etvJdPwJtfoKX
zwc%bh#JH=GyD8k@*u7F&_Ono*Lk>;!WBRZ9dIF^~K|ulMy=^pHDytrSp#bxLJN`c$
z!P{)YNO+gzLQ+^P8sE8<%e@++4Uie;LwhfJFIi)7<9O@|RAik#sTPj<3NUdt=*eo2
zR9@d%B}e10<JCr8pN|FVOUs|UZcfwSPX3w8{3l^v9H*eVzpq$piTRuKvqR4?#8<q{
zposYm$EJg~{*m4XPO@{DD9~;Xfb_&X!~889bK~tFe$FQGzITMAhGZ|>U`7dS+I#%z
z#y{FtsfULa<rh~`RinK#J^X+6QTY;03;hUmU$I0gzUi$s9u*Jp3AE{;c@M*RyQlO*
zF{bd~G+-a)Vr7;~;d)%^C{YcOFvZyLU*v5^#OtsEUeU;BM|d7ls80>uQg82H(b^JX
z7K2ew;pIN~)FLJ+Q=CP{)kai7C6B85v+Q??Z4O$|Go$Bv!F2fNMEpEYfQ(#WSRMN!
z;ExiSI#apkpE=X|CtMWKH%y|%HhuVbX7Y-yadZPg_sr_$24(l!y=L;?-u#6jbQ)&i
zVlRn;(7-_C$QZ-Snqdo@sP^@wrtM5Wd3EBl>8FIZfdjVDQh8sDZDE+m=L2DU+jBLx
zl9FP@23q7mM`ATFn52;^6cPoF!+zq2?0~-^9}rc1k66(^za2*;hHU_F>?Ii(<MRzh
zlzrcK^NeQX8$E%M-_?v!Ut;wdOh%N%FGW@7OINwLmNH%t=Q%0v+|J*MKsT0RvA)XV
zd-j&Qa+yaC(rfF?)r>9_sC~WjzJ)LOxyjyC->@EY8j=?kMTGryss6<|sPCjbzl;NM
z**+5;avBvT^IBWH)i<A8&Gxq^4od;0yoGYBBFwV1Hgm{vOuZa0X9iD;M=igsGeIWO
z0ny<ag=wbLYK9Anw)OgL3Q7ocr(AYnwDHU7o~0QwzRjH^TA$oPnE}20F!OBKQR8M-
zNzJP1NHkq)+t&hl@<Rm&*r!e+GR4R{Y&7}wCx%3N5NW29L(MXSfQd5Bdx?wCrUnHb
z?zp=w^1{7=4RV(Hbj8(HwT><Wn6^-kqJI}5!(o$$NXmv#<<E@C0^oZ%XCw{7MR8i3
zl0s&jhtn&$j|oVH<99UCSmk7T!G!pzYBLE1h{Rp1T3^fX4?79uDm4Z}qGf$hE%ZEN
zj;%5Z{YG(-1lXicug^afD}EK*lI}ALp>;c+#V*}II(87KIXWYev#Mqbx^&u^C)5fK
zq7&~<UB*nZQqf)P%{CRR^?THO=7WE=Q33Srhx=Pi+7Y7~kX2d0^tt~~Q<#{k$G6ZF
zLMKcOvMy+z@fb#9+M808KJ1k!a#sHkM|bSl;J%*aB+IRYC;d#7)|UH&F$GreoyEIH
zzJ67}OAAdhT|Sj-rtn&`?Du|_T`W!dXDInw_k?Zar=S;$PHFx{4>Hc$Dr=RociTI4
zW+)`uGBM;m@cuulNDffXeY?JYa@vGeFrSNY?T=^2nWrI9bmZ{1vB(0*6L`<*#T}$W
z%GWZE=Q3fTe%!!?4WZUl7o*)Zl*eUs&fBBYjkCmwxBb@}PmPZ=i`4lsE0;h|{^+&&
zXf_B`R5J1d3+3eI2^*v<cuxpgaDR(KIR-QdL&0LRSlv<xd5*fgF3a5#-2}0DU9lE2
zi^}7RM*HGeoTg-tjBN2shtZ+FzpOvvp!t3;L$G5|^+5_CFqJZqGsE-yAvesft2Pm<
zpeR4-oTu38E$uEAdTP?%XcV-cr}acpe#Y#RN@4pxv=PqE#e+x6gcfk3V`OLnnZid(
z0Bp7nSRRbErj%|2Wu}&}2-CB=Q$V&GmL(dG7_R#Da(qSct&#u!lBd08H14@zeVOVw
z>L%CwpSyY-bxzJ_qh%LQp6{HC2^0HFIcG+{JJRdwJSM}3YD(n)p;HIW^J$OUp~M~D
z1s*Z>S@P9KddhlSESGsrBJP#PU$>sWV#DI&`Uv~}VeCC~TnmA4k(nL|t_)6o05Add
z?c{Ez>wOAD@qz=%zkjd=@sVl`;iRJK*?ypBc(tit(>7cjdOyyE;|d+MVlFkNnk(rJ
zr2HCTR7@gFO+e>8HsyIiT~fD6J~zZd9q0biWtQ&<>F1?5(Dz_lnW1c-RkiG4b}9nc
zQiqMF;lQ7=0kM_X0Hnh0DC=~7djmU$oH#5*;$DNOCWF&k>7@#0jXD%HN3<=OBpLgp
zW(XH64yxLSE0CAr`LX`-H)n~4;boK)u<Si>hKM~PlH<N3zT5;un7-n*mih=OR27Nk
zB00x&vx`L6YHn*i3y_5Pqg$pHBaGrvbJwIWq{8y7RAhE?URt(-lj#VlY*NP75UP}_
ziYG!J?+7wrGB9Vkym^D=R$pi7tnEM?idlQuisuT@L~7QwFiKrpPJ$D6OIj9F9fn>z
z|F8w?zCQ*W(~!y?9{Ew9vD>)3n6qsFf+)&mkOTwJIeP#*Gi><Q`4Q>JWH7}U23Y6A
z#?8gPWzQcLxE>Y`l@dr1PB8U>1rAT)aW4$KEA~(-wkFRu_;lw5H&slHYdo$$Tb|ND
zqC=+-<Gob(EVno}96``Y$<;34sQ<0s6ZIuvAp2#V%pr490A{X6FR|9oF$7QWxB!7&
z(-(v!##jjGH$s(3{n2r&Cw|D2i+VK{(GlVG!3yz>auz{)&UOoEQ!Ghn1!gPN0y`J9
zEMT9z)UjLFieZrP%eqs{MF`DFC2SaDO_(sIf{lY@S9RS6hz0!RqJn$M4Zu>Hx)tba
zPO)vCX*z1hYEyUgSkC?40HaHgNB?0tZJh<YduOe*fVFGL9iP4hm#*=1z2k1FXB(>c
zH~ScG5HoaNl!1ia4CcF8u1}=H)lkQ=xV@|?%#T_X0VIfIQh0ch)Q8_h>^}Kay=W00
z0@W{diYFLsPZg%aY)OK-_QoK9wMPo<$KRetL<pV<#f>LYd>&VJmbu;iPs`P#J%I&M
zeva3dTToozKbS5m%0J*KZOZL5_<c~9pwGXG8WP=e=e{{#=fJbrsaJysr`;Ev@XNgB
zQ+CrFnI60(e6fAv{$|7>Scx%F{9Ln^MXj_|MCt-=TW^%-GYyzOSsyi@iNeC*PpaP}
zwk_ex6-ocHNoEOq0f}a9mgxi*^a9xB_S7C~F}#4#u{T{}^+y%(Cb2m$%u=vEE=JaH
z*Rqa5SYcK?Vv$Y_Fg(xLy(^G_m<P~@;)gLc*?^L!;ySV)>>tXGJi&P;0$vn{t_N<5
zj0_uA4M87+NzWasyOl?jEs#RnWj??)JZfR;FADAxnJ_HD3pEC;rZ2`*=6R{ri(FGD
ztx9&~Of?>FeBy=$YeFR+rfnMbrBr%1-gn={$cdC`R$sTEh9an4gA#{XijmfM#LN|b
zA3X+~GMiH0oRXPY$1$1xEU}30fU!I|+@XG4>(^#zc^XJ~QD<-?{vzu0Q-Qx*Tx@S}
z1-5_UXmG)TNmt>?1jFQmcxTNftr(D81L{)rA7y^aGP{*`w{mZ4w->S!anE<BY9jDi
zxk4T1t(TfT^KDs_j=-uSytGtUNE9?hHHRGyH-x<Tq#l1yne|II%Q-A1Xgvbtp=QLp
zOW+D`xC2qjy`uY|SLIB7q}N_q&z>jBgKf+(*CO+`?u<gT?9}_<muY6VIEx^1GASKP
z|7*Owv=bluj*v(c_<R@C4%->u;w{((t>a=mQA|ZD_)Y$hx_~^&oPF$7OAC->_nC8a
zn%oY0X(O;j2&j>to*P;9y&o>(Kq9Ypq%q4=OTF;{Ud*)LB}g=>$FxmjGykGouM4IP
z=WpK!il?&&*vDsvk3Qyp(Yf7X*R=VX*G`5FXILpubwT2@PfDh^n*5cS-ki=S!AL9U
zi(-{8vSTFSJ6h%K-zoU2Gi8axOXJW6FA_g2pX1{`+F+hAMH+uvb?S-UjAzxXrxJGC
ze#d}oR`6qQttk*254J(%gqVoEhN>AMUm=aqv0K}i)1WL1(6SXGk)au{^Xc;SBiQKX
zrUx92<V{N7_)<My!Oi@Ox`wmSj~@l94(oS|>1|~}-nFVJoyu+dg}Z;wzUNf2_P&FH
z7AZf5+jeR<mcR@#o(M(vR5u#4(6AY9o0lQViwB&L)^8*mAW&ezqrYO)n*U5K;C2Ln
zGZzP}7Q~Z=nVI{8hQsQK(iL7(6wg-^^!x^vnPN<ja2;tk0Il?nitUZ--m8sNp)cj<
zA!}Pl4cDZhQ+OpWAJ80sU#NP_4==?&y}k2z=!QhkdAMBjEqRRL<JE<APiP^8KYu;S
z_B6AzWob$`s;U2S853+7T9oN-|MKHyFtaY0f6UTCS6z5Ylndeo*TT40O^CDk_o}9J
zE~4~W<;Z&8Qxl4AY_y;+d7OUVr&<mjF-PSB;_z-&x5=bYaW5L)RT!lpuZ<5ruK#mY
z3o6x^%Jk*#Q(~02R(R_bl}0T?f`>wLm>~tPx$2tD&Oz;9%csZ4`VfT>lHQdW@p#+v
zSfLl>6Bb6^MkhE|foKKE9;xeJv+doD>=|lF?`doC4W-DXeDWsd{yQvtRlcGBj3RTM
zo0q~>G_N~>D;h5Gu@PsrlXfR|TdDDyd}4mrjYw>U)UEu=mIbbb@zn!6qQwXcfrCiQ
z9WD2D?TKms`w)_0)HH&l!S&S_+{iZt#|9U@^O5I>W1ZNtg(}812!1Ju$Y^TIatLA{
zg2#E;XO(`vHMAI^wL7jd_WBpA7m&vDlRwVq7f|(y{~qzfJ&1wH8|~$MN$e@uF@NI4
zx(FJcA9wCaqRRRuUMU`3^ahT%E~zg)8J8XB`#i5=#_P*deu@1@;J~o%h>Az%C^tar
zLg~7aOw-JJ!rY~Ax462Q`#nhwZ!Zt2CGABFHvs386J)SET~lp_D*B)nw|_Cr*!;>@
zKYeZZ&j6!75nXjt%GJy9V16e23GpiHZH{ce>94yfKWWBuM4DO&r5^E%KDqa&r%4u}
zNa{>}@6p7#jE_qZI$fw4LJ4(@cP}?O5z(KQ>MU>D(|=Tf;-TsKu|I^52jczeT6Nm=
zMr$KFH-JPp$co-Os#ciD2#V|$R`gez<qFwx0vAk)Vpt;WQ^&6S=BMPiKrPpkLsKoo
zJ31XkLZEGnNrke6+MeUFhi+7;qHKXE)Hh0ha;Ef|7e^sDn;q>=URsne-=9INvbl_F
zsJuG-{uED3e{mkQKNhP=yEFV2J$fX@T<!CqFFzd;oYO<KE@g|JQ=4ASL;v!9>;0NZ
zxvJ6My6v1;zjAcH_fo{a{AH$=9xiI4yU_pmU2}!L`-$+epOQzW&=DC?#T7FGp??Y|
zDj0L>>U!t3708>m$$MlcdPd?uG&3I8&aD3+dc$q<r?mYNSRS=Tn7Av%*o8qT>bj!e
zNpXFRL5AJG!fBdrfiH4n>xR{PbwMp-JC9ejP)(m2M&~j@Gn>HlDIp2>d&(0`01oW<
zjQa@(<|8Qhh7ROvHc-~`mYlwFg<2I#7fN83X1}{?cT#B$P(9>K?NNFT@}M-WN6}Sp
z5XiWwe_X?e<!MSYg!_KUXBFD`LHW^$FlW_?B%Z}FR($Xk8BJo2&=&GLYDs5OYB6`p
zOnLN_f4GIw2{Nk|?=eUx>KT%hIQ^6CP_(TJDhua~4DCMRAF_BO8ve4q>y`1-2c*P8
z?M8d{bf(s5OuQl4fV?O7XEf&+$H^0JJA}ozJ7S{BDk|edS}qGtlgQx{K3+#z;>1l>
zZkGqvumfp&27)0A`c-OowX3B+XL_}LmjBTszeD^et!_UeB;wNKD|YYeP|7W4t_={g
zymZTXre|gJR)I?^`=%QE?DgJMNjfD7poR)B+Rv3sS{~{LmrgU!+|{}MUJ0<WdpHpc
zZFatYwuZ&3XxuOgi|^0dH?Qx({DAi4rgg;YD`F<x)3ZHpe;Z|c`35WaXsUC~T{9ry
z@m}zt)=-inSgD3UmjA^S8(yDNEZJ3V`l~m&Wu|PI)iH7NM*W8Du6<VYDGb?RemVhq
z7M#=;LtGgMADP3_k&JRE6#dV<PSi8(4x#LgjtN9x`bz7&&^gN}qD}pvuhPv8lTLtq
zRz$jhE~CG)%-BfYOJa+EH-adFhg9nNG5ralXKA9WCt6Df9~V*7U8~ZIePvQp46RxT
zW|<M!FB#$SSOym_#jgAkdxRY}rEB1A3TaM>IX`VekCTqW0&@ap_1_@IE0KnftK*<o
z2OY`mnzgkq<A<gxHrsiEI4gw~Pr%6Fydg|mfONWX+FVE=`_|`sk2o4gtCZPk2HBCg
z=I(lUs+8;S0qZX0)^^SPz9oR1rKQYG2qh7oSv#LtWmXeAK@Zh3V~~~;>Zbfx)^BNw
z<|oK?3JOS?7-`H-aF@~x>*Qr*R;rpq>y6_II9{*7inaL!O+L8#5kaUY8E}%sT>N#~
z4XvzepGwh4n$m9%n{se%#q=5>v{1F4UC)n!8llT(jlia<^)Nhv2*PMcukU*MoI2K*
zO7-EGK>EgJPhV@H43h)z#`d~Lf?&c`F&O2G(9_3?8GjkE6D%m^6CE`i>G&4Y;j{zl
z$1CxpnLT~M=Wg=X6jgfpj)#j2vwus+VEhHtX$(eaJ|_J}6J#AAKkhvDxg-)kt6`MH
zzBoL}(s@xCnfBI@Go54BrxGcreheIjQr3OZ^v>s9fukrScP!3iM~ITl9;wvNdw(4}
znC13N@@q+cu0oroI(p5kxhVx)gGu~xgQlB*1-nEO-?-KI_ewjYE_SjpVvUEgd+SEm
zZu4tsVm7&r$|6$DKZt^DWSZ(5F`iMO*>5R1axPUN-coi(EKD&>JmJ{wF9~~_bIo=u
zM2Dv<6f#^6PpZ^Vm{8PX<w^}PeI?lp{$x&|Bsr<5IShqZc7H^I`9X8B$(Be(J2d|h
z{g!%kr<D>Kjz$<@Hm^*ynsR9lG=H|p!i2$wwJ0I+*3F2Eu{dV?X!YDPraO#GvDp2s
z%n$xDBezH&sIojSB95y1aeb@1QRpx2poQdMw&Pb=sG18$nYdYzsXp{!G~c&4hs{;+
z0=bpSt^}%E^mSQ}guZJlOE`zU<ys`9Mx<(q@TP8~7z?=*Z0}8r(%7<RaKFY^D-(FB
zuBeo+hBCE6(+I-#l0C}mO8`Oa2I5lNkgx_Pp9WS8mSLF+aSdu^%j*rr+tdZ_ysh3k
zDZ<5&#ZbsB)Rs~%=<Cv{Cn;F=OX$wf+PgOYz$Q{>X53#v8q3_8*@KIWlnM-Vf4*oj
zkaFBV0L)C#<gqR*T!8stl4j=<2uTo;>EW4OCDSPkj`QcV>%Hku3d5VB@S`f19=CDY
zn;x+_M#A#rPB%Fm%^5%|qPeOQa#5e@9nQvxF@Jr*jDq}J(X|oH1M#J8kd~Mo>K@ii
zUv^X+?O)nm;?RTzu!WgI?aiqATi>55Au&HtPYd|*=}@h4_B<!>n7YB>*zx)EX4A6s
zisFbg(M{Psa6S*Az{<l1=KPx_Nkiv-A;QoE0+w{!2xd3m)6FIK$NS5<wISGeFcrv@
z#CM%A?k>O9VHtf|>e``y(~gTKEsRaZ)fv9_qJGm|sF=+xW0*q1oT;_HIRv{j1hq{w
z6S~b|@#}80WL&!w>u)v(V=HqCh`_(ua$u|VNM$hObyB#)xx3OHA>HczJJtcMo?+b5
zLLm;Vv?%T6I6^-~MnshT&4SGICR4SAJnV+t3r)@_%AnIBy{SG?M7kP@qtV46S6vs6
zNyuq;vWiL}_VuT=&Mwlqe}A{HKww)^gX<Gj@2}f(G(V<XLc;-$5XpXoP;>MPvXg?0
z+RV-08LA~Z&S@B``h?r|u+~akHDjU&bx7COP#iQd3;b=p=e8W#=G5oPdLc0k9uNqX
zy4}T|p;Nl9{U9m@kA~6lFZ&Q{?ilOBS(9U&Ho_UPPrPk^2sXsJn2mk98cS^5w)3D;
z73UaGG_}_-PfQ8>z`Uoh5LDDXFK$&85glNpsvLH4`qLL+){$@UAnEWKg~G%P@TAKg
zcd{j8SSnDv@h>j3UJ|JnE8!#!_-T}aER$x@%ejp!0gYS)b!;(x_lz2S33_9njV$>P
zPtTr7>1SQ#FX+^e*cHNlrT;|c>NP5R_VvS05MoU^@5(Gq8y6kheaHlXd#ZBvLPCbf
zOy_vC9GWa1kT=lO>wZV($C}Lj%_W|ZwcJ1pW7H$IHTc8GR+_tw<l{T%Kg&o_BEIwK
zX3D0Vl4N>i@369O`%lob5Qa-EPK4dWLU0Ct=XYcVrJjlS6GCywNYzJN0XNh59={X{
zT91gh7FeVWuvob?3L&`<!CWXvP(M~ARzDgM{8&83vdm;wYm6TtjBn(WS@}nw?}?i#
zUZuQT*EsbWp|u&~@0Xezc`y3<BPazYk)U1?#O8%DpNUppZ~ZV-ofy~Ryh=cYQvYJl
zsLp;h=VC^re_>9PA#pv%++NO9t^75o3^Y{Djra!sx${&wuahG2rBHWGD>z$|Qhq6*
z-;QGW1`{M-X+lf_yh>_*J!FBrmeG4@Tzr=3sLbM+1xRmN#dg@AFZD9-XKcc-C-d{t
zEK*N*zDar#wG|Ps&?RuSo{TUIJ{#!gGhrD|tpIQTjHBrP=M86EkJU3{fmiQL4Be7>
zDxjTbJ7cUEYl-^-W`2Kun~;-p8%r>REU<%AEy<mdBp6804r6$$Hu<3ZM~tfnYl#Ac
z&cynugP*EUIB)-L3z@t<-!*+p+B2?ECMgm+N9O<%djJhkSKA?XjzVf7RY8<4^CR%i
z$RNVZSVUqd%H69KxT<8VreUSAdr5D!nBchzjwyzz43@$qcJm_<#YTB$%tqpl!9#qm
zp;7DKe8rbjKi?t?5`z>IlNdO`-yA0}fhr6&7_>akCqQ$a{Q(d;D$HB#PPyW5$5!Hm
zgS#WBZE=RCl_~ZLK1BThXP0>K5!z~?aR_=28IxwS^iqwJLHZ%$94Divi_G-L3J7f*
zP^**oe;%q?bSp4w;lbS8&X0o%dWFIxTOTzLi4&Q#Z=p2+w4+=Wzu#nDWEj%4ZK}FG
zO@G`Ad`kJ-a{_#bY{qO5(lIKV?)NVeF%$W~T>%6(4U-T9*W~E3lSumX%E6Y^5a>LJ
zStL0t0?iuqgQ@;Qz_Q|yd<GLHy2Y38l$Du0pVGBe3`Egwa=)xjhQeQD0Q3&}=v{a$
zZ6TyCXWB*)ESb*$3DcBOqA1SHuTG$WTWq8VJZoz*cqT@$tzu;j^vbLciQHN>z_Uy?
zXWJvyd3f$*=7y&58_Ao4SqkERe7l~oXHGy-s7vBDt<U+GP!A73d4i4B*>LKhE0m-m
zFU_r=H~zVZN3HwA^%jvCyuoTjLa-II45b%FrY@=isR-vl``dR~&`PqlY(?1|&+2Sb
zyMl(*`ro)}gL{_*EtdzGxZ>2Y&%Q$ka6Qe*2?)8Fo?h)=pB!wa*j9hY@<+odPpua&
z*Dz{o*IoisRt!@fymibI=#jpZU}IdcD3X1>K{(ay>24`NeqaxKKMEIGF9ZO&s9<`x
zlo*@-_P9*KybM3GUew|iW4q425rpKzRG)BJ55hX$;|i~X_FvhCH;KT1cVG5Jp9h+w
zISKJ`srLAPKF~5X1x4}_$RHj7Rl)i3;j)E~vDh1+@Oh9FIkc(UAa(&+!-km(Q%w{8
zG`NQ8g}&qu;x>~yf<i+;o*xvxTK1<;C%}uESKRToeJZ(>>PjF0G;AxMJc8RGJlaA*
zcXJMz-n6fG*hsH#j7L5~wHq@6kh!UPUVM9w|3i{+yYsMylbqWm40WW=k2L{9XWB}L
ziYo_nGG~G|-w$>X4wnlq=_x#x@su&j^hdach-h=KkLRVbK>{Z}2PC{ex93Ca@W$4d
z+GRTyd!^47xO7~RhW~n})J;=2;3-Eqxw-`XDyZq|rUR@sl`T&2<{bBjHwe5g2U=6V
zm7!Bj?k-q&t1@M$wp*MQ319Cz-(>)WiJsq~7~qtPACYIJy&<7jV8A=7tmk-ZYtCvv
z!Fx>4?TyerWOf8V=XO?rWKnHjp_U!?xmJpS1Kyb>MX8km`tgcE1FrMkg3FS+exrl{
zhLo!>zE%{|0tnVvCm@i|+_ajGWWrR|5)RI|b%z~!+LS@_Gw8P3-}}A~0s+qO<{8jl
zR$XG)hSsKjg~JhsO(Obj*`lDRy8Li|JU?dN$|pkfVS4e+VeQ(}TbIZ_<CkCIT`ZPJ
zmXn3{AXizv=IR<|)QC~+`lE-+y-@IGJL_Za(sfN3IS;cwgS40!^M`%}cq39<RK>x5
z((3mS&1R1;c68CCzW3w#imaji5KOLoD@Iv6SY(&QBs^f+d;w%nrarZtcf4WCL1C0+
zGoTA?!Vl_KXc+#wySzxm=LLcWXrH3&fo#7BT5b1d&A3`zix6F`4mx>DuFhCo4Da69
z1z;`>MdB_T9t&*_+-U_3Fthe7enLo%aJ`0VOUHfR7?FJJ5cC5?dJcmAxJ`Kc2<(he
z^O0Pwken?Zv%fU_%)(r{Udaq2N)ZyIPSPUW4j{Bx58sEwg}F3<w!_kgc6^@y>=|C9
zPtz;IyvNqlSiOOd7arELmH9HN-|`xhe$zcWxuOIOn$vE&9hLeZ-{n_v&TeFY_sQvC
z{x!emw;p)k+{`ieu#n+cBS=J3D4?l%%?9wLj*iQ8tqzugRypUw9c)STBx(-RrHuFJ
zg5h0+)b0k+!VvCQOe~IGUK~n+@&DYSCW_35{*T19N44#tLXAM|M->ll2{eZtf>a?!
zIPZGil;JVACtAc*zU~GT^v$yycdo0xQ!dh&5Qz^M)}z-*rN^%Z#_sJjz$n>m!c~&v
zqWh&CPuqlp@gk#StY^wM(7NJL6r^=qfW4q1xItgA577(l(Uop3$^1^_B}1=a*?t-5
z-=wzUU7@@4-ziRGmC#nTyFxqP$B&`&dSP-%jXRB)_{L*<_4slR@pqJKR;s(+pHKOh
zNV7ecpvQ0UD|>~HYN~T(3j%~oDB>VDJOZ3Pe90*=6G@-PvAzlZ=6Cgxy=hzpV<?fc
zLxZ<ar)gG1oKraTHKUuH_;>`X%J1}HSZIr#qzh3F*viw9So$Pa{(Oq%aX0$1eY%0Q
zPy@oYQx&FinyJ0TC`J`SLZ{L-VERsPMVZr%G16J!tsK`JM-10|dxjSklHlyq726L|
zuS&U^R;HFwVrs_Xyicqc(y%>$ZFfI_sAul{VKh$vPFG;F=dDJ;H@N>x5q0FKb+x5r
zWWqSnvVb0fK{6N`B+(@$*lN%pC?aB9*EL6{K}VI_Waf(yvJg{Lp2BS!e(sy;%uM7a
z>zgjO$sA?JJrAIEZ!P^U#g?i@CP2Y$Q9(gUuRvmSXx3p^c%K$=h(JzAzo!i24LrNj
zW91Ze5YH)H5U|_WZe~aR;F+JhQ~rHVtI=HQ#sMDNc9!NywyMeq0=>TgKMYcuJCbe;
z@`)2l1`c+bk04xR(*4D_%!X9FA0(V%<x*&__`<bflCuXReOiuTK+LXVb(<1Ev8Qr2
z4*azi>$&}_d>IZ_DONHbwaU_;cm<#%I6O8*cnit;;)iEl{S0@(?X>CNDM;Dxa1oVp
ziEAdHUI^q=P<~G^t1$H=tj^cRdj3gz2{^Ac;JYg34wo;FPtD%-6TcqkkD|={?!U$7
zjyAV?bYBLq!ncHeNH<3+@>GZr>lYkgY1V+Ir#a3$lVKsY>V*}aR!$u0C%-*hzTCJS
zHysN!eLTooO6GMR`T_oW&hDwxiQ{RN>e3+M1{_M0fc$$NecJ@+Sy}^X;@P=hfzfY}
zoOCB2HH&={f=x`3JcgS3GxROIq0|Yiomx+vUx*-r8%LSI=f_ONj!2H<c3lJdf_mIQ
z#*eWUAFuB%=z{2*z*ZqubSnIia}Z+AS^gRrD7Ye;ZYbtwovTYj4k6Nnh-z%08R<a|
z-oJPmrESO#^J9Bh$WM-xI#5I_umVj^@NSBAL?o>0Kz+;SXk+Clsz0#=WMKK{7GNhI
zLQxHl99&yk0Cfdb6#{uJ3;%YGAc;=UV*!4Ofqvot_i+6uuxixSK22zV5b#S7<$i6}
z>VsI_L|Bjv@XjOr3kLqD&DQ^4$FUvAL^;}R&I8zS@bvY1<g#?;5zx9DK+o%VcuyGF
z8XPkT5=ZS_-!45KfB;g$@}D{p&zoA-nt3k%7^UK-3k|qG$me>bR|EVU^vn1~_}7vY
z)ht?k_hheIk6zXZ2DpY`9=K&DJ-XiaRdWWRtb4V<Gse$C_?Ugi)XGdjtp|f4s+@(q
zZXG2AvwJ;9QTBD0=TRHFq%A0RRV53c`(o8g#DhY>@t0?j1R?xxN$C7mugC>KdC5_D
zwtCO<|MYUE@lfx39H%TrmSm`8X`;w-l9DWSDqECJ#7MS`aASmyk!2!MveO|&8&aaA
z&>%_)6G>WWDA8iClP$vi{M=sm!MXR@T^<hN-~YFKx6kLzX{wzF8MDc=QJ=6&QvOfg
z&;QlAo~wXC6cY&(gL4hsfhzZ(PWoI0X#6ktwibJGt|1Wo^Xvb*=(di0wg`?)WN?8T
z#;wQNaB{-PksJ)P!&O)z^tuwan0XrnkIeh|^%>(1RYH@{U8vOgR$)M8{N*EmFVsw;
z@rI915jVez4knWU>UKpwghg|fSU<fR(liHPJTEwF&YT>2wqs-zv$EfjlR@V2>(0qZ
z3R$8}r;*q8!V0(N&LLlX5C1Smk9c!cE@wz^m$m$f0Kq0H!&EyNwEGks#Auy~<k#=+
z^i;6Vj=eLF#@|VxF|dMePg5!FFL}eoN7;<6+8J;NdJk|*LHt0?BNu>hBk2B<cN0s-
zmpPY{PwNNz`6%urN1u3BB5sYP>8c5&Oi6$6+-#RGj>+q~V*0rsGw%8r(-C4x@FvL)
zI5f?d%-ir1<iMdx^@LRfCV4ZY_x?y>Eqqd6BP|}dx+_;AgK`YE>BgB{0FOKUt!ax`
zDFLydG;eGS4CjVUPhLm5%G98?yvW|V;I>!GP0&96e2Ph44|<|988`t!Ga`K$0Wlcp
zd3mkZtudn;f`bLzWz-fw$h^z2z5u02{g8EnuKt}`rQ72(r5_)s3%W}v<+uk9nz|7d
zL0fr%SffxaaV%?n!f$nv3|jt1ryREM0h~wTAQl~%Kc7P=LFpA7GQEd)oTQH``6Sf<
z&d0Wjc=ZI_Wy(lp#xHFzo<Y&zw>9d!H(TuY1cMP<AE~zpSsnOsN(Loi@a}Ybs=rCx
z2M%C2Ak!$y5Zpq*JzhaJ=2`35pTzErD4+O@H|dk$`T+jw4rtoS9Mk6&AnhHgwDK6H
zeeJRi8*XtwUn+Cp&eM1zt^GsQX!WLP(d%KE)#*K;#mHtD9S_|YdVE{b*>O~ZSVDGd
z9{2@5sq4?VNp3WbQ;2d_c4~_Fl)A^8Jj0%a^3bODpvT9EIaIe_lTr@93BS|Qmg+;H
zFRW?15AKwbUBhU7E{i`l0LPMY^gE$Iit~JNj}OPYw8)uwxU^uF+Q-Kaa@$a`mc?mD
zm!wD!8}IQdH1d&>wNu!ID@G^A0z!E%T>nclQqWO9XsIDGi1+WBHx~+u{q<Q{HBY+S
zP2w6HE}5l--}2}KYsnkclPK^#*}vrq<V8VtRNs$nK37i;DP^mWk#!d|WR|);U5?dd
z{=FYz8%uuY#X<-QK%guLN9~(5PdP%V#4^!1OIS+nhKh-eNIaYv;RLs#V({}YKO-0D
zzYQpVi7)@Vj}yo)+F(KJ27ckyyK^@?-M?ymZ^3Kr!NmUAm|gbD$<feoI;zyr=?V~|
zvOzbA<5Fn$9Vp07zSG+GjYJ@Va+rjshFEc!@O_fY%W?_icY-q03k3_HOS#>hlioTB
zm{imZ`N_WYrVI-6Hrir7+t>nf)lB{%QEDu<OJd)RXl})5yC-cE&`)t{>{%Q0P`fdQ
zwXtvCInGad{}mgYjS*67&1QM~4%iC)<XJ;W6By-31e;yPy*zLsLi8q&_oF{lECQ3c
z**tkszWi%ZA)*#Hc!gHMyY|n&_qV<v2K$j<oJ?u1D%ElfEwe7ipl&7FWeZsu;jEXX
z2i-~gW)uT$HpVDx*)+csv+}7%`vY;>ncM=Wjpo)SapwaO`rc^L{C2)nKs3BcSWil)
zFKrQBU(JA>sLDNa%WgsXx`j?E^@-d}o;*`xUh&3;x(>CRH`+nM196TJd#S|~2MzBh
zwJ+ajbd;n<jcyKaFK!p+Th=I^w;xi3>w6y@(-z^RX_O)W&wt+oB|H|aVx+a6u$|&h
zen(@23r+?>o_OXC?%43XT4<eBhx<3ZFL15p3>#3X-=j6-3q`x*3!Gy~tAr6Ui4}u-
zUO1ru$wg6If3jXt^o=<?#nu8J73_<$t@t`B-zxW)wN`WjAb|vbAVO@zYXzOm#Iy4#
zDqqw~UQ^itTkJV;*xvCw)_?dT->m_aXfy7J4l<Xl&0nGzL-8cs4e-xOT!v-5*;NKZ
zO<Pir2%Xxws@w++jhu$CYYyczm=SG9F**I$Xy9v(#qL^zy&xXhuTY$!#?CbEg#@ZN
zZ)LdZtd&CAECb$yQ*c4~zOp|UHvxhH-1%d20>W1oS{VwRmhZIHm;8k-M9+|g@XMiE
z!d_EuBIX5d)v~Q8m+xj-uMT;Fgp^);*y|Mc0#9C@xH5r`#HRy;A>Y{%+2fgm>%^_%
zrgvHQa-u0KCo->~8(vtjk?*+BE@ey~c$yi>Qk=Y&of{=dt<kR0QIv5q$Qc?NCq?l1
zZsNEkZlISkF+3ueF#7-paz=K=``TAZ=BZcaEjx}L{^}uzivdE&9bM%+0|6uH>m<1y
zER99Om8rR86f_aS;<bw6jH#+EPPe?PM78vQ)$UpHK+oX@^T@s_Fausrj6<DN27O*F
z17sv76275q>71$H+|JCqsa*ny2yWfYm#Uu1TOIxC!~Y!FY<m45dO@5ReJQKZ$_NOe
zHXjvC*j1GlWx7Eqfx*#mesE>4$hxJ&Y2zq8Ci~JDzHssw=*6$luRK<JDAyLCt_Da>
z7A#p$Lwf^kh#}g=PzwJ^_*R7m9OP+Msy6v^8mB(zrED7uD9pAs%x=oosyw!{s~wjm
zG_0uC=f>MN^QitPzYiC6Do)jdmunr78HQ(d&58Of)lk%dW73I{R%fHZsC@uH4z{7H
z*=I(@rZpJ9t)xaO>z6#NH+z_A;(T*?_F-S~EB@OJJ3YNE!>nB~gz4V}182WZQlzkS
z>*`L32%f~D+uerXZqs0~bNMeWman@9oa&rAdyDUHIu~Vn@j}gW^A-2Z{FCa(9>vZ|
zPT89{_uG*(HLtiAu{FjNj;mC<Ztp(F8reNVR14qgct_F^IYs5b=d1)KNe70T%vOkq
z=7_VB+_XzR0KMdKIK=4c&AHiE9VW3I%-jT%`RTDALe$q(eiX%uEDy0xQBG-)(hZ%S
zc&o0Ed5;Ao9pTaxU3y@$#P=w}z6{AztMhxoIn(bg6!FuIDQAJCo14Jsc1^ZqiO>sA
z<)79%trg0f_jPRm*-CpD#nwJWhjsO0Evh$^`!{V8Y&lHJzCbTjd@a2zr?qaqe&SL2
z2>fTA_Z6SA2zxkoy07<sWIsSXbK|uorxtb8Dp1UMZIZTL_E_B}t?IyKjq6&6QKlU5
z4XUMbv%1-6ovu<V-}yp+VDOj?+wS9H^s4>p5%PFD*$}Xui7!zaFrhTAQfh7eh-|Uw
zV}RpT@T}bS+G+k+NN{TO^nwRwx8+|DVO09(<MZtcuhhM|*DR*m5}x^G(B+c|M+CoW
zp6WD_fz_TEzgmPO&b9Kq`oSxAgFpdd^k8n(Qj(eYc-tbrA5770(&LN64!wRNzUD1~
z3ChMqNlMg|px%4qtIL}zFT9A3{mZPkHTd3jvLq<IPzq{+tlqZr+vFV5YM3>LX8vH}
zTLue2Ltk3iZ;FAqRa5Vb{q5B%s9c1vlF4K538N%Eqd|agZWSzzNKsy9{N<sPfoZYU
z9UPc%^d)pTy3=Ye0TzG}wsES`w@9Zm7*WBzre0K5mwl^ISGD`muQiV6yPL<(>{;ow
z`L?Ob%IDTkj~z(~ZFp7truoQ-Fq(sf*L>!%_rJ{l+n(Mge>P}nB^9%2W@{eN6EAeG
za*`SB=}w_J`hNTL<hG3%Y5&=jMwwP+R)_a3=v1XIlg=u<lIx<Iq|QMvb=^#Zg>9-T
zQ0WfNp)VR@X}#?g!Oh0m&dWT!`S!*ZoG8&g`6sRWF6X0vwlnEr5=*fkZl06=`<^Tx
z-<PCuxnj0K5mv2*z<Chm4^+(N47or1{4}fW{lgfCPmO2WV8BM~EdAB$s8RHKmM)*w
z@nHy&`9_Top!KQkUpLr;L7PuOlxc@ch*DPdYw7k|YxjH2s&M5<$T%(Nmr<pdV8^-a
zPx#J~NbA!~Q`d5DEPDGCgOiD~RBB|rgm8`iDgn0`d8bA7FU~C;#Xfg|&+Nu#re#aZ
zjEZ`AFH9y5us}xy8yO18)8+CCRUXzEOU1O)hMHPKzCCV(|56UmXo!%xjJ;UL=K_U(
zEZEK{^2MqmKOK0-%xn}9Z)a<$35qOsr7O_)KF7&mSB>oBlsrv}&cX#yn13pW_e`f!
zYx=4MUc8$`HlN?XvY&x785u^K0HoLkg{KE&A<&yL+&#?0w?%rchrE&H7}yc$0*bYL
tgk@$(&EX+KD8+xE%l@k$KX9jK%Vtt8#yc5&1tOJatC5A__07)Ve+T*0?K}Vg

literal 0
HcmV?d00001

-- 
GitLab


From c64aebb7db4673b33239cf0f590d7b2270039085 Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Tue, 2 Oct 2018 08:58:35 +0000
Subject: [PATCH 07/22] Update circuit-protection.md

---
 low-voltage-system/circuit-protection.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/low-voltage-system/circuit-protection.md b/low-voltage-system/circuit-protection.md
index d920693..ddc005b 100644
--- a/low-voltage-system/circuit-protection.md
+++ b/low-voltage-system/circuit-protection.md
@@ -102,6 +102,10 @@ voltage reference, protecting the circuit while keeping the voltage steady.
     + Vast amounts of information online if you need to know something more 
 specific.
 
+| **Fig. 4** - Voltage clamping with a zener.|  |
+|:---:|---|
+|![image](files/zener-diode-clamp.png )|signal and the D1 D2 juction limits the current adding further protection.|
+
 <br>
 
 * TVS:
@@ -157,7 +161,7 @@ features that are often difficult to implement with discrete components.
 
 <br>
 
-| **Fig. 4** - Fuse.|  |
+| **Fig. 5** - Fuse.|  |
 |:---:|---|
 |![image](Files/Dn-1.jpg)|Trotection.|
 
-- 
GitLab


From 5f38ae362d425ab84f44a370ec86a49c28e625a3 Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Tue, 2 Oct 2018 09:11:42 +0000
Subject: [PATCH 08/22] Update circuit-protection.md

---
 low-voltage-system/circuit-protection.md | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/low-voltage-system/circuit-protection.md b/low-voltage-system/circuit-protection.md
index ddc005b..7ceb1c6 100644
--- a/low-voltage-system/circuit-protection.md
+++ b/low-voltage-system/circuit-protection.md
@@ -70,9 +70,13 @@ Including a series resistor.
 
 
 # 3. General Overvoltage Protection 
-Analogic overvoltage protection solutions consist of some type of component 
-parallel to the circuit we want to protect. There are several options for the 
-component used in parallel:
+
+The simplest solution for analogic overvoltage protection is an approach called 
+**voltage clamping** where some sort of component is placed in parallel with the
+circuit we want to protect and clamps voltage spikes. There are several options
+for the component placed in parallel:
+
+* Diodes:
 
 | **Fig. 3** - Diode overvoltage protection example: diode clamp.|  |
 |:---:|---|
@@ -117,10 +121,12 @@ specific.
 
 
 # 4. General Overcurrent Protection 
-Analogic overcurrent protection solutions consist of some type of component 
-in series with the circuit we want to protect. The main analogic component used
-for this purpose is the fuse, but there are other options, such as circuit 
-breakers.
+The simplest form of analogic overcurrent protection solutions consist of some 
+type of component in series with the circuit we want to protect. 
+The main analogic component used for this purpose is the fuse, but there
+are other options, such as circuit breakers. There are, however much more
+complex solutions using comparators and some sort of control circuit coupled 
+with a disconecting circuit.
 
 Types of fuses:
 + **Fast-acting fuses** open very quickly when their current
-- 
GitLab


From 7f4e312569b56d8a1b538dd6189018f216d10267 Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Tue, 2 Oct 2018 09:16:21 +0000
Subject: [PATCH 09/22] Update circuit-protection.md

---
 low-voltage-system/circuit-protection.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/low-voltage-system/circuit-protection.md b/low-voltage-system/circuit-protection.md
index 7ceb1c6..2bd7263 100644
--- a/low-voltage-system/circuit-protection.md
+++ b/low-voltage-system/circuit-protection.md
@@ -106,9 +106,9 @@ voltage reference, protecting the circuit while keeping the voltage steady.
     + Vast amounts of information online if you need to know something more 
 specific.
 
-| **Fig. 4** - Voltage clamping with a zener.|  |
+| **Fig. 4** - Voltage clamping with a zener. (a) simple Zener diode  (b) higher current with transistor buffer|  |
 |:---:|---|
-|![image](files/zener-diode-clamp.png )|signal and the D1 D2 juction limits the current adding further protection.|
+|![image](files/zener-diode-clamp.png )|The Zener diode voltage is chosen to be slightly above the maximum rail voltage.<br>Under normal conditions it will not conduct.<br>If the voltage rises too high, then it will start to conduct, clamping the voltage at a value slightly above the rail voltage.<br>If a higher current capability is needed then a Zener diode with a transistor buffer can be used.|
 
 <br>
 
-- 
GitLab


From 5e3dca720c2615643b545a2f1d99b2838ffb04ab Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Tue, 2 Oct 2018 09:17:44 +0000
Subject: [PATCH 10/22] Update circuit-protection.md

---
 low-voltage-system/circuit-protection.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/low-voltage-system/circuit-protection.md b/low-voltage-system/circuit-protection.md
index 2bd7263..792be61 100644
--- a/low-voltage-system/circuit-protection.md
+++ b/low-voltage-system/circuit-protection.md
@@ -108,7 +108,7 @@ specific.
 
 | **Fig. 4** - Voltage clamping with a zener. (a) simple Zener diode  (b) higher current with transistor buffer|  |
 |:---:|---|
-|![image](files/zener-diode-clamp.png )|The Zener diode voltage is chosen to be slightly above the maximum rail voltage.<br>Under normal conditions it will not conduct.<br>If the voltage rises too high, then it will start to conduct, clamping the voltage at a value slightly above the rail voltage.<br>If a higher current capability is needed then a Zener diode with a transistor buffer can be used.|
+|![image](files/zener-diode-clamp.png )|The Zener diode voltage is chosen to be slightly above the maximum rail voltage.<br>Under normal conditions it will not conduct.<br>If the voltage rises too high, then it will start to conduct,<br>clamping the voltage at a value slightly above the rail voltage.<br>If a higher current capability is needed then a Zener diode with a transistor buffer can be used.|
 
 <br>
 
-- 
GitLab


From 32e52d235f6210e42014e4956d080356b3976bbd Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Tue, 2 Oct 2018 09:39:11 +0000
Subject: [PATCH 11/22] Upload New File

---
 .../files/temperature-derating.gif              | Bin 0 -> 30738 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 low-voltage-system/files/temperature-derating.gif

diff --git a/low-voltage-system/files/temperature-derating.gif b/low-voltage-system/files/temperature-derating.gif
new file mode 100644
index 0000000000000000000000000000000000000000..ddd7c40b49d2c204d21b5c5d57cb56fcb63126ab
GIT binary patch
literal 30738
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
VFfcp5#H#=R002ovPDHLkV1jeg<(mKi

literal 0
HcmV?d00001

-- 
GitLab


From 57a26162591f9cb7c8504f09ec65d7c0c6e660e2 Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Tue, 2 Oct 2018 09:39:46 +0000
Subject: [PATCH 12/22] Update circuit-protection.md

---
 low-voltage-system/circuit-protection.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/low-voltage-system/circuit-protection.md b/low-voltage-system/circuit-protection.md
index 792be61..065664d 100644
--- a/low-voltage-system/circuit-protection.md
+++ b/low-voltage-system/circuit-protection.md
@@ -126,7 +126,7 @@ type of component in series with the circuit we want to protect.
 The main analogic component used for this purpose is the fuse, but there
 are other options, such as circuit breakers. There are, however much more
 complex solutions using comparators and some sort of control circuit coupled 
-with a disconecting circuit.
+with a disconecting circuit, among other.
 
 Types of fuses:
 + **Fast-acting fuses** open very quickly when their current
@@ -165,11 +165,13 @@ features that are often difficult to implement with discrete components.
         + [Basics of eFuses](files/basics-of-efuses.pdf)
     + [eFuses vs PTCs](files/efuses-vs-PTCs.PDF)
 
+## Simple guide to choosing fusing rating for low voltage applications
+
 <br>
 
-| **Fig. 5** - Fuse.|  |
-|:---:|---|
-|![image](Files/Dn-1.jpg)|Trotection.|
+| **Fig. 5** - Fuse.|
+|:---:|
+|![image](Files/temperature-derating.gif )|
 
 
 # 5. Generalized Solution 
-- 
GitLab


From eb2f919e0e82f7af1adb5d63436b80415d418302 Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Tue, 2 Oct 2018 09:40:18 +0000
Subject: [PATCH 13/22] Update circuit-protection.md

---
 low-voltage-system/circuit-protection.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/low-voltage-system/circuit-protection.md b/low-voltage-system/circuit-protection.md
index 065664d..d3070c8 100644
--- a/low-voltage-system/circuit-protection.md
+++ b/low-voltage-system/circuit-protection.md
@@ -171,7 +171,7 @@ features that are often difficult to implement with discrete components.
 
 | **Fig. 5** - Fuse.|
 |:---:|
-|![image](Files/temperature-derating.gif )|
+|![image](files/temperature-derating.gif)|
 
 
 # 5. Generalized Solution 
-- 
GitLab


From 2c028810ec8db7952c7a9194d154fe462ff572f6 Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Tue, 2 Oct 2018 09:44:30 +0000
Subject: [PATCH 14/22] Update circuit-protection.md

---
 low-voltage-system/circuit-protection.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/low-voltage-system/circuit-protection.md b/low-voltage-system/circuit-protection.md
index d3070c8..0268f8a 100644
--- a/low-voltage-system/circuit-protection.md
+++ b/low-voltage-system/circuit-protection.md
@@ -117,7 +117,8 @@ specific.
    + Faster than zeners;
    + Can only sustain the harsh voltage for a short time (good for ESD);
    + Not precise enough to act as a regulator;
-   + [TVS versus Zener.](files/zener-vs-tvs.pdf)
+   + [TVS versus Zener.](files/zener-vs-tvs.pdf) (remember that this kind of 
+documents have some sort os conclusion in the end, dont read the whole thing)
 
 
 # 4. General Overcurrent Protection 
-- 
GitLab


From bc8749c2bfaf31f5fefb6f82a69b5a7432d45764 Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Tue, 2 Oct 2018 09:45:25 +0000
Subject: [PATCH 15/22] Update circuit-protection.md

---
 low-voltage-system/circuit-protection.md | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/low-voltage-system/circuit-protection.md b/low-voltage-system/circuit-protection.md
index 0268f8a..f2c4ec7 100644
--- a/low-voltage-system/circuit-protection.md
+++ b/low-voltage-system/circuit-protection.md
@@ -117,9 +117,7 @@ specific.
    + Faster than zeners;
    + Can only sustain the harsh voltage for a short time (good for ESD);
    + Not precise enough to act as a regulator;
-   + [TVS versus Zener.](files/zener-vs-tvs.pdf) (remember that this kind of 
-documents have some sort os conclusion in the end, dont read the whole thing)
-
+   + [TVS versus Zener.](files/zener-vs-tvs.pdf) 
 
 # 4. General Overcurrent Protection 
 The simplest form of analogic overcurrent protection solutions consist of some 
@@ -164,7 +162,8 @@ limit circuit currents and voltages to safe levels during fault conditions.
 eFuses offer many benefits to the system and can include protection
 features that are often difficult to implement with discrete components.
         + [Basics of eFuses](files/basics-of-efuses.pdf)
-    + [eFuses vs PTCs](files/efuses-vs-PTCs.PDF)
+    + [eFuses vs PTCs](files/efuses-vs-PTCs.PDF) (remember that this kind of 
+documents have some sort os conclusion in the end, dont read the whole thing)
 
 ## Simple guide to choosing fusing rating for low voltage applications
 
-- 
GitLab


From 2bf49b6a1119a2217461a2e986c76af15c0948dd Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Tue, 2 Oct 2018 10:08:08 +0000
Subject: [PATCH 16/22] Update circuit-protection.md

---
 low-voltage-system/circuit-protection.md | 38 +++++++++++++++++-------
 1 file changed, 27 insertions(+), 11 deletions(-)

diff --git a/low-voltage-system/circuit-protection.md b/low-voltage-system/circuit-protection.md
index f2c4ec7..4ef7cf2 100644
--- a/low-voltage-system/circuit-protection.md
+++ b/low-voltage-system/circuit-protection.md
@@ -162,14 +162,12 @@ limit circuit currents and voltages to safe levels during fault conditions.
 eFuses offer many benefits to the system and can include protection
 features that are often difficult to implement with discrete components.
         + [Basics of eFuses](files/basics-of-efuses.pdf)
-    + [eFuses vs PTCs](files/efuses-vs-PTCs.PDF) (remember that this kind of 
-documents have some sort os conclusion in the end, dont read the whole thing)
+    + [eFuses vs PTCs](files/efuses-vs-PTCs.PDF)
 
 ## Simple guide to choosing fusing rating for low voltage applications
+(coming soon, currently finishing BSPD and DCU)
 
-<br>
-
-| **Fig. 5** - Fuse.|
+| **Fig. 5** - Fuse derating with ambient temperature.|
 |:---:|
 |![image](files/temperature-derating.gif)|
 
@@ -178,15 +176,19 @@ documents have some sort os conclusion in the end, dont read the whole thing)
 Protection should be applied in 2 main spots:
 + PCB power supply;
 + Sensors power supply.
++ It might be also necessary to protect the MCU pins.
+
+## 5.1 Protect your PCB power supply
 
-It might be also necessary to protect the MCU pins.
+## 5.2 Protect your Sensor
 
+## 5.3 Protect the MCU pins
 
 
 # Random ideas
-+ Fuse before the DCDC:
-    + Might save the DCDC but given that the effiency of he DCDC varies with the
-voltage difference and current drawn it becomes difficult to choose an
++ Fuse before the DC-DC:
+    + Might save the DC-DC but given that the effiency of he DC-DC varies with 
+the voltage difference and current drawn it becomes difficult to choose an
 appropriate fuse.
     + Calculation example to know the current drawn under normal circunstances:
         1. Vout = 5V | Iout = 50mA
@@ -195,6 +197,20 @@ appropriate fuse.
         3. Pin = 0,25/0,9 = 0,27(8) W
         4. Vin = 24V
         5. Iin = 0,27(8)/24 = 11,6mA
-    + It would need to be heavily tested.
-+ Do not trust the word of a Mechanical Engineer doing eletronical work.
+    + It would need to be heavily tested because of the real values of 
+efficiency.
+    + A good protection solution after the DC-DC already provides good 
+protection for the DC-DC since there are several components more likely to fail
+before the DC-DC, wich means your circuit should already be open by the time you
+would be damaging the DC-DC
+
+<br>
++ Circuit protection can be done using sensors and the MCU, reading the current
+and/or voltage values and programing the MCU to open the circuit at a given
+treshold.
+    + It uses a lot of space compared to other solutions.
+    + Temperature problems;
+    + Takes time to implement;
+    + It has a fast response time;
+    + It's very flexible because you can just reajust your treshold.
 
-- 
GitLab


From 34b2c4580d08745c5954c16a2d4e68931b5207c6 Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Tue, 2 Oct 2018 10:09:05 +0000
Subject: [PATCH 17/22] Update circuit-protection.md

---
 low-voltage-system/circuit-protection.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/low-voltage-system/circuit-protection.md b/low-voltage-system/circuit-protection.md
index 4ef7cf2..0386709 100644
--- a/low-voltage-system/circuit-protection.md
+++ b/low-voltage-system/circuit-protection.md
@@ -164,7 +164,7 @@ features that are often difficult to implement with discrete components.
         + [Basics of eFuses](files/basics-of-efuses.pdf)
     + [eFuses vs PTCs](files/efuses-vs-PTCs.PDF)
 
-## Simple guide to choosing fusing rating for low voltage applications
+## 4.1 Simple guide to choosing fusing rating for low voltage applications
 (coming soon, currently finishing BSPD and DCU)
 
 | **Fig. 5** - Fuse derating with ambient temperature.|
@@ -205,6 +205,7 @@ before the DC-DC, wich means your circuit should already be open by the time you
 would be damaging the DC-DC
 
 <br>
+
 + Circuit protection can be done using sensors and the MCU, reading the current
 and/or voltage values and programing the MCU to open the circuit at a given
 treshold.
-- 
GitLab


From f41c7084d2c7ec6777430b72ad41e290866d3110 Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Mon, 8 Oct 2018 13:33:13 +0100
Subject: [PATCH 18/22] Requirements change

---
 low-voltage-system/bspd.md | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/low-voltage-system/bspd.md b/low-voltage-system/bspd.md
index 42ab79e..5578e2b 100644
--- a/low-voltage-system/bspd.md
+++ b/low-voltage-system/bspd.md
@@ -1,12 +1,5 @@
 # **BRAKE SYSTEM PLAUSIBILITY DEVICE**
 
-## **Requirements**
-+ Comply with the rules;
-+ Latch the error until power cycling ocurrs;
-+ Open the shutdown circuit if both of the conditions are verified simultaneously during more than 500ms:
-    + Invalid high voltage signal or a high voltage signal above 5kW;
-    + Invalid brake signal or a brake signal corresponding to hard braking;
-
 ## **Rules**
 
 ### EV 7.5 Brake System Plausibility Device (BSPD)
@@ -65,6 +58,12 @@ signals which:
 Signals might be a member of multiple signal classes, e.g. analog signals transmitted by wire might be member of (a), (b) and (c).
 + **T10.3.3** [EV ONLY] Indicators according to T10.3.1 with safe state “illuminated” (e.g. absence of failures is not actively indicated) must be illuminated for 1 s to 3 s for visible check after power cycling the Grounded Low Voltage Master Switch (GLVMS).
 
+## **Requirements**
++ Comply with the rules;
++ Latch the error until power cycling ocurrs;
++ Open the shutdown circuit if both of the conditions are verified simultaneously during more than 500ms:
+    + Invalid high voltage signal or a high voltage signal above 5kW;
+    + Invalid brake signal or a brake signal corresponding to hard braking;
 
 ## **Design Objectives**
 + Extensive testing to ensure perfect functionality;
-- 
GitLab


From 8410d11d939f273ad0c237ed7926dd3e8658bd78 Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Mon, 8 Oct 2018 13:02:24 +0000
Subject: [PATCH 19/22] Update bspd.md

---
 low-voltage-system/bspd.md | 64 ++++++++++++++++++--------------------
 1 file changed, 30 insertions(+), 34 deletions(-)

diff --git a/low-voltage-system/bspd.md b/low-voltage-system/bspd.md
index 5578e2b..c042596 100644
--- a/low-voltage-system/bspd.md
+++ b/low-voltage-system/bspd.md
@@ -2,40 +2,36 @@
 
 ## **Rules**
 
-### EV 7.5 Brake System Plausibility Device (BSPD)
-+ **EV 7.5.1**
-A standalone non-programmable circuit must permanently open the shutdown circuit when
-hard braking (without locking the wheels) occurs, whilst power is delivered to the motors.
-Only power cycling the GLVMS may reset this functionality and close the shutdown circuit
-again.
-
-+ **EV 7.5.2**
-Standalone is defined as there is no additional functionality implemented on all required
-PCB(s). The interfaces must be reduced to the minimum necessary signals.
-
-+ **EV 7.5.3**
-The BSPD must be directly supplied from the GLVS master switch
-
-+ **EV 7.5.4**
-The BSPD including all required sensors must not be installed inside the accumulator
-container.
-
-+ **EV 7.5.5** 
-The current limit for triggering the circuit must be set at a level where ≤5 kW of electrical
-power in the DC circuit is delivered to the motors at the nominal battery voltage.
-
-+ **EV 7.5.6** 
-The action of opening the shutdown circuit must occur if the implausibility is persistent for
-more than 500 ms.
-
-+ **EV 7.5.7** 
-All necessary signals are system critical signals, see T 10.4.
-
-+ **EV 7.5.8** 
-The team must prove the function of the BSPD during technical inspection by sending an
-appropriate signal to the non-programmable circuit that represents the current, in order to
-achieve ≤5 kW whilst pressing the brake pedal hard. This test must prove the functionality
-of the complete BSPD except for any commercially available current sensors.
+### T11.6 Brake System Plausibility Device (BSPD)
++ T11.6.1 A standalone non-programmable circuit, the BSPD, must open the 
+shutdown circuit, see EV6.1 and CV4.1, when hard braking occurs, whilst 
+**&#8805;5kW** power is delivered to the motors.
+The shutdown circuit must remain open until power cycling the LVMS or the BSPD 
+may reset itself if the opening condition is no longer present for more than 10s.
++ T11.6.2 The action of opening the shutdown circuit must occur if the 
+implausibility is persistent for **&#8805;500 ms**.
++ T11.6.3 The BSPD must be directly supplied from the LVMS, see T11.3.
++ T11.6.4 Standalone is defined as there is no additional functionality 
+implemented on all required Printed Circuit Boards (PCBs). The interfaces must 
+be reduced to the minimum necessary signals,i.e. power supply, required sensors
+and the shutdown circuit. Supply and sensor signals must not be routed through 
+any other devices before entering the BSPD.
++ T11.6.5 To detect hard braking, a brake system pressure sensor must be used. 
+The threshold must be chosen such that there are no locked wheels and the brake
+pressure is **&#8804;30bar**.
++ T11.6.6 [EV ONLY] To measure power delivery, a DC circuit current sensor only
+must be used. The threshold must be chosen to an equivalent of **&#8804;5kW** 
+for maximum TS voltage.
++ T11.6.7 It must be possible to disconnect each sensor signal wire for
+technical inspection.
++ T11.6.8 All necessary signals are System Critical Signal (SCS), see T11.9.
++ T11.6.9 [EV ONLY] The team must prove the function of the BSPD during 
+technical inspection by sending an appropriate signal that represents the 
+current, in order to achieve **&#8804;5kW** whilst pressing the brake pedal. 
+This test must prove the functionality of the complete BSPD except for any 
+commercially available current sensors.
++ T11.6.10 [EV ONLY] The BSPD including all required sensors must not be
+installed inside the accumulator container.
 
 ### T 10.3 System Critical Signals (SCSs)
 + **T10.3.1** System critical sensor signals and system critical general signals are defined as all electrical
-- 
GitLab


From c1102116cc3d2884eaab173e46ad94ab5b70d231 Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Mon, 8 Oct 2018 13:17:43 +0000
Subject: [PATCH 20/22] Rules fixed (bspd.md)

---
 low-voltage-system/bspd.md | 55 ++++++++++++++++++++++++--------------
 1 file changed, 35 insertions(+), 20 deletions(-)

diff --git a/low-voltage-system/bspd.md b/low-voltage-system/bspd.md
index c042596..ec52ccd 100644
--- a/low-voltage-system/bspd.md
+++ b/low-voltage-system/bspd.md
@@ -3,56 +3,71 @@
 ## **Rules**
 
 ### T11.6 Brake System Plausibility Device (BSPD)
-+ T11.6.1 A standalone non-programmable circuit, the BSPD, must open the 
++ **T11.6.1** A standalone non-programmable circuit, the BSPD, must open the 
 shutdown circuit, see EV6.1 and CV4.1, when hard braking occurs, whilst 
 **&#8805;5kW** power is delivered to the motors.
 The shutdown circuit must remain open until power cycling the LVMS or the BSPD 
 may reset itself if the opening condition is no longer present for more than 10s.
-+ T11.6.2 The action of opening the shutdown circuit must occur if the 
++ **T11.6.2** The action of opening the shutdown circuit must occur if the 
 implausibility is persistent for **&#8805;500 ms**.
-+ T11.6.3 The BSPD must be directly supplied from the LVMS, see T11.3.
-+ T11.6.4 Standalone is defined as there is no additional functionality 
++ **T11.6.3** The BSPD must be directly supplied from the LVMS, see T11.3.
++ **T11.6.4** Standalone is defined as there is no additional functionality 
 implemented on all required Printed Circuit Boards (PCBs). The interfaces must 
 be reduced to the minimum necessary signals,i.e. power supply, required sensors
 and the shutdown circuit. Supply and sensor signals must not be routed through 
 any other devices before entering the BSPD.
-+ T11.6.5 To detect hard braking, a brake system pressure sensor must be used. 
++ **T11.6.5** To detect hard braking, a brake system pressure sensor must be used. 
 The threshold must be chosen such that there are no locked wheels and the brake
 pressure is **&#8804;30bar**.
-+ T11.6.6 [EV ONLY] To measure power delivery, a DC circuit current sensor only
++ **T11.6.6** [EV ONLY] To measure power delivery, a DC circuit current sensor only
 must be used. The threshold must be chosen to an equivalent of **&#8804;5kW** 
 for maximum TS voltage.
-+ T11.6.7 It must be possible to disconnect each sensor signal wire for
++ **T11.6.7** It must be possible to disconnect each sensor signal wire for
 technical inspection.
-+ T11.6.8 All necessary signals are System Critical Signal (SCS), see T11.9.
-+ T11.6.9 [EV ONLY] The team must prove the function of the BSPD during 
++ **T11.6.8** All necessary signals are System Critical Signal (SCS), see T11.9.
++ **T11.6.9** [EV ONLY] The team must prove the function of the BSPD during 
 technical inspection by sending an appropriate signal that represents the 
 current, in order to achieve **&#8804;5kW** whilst pressing the brake pedal. 
 This test must prove the functionality of the complete BSPD except for any 
 commercially available current sensors.
-+ T11.6.10 [EV ONLY] The BSPD including all required sensors must not be
++ **T11.6.10** [EV ONLY] The BSPD including all required sensors must not be
 installed inside the accumulator container.
 
-### T 10.3 System Critical Signals (SCSs)
-+ **T10.3.1** System critical sensor signals and system critical general signals are defined as all electrical
-signals which:
-    * Influence actions on the shutdown circuit, see CV4.1 and EV5.1.
-    * Influence the requested wheel torque.
-    * [EV ONLY] Influence indicators according to EV3.7.6, EV4.13 or EV5.4.6.
-+ **T10.3.2** Any of the following signal failures must result in a safe state of all connected systems:
+### T11.9 System Critical Signals (SCSs)
++ **T11.9.1** System critical signals are defined as all electrical signals
+which:
+    * Influence actions on the shutdown circuit, see CV4.1 and EV6.1.
+    * Influence the wheel torque.
+    * [EV ONLY] Influence indicators according to EV5.8.8, EV4.10 or EV6.3.7.
++ **T11.9.2** Any of the following signal failures must result in a safe state 
+of all connected systems:
     * (a) Failures of signals transmitted by wire:
         * Open circuit
         * Short circuit to ground
     * (b) Failures of analog sensor signals:
         * Short circuit to supply voltage
     * (c) Failures of sensor signals used in programmable logic:
-        * Implausibility due to out of range signals, e.g. mechanically impossible angle of an angle sensor.
+        * Implausibility due to out of range signals, e.g. mechanically 
+        impossible angle of an angle sensor.
     * (d) Failures of digitally transmitted signals by wire or wireless:
         * Data corruption (e.g. checked by a checksum)
         * Loss and delay of messages (e.g. checked by transmission time outs)
 
-Signals might be a member of multiple signal classes, e.g. analog signals transmitted by wire might be member of (a), (b) and (c).
-+ **T10.3.3** [EV ONLY] Indicators according to T10.3.1 with safe state “illuminated” (e.g. absence of failures is not actively indicated) must be illuminated for 1 s to 3 s for visible check after power cycling the Grounded Low Voltage Master Switch (GLVMS).
+Signals might be a member of multiple signal classes, e.g. analog signals 
+transmitted by wire might be member of (a), (b) and (c). <br>
+If a signal failure is correctable, e.g. due to redundancy or worst case values,
+the safe state must be entered as soon as an additional non correctable failure occurs.
+
++ **T11.9.3** Safe state is defined depending on the signals as follows:
+    + signals only influencing indicators – Indicating a failure of its 
+own function or of the connected system
+    + low voltage battery signals – At least one pole is electrically
+disconnected from the rest of the vehicle
+    + [EV ONLY] For all others signals – opened shutdown circuit and opened AIRs
++ **T11.9.4**  Indicators according to T11.9.1 with safe state “illuminated” 
+(e.g. absence of failures is not actively indicated) must be illuminated for 
+**1 s to 3 s** for visible check after power cycling the Grounded Low Voltage 
+Master Switch (GLVMS).
 
 ## **Requirements**
 + Comply with the rules;
-- 
GitLab


From 1daaa26a41efbda88f73bddbe8fd9f28491a417b Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Wed, 10 Oct 2018 10:25:42 +0000
Subject: [PATCH 21/22] bspd.md - updated requirements

---
 low-voltage-system/bspd.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/low-voltage-system/bspd.md b/low-voltage-system/bspd.md
index ec52ccd..19cf345 100644
--- a/low-voltage-system/bspd.md
+++ b/low-voltage-system/bspd.md
@@ -71,10 +71,12 @@ Master Switch (GLVMS).
 
 ## **Requirements**
 + Comply with the rules;
-+ Latch the error until power cycling ocurrs;
-+ Open the shutdown circuit if both of the conditions are verified simultaneously during more than 500ms:
++ Latch the error until power cycling ocurrs or if the error disappears for 10s;
++ Open the shutdown circuit if both of the following conditions are verified
+simultaneously during more than 500ms:
     + Invalid high voltage signal or a high voltage signal above 5kW;
     + Invalid brake signal or a brake signal corresponding to hard braking;
++ Use less relays.
 
 ## **Design Objectives**
 + Extensive testing to ensure perfect functionality;
-- 
GitLab


From 19e88b1ebe427c5d4e5f88fe8230ca009d0683f8 Mon Sep 17 00:00:00 2001
From: David Ribeiro <david.vaz@ist.utl.pt>
Date: Wed, 10 Oct 2018 13:00:58 +0000
Subject: [PATCH 22/22] Update bspd.md

---
 low-voltage-system/bspd.md | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/low-voltage-system/bspd.md b/low-voltage-system/bspd.md
index 19cf345..bf59f55 100644
--- a/low-voltage-system/bspd.md
+++ b/low-voltage-system/bspd.md
@@ -78,14 +78,19 @@ simultaneously during more than 500ms:
     + Invalid brake signal or a brake signal corresponding to hard braking;
 + Use less relays.
 
+
 ## **Design Objectives**
++ Robust desing focused on reliability;
 + Extensive testing to ensure perfect functionality;
-+ Ensure driver safety.
 
 ## **Problems with Previous Versions**
 + Faulty logic;
 + Analog method to latch the error was not working;
-+ Previous method of creating a 500 ms delay before opening the shutdown circuit used a diode. Diodes have a forward voltage, wich messed the times of the delay after the first charge of the capacitor.
++ Previous method of creating a 500 ms delay before opening the shutdown circuit
+used a diode. Diodes have a forward voltage, wich messed the times of the delay
+after the first charge of the capacitor.
++ Did not account for the new rule changes to the BSPD, specifically the new 
+possibility of reseting after 10 seconds withouth fault.
 
 ## **Interactions**
 + Input from Torque Encoder: brake pedal signal.
\ No newline at end of file
-- 
GitLab