From 42624d163b791fb51467fb190f570a3c0a49cc31 Mon Sep 17 00:00:00 2001 From: gab-k Date: Sat, 4 Jan 2025 13:36:00 +0000 Subject: [PATCH] deploy: 185c703bc0e1a079aa6f626578c7ede3e92634c0 --- sphinx/doctrees/environment.pickle | Bin 672650 -> 687736 bytes sphinx/doctrees/gs/getting_started.doctree | Bin 0 -> 25063 bytes .../hardware/rev_0_3/hw_description.doctree | Bin 33346 -> 32676 bytes .../hardware/rev_1_0/hw_description.doctree | Bin 34702 -> 34032 bytes sphinx/doctrees/index.doctree | Bin 3478 -> 3475 bytes sphinx/doctrees/other/CV_list.doctree | Bin 0 -> 29706 bytes sphinx/doctrees/other/debug_logging.doctree | Bin 0 -> 7034 bytes sphinx/doctrees/other/getting_started.doctree | Bin 22295 -> 0 bytes sphinx/doctrees/other/index.doctree | Bin 2761 -> 2842 bytes sphinx/doctrees/other/troubleshooting.doctree | Bin 0 -> 7807 bytes .../doctrees/software/sw_description.doctree | Bin 45091 -> 45994 bytes .../Block_Diagram_Digital_Controller.svg | 4 + sphinx/html/_images/GPIO_slices.svg | 4 + sphinx/html/_images/Long_address.svg | 4 + sphinx/html/_images/Wiring_diagram1.svg | 4 + sphinx/html/_images/feed_forward.svg | 159 ----------- sphinx/html/_images/speed_table.svg | 143 ++++++++++ .../{other => gs}/getting_started.rst.txt | 16 +- .../hardware/rev_0_3/hw_description.rst.txt | 4 - .../hardware/rev_1_0/hw_description.rst.txt | 4 - sphinx/html/_sources/index.rst.txt | 5 +- sphinx/html/_sources/other/CV_list.rst.txt | 126 +++++++++ .../html/_sources/other/debug_logging.rst.txt | 23 ++ sphinx/html/_sources/other/index.rst.txt | 5 +- .../_sources/other/troubleshooting.rst.txt | 27 ++ .../_sources/software/sw_description.rst.txt | 44 +-- sphinx/html/genindex.html | 2 +- .../html/{other => gs}/getting_started.html | 19 +- sphinx/html/hardware/index.html | 10 +- .../html/hardware/rev_0_3/hw_description.html | 7 +- .../html/hardware/rev_1_0/hw_description.html | 9 +- sphinx/html/index.html | 46 ++-- sphinx/html/objects.inv | Bin 15461 -> 15650 bytes sphinx/html/other/CV_list.html | 252 ++++++++++++++++++ sphinx/html/other/debug_logging.html | 138 ++++++++++ sphinx/html/other/index.html | 31 ++- sphinx/html/other/troubleshooting.html | 146 ++++++++++ sphinx/html/search.html | 2 +- sphinx/html/searchindex.js | 2 +- sphinx/html/software/header_files.html | 2 +- sphinx/html/software/index.html | 4 +- sphinx/html/software/sw_description.html | 46 ++-- 42 files changed, 1019 insertions(+), 269 deletions(-) create mode 100644 sphinx/doctrees/gs/getting_started.doctree create mode 100644 sphinx/doctrees/other/CV_list.doctree create mode 100644 sphinx/doctrees/other/debug_logging.doctree delete mode 100644 sphinx/doctrees/other/getting_started.doctree create mode 100644 sphinx/doctrees/other/troubleshooting.doctree create mode 100644 sphinx/html/_images/Block_Diagram_Digital_Controller.svg create mode 100644 sphinx/html/_images/GPIO_slices.svg create mode 100644 sphinx/html/_images/Long_address.svg create mode 100644 sphinx/html/_images/Wiring_diagram1.svg delete mode 100644 sphinx/html/_images/feed_forward.svg create mode 100644 sphinx/html/_images/speed_table.svg rename sphinx/html/_sources/{other => gs}/getting_started.rst.txt (75%) create mode 100644 sphinx/html/_sources/other/CV_list.rst.txt create mode 100644 sphinx/html/_sources/other/debug_logging.rst.txt create mode 100644 sphinx/html/_sources/other/troubleshooting.rst.txt rename sphinx/html/{other => gs}/getting_started.html (84%) create mode 100644 sphinx/html/other/CV_list.html create mode 100644 sphinx/html/other/debug_logging.html create mode 100644 sphinx/html/other/troubleshooting.html diff --git a/sphinx/doctrees/environment.pickle b/sphinx/doctrees/environment.pickle index 96132c9ce51bd47e6b3bbd8db9fe4315d74f2087..483627a311974373b5d467d65b5e91adc386fa1a 100644 GIT binary patch literal 687736 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

uA{9 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 diff --git a/sphinx/doctrees/gs/getting_started.doctree b/sphinx/doctrees/gs/getting_started.doctree new file mode 100644 index 0000000000000000000000000000000000000000..5389d12769828ae03634b16cb4f47da6e4d93ea3 GIT binary patch literal 25063 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 literal 0 HcmV?d00001 diff --git a/sphinx/doctrees/hardware/rev_0_3/hw_description.doctree b/sphinx/doctrees/hardware/rev_0_3/hw_description.doctree index 2e7c226f70c1a4450e322832beb3044d42849348..aa8d4e01df7bcd4c29fba9c24665bb1b324e48f6 100644 GIT binary patch delta 342 zcmX@q!nEW+BWnZe)S2}gS-o=@8zu+l)NekY)4@3TNa4kRg-7oFSW`lOg9_I(bi;+~$-bMn=Z+$&R_olY5GUCeJSBWi1El zPo2EB*paacs84rtLIekE4OmRG#12D5f*h=MK*^BFoaI`K-jhwr z1DH#DBqwhu7o9w(oP%u%(9$f2$*am0*}TEb%@@lvn3%3`ZMLqu%FF>0i=6^gAW>H? z6$nz`2O_|_!0H!+xCMsQ{}5c`$1MhzOaytlovK w3&c#F{Gt9U(<83Q&l^@S+D@L(sLo`?J^7)C+~n(x+H6Io8QNJElR28K0NXil1^@s6 delta 840 zcmZ4TpYc!&6KezORP&~dtll|{^^*g0>Nj7^X=j{#F0ax>+{xcpK~2FirzEu~FR>)E zEL9;Ov8beYN(OuElnk*Robs(x8mH7w(a4a_@}B%L+pyk)i-93SCWARcHbW;v&bz2I zDI-x6qJ*`_sURmcu{c$sI5ky4ODn*~(b?6*-^ax@NY^nm#NXZ3&o#&~#MMO?=ol?6 zg|z%4g_4X^h2;EPpuUn+1)#7V*g+aV7jYw*H3ja9`m9K}1N<`N{D9W?!mU>%XeZ3O zvUuHwur4bR&9+H7a)v#?zyP@dXt!987!Gg1T?|w@d7`cfYcWul$7KJ!T-Gu$>tLRQ zrD#%qu5KbCPIL>vagvy!42%@j*eN~YKn1{PLsFsuRx;UMT#m75a-6u_WcPf_$zCOT zlM7;41bX4F1xHTh00^Zzu_1tenhP zD$jNoXna=XWVKR7wiYmRvu|kz6B94@=I!NInK?jWu~UEwrc{@!xPlZofru^;(GDWO z`oTKyfVej&tJVYvgA{gx6?K9YbY$I`+*FgJ0@lk0*9%IKSzx^&?`Pcv5xtW+YF*e4 zgP8Ls2i1OMlIEW5S+|0 B5SRb} diff --git a/sphinx/doctrees/hardware/rev_1_0/hw_description.doctree b/sphinx/doctrees/hardware/rev_1_0/hw_description.doctree index 6392d51fabaace99027646e2d944bcde56b849f0..f6b1c014d15776026e5f5aaf6cebabe97a0fbb23 100644 GIT binary patch delta 371 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 E2crvMv;Y7A literal 0 HcmV?d00001 diff --git a/sphinx/doctrees/other/debug_logging.doctree b/sphinx/doctrees/other/debug_logging.doctree new file mode 100644 index 0000000000000000000000000000000000000000..b53d588cd4426ac6d7f6a7e2b170d602182194b3 GIT binary patch literal 7034 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 literal 0 HcmV?d00001 diff --git a/sphinx/doctrees/other/getting_started.doctree b/sphinx/doctrees/other/getting_started.doctree deleted file mode 100644 index f4e9772a8fd49a320b69957471432badf37b6876..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 22295 zcmeHPYm6k-b>7#^?99Fgm=M@qY8TAT;_04!nZye$u)8eaWtR=Rz#VobR4{?!7Vc&7Ci9;{U~ag0^M5OJ&_KT+c9rPQ2al zYEjE{!_GH4M_=o_+L?~WeSI8HE)96r9l-zdBTp|*>3%t=0RE@TE z&=7X4eerlDCED5=k0!KUj<-3sYj!S2RXv{2!_c>@QHU|pn6}zRK=hB*96bo|62C`W zy(NBaH==g-M^&%Q`(~ZWMDbXtH|SHx+GE{q?X>n=Tdf1}nc0RNT2Xa&(evknwq7%5 zK~gX)*gGpIn)O1<^k*Al#Fb>kWk0|m4qn_6RjnO@;~C5L$`|on$IIG_sBUVZr=bZA zZE00c_l-vd&!z?zNw@}*j|q}5TL+0T);-{cbqGAa7ymwke@F1|C`M|1mPc3;#jP2T zI06#K<8d%vZ}@uKQUrPZ?>2AR^pY28HQm)}mgfbgrn}49m2+pcmhMJ%y%t8k>1)d< z4eL+UxIfm)8ineseLC3AO=R)()@8eEr`mP?@3#PL?!(*fIdp>F?G}I%@GBi!|>RgprQ(e|98Z1~O=mo)cy>8bcC#2pTZV?P&%6*~_tuN@d zqZ1eOPT0dFhj2O5F_;OS_fgeM4MaS(Nam*$dL@{j64bTC=BJ}e)4>La3-z#3x@uS^ zGSitFmI1c!_7i38itiZ_dlpy-#|%=d*ZX5O{+EUyKUwq_6ni%Td-tfcz}HV;W;~rv zZcj6p+MX}$aJxX9HvOdOS7GbVK6`2Qij7H4v-pYwzi?ET3D<Dk%E#l`ZxUDJ)S=QrR$7G1~FjoCAE70h0{W|1B6+NKMWMc%kP0di_OEG-#TvH@&( z$W+yRua(Sh*gUG|o3H}#>xQth5o(denY*A@eRN4KyL8R-oOu)%WVM~BVY_65s;28M zx6DRHsql7WSZ3wN*&Z!{a<(he)>M3XV|mxfB-~IXOb!ap8k*_?uSg7Ijl>TO&u!^Y zN0<>xPp_yw_4l3eHbw|>Qa>IAL6L8F;(OMRG<#hSTG(JuI|@vMxu%Zda3+I(+9Ifz zemx#xjZ$W5`Xcf4DS6iKlGA@Zo=Ev;bS`dAsF{ji`oxq_;c#A-Z8`a3{njWd^mL|& z9`~IQ3gv&iKHXSfH`Z(Mtkj($=Uz^ielKO@iA;fpZ0Jlup=Roe$q0qXD6x{2gvlsX zmrK$rD0R+M6L~c5_e61a?USkx zjlcgiBW^}@d?tB8pL$~4jTVvxtVG1WS~O=e`xp zVM37M(HdB5_$C&3O|MGd0Y)7xhKa#~DK1zZVj(Ehm;l)Ke}#mo_|*?oJ+?AL@Zik} zT4KA&ZZ%Ol{YdR}ZJ^hyF}Uo5(q;EnyVOH}kaJCkGF9qbujr5`g+fE2NaIUXNpUI3 zR|MF2J|tg@&b2v;S+4q5qG>9AVEB2VaIc@p{98YFq`0Sg&)SUW=AB@``lQ~kO-TL) zDfx{x27NT;dPR(>*or%*V8LnFGve;c!@Ss+R+d zzkb;Z&C^-}U1*&xp&z@prx1fB;HW)kE@;QfC&|NAO~+eA98`B3YB16ObaZK{tzltJ zZc;mU36Ag?JAktYm*6UaQ{Wy?YlrhdM}%5Rj@i&_%Vq1ZRO@ej3Z%V%E4-e6wbQ&tqj@Wcf30UJEDK)kSZ|{MjOQRseyXfpz`g^vUdUY&)Jcez zn7nU+RK1&DS{Gvh%bQo zt!uPci2^CbYl2V_?bo}K75|JcoiEh0M;+sP`2~5 zV$i0qzIguV#Keg*w!cIf9XlZiL?^mB3za?jxnrd&!k~uO4-;BD$14u3rK{QW%G{(9 z`cN?XY*vS1H_SA)S*FiD}Mat)l4{5L~jY~IaPf}T%NE#8V)d)%rIY$SGIl~wdS*RdE`jPv3 z%?#+A7V_OvNZ*bkEsa3OaM zBP@Bp@eOB^`JbDT%(TJ_@L&LZoIXX~Fa;tifaGDOI7AM1_zKw|CbmF2oZK>u^B{OR zmeyc+`B_zv*YCqeq_4ODKFD|BfPVvS5z8PVUpQ5`Zx4A1aFCvM2{{r7;d#h3AtkC(olf9#cC?!b?Y=kzG*dTAkGg)nfYJIJ?Tuahm z3}zn1E-^6f*gzrI+hDYDkRAWHHwr0X;7xn%X%_Zv(z)(7?UJ%Gc^Oka3~P! zcYX99i ziic(t$CcZqJG!bMD{;F42#OH?5IRE)}y+Z^Eg z51%5qd7)S2r3i6`DVq8FXNT5sBAopFGieR>_a}1x{y*_Cr82=@>~oO(86pQ5&KypN zaw#3!_k;VP^i1|hc!~Wj-V7F7T)MGfu?iqaV;*0PuPjcAOD_f5t;6<^v= zi>N3{_xkhl_dR`@fvEM5GhWZ5LmG)rmAIU5ev{63K?;`k>)aw_D5 zgB_8=vo5J+sT@naQaNsgzmhg-{~&**`3cRJUKU4N3x6o09H5TIt$-;~^(MO^kwWFq*R629+Jl-s zvmuTxL0SF%+p`0kS4&j=$&h4}+i zB>dC>CgK-Uy}_+Q`A6$kn|^IVb*^uW>U3k~{%Z8ajZ&lTPK(It4n0{Zlysp{4C@uO znvw-H{j|_3S)xm|Mz{7dOv42t$g9c~buJKbKt>h10};WZp%5z8`?7R*3__Gni0%`8 zz#={)H@-tQmg`#S@=oNb$TGPOQ6}G!JSm%Io(za_jDHSCU2QsYDUGD^CW}~uc4Q6`pf%`#^hLs$kEE4(=no+Q<1xHS6EN-E?IP;;Hl{F|LtvuL#7NvSg z=;5^`M7f5lgpO5C_LR_<(M7j}hG z@El6+r6J8-^SuZs?E_qRz_(b~bSZ&2rmTdPmF$~_UM0OR?~v0%6o|ri|L&IkmSk-xEaO)Kw3Z^g&6gWR-`%X4hshHpWbL%CTXQy@e}{wpw)l%hY&g}PF6$G2sZaC+Eb zDtfMO=onW5)4fE&`pPh?C|I-e|b-e1@1=pGhS@%IYvuNnKnf2iC z5>whMPAHYcZ2IKiCVn)VEQg5}WwIo+O~uDrIIUMF_%;2e+x&ES*hO>H4z=Vyl zQudz+1*=C@GOO3Wo92hW5zYUi$47Wrqs?E?@BhYwT1;{uCGJQf>*sUOa4$|J3;0$_ zB$hFh5M26MqPx^5kYX24wg8i5)W&-X`$Y==l%M2|Q1?=PtFT`T^>Axdf8M26aal9* z?YOMT4IDlzE3&_k0LNExjf7sPJ6NX16S55M0lT;&S2e3KH#I?7xh@pgRP9`VyK5vAPbGeBO*|G z87o?B2mz3z1Uz&L4UR(`HIt|&`fL|GtKe1@oYh8TCLWK%dg(VyxVWnm@6Ug%;Eaps zSLo_0$MhiqBDEIcGB?3_rIitGr4t`0d?_^1{Bumxc(-Ubqe0f*pZ`#(9PgzuK=%R* zETT(zI`J+CNAn`&lz`(nE*o#bb$0P>luqFrNF|`{M0A4$5%6IYnVEGA6CAM(sSrqL z-mOQWSIJ(*Tj*YhT}ISuBQ1dUW2yRXe!<5+TqL;Q%^rTk%1+YHUbO==GQ7%Cixg@v zmPNQmt)kXsEy3wDY^~TrW%pFz8tJw#3?!j)OimR{yPX&e;0)bShCBJ7HA%4w<+Spx zcT@BWonUL2%0M>MngNmTz`cLzpBFdB`#4hOm~I1#=-4f6C0^QlB;MUN+u3nB8Vq)0 z+t7B@S#S1%C}>s)a|^A($yT!F@nr6;xI+=I(ONzIgRVoO z>lf*)B+j_Kr3djCeH8Den-S)E)5pWQYF)A3wcfGbw7zEj$ohdee))FuD!I}t^w>*} zUG$*axtg=|ID$n<^FDgKOMkvYkEao{YhIwoX?pwyJ?^0*`|0sj`tvLFc$XgU(BlJo z{5w7NQjuNs_#1kBj~*=|u}P0#(4QaDV}|}bN{`F*xQIs-kJG?tC!T#B4{g=Dx@x_< zYQ4E){b+@Uw8A4=<1T%N_-1cY?DeaP|do_6_R?)?eY+>U+#n{2w!PEM@3X`o#>T6QqKnKc!#H zP)hq33_VW2n4z?hAsD(qznGyvrC-d@f1_W_(6N-E6eJT2B}^n3`T_l7hTba~+I)h! zx=Wq5tarPR*dVY4luNuJ>nzI&jaA=}N#VDc=B=vdq?UkR-d=c_mLAWwI4*nTN|U+v z`EUU4&x-FTwv~JV-huC^c@Z551h}Xnu7o*;*#z`3hC_$^{u`Jk%^zaa7dHoQbe@Af z#O;l+tjLiJU;;$PsVh-mV{c=3u#AktmVBE+AbG)P7F-gcE(DeydJ4+wlR44EWY-SM z6vW&v&|#oXj^lxk;<7bEX2<{{?-<#%DHwnZ3EG`Ox$P)75J8S4Xl8S~P2{s|d;0Q) zX9-dWGzb?bZh5`9hj8_%XfNK8a)b@o4%@9ckwFHtK{vfl806>^pGasns+Rv3*1!WX diff --git a/sphinx/doctrees/other/index.doctree b/sphinx/doctrees/other/index.doctree index 16c4e9dd9648a406d8a22ffcd39279366e85ebb8..5ec2379e1493c7f3c2e82ad76b622b1804de3711 100644 GIT binary patch delta 165 zcmX>pI!lbTfpscB_eR#Ij7b`PJ)-#~8L373B}MtANja&-8Tt7onR)3`+NSvR2t%Y& zQj<#4<8$)U(_s?45DDk7_?*n*5}?}D9-hp+H{W6$PF*89vd@fk72J)C)oxv3?U1wh5MQ!?T^i!&5~bj;=w&QL}Gv*kdm delta 84 zcmbOwc2bnJfpzLWu8piu83lWIGV_viN>ftPGILUkr^HT~?88*Y=(71V(?2H0w#}zl n?=#CpW`q^@aONfErj}F|02S3v$%yPM&QJu>VVjR~hB5*GRhuB_ diff --git a/sphinx/doctrees/other/troubleshooting.doctree b/sphinx/doctrees/other/troubleshooting.doctree new file mode 100644 index 0000000000000000000000000000000000000000..20a370c3aae0a39835d66208ee0ea5e289bd4584 GIT binary patch literal 7807 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 literal 0 HcmV?d00001 diff --git a/sphinx/doctrees/software/sw_description.doctree b/sphinx/doctrees/software/sw_description.doctree index 1d2d5e441e8e1161745993a9d6b30a42efaa5ae5..91a8858718f188bacabde06f2666c59509423599 100644 GIT binary patch delta 6694 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 + + +
STARTUP_MODE
K_FF*startup.level
MEASUREMENT & ERROR
MODE?
STARTUP
CONTROLLER
PID
CONTROLLER
PID_MODE
FEED_FWD
LEVEL
+

+
OUTPUT (PID_MODE)
OUTPUT (STARTUP_MODE)
MEASUREMENT & ERROR
\ No newline at end of file diff --git a/sphinx/html/_images/GPIO_slices.svg b/sphinx/html/_images/GPIO_slices.svg new file mode 100644 index 0000000..3cf07ea --- /dev/null +++ b/sphinx/html/_images/GPIO_slices.svg @@ -0,0 +1,4 @@ + + + +
MOTOROUT
MOTOROUT
GPIO
GPIO
0
0
1
1
2
2
3
3
4
4
5
5
6
6
7
7
8
8
9
9
10
10
11
11
12
12
13
13
14
14
15
15
0A
0A
0B
0B
1A
1A
1B
1B
2A
2A
2B
2B
3A
3A
3B
3B
4A
4A
4B
4B
5A
5A
5B
5B
6A
6A
6B
6B
7A
7A
7B
7B
16
16
17
17
18
18
19
19
20
20
21
21
22
22
23
23
24
24
25
25
26
26
27
27
28
28
29
29
PWM Sl./Ch.
PWM Sl./Ch.
GPIO
GPIO
GPIO
GPIO
AUXOUT
AUXOUT
ADC (VEMF)
ADC (VEMF)
DCCIN
DCCIN
Text is not SVG - cannot display
\ No newline at end of file diff --git a/sphinx/html/_images/Long_address.svg b/sphinx/html/_images/Long_address.svg new file mode 100644 index 0000000..69f3706 --- /dev/null +++ b/sphinx/html/_images/Long_address.svg @@ -0,0 +1,4 @@ + + + +
CV_17 = {192, 231}
CV_17 = {192, 231}
CV_18 = {0, 255}
CV_18 = {0, 255}
215
215
214
214
213
213
212
212
211
211
210
210
29
29
28
28
27
27
26
26
25
25
24
24
23
23
22
22
21
21
20
20
1
1
1
1
A
A
A
A
A
A
A
A
A
A
A
A
A
A
A
A
A
A
A
A
A
A
A
A
A
A
A
A
Bit Weight
Bit Weight
Bit Value
Bit Value
Text is not SVG - cannot display
\ No newline at end of file diff --git a/sphinx/html/_images/Wiring_diagram1.svg b/sphinx/html/_images/Wiring_diagram1.svg new file mode 100644 index 0000000..a2242a4 --- /dev/null +++ b/sphinx/html/_images/Wiring_diagram1.svg @@ -0,0 +1,4 @@ + + + +
Motor0
Motor1
Track0
Track1
Load1
Load0
\ No newline at end of file diff --git a/sphinx/html/_images/feed_forward.svg b/sphinx/html/_images/feed_forward.svg deleted file mode 100644 index 0b53f41..0000000 --- a/sphinx/html/_images/feed_forward.svg +++ /dev/null @@ -1,159 +0,0 @@ - - - gl2ps_renderer figure - -Creator: GL2PS 1.4.2, (C) 1999-2020 C. Geuzaine -For: Octave -CreationDate: Mon Aug 1 18:41:06 2022 - - - - - - - - - - - - - - - - - - - - - - - - 0 - - - 500 - - - 1000 - - - 1500 - - - 2000 - - - 2500 - - - - - - - - - - - - - - - 0 - - - 1000 - - - 2000 - - - 3000 - - - 4000 - - - 5000 - - - - - - - sp - - - PWM-Level (sp) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - forward - - - - reverse - - - - - - - x1 | y1 (fwd) - - - - - - - x2 | y2 (fwd) - - - - - - - x1 | y1 (rev) - - - - - - - x2 | y2 (rev) - - - - adjustment threshold y2 - - - - diff --git a/sphinx/html/_images/speed_table.svg b/sphinx/html/_images/speed_table.svg new file mode 100644 index 0000000..d04c27b --- /dev/null +++ b/sphinx/html/_images/speed_table.svg @@ -0,0 +1,143 @@ + + + gl2ps_renderer figure + +Creator: GL2PS 1.4.2, (C) 1999-2020 C. Geuzaine +For: Octave +CreationDate: Mon Aug 1 20:12:59 2022 + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + 20 + + + 40 + + + 60 + + + 80 + + + 100 + + + 120 + + + 140 + + + + + + + + + + + + + 0 + + + 500 + + + 1000 + + + 1500 + + + 2000 + + + + + + + Speed-step + + + Setpoint + + + + + + + + + + + + + + + + + + + + + + + + + + + Setp.(Speeds.) + + + + + + + 1 | CV2 + + + + + + + 63 | CV6*16 + + + + + + + 126 | CV5*16 + + + + diff --git a/sphinx/html/_sources/other/getting_started.rst.txt b/sphinx/html/_sources/gs/getting_started.rst.txt similarity index 75% rename from sphinx/html/_sources/other/getting_started.rst.txt rename to sphinx/html/_sources/gs/getting_started.rst.txt index c21a635..4ef9afb 100644 --- a/sphinx/html/_sources/other/getting_started.rst.txt +++ b/sphinx/html/_sources/gs/getting_started.rst.txt @@ -8,8 +8,9 @@ You can choose any PCB manufacturer you like. The PCB is designed to fit with JL 2. Production files? ---------------------------------- +The latest release includes the production files for JLCPCB, which includes the Gerber files, BOM, and Pick and Place files. You can find the latest release `here `_. -In order to export the production files (Gerber/BOM/Pick and Place), you need `KiCad `_ which is open source. +In order to manually export the production files (Gerber/BOM/Pick and Place), you need `KiCad `_ which is open source. In case you are ordering from JLCPCB it is recommended to use the `Fabrication-Toolkit KiCad plugin by bennymeg `_ .. _building_the_software: @@ -17,7 +18,7 @@ In case you are ordering from JLCPCB it is recommended to use the `Fabrication-T 3. Building the software ---------------------------------- -If you got a RP2040-Decoder with USB the easiest way to get the RP2040-Decoder up and running is to just use the precompiled .uf2 file and ignore the rest of this section. +If you got a RP2040-Decoder with USB the easiest way to get the RP2040-Decoder up and running is to just use the precompiled .uf2 file in the latest `release `_ and skip to :ref:`flashing_the_software`. However sometimes you might want to build by yourself, be it for debugging or to make your own modifications to the source code. The easiest way to do this is to just use `Visual Studio Code `_ and the Raspberry Pi Pico extension. @@ -25,6 +26,8 @@ The `official documentation `_ +.. _flashing_the_software_swd: + 4.2. Flashing the software via SWD ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Flashing via SWD is a little more complicated but also comes with great advantages in terms of debugging. The book on `Getting started with Raspberry Pi Pico-series `_ does a great job of explaining how debugging works. -As already suggested in :ref:`3. ` it is recommended to use the `Visual Studio Code Extension `_. -Most relevant in the book are `Chapter 4.3. Debug `_ and `Appendix A: Debugprobe `_ +As already suggested in :ref:`building_the_software` it is recommended to use the `Visual Studio Code Extension `_. +The most relevant sections in the book are `Chapter 4.3. Debug `_ and `Appendix A: Debugprobe `_ + 5. Wiring ---------------------------------- diff --git a/sphinx/html/_sources/hardware/rev_0_3/hw_description.rst.txt b/sphinx/html/_sources/hardware/rev_0_3/hw_description.rst.txt index 7602360..3fc164f 100644 --- a/sphinx/html/_sources/hardware/rev_0_3/hw_description.rst.txt +++ b/sphinx/html/_sources/hardware/rev_0_3/hw_description.rst.txt @@ -110,10 +110,6 @@ Complete Schematic Complete Schematic -BOM & Alternative Parts -============================== -please see **PLACEHOLDER-AUTOGENERATED-BOM** for the complete BOM. - .. _wiring_rev_0_3: diff --git a/sphinx/html/_sources/hardware/rev_1_0/hw_description.rst.txt b/sphinx/html/_sources/hardware/rev_1_0/hw_description.rst.txt index 02ac344..c92c0dd 100644 --- a/sphinx/html/_sources/hardware/rev_1_0/hw_description.rst.txt +++ b/sphinx/html/_sources/hardware/rev_1_0/hw_description.rst.txt @@ -112,10 +112,6 @@ Complete Schematic Complete Schematic -BOM & Alternative Parts -============================== -please see **PLACEHOLDER-AUTOGENERATED-BOM** for the complete BOM. - .. _wiring_rev_1_0: diff --git a/sphinx/html/_sources/index.rst.txt b/sphinx/html/_sources/index.rst.txt index 67b8374..151cca1 100644 --- a/sphinx/html/_sources/index.rst.txt +++ b/sphinx/html/_sources/index.rst.txt @@ -10,8 +10,7 @@ RP2040-Decoder Documentation :maxdepth: 3 :caption: Contents: - other/getting_started + gs/getting_started hardware/index software/index - other/index - other/troubleshooting + other/index \ No newline at end of file diff --git a/sphinx/html/_sources/other/CV_list.rst.txt b/sphinx/html/_sources/other/CV_list.rst.txt new file mode 100644 index 0000000..b84491a --- /dev/null +++ b/sphinx/html/_sources/other/CV_list.rst.txt @@ -0,0 +1,126 @@ +Configuration Variables (CV) +============================ + + +.. note:: + + - ``CV.h`` contains default values for every CV. When your board is still "factory new" these values are automatically written into flash. ``CV_65 == 255`` indicates a factory condition and resets all CVs to default. + + - Index 0 in the CV array corresponds with ``CV_1``, index 1 corresponds with ``CV_2`` and so forth. + +Reset all CVs +------------------------ + +To reset all CVs to default, a value of ``8`` can be written to ``CV8``. Alternatively write a value of ``255`` to ``CV_65`` this will also reset all CVs to default, but only after power cycling the decoder. + +Speed step configuration +------------------------ + +.. figure:: ../../../svg/sw/speed_table.svg + :alt: Speed Table + :align: center + + Speed Table + +* :math:`v_{min} = CV_{2}` +* :math:`v_{mid} = 16 \cdot CV_{6}` +* :math:`v_{max} = 16 \cdot CV_{5}` + +The figure above shows how the speed steps can be configured using the corresponding CVs. The red * represents :math:`v_{min}` which is always at speed step 1, the green * shows :math:`v_{mid}` at speed step 63, and the blue * shows :math:`v_{max}` at speed step 126. + +CV List +------- + +:math:`CV_{1}` - Basic address +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Short DCC address + +:math:`CV_{2}` - :math:`v_{min}` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Min motor voltage/speed is: :math:`v_{min} = CV_{2}` + +:math:`CV_{3}` - Acceleration rate +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +The time for one discrete acceleration time step can be calculated as :math:`CV_{3} \cdot CV_{175}`. + +.. note:: Base speed steps are always 128/126 steps. + +:math:`CV_{4}` - Deceleration rate +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +The time for one discrete deceleration time step can be calculated as :math:`CV_{4} \cdot CV_{175}`. + +.. note:: Base speed steps are always 128/126 steps. + +:math:`CV_{5}` - :math:`v_{max}` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Max motor voltage/speed is calculated as: :math:`v_{max} = 16 \cdot CV_{5}` + +:math:`CV_{6}` - :math:`v_{mid}` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Mid motor voltage/speed is calculated as: :math:`v_{mid} = 16 \cdot CV_{6}` + +:math:`CV_{7}` - Version No. (Read-Only) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Writing a value of ``7`` triggers an ADC offset adjustment. + +:math:`CV_{8}` - Manufacturer (Read-Only) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Default = ``13`` = Public Domain & Do-It-Yourself Decoders + +Even though :math:`CV_{8}` is defined as a Read-only CV, writing a value of ``8`` resets all CV values to the default values in ``CV.h``. + +:math:`CV_{9}` - Motor PWM Frequency +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +:math:`f_{PWM_{MOTOR}} = (CV_9 \cdot 100 + 10000) \, Hz` + +:math:`CV_{11}` - Packet timeout +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +If no package is received for :math:`x = CV_{11}` seconds the decoder will automatically stop the motor (Emergency Stop). + +:math:`CV_{12}` - Permitted operating modes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Currently, DCC Digital mode is the only supported mode. + +:math:`CV_{17}` & :math:`CV_{18}` - 14-Bit extended/long address +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Address is only used if bit5 of :math:`CV_{29}` has a value of ``1``. + +.. image:: ../../../svg/sw/Long_address.svg + :alt: Long Address + :align: center + +Bit15 and bit14 which correspond to bit7 and bit6 of :math:`CV_{17}` are always ``1``. :math:`CV_{17} = 192` & :math:`CV_{18} = 0` is also not a valid address. +Otherwise, the valid value range of :math:`CV_{17}` ranges from ``192`` to ``231`` and ``0`` to ``255`` for :math:`CV_{18}` respectively. + +:math:`CV_{29}` - Decoder Configuration +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Bit0 is can be used to reverse motor direction, i.e., ``0`` = normal, ``1`` = reverse. +Bit5 switches between basic and extended addressing modes, i.e., ``0`` = basic address, ``1`` = extended address. +The other 6 bits are currently not in use and therefore irrelevant. + +:math:`CV_{31}` & :math:`CV_{32}` - Extended CV pointer (Read-Only) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Not in use. + + +:math:`CV_{116}` to :math:`CV_{171}` - PWM Slice configuration +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.. image:: ../../../svg/sw/GPIO_slices.svg + :alt: GPIO Slices + :align: center + +Every slice controls two independent output channels, duty cycle from 0% to 100% inclusive, and can be configured with several parameters: + +* Wrap (16Bit): Sets the slice time period of x cycles - effectively determining the frequency +* Clock Divider: Additional clock divider +* Level Channel A / Level Channel B (16Bit each): Determining how many of the x cycles the signal is at a high level - effectively determining the duty cycle + +To see which CVs correspond to which slice and channel, it is advisable to use ``CV.h`` as a reference. + +The PWM frequency is calculated as follows: :math:`f_{PWM} = \frac{125 \, \text{MHz}}{(CV_{\text{clk_div}} + 1) \cdot (CV_{\text{wrap}} + 1)}` + +The duty-cycle can be calculated as follows: :math:`D = \frac{CV_{\text{Level}}}{CV_{\text{wrap}} + 1}` + + +A more detailed explanation regarding PWM can be found in the `RP2040-Datasheet - Chapter 4.5 `_. + diff --git a/sphinx/html/_sources/other/debug_logging.rst.txt b/sphinx/html/_sources/other/debug_logging.rst.txt new file mode 100644 index 0000000..7b3f6e0 --- /dev/null +++ b/sphinx/html/_sources/other/debug_logging.rst.txt @@ -0,0 +1,23 @@ +Debugging and Logging +================================== + +For logging and debugging you have to build the software yourself. This is explained here: :ref:`building_the_software` + +.. _debugging_via_swd: + +Debugging via SWD +---------------------------------- +Please refer to :ref:`flashing_the_software_swd`. + + +.. _logging: + +Logging +---------------------------------- + +Logging can be enabled in ``CMakeLists.txt``, and is available with two interfaces: + + - Logging via UART RX/TX pins (GPIO0/GPIO1 by default) + - Logging via USB CDC/ACM + +Additionally you can make the decoder wait for input via serial port by setting LOG_WAIT to 1. For more details please see comments inside ``CMakeLists.txt``. diff --git a/sphinx/html/_sources/other/index.rst.txt b/sphinx/html/_sources/other/index.rst.txt index f775542..8e1aa68 100644 --- a/sphinx/html/_sources/other/index.rst.txt +++ b/sphinx/html/_sources/other/index.rst.txt @@ -5,5 +5,6 @@ Other :maxdepth: 2 :caption: Contents: - CV_list - troubleshooting \ No newline at end of file + troubleshooting + debug_logging + CV_list \ No newline at end of file diff --git a/sphinx/html/_sources/other/troubleshooting.rst.txt b/sphinx/html/_sources/other/troubleshooting.rst.txt new file mode 100644 index 0000000..771778a --- /dev/null +++ b/sphinx/html/_sources/other/troubleshooting.rst.txt @@ -0,0 +1,27 @@ +Troubleshooting +================ + +To narrow down the issue when your decoder is not working as expected, you can do the following (in no particular order): + +Enable logging and or debug via SWD +------------------------------------ +Log messages can be enabled and output via either UART or USB please see :ref:`logging` for details. +For more advanced users it might also be beneficial to :ref:`debug with SWD ` + +Checking the power supply: +-------------------------------------- + +* **+3V3 to GND** should be 3.3V ± 1% +* **VDC/+V to GND** should be somewhere in the range of at least 6V to 23V depending on your track voltage. + +If you don't measure the correct voltages, try to `measure your track voltage `_ + +Check your motor: +----------------- + +Desolder your motor and try the motor with an appropriate power supply and DC voltage, to check if the motor is working or not. + +CV Reset: +------------ + +Try to reset the decoder by writing a value of ``8`` to ``CV8`` (beware, this will reset the complete CV memory!) diff --git a/sphinx/html/_sources/software/sw_description.rst.txt b/sphinx/html/_sources/software/sw_description.rst.txt index 4892bb0..7e88fdf 100644 --- a/sphinx/html/_sources/software/sw_description.rst.txt +++ b/sphinx/html/_sources/software/sw_description.rst.txt @@ -65,14 +65,14 @@ Control Loop & Digital Controller Control Loop - Block diagram -The block diagram above shows the complete control loop. The actual digital controller block is explained below. +The block diagram above shows the (simplified) control loop. The actual digital controller block is explained below. -The Speed Helper block effectively sets the setpoint of the controller according to the CV configured acceleration and deceleration rates and actual target speedstep. +The *Speed Helper* block effectively sets the setpoint of the controller according to the CV configured acceleration and deceleration rates and actual target speedstep. -For feedback the back EMF voltage V_EMF is measured via voltage divider and ADC. V_EMF is proportional to the motor speed in RPM. +For feedback the back EMF voltage *V_EMF* is measured via voltage divider and ADC. *V_EMF* is proportional to the motor speed. -TODO: rewrite this: While the central component is the PID controller, there is an additional block called `Feed-forward `_ that has an impact on the control output variable. The Feed-forward block adds an additional offset to the output depending on the setpoint; this is done to achieve better control. A more detailed explanation regarding Feed-forward can be found below. The speed helper block corresponds to the ``speed_helper()`` function, which delays changing the setpoint according to the configured deceleration/acceleration rates. +While the central component is the PID controller, there is an additional block called `Feed-forward `_ that has an impact on the control output variable. The Feed-forward block adds an additional offset to the output depending on the setpoint; this is done to achieve better control. A more detailed explanation regarding Feed-forward can be found below. The speed helper block corresponds to the ``speed_helper()`` function, which delays changing the setpoint according to the configured deceleration/acceleration rates. .. figure:: ../../../svg/sw/Block_Diagram_Digital_Controller.svg :alt: Block Diagram - Digital Controller @@ -80,12 +80,27 @@ TODO: rewrite this: While the central component is the PID controller, there is Digital Controller - Block diagram -The controller is divided into two parts, depending on whether the motor is stationary or in motion. The startup controller handles overcoming friction of the motor, and finding base PWM level for overcoming friction. The base PWM level is saved and added to the output of the PID controller which handles motor control when the motor is in motion. +The controller is divided into two parts, depending on whether the motor is stationary or in motion. +At all times either the startup controller or the PID controller is active. + +The startup controller handles overcoming friction of the motor, and finding a base PWM level for overcoming friction. +The base PWM level is equivalent to a certain PWM duty cycle. +The base level gets saved and added to the output of the PID controller which handles motor control when the motor is in motion. +This means the actual output of the PID controller is the sum of the PID output and the base PWM level. This is referred to as the :ref:`feed forward ` block. +The benefit of doing this is that the PID controller does not have to work in the non linear friction region of the motor, improving control performance. Startup Controller ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Used on startup, meaning when the motor is not moving. The startup controller sets a PWM duty cycle level of :math:`\frac{2}{3} \cdot \text{base_pwm}` and then ramps up the duty cycle/PWM level until the motor starts moving. This is done in order to overcome the friction of the drive train and motor. :math:`\text{base_pwm}` is the average value of the 16 previous startup PWM levels. When no previous startup PWM levels are saved the startup controller begins ramping up from 0. The actual value at which the motor started moving is used as a reference for the :ref:`feed forward ` block. + +Used on startup, meaning when the motor is not moving. First the startup controller retrieves the last `BASE_PWM_ARR_LEN` base PWM levels. +The base pwm levels are not retained on a power cycle. That means when there is no previous base PWM level saved, the startup controller will start ramping up from 0. +When there is less than `BASE_PWM_ARR_LEN` base PWM levels saved, the startup controller will ramp up from the average of the saved base PWM levels. + +After the startup controller retrieved the average of the last base pwm levels :math:`\bar{b}` it sets a PWM duty cycle level of :math:`\frac{2}{3} \cdot \bar{b}` and then ramps up the duty cycle/PWM level until the motor starts moving. +When no previous startup PWM levels are saved the startup controller begins ramping up from 0. +The actual value at which the motor started moving is multiplied by `K_FF` and used as a reference for the :ref:`feed forward ` block. + PID Controller @@ -131,7 +146,7 @@ This results in the following difference equations which are then implemented in Gain Scheduling -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +^^^^^^^^^^^^^^^^^^^^ .. figure:: ../../../svg/sw/adaptive_kp.svg :alt: Gain Scheduling figure @@ -145,19 +160,12 @@ Another aspect to consider is the implementation of `gain scheduling `_ is used. +In essence this means that the output of the PID controller is not only the sum of the proportional, integral, and derivative parts, but also the base PWM level. +The base PWM level is set by the startup controller and is the PWM level at which the motor starts moving. -.. figure:: ../../../svg/sw/feed_forward.svg - :alt: Feed forward figure - :align: center - - Feed-forward - - -TODO: Update this part: - -To achieve better control, `Feed-forward `_ is used. On startup, the decoder will check for a configuration regarding Feed-forward control. When no configuration is found, the decoder automatically runs a calibration to establish a base PWM level (y\ :sub:`1`) for both directions. The base PWM level (y\ :sub:`1`) will vary depending on load, motor, and voltage on the tracks and can be configured with CV_176 - CV_179. If the setpoint is greater than the threshold, y\ :sub:`2` is corrected automatically when i\ :sub:`n` reaches 0.5i\ :sub:`min` or 0.5i\ :sub:`max`. CV_47 can be used to set how sensitive this correction is. Back-EMF voltage measurement ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/sphinx/html/genindex.html b/sphinx/html/genindex.html index 6729ffc..65d56df 100644 --- a/sphinx/html/genindex.html +++ b/sphinx/html/genindex.html @@ -41,7 +41,7 @@

@@ -78,7 +78,7 @@
  • - View page source + View page source

  • @@ -94,19 +94,20 @@

    2. Production files?

    -

    In order to export the production files (Gerber/BOM/Pick and Place), you need KiCad which is open source. +

    The latest release includes the production files for JLCPCB, which includes the Gerber files, BOM, and Pick and Place files. You can find the latest release here.

    +

    In order to manually export the production files (Gerber/BOM/Pick and Place), you need KiCad which is open source. In case you are ordering from JLCPCB it is recommended to use the Fabrication-Toolkit KiCad plugin by bennymeg

    3. Building the software

    -

    If you got a RP2040-Decoder with USB the easiest way to get the RP2040-Decoder up and running is to just use the precompiled .uf2 file and ignore the rest of this section.

    +

    If you got a RP2040-Decoder with USB the easiest way to get the RP2040-Decoder up and running is to just use the precompiled .uf2 file in the latest release and skip to 4. Flashing the software.

    However sometimes you might want to build by yourself, be it for debugging or to make your own modifications to the source code. The easiest way to do this is to just use Visual Studio Code and the Raspberry Pi Pico extension. The official documentation of the Pi Pico does a great job of explaining this in detail.

    Note: If you are building for Hardware Rev 0.3 or below change the board defintion in your CMakeLists.txt file to: “RP2040-Decoder-board-legacy.h”

    -

    4. Flashing the software

    +

    4. Flashing the software

    For RP2040-Decoders with USB there is two ways of flashing the software:

    1. Flashing via USB using the .uf2 file by copying it with your preferred file explorer.

    2. @@ -120,15 +121,15 @@ The

      When first plugged in the RP2040 boots into Mass Storage Device mode. To flash the software, you need to drag the ‘.uf2’ file onto the disk using any file explorer. This will write the file to the Flash and restart the RP2040. -In case you want to repeat the flasing process, temporarily connect the solder bridge called JP1 on the back side of the board and power cycle the device. +In case you want to repeat the flashing process, hold the button SW1 while re-plugging the decoder into your computer. The decoder should now show as a Mass Storage Device again. This procedure is also described in the Raspberry Pi Pico Datasheet Chapter 4.1

    -

    4.2. Flashing the software via SWD

    +

    4.2. Flashing the software via SWD

    Flashing via SWD is a little more complicated but also comes with great advantages in terms of debugging. The book on Getting started with Raspberry Pi Pico-series does a great job of explaining how debugging works. -As already suggested in 3. it is recommended to use the Visual Studio Code Extension. -Most relevant in the book are Chapter 4.3. Debug and Appendix A: Debugprobe

    +As already suggested in 3. Building the software it is recommended to use the Visual Studio Code Extension. +The most relevant sections in the book are Chapter 4.3. Debug and Appendix A: Debugprobe

    diff --git a/sphinx/html/hardware/index.html b/sphinx/html/hardware/index.html index 0b92be3..148bdae 100644 --- a/sphinx/html/hardware/index.html +++ b/sphinx/html/hardware/index.html @@ -20,7 +20,7 @@ - + @@ -44,7 +44,7 @@ @@ -133,7 +130,6 @@
  • GPIO
  • Microcontroller
  • Complete Schematic
  • -
  • BOM & Alternative Parts
  • Wiring the Decoder
  • @@ -144,7 +140,7 @@
    -
    -

    BOM & Alternative Parts

    -

    please see PLACEHOLDER-AUTOGENERATED-BOM for the complete BOM.

    -

    Wiring the Decoder

    diff --git a/sphinx/html/hardware/rev_1_0/hw_description.html b/sphinx/html/hardware/rev_1_0/hw_description.html index 12be8d2..d09b808 100644 --- a/sphinx/html/hardware/rev_1_0/hw_description.html +++ b/sphinx/html/hardware/rev_1_0/hw_description.html @@ -44,7 +44,7 @@
    -
    -

    BOM & Alternative Parts

    -

    please see PLACEHOLDER-AUTOGENERATED-BOM for the complete BOM.

    -

    Wiring the Decoder

    -Wiring Diagram +Wiring Diagram

    Wiring Diagram

    diff --git a/sphinx/html/index.html b/sphinx/html/index.html index 96213b6..3dd85a0 100644 --- a/sphinx/html/index.html +++ b/sphinx/html/index.html @@ -20,7 +20,7 @@ - + @@ -44,7 +44,7 @@

    diff --git a/sphinx/html/objects.inv b/sphinx/html/objects.inv index d46e8d68cc1c17db316cc593ecf8cc7b9e2fc863..f3947a8bbc4baebdef4bc4a6077e09072bed0a16 100644 GIT binary patch literal 15650 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 literal 15461 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 PW~=PL2c!?GF~|P^vwnm6 diff --git a/sphinx/html/other/CV_list.html b/sphinx/html/other/CV_list.html new file mode 100644 index 0000000..a39142a --- /dev/null +++ b/sphinx/html/other/CV_list.html @@ -0,0 +1,252 @@ + + + + + + + + + Configuration Variables (CV) — RP2040-Decoder 0.3, 1.0 documentation + + + + + + + + + + + + + + + + + +
    + + +
    + +
    +
    +
    + +
    +
    +
    +
    + +
    +

    Configuration Variables (CV)

    +
    +

    Note

    +
      +
    • CV.h contains default values for every CV. When your board is still “factory new” these values are automatically written into flash. CV_65 == 255 indicates a factory condition and resets all CVs to default.

    • +
    • Index 0 in the CV array corresponds with CV_1, index 1 corresponds with CV_2 and so forth.

    • +
    +
    +
    +

    Reset all CVs

    +

    To reset all CVs to default, a value of 8 can be written to CV8. Alternatively write a value of 255 to CV_65 this will also reset all CVs to default, but only after power cycling the decoder.

    +
    +
    +

    Speed step configuration

    +
    +Speed Table +
    +

    Speed Table

    +
    +
    +
      +
    • \(v_{min} = CV_{2}\)

    • +
    • \(v_{mid} = 16 \cdot CV_{6}\)

    • +
    • \(v_{max} = 16 \cdot CV_{5}\)

    • +
    +

    The figure above shows how the speed steps can be configured using the corresponding CVs. The red * represents \(v_{min}\) which is always at speed step 1, the green * shows \(v_{mid}\) at speed step 63, and the blue * shows \(v_{max}\) at speed step 126.

    +
    +
    +

    CV List

    +
    +

    \(CV_{1}\) - Basic address

    +

    Short DCC address

    +
    +
    +

    \(CV_{2}\) - \(v_{min}\)

    +

    Min motor voltage/speed is: \(v_{min} = CV_{2}\)

    +
    +
    +

    \(CV_{3}\) - Acceleration rate

    +

    The time for one discrete acceleration time step can be calculated as \(CV_{3} \cdot CV_{175}\).

    +
    +

    Note

    +

    Base speed steps are always 128/126 steps.

    +
    +
    +
    +

    \(CV_{4}\) - Deceleration rate

    +

    The time for one discrete deceleration time step can be calculated as \(CV_{4} \cdot CV_{175}\).

    +
    +

    Note

    +

    Base speed steps are always 128/126 steps.

    +
    +
    +
    +

    \(CV_{5}\) - \(v_{max}\)

    +

    Max motor voltage/speed is calculated as: \(v_{max} = 16 \cdot CV_{5}\)

    +
    +
    +

    \(CV_{6}\) - \(v_{mid}\)

    +

    Mid motor voltage/speed is calculated as: \(v_{mid} = 16 \cdot CV_{6}\)

    +
    +
    +

    \(CV_{7}\) - Version No. (Read-Only)

    +

    Writing a value of 7 triggers an ADC offset adjustment.

    +
    +
    +

    \(CV_{8}\) - Manufacturer (Read-Only)

    +

    Default = 13 = Public Domain & Do-It-Yourself Decoders

    +

    Even though \(CV_{8}\) is defined as a Read-only CV, writing a value of 8 resets all CV values to the default values in CV.h.

    +
    +
    +

    \(CV_{9}\) - Motor PWM Frequency

    +

    \(f_{PWM_{MOTOR}} = (CV_9 \cdot 100 + 10000) \, Hz\)

    +
    +
    +

    \(CV_{11}\) - Packet timeout

    +

    If no package is received for \(x = CV_{11}\) seconds the decoder will automatically stop the motor (Emergency Stop).

    +
    +
    +

    \(CV_{12}\) - Permitted operating modes

    +

    Currently, DCC Digital mode is the only supported mode.

    +
    +
    +

    \(CV_{17}\) & \(CV_{18}\) - 14-Bit extended/long address

    +

    Address is only used if bit5 of \(CV_{29}\) has a value of 1.

    +Long Address +

    Bit15 and bit14 which correspond to bit7 and bit6 of \(CV_{17}\) are always 1. \(CV_{17} = 192\) & \(CV_{18} = 0\) is also not a valid address. +Otherwise, the valid value range of \(CV_{17}\) ranges from 192 to 231 and 0 to 255 for \(CV_{18}\) respectively.

    +
    +
    +

    \(CV_{29}\) - Decoder Configuration

    +

    Bit0 is can be used to reverse motor direction, i.e., 0 = normal, 1 = reverse. +Bit5 switches between basic and extended addressing modes, i.e., 0 = basic address, 1 = extended address. +The other 6 bits are currently not in use and therefore irrelevant.

    +
    +
    +

    \(CV_{31}\) & \(CV_{32}\) - Extended CV pointer (Read-Only)

    +

    Not in use.

    +
    +
    +

    \(CV_{116}\) to \(CV_{171}\) - PWM Slice configuration

    +GPIO Slices +

    Every slice controls two independent output channels, duty cycle from 0% to 100% inclusive, and can be configured with several parameters:

    +
      +
    • Wrap (16Bit): Sets the slice time period of x cycles - effectively determining the frequency

    • +
    • Clock Divider: Additional clock divider

    • +
    • Level Channel A / Level Channel B (16Bit each): Determining how many of the x cycles the signal is at a high level - effectively determining the duty cycle

    • +
    +

    To see which CVs correspond to which slice and channel, it is advisable to use CV.h as a reference.

    +

    The PWM frequency is calculated as follows: \(f_{PWM} = \frac{125 \, \text{MHz}}{(CV_{\text{clk_div}} + 1) \cdot (CV_{\text{wrap}} + 1)}\)

    +

    The duty-cycle can be calculated as follows: \(D = \frac{CV_{\text{Level}}}{CV_{\text{wrap}} + 1}\)

    +

    A more detailed explanation regarding PWM can be found in the RP2040-Datasheet - Chapter 4.5.

    +
    +
    +
    + + +
    +
    + +
    +
    +
    +
    + + + + \ No newline at end of file diff --git a/sphinx/html/other/debug_logging.html b/sphinx/html/other/debug_logging.html new file mode 100644 index 0000000..58dc3c6 --- /dev/null +++ b/sphinx/html/other/debug_logging.html @@ -0,0 +1,138 @@ + + + + + + + + + Debugging and Logging — RP2040-Decoder 0.3, 1.0 documentation + + + + + + + + + + + + + + + + + +
    + + +
    + +
    +
    +
    + +
    +
    +
    +
    + +
    +

    Debugging and Logging

    +

    For logging and debugging you have to build the software yourself. This is explained here: 3. Building the software

    +
    +

    Debugging via SWD

    +

    Please refer to 4.2. Flashing the software via SWD.

    +
    +
    +

    Logging

    +

    Logging can be enabled in CMakeLists.txt, and is available with two interfaces:

    +
    +
      +
    • Logging via UART RX/TX pins (GPIO0/GPIO1 by default)

    • +
    • Logging via USB CDC/ACM

    • +
    +
    +

    Additionally you can make the decoder wait for input via serial port by setting LOG_WAIT to 1. For more details please see comments inside CMakeLists.txt.

    +
    +
    + + +
    +
    + +
    +
    +
    +
    + + + + \ No newline at end of file diff --git a/sphinx/html/other/index.html b/sphinx/html/other/index.html index 29b10f1..00bd9a0 100644 --- a/sphinx/html/other/index.html +++ b/sphinx/html/other/index.html @@ -16,9 +16,11 @@ + + @@ -43,10 +45,13 @@

    diff --git a/sphinx/html/other/troubleshooting.html b/sphinx/html/other/troubleshooting.html new file mode 100644 index 0000000..2f59eff --- /dev/null +++ b/sphinx/html/other/troubleshooting.html @@ -0,0 +1,146 @@ + + + + + + + + + Troubleshooting — RP2040-Decoder 0.3, 1.0 documentation + + + + + + + + + + + + + + + + + +
    + + +
    + +
    +
    +
    + +
    +
    +
    +
    + +
    +

    Troubleshooting

    +

    To narrow down the issue when your decoder is not working as expected, you can do the following (in no particular order):

    +
    +

    Enable logging and or debug via SWD

    +

    Log messages can be enabled and output via either UART or USB please see Logging for details. +For more advanced users it might also be beneficial to debug with SWD

    +
    +
    +

    Checking the power supply:

    +
      +
    • +3V3 to GND should be 3.3V ± 1%

    • +
    • VDC/+V to GND should be somewhere in the range of at least 6V to 23V depending on your track voltage.

    • +
    +

    If you don’t measure the correct voltages, try to measure your track voltage

    +
    +
    +

    Check your motor:

    +

    Desolder your motor and try the motor with an appropriate power supply and DC voltage, to check if the motor is working or not.

    +
    +
    +

    CV Reset:

    +

    Try to reset the decoder by writing a value of 8 to CV8 (beware, this will reset the complete CV memory!)

    +
    +
    + + +
    +
    + +
    +
    +
    +
    + + + + \ No newline at end of file diff --git a/sphinx/html/search.html b/sphinx/html/search.html index dc3f6bc..69075b3 100644 --- a/sphinx/html/search.html +++ b/sphinx/html/search.html @@ -44,7 +44,7 @@
    -

    The block diagram above shows the complete control loop. The actual digital controller block is explained below.

    -

    The Speed Helper block effectively sets the setpoint of the controller according to the CV configured acceleration and deceleration rates and actual target speedstep.

    -

    For feedback the back EMF voltage V_EMF is measured via voltage divider and ADC. V_EMF is proportional to the motor speed in RPM.

    -

    TODO: rewrite this: While the central component is the PID controller, there is an additional block called Feed-forward that has an impact on the control output variable. The Feed-forward block adds an additional offset to the output depending on the setpoint; this is done to achieve better control. A more detailed explanation regarding Feed-forward can be found below. The speed helper block corresponds to the speed_helper() function, which delays changing the setpoint according to the configured deceleration/acceleration rates.

    +

    The block diagram above shows the (simplified) control loop. The actual digital controller block is explained below.

    +

    The Speed Helper block effectively sets the setpoint of the controller according to the CV configured acceleration and deceleration rates and actual target speedstep.

    +

    For feedback the back EMF voltage V_EMF is measured via voltage divider and ADC. V_EMF is proportional to the motor speed.

    +

    While the central component is the PID controller, there is an additional block called Feed-forward that has an impact on the control output variable. The Feed-forward block adds an additional offset to the output depending on the setpoint; this is done to achieve better control. A more detailed explanation regarding Feed-forward can be found below. The speed helper block corresponds to the speed_helper() function, which delays changing the setpoint according to the configured deceleration/acceleration rates.

    -Block Diagram - Digital Controller +Block Diagram - Digital Controller

    Digital Controller - Block diagram

    -

    The controller is divided into two parts, depending on whether the motor is stationary or in motion. The startup controller handles overcoming friction of the motor, and finding base PWM level for overcoming friction. The base PWM level is saved and added to the output of the PID controller which handles motor control when the motor is in motion.

    +

    The controller is divided into two parts, depending on whether the motor is stationary or in motion. +At all times either the startup controller or the PID controller is active.

    +

    The startup controller handles overcoming friction of the motor, and finding a base PWM level for overcoming friction. +The base PWM level is equivalent to a certain PWM duty cycle. +The base level gets saved and added to the output of the PID controller which handles motor control when the motor is in motion. +This means the actual output of the PID controller is the sum of the PID output and the base PWM level. This is referred to as the feed forward block. +The benefit of doing this is that the PID controller does not have to work in the non linear friction region of the motor, improving control performance.

    Startup Controller

    -

    Used on startup, meaning when the motor is not moving. The startup controller sets a PWM duty cycle level of \(\frac{2}{3} \cdot \text{base_pwm}\) and then ramps up the duty cycle/PWM level until the motor starts moving. This is done in order to overcome the friction of the drive train and motor. \(\text{base_pwm}\) is the average value of the 16 previous startup PWM levels. When no previous startup PWM levels are saved the startup controller begins ramping up from 0. The actual value at which the motor started moving is used as a reference for the feed forward block.

    +

    Used on startup, meaning when the motor is not moving. First the startup controller retrieves the last BASE_PWM_ARR_LEN base PWM levels. +The base pwm levels are not retained on a power cycle. That means when there is no previous base PWM level saved, the startup controller will start ramping up from 0. +When there is less than BASE_PWM_ARR_LEN base PWM levels saved, the startup controller will ramp up from the average of the saved base PWM levels.

    +

    After the startup controller retrieved the average of the last base pwm levels \(\bar{b}\) it sets a PWM duty cycle level of \(\frac{2}{3} \cdot \bar{b}\) and then ramps up the duty cycle/PWM level until the motor starts moving. +When no previous startup PWM levels are saved the startup controller begins ramping up from 0. +The actual value at which the motor started moving is multiplied by K_FF and used as a reference for the feed forward block.

    PID Controller

    @@ -237,9 +246,8 @@ d_n &= \frac{2 K_D \cdot \left(e_n - e_{n-1}\right) + \left(2 \tau - T_s\rig
  • The previously explained base PWM is added to the actual output as well, meaning the formula above only shows the actual PID control part without feed forward.

  • -
    -

    Gain Scheduling

    +

    Gain Scheduling

    Gain Scheduling figure
    @@ -249,15 +257,11 @@ d_n &= \frac{2 K_D \cdot \left(e_n - e_{n-1}\right) + \left(2 \tau - T_s\rig

    Another aspect to consider is the implementation of gain scheduling. KP is a function of the current setpoint. Often it is favorable to have a higher proportional gain KP for slow speeds, achieving better control results. The illustration above shows the default setting for KP. CV_54 & CV_55 are used to set KP @ x0, CV_56 & CV_57 for KP @ x1, and CV_58 & CV_59 for KP @ x2. Additionally, CV_60 is used to shift x1 from the leftmost point (0% = 0/255) to the rightmost point (100% = 255/255).

    -

    Feed-forward

    -
    -Feed forward figure -
    -

    Feed-forward

    -
    -
    -

    TODO: Update this part:

    -

    To achieve better control, Feed-forward is used. On startup, the decoder will check for a configuration regarding Feed-forward control. When no configuration is found, the decoder automatically runs a calibration to establish a base PWM level (y1) for both directions. The base PWM level (y1) will vary depending on load, motor, and voltage on the tracks and can be configured with CV_176 - CV_179. If the setpoint is greater than the threshold, y2 is corrected automatically when in reaches 0.5imin or 0.5imax. CV_47 can be used to set how sensitive this correction is.

    +

    Feed-forward

    +

    As previously mentioned, to achieve better control, Feed-forward is used. +In essence this means that the output of the PID controller is not only the sum of the proportional, integral, and derivative parts, but also the base PWM level. +The base PWM level is set by the startup controller and is the PWM level at which the motor starts moving.

    +

    Back-EMF voltage measurement