From 2789165337427f5591e6b07e4e0128882294588e Mon Sep 17 00:00:00 2001 From: gab-k Date: Wed, 25 Dec 2024 20:48:40 +0000 Subject: [PATCH] deploy: acdbf3cffe9f3456902e11088aa95b2c8b12f92a --- sphinx/doctrees/environment.pickle | Bin 59432 -> 59690 bytes .../hardware/rev_0_3/hw_description.doctree | Bin 57389 -> 55574 bytes .../hardware/rev_1_0/hw_description.doctree | Bin 58383 -> 56592 bytes sphinx/doctrees/other/getting_started.doctree | Bin 23623 -> 22287 bytes sphinx/doctrees/software/header_files.doctree | Bin 6086 -> 5350 bytes .../doctrees/software/sw_description.doctree | Bin 38683 -> 36280 bytes sphinx/html/_images/Block_Diagram_Control.svg | 4 + sphinx/html/_images/Block_Diagram_PID.svg | 4 + sphinx/html/_images/adaptive_kp.svg | 131 ++++++++++++++ sphinx/html/_images/feed_forward.svg | 159 +++++++++++++++++ .../hardware/rev_0_3/hw_description.rst.txt | 34 ++-- .../hardware/rev_1_0/hw_description.rst.txt | 28 +-- sphinx/html/_sources/index.rst.txt | 1 - .../_sources/other/getting_started.rst.txt | 19 +- .../_sources/software/header_files.rst.txt | 8 +- .../_sources/software/sw_description.md.txt | 82 --------- .../_sources/software/sw_description.rst.txt | 151 ++++++++++++++++ .../html/hardware/rev_0_3/hw_description.html | 14 +- .../html/hardware/rev_1_0/hw_description.html | 16 +- sphinx/html/index.html | 1 + sphinx/html/other/getting_started.html | 1 + sphinx/html/searchindex.js | 2 +- sphinx/html/software/index.html | 4 +- sphinx/html/software/sw_description.html | 166 ++++++++++++------ 24 files changed, 635 insertions(+), 190 deletions(-) create mode 100644 sphinx/html/_images/Block_Diagram_Control.svg create mode 100644 sphinx/html/_images/Block_Diagram_PID.svg create mode 100644 sphinx/html/_images/adaptive_kp.svg create mode 100644 sphinx/html/_images/feed_forward.svg delete mode 100644 sphinx/html/_sources/software/sw_description.md.txt create mode 100644 sphinx/html/_sources/software/sw_description.rst.txt diff --git a/sphinx/doctrees/environment.pickle b/sphinx/doctrees/environment.pickle index fd50a82cf7c0317b0326cea204da467c141a368a..a2efad63995d2b2a4f4749b73d3a8246c5a8c157 100644 GIT binary patch literal 59690 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 F^xp;>=cfPw literal 59432 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 literal 57389 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≠;l#tb`vUF5@jFI`2CZjZ5K45`?PC3f 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 literal 58383 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 Ar2qf` diff --git a/sphinx/doctrees/other/getting_started.doctree b/sphinx/doctrees/other/getting_started.doctree index e65180caa42940335b92a0431b1cda0d203f912c..a2cd6832f908cf6873c46bb71c4ae8a6aa65cc74 100644 GIT binary patch delta 2679 zcmb_eZA_C_6!yNfIk}W2SZdtNrE+#7O-|o2uDQMiE{dsclx%Zs& zoaf$q-govqnV2HVA?1gPz0=B8H3^%sslOy7{PPzyfv$~IPv>bg4RE&5mn_5HgWd$H z96MTL@0IezigvNz?i8&KNo;Z2I@@gB9b&uPA(mSmZGC91llF^gDVZX(wMd=zKCzWr zyE`PYmog7K+aRNB>Fr7Bebdz|w%ag7hVW({giV`vgJRK~!8$aACpg zhK{Jy0RjS^F!<4Vkl>eJT$YQvl1AM(ZDaUaY_?gJq{54 zSePVmEiMX9#mM9wXbpp862=Xny~JFdG?5;nM=J^2JP8@bBK71GZZ*_U0~gmOD9t?5 z8KZ~%#5u5{lOfx-%L5@&uiEd-EAn2)<5h`22QjN5|XX8aLmY)ZJRO=AxJbwt9;mPAz&iybJy z+m=DiD!CIuy}1vL=V)MDXW%KTR;J9DncX}ZK$=)e9dxC9ElA60Ur8Ni3qPmc)jC(D zW!uxNY%M*V>PIo4@45<^DSkI&0wYDkwRB6+d$>n0dw^tAlaFCn#_p&iX!4zHCR=L4 z3@z-+8=yNRL6CifNah#9xg|oua65B|C4DXHy7m%o_dCxfD9+AWtm6IbQQ^jtQxH^d z>0%2Pw#;aMeagv|6Se3xlk=(YXxZtV7Z0)pA$L}*3Rs!>@HXzUbu2OpIz`G&}}uqu>!r>%~&rr zE4dDLGO^|H6;`-eU?zK6yqJIl`6Kvdt2uO0@&@Jr)A2ESl|yQ8v$uNXQ_OQLn9sVb zwr;O%h2g>!avIJSMr!;{rGS-K3vX4JL~4+Cu`rc*gsZ3)EKtCdWIX$kdGvFb7qaJWjFj_{sa{@n zK>6_ZOFKv|KgHce`A}Y*B4RT;i@TSbS&{#T1hmD;5L#SFF7k8z%ot=Y@pEB94X`G$ zbdpqs$Cw}w!O7xx$qlfSn1ovaymz&iOpx0whK0R-JGliD+s=po#S;79_gknJ_N!8s z;ySB!lYg^BB z=V7|Soc(|)CqG1ZgpF1uFW~qw13dc0=DX@}N+D!tBPp6`-}$W&dXnWFQ%eqq-2wNj zHq4Y%e;?p-GNbH3HubcY&e5xMoQ~3IIwdz?mMd~SW~oKcAgn{kKuAT1X9~+^ggKmE zMW|rcQ!YcuL&!le;+ALx7fuHe<`}r-t2n%e@F#)>_pC!WgD{EEg&bvs1)M%WNW!TF zp$4InfpaXl+u9}d_V1H=@V`dJ+B~%0L+3nn+)bz5ye2m<$-~QWxA0orybceq!Oi)5 zICnSa?cto=oUfZxb#t0-PSL~Zc{nvUr{(69+)f&cBpk4>PDg5Cv`**ZLgClRC)8ye zaiQ=V=o2a(M_efUNcn`?k0Y+rWgKyxe!~&hDe#F-_<(&n;WhB-bPq>dr%j4rHbkN1 z?T}pm&~TOwD@o5`Z=H8cz0d0Ck(#@to*rullds7O+QtYdZb*g;dxN2-v5bVm{XIs| Xs8lMw9HjJhRJh%kDyWp8el_=BgvAG| delta 3544 zcmcImZETa*73RLS^TB}FSwgU#I8GpqEho+=`66EqAvCxntZCCR+6E_io9h>Ugx7YU zA1I)yn@udLao&kdVngayY0_AK zeA{vamd$P`vK1K0X#@Pja+$^8$5w@%KsUSdY^aSec(2z6jYE3taq^h*Mk}FofY^kh zE}bs-F?No287gt@ER@?GNEaC#Z#6?hrNVxOOHO#Fy#W4P>17w8%nqhE(Ls#6_;>hu zFT+h2;kvz_HobG8)len8v{fb89r9YRljgVqJRZ9-3kgLFL4EaTS%C1Y$=e1Os(;5m zAs<_6vXdFfXYe)GE5@8EI7Ha1uEWfO&YWP(&o?Q(xG$?x4NHgW=5=fY zXCm;9Jc;TzjjTTTYRm{O2^jJt?)gwO6%NwXMn-bWj0@ zTbzY+WMWlbmawR`aHXY2N=op{{yH$UI*c#UVyeE4Xfy&nt<3_)@3DN8y1e_0eguu+ zx23aiwC%9zO`K#`a0LF;)+)AGz}!C1Zi#Jo+k>bZ>{xQ$&9$fb1mZQ=eW59P7G%oa z0^OaL*hj+0)~-|NW4`O{k_YSfAl40pxffuMnoD{Ely=L^BB=jScP*=gTM_dsy{S6uFA9HP2-Ik za;;=lsS`6E0AF8Cg$J>Csj@lHJJZl@u-s=|4L`Up{NVZiT}<5oaCm*dudENaal9oL za2FyxMu5#50q&yvT~<%ntV&LaI^d*dKWoD}9%gTd8oo|;nI6{zM+RoWJRo}7u0Hgz zVt_OR@piA&j^|O~9Eu9Az2C)CdS!35bXzBy)u(%3WACE#RI~ck;554pJN8{O{S8B9 zANAYt{yvw%gE9U9rlFnL&5@MLX=KzKVPxn-=?fin?C+KSor?1P{S%U256e{!(GzPP ze}YybkDo0r(XWn!>Z0MYm3^M!QR%VNz8k{_NW1yK%f)SL_gpxzn^vil4j`O|gwd4M zHc7dx19x?Gn{pqSQ9dN`5p}>k3kN^Z z)lMS}WeNo!<%jqk{zra}&+|pTpbU}UTgpE2I{-JI+%acHew6JbZjkaii9LAal@1bh zB%CBnWU`IKahirm+#qqC#61#!B_WZ?e`s`xMi)tp6P{;Dd`#2(By2Rb>I+f!)367Q zj+V?3@&q4E@H+{9F3uO@0&!dbPAEnM7gw5vB-{ysIWF)f1lG8~nGhJ`0$*HUiwj(F zfhi&IBm|bYz!4V^;xRr~g|Bjoxh=?CJu)|j%)QDN_|N$*{;o2BvGH#!v6N4ufrOKU z;E-OK6o*%7BsiqkEXCnYqD62>FHMR=P9wqLRcX^;n#8}5QjqwNMuJ4TgDDc}1f)p3 zMYwa&xcqblbHKf)>*tbv`%caT{FDBuJ?K-9#b)esXeweq;g9lg zENb`JCj!3EF?+xtlK0qSA^GHtJQWou zDARX}@Rom$>YVnH`QA!ep7KWnG9sFiRdQ>OhQsy<54Wh9G&iy#lS~3-21>wbRZ0xv z?JP`g4fvz7>I;ld1j3WYG|*OHBt5O}Cb(oSgZEqp2)GJsHb1|?Z-wgI9gdB6q#$7% zsYM_W@D!Fi3r_|EU6C0da+NHYQRRrN&dTBqs6iVvCCt=7@VzddOXhN~m~eT8cE`H3 zulYv%D&|w29=|Zwuv?lgL55xgI0(;;)s}h?2ReQX|GwmM54`WHuHKlA^jQ^VkHXqF z(K)eZH7mPusI*Z`JYH$02*M+<)UXaqUq#7UDzcbJr|~6Ql{p7C!x%z z{{PI_OBh2iR&nI7(rb^aFxY&4$$ diff --git a/sphinx/doctrees/software/header_files.doctree b/sphinx/doctrees/software/header_files.doctree index acda21a10454aa055d1dfd40819af3b2a27312e6..0ee0c370ddc948dfe4a3e375ec40a6bf02303ad0 100644 GIT binary patch delta 62 zcmX@6|4fs$fpzL_k&Uc1LX&mbxhLm{rZXOxyjQ@Gaqr~!0tS<9gm@=Ai!EZj4Hmlr J7Yh|H1OUoz7FYlP delta 551 zcmaE+c}$qrq8`n`2d6keHl0rH7-S zD784Xs4R6#X@+*zS)dxAdmt`Io&1ndax$Nw;A9&i-g@C4w&MKKBA}iO9gxx%uq(4# zffUSH5Kkk80$$$}9Y7jD7rmLhSHRHsCB)8iNOqDH6u*E5fWuoM>n@O)bq{1N!uud= zGGu|?OhO3)M&ZdR!ir4Z!jp4^+L=U|Chrq4U=m`Q{6Rn;6hf1eg%>dyKty#BqNO5* E0Pv5rH2?qr diff --git a/sphinx/doctrees/software/sw_description.doctree b/sphinx/doctrees/software/sw_description.doctree index 02edb3eaf4e222e1dd96cef11b34b6ab8dc60cb0..98a9c9c93082dc0a49374c18468604f78133e841 100644 GIT binary patch literal 36280 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 literal 38683 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 diff --git a/sphinx/html/_images/Block_Diagram_Control.svg b/sphinx/html/_images/Block_Diagram_Control.svg new file mode 100644 index 0000000..11a030f --- /dev/null +++ b/sphinx/html/_images/Block_Diagram_Control.svg @@ -0,0 +1,4 @@ + + + +
Speed Helper
Motor Controller

PID MODE

or

STARTUP MODE
Motor Driver
ADC
Motor
Setpoint
Accel/Decel - Rate
Target Speedstep
Measurement
+

-
Error
Output
BEMF-Voltage
RPM
Voltage Divider
\ No newline at end of file diff --git a/sphinx/html/_images/Block_Diagram_PID.svg b/sphinx/html/_images/Block_Diagram_PID.svg new file mode 100644 index 0000000..c9364d6 --- /dev/null +++ b/sphinx/html/_images/Block_Diagram_PID.svg @@ -0,0 +1,4 @@ + + + +
KI
KI
I
I
KP
KP
Output
Output
P
P
        +
+
       +
+...
KD
KD
s
s
D
D
Error
Error
1/s
1/s
1/(sτ+1)
1/(sτ+1)
Text is not SVG - cannot display
\ No newline at end of file diff --git a/sphinx/html/_images/adaptive_kp.svg b/sphinx/html/_images/adaptive_kp.svg new file mode 100644 index 0000000..c3356ca --- /dev/null +++ b/sphinx/html/_images/adaptive_kp.svg @@ -0,0 +1,131 @@ + + + gl2ps_renderer figure + +Creator: GL2PS 1.4.2, (C) 1999-2020 C. Geuzaine +For: Octave +CreationDate: Thu Aug 4 01:55:04 2022 + + + + + + + + + + + + + + + + + + + + + + 0 + + + 500 + + + 1000 + + + 1500 + + + 2000 + + + + + + + + + + + + + 0 + + + 5 + + + 10 + + + 15 + + + 20 + + + + + + + sp + + + k + p + (sp) + + + + + + + + + + + + + + + + + + + + + + + + + + + k + p + + + + + + + x0 | y0 + + + + + + + x1 | y1 + + + + + + + x2 | y2 + + + + diff --git a/sphinx/html/_images/feed_forward.svg b/sphinx/html/_images/feed_forward.svg new file mode 100644 index 0000000..0b53f41 --- /dev/null +++ b/sphinx/html/_images/feed_forward.svg @@ -0,0 +1,159 @@ + + + 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/_sources/hardware/rev_0_3/hw_description.rst.txt b/sphinx/html/_sources/hardware/rev_0_3/hw_description.rst.txt index 24585a5..c76e382 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 @@ -1,8 +1,9 @@ Overview -==================== +============================== .. figure:: ../../../../svg/hw/rev_0_3/Block_Diagram_Hardware.svg :alt: Block Diagram + :align: center Harware block diagram @@ -22,7 +23,7 @@ The above block diagram gives a general overview regarding the operation of comp - Crystal oscillator Electrical Characteristics -==================== +============================== .. table:: Electrical Characteristics & Absolute Maximum Ratings :widths: auto @@ -46,10 +47,11 @@ Electrical Characteristics (2): According to: `T2N7002BK Datasheet `_ Input Stage -==================== +============================== .. figure:: ../../../../svg/hw/rev_0_3/Input_Stage.svg :alt: Input Stage + :align: center Input stage @@ -58,20 +60,22 @@ D1 Rectifies the DCC square-wave into +V, the amplitude is not critical as long The MOSFET on the right effectively translates the rather high DCC voltage to a suitable level for the microcontroller to process. When Q1 is turned off GPIO21 is pulled high by the RP2040 internal pull-up resistor, as soon as Q1 gets turned on (V\ :sub:`GS`\ > V\ :sub:`GS,th`\), GPIO21 gets pulled to GND potential. R1 and R2 ensure that V\ :sub:`GS`\ doesn't exceed ±20V. Motor Driver -==================== +============================== .. figure:: ../../../../svg/hw/rev_0_3/Motor_Driver.svg :alt: Motor Driver + :align: center Motor driver The Motor Driver is a special H-Bridge IC that is made for DC motors. To control the motor, it is necessary to measure the back-EMF voltage, which is directly related to the motor's speed. This is done by the ADC, which measures at Points ADC_EMF_A and ADC_EMF_B. The two resistors work together as a voltage divider. Auxiliary Outputs -==================== +============================== .. figure:: ../../../../svg/hw/rev_0_3/Aux_Outputs.svg :alt: Auxiliary Outputs + :align: center Auxiliary Outputs @@ -79,31 +83,33 @@ Switching of loads can be done using four N-Channel MOSFETs (Q2 to Q5). The amou GPIO -==================== +============================== To switch lighter loads, six GPIO soldering pads are connected to GPIO0 to GPIO5 pins. Although not yet set up in the software, they could be used as inputs as well (e.g. reed switch). GPIO0 and GPIO1 can also be used to facilitate stdio logging via UART, which can easily be set up in CMakeLists.txt. Microcontroller -==================== +============================== .. figure:: ../../../../svg/hw/rev_0_3/Microcontroller.svg :alt: Microcontroller + :align: center Microcontroller, flash memory, crystal oscillator, ... The Microcontroller needs a crystal oscillator for its clock. External flash memory holds the configuration variables and the program itself. R3 & C14 are used to filter ADC_AVDD (ADC Reference Voltage). Complete Schematic -==================== +============================== .. figure:: ../../../../svg/hw/rev_0_3/RP2040-Decoder.svg :alt: Complete Schematic + :align: center Complete Schematic BOM & Alternative Parts -==================== +============================== .. table:: BOM :widths: auto @@ -142,14 +148,16 @@ Alternative for HT7533S: .. _wiring_rev_0_3: + Wiring the Decoder -==================== +============================== .. figure:: ../../../../svg/hw/rev_0_3/Wiring_diagram.svg - :width: 700 - :alt: Wiring Diagram + :align: center + :width: 700 + :alt: Wiring Diagram - Wiring Diagram + Wiring Diagram The illustration above provides an example of a wiring configuration. It supports the connection of up to 4 transistor-switched outputs and 6 GPIOs for lighter loads or custom applications. 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 dc039ef..2bf67a9 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 @@ -1,7 +1,8 @@ Overview -==================== +============================== .. figure:: ../../../../svg/hw/rev_1_0/Block_Diagram_Hardware.svg + :align: center :alt: Block Diagram Harware block diagram @@ -23,7 +24,7 @@ The above block diagram gives a general overview regarding the operation of comp - USB Connector Electrical Characteristics -==================== +============================== .. table:: Electrical Characteristics & Absolute Maximum Ratings :widths: auto @@ -49,9 +50,10 @@ Electrical Characteristics (3): T\ :sub:`Case`\ = 25°C, keep power dissipation, thermal resistance the corresponding temperature rise ΔT and switching losses in PWM mode in mind! Input Stage -==================== +============================== .. figure:: ../../../../svg/hw/rev_1_0/Input_Stage.svg + :align: center :alt: Input Stage Input stage @@ -60,9 +62,10 @@ D2 Rectifies the DCC square-wave into VDC, the amplitude is not critical as long The MOSFET on the right effectively translates the rather high DCC voltage to a suitable level for the microcontroller to process. When Q1 is turned off GPIO21 is pulled high by the RP2040 internal pull-up resistor, as soon as Q1 gets turned on (V\ :sub:`GS`\ > V\ :sub:`GS,th`\), GPIO21 gets pulled to GND potential. R1 and R2 ensure that V\ :sub:`GS`\ doesn't exceed ±12V. Motor Driver -==================== +============================== .. figure:: ../../../../svg/hw/rev_1_0/Motor_Driver.svg + :align: center :alt: Motor Driver Motor driver @@ -70,9 +73,10 @@ Motor Driver The Motor Driver is a special H-Bridge IC that is made for DC motors. To control the motor, it is necessary to measure the back-EMF voltage, which is directly related to the motor's speed. This is done by the ADC, which measures at Points ADC_EMF_A and ADC_EMF_B. The two resistors work together as a voltage divider. Auxiliary Outputs -==================== +============================== .. figure:: ../../../../svg/hw/rev_1_0/Aux_Outputs.svg + :align: center :alt: Auxiliary Outputs Auxiliary Outputs @@ -80,14 +84,15 @@ Auxiliary Outputs Switching of loads can be done using four N-Channel MOSFETs (Q2 to Q5). The amount of current is somewhat dependend on either static R\ :sub:`DS(on)`\ losses and/or switching losses using PWM. They are switching on the low-side, which means the load effectively gets connected to GND potential as the transistor starts to conduct. GPIO24 - GPIO27 are used. GPIO -==================== +============================== To switch lighter loads, six GPIO soldering pads are connected to GPIO0 to GPIO5 pins. Although not yet set up in the software, they could be used as inputs as well (e.g. reed switch). GPIO0 and GPIO1 can also be used to facilitate stdio logging via UART, which can easily be set up in CMakeLists.txt. Microcontroller -==================== +============================== .. figure:: ../../../../svg/hw/rev_1_0/Microcontroller.svg + :align: center :alt: Microcontroller Microcontroller, flash memory, crystal oscillator, USB connector, ... @@ -95,15 +100,16 @@ Microcontroller The Microcontroller needs a crystal oscillator for its clock. External flash memory holds the configuration variables and the program itself. The USB connector can be used to flash the software onto the decoder and also for logging via stdio (can be enabled via CMakeLists.txt). D3 is used as a status LED. R11 & C13 are used to filter ADC_AVDD (ADC Reference Voltage). Complete Schematic -==================== +============================== .. figure:: ../../../../svg/hw/rev_1_0/RP2040-Decoder.svg + :align: center :alt: Complete Schematic Complete Schematic BOM & Alternative Parts -==================== +============================== .. table:: BOM :widths: auto @@ -142,12 +148,14 @@ Alternative for HT7533S: .. _wiring_rev_1_0: + Wiring the Decoder -==================== +============================== .. figure:: ../../../../svg/hw/rev_1_0/Wiring_diagram.svg :width: 700 :alt: Wiring Diagram + :align: center Wiring Diagram diff --git a/sphinx/html/_sources/index.rst.txt b/sphinx/html/_sources/index.rst.txt index 1c9a751..3447a3d 100644 --- a/sphinx/html/_sources/index.rst.txt +++ b/sphinx/html/_sources/index.rst.txt @@ -15,4 +15,3 @@ RP2040-Decoder Documentation software/index other/index other/troubleshooting - other/debugging \ No newline at end of file diff --git a/sphinx/html/_sources/other/getting_started.rst.txt b/sphinx/html/_sources/other/getting_started.rst.txt index 7175ebb..abcd068 100644 --- a/sphinx/html/_sources/other/getting_started.rst.txt +++ b/sphinx/html/_sources/other/getting_started.rst.txt @@ -1,20 +1,21 @@ Getting started -=============== +================================== 1. Where to get the board? --------------------------- +---------------------------------- You can choose any PCB manufacturer you like.The PCB is designed to fit with JLCPCB.com's capabilities and constraints.You can assemble the board yourself, but it's best not to do so if you're not familiar with soldering small components. Alternatively, you can order the board fully or partly assembled.Soldering the back of the PCB by hand is not too difficult. All parts are normally available at LCSC.com, who supply parts to JLCPCB.com. 2. Production files? ---------------------- +---------------------------------- In order to 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: + 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. @@ -22,8 +23,10 @@ However sometimes you might want to build by yourself, be it for debugging or to 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 ------------------------- +---------------------------------- For RP2040-Decoders with USB there is two ways of flashing the software: @@ -37,21 +40,21 @@ For RP2040-Decoders with USB there is two ways of flashing the software: For RP2040-Decoders without USB the only way of flashing the software is via SWD 4.1. Flashing the software via .uf2 file -^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 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. This procedure is also described in the `Raspberry Pi Pico Datasheet Chapter 4.1 `_ 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 `_ 5. Wiring ---------- +---------------------------------- | Please refer to the hardware section for your board: | :ref:`Wiring Rev 1.0 ` diff --git a/sphinx/html/_sources/software/header_files.rst.txt b/sphinx/html/_sources/software/header_files.rst.txt index a8cf886..64b3b57 100644 --- a/sphinx/html/_sources/software/header_files.rst.txt +++ b/sphinx/html/_sources/software/header_files.rst.txt @@ -2,27 +2,27 @@ Header files ================= core0.h -------- +-------------- .. doxygenfile:: core0.h :project: RP2040-Decoder core1.h -------- +-------------- .. doxygenfile:: core1.h :project: RP2040-Decoder shared.h -------- +-------------- .. doxygenfile:: shared.h :project: RP2040-Decoder CV.h -------- +-------------- .. doxygenfile:: CV.h :project: RP2040-Decoder diff --git a/sphinx/html/_sources/software/sw_description.md.txt b/sphinx/html/_sources/software/sw_description.md.txt deleted file mode 100644 index 6e243ea..0000000 --- a/sphinx/html/_sources/software/sw_description.md.txt +++ /dev/null @@ -1,82 +0,0 @@ -# Software Description - -## Overview - -The Software is structured as follows: -* Core0.c - - DCC package detection & decoding - - Programming mode (Modify and read CVs on programming track) - - ADC-Offset measurement - - Feed-forward base PWM measurement - -* Core1.c - - PID motor controller -* CV.h - - Default configuration variables - -Conveniently The Raspberry Pi Foundation provides a well documented [SDK](https://datasheets.raspberrypi.com/pico/raspberry-pi-pico-c-sdk.pdf) for the RP2040. The SDK provides abstraction to a higher level and therefore there is no need to access any registers directly. Everything is written using the SDK so hopefully the code is easier to understand. In the following, the motor control and the decoding of the DCC signals will be explained. - -## Motor control overview - -![Block Diagram](https://github.com/1nct/RP2040-Decoder/blob/main/docs/svg/Block_Diagram_Control.svg) -*** -**Block diagram - Motor control** - -The above block diagram in essence describes the functionality of the control loop. While the central component is the PID controller, there is an additional block called [Feed-forward](https://en.wikipedia.org/wiki/Feed_forward_(control)) 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 is corresponding to the speed_helper() function which delays changing the setpoint according to the configured deceleration/acceleration rates. - - -## PID Controller - -![PID Controller](https://github.com/gab-k/RP2040-Decoder/blob/main/docs/svg/Block_Diagram_PID.svg) - -The block diagram above shows the PID controller in the s-domain. The derivative part contains an additional digital low pass filter used to filter out high-frequency noise. - -Output = E * (KP + KI/s + (KD*s)/(sτ+1)) = P + I + D - -* P = E * KP -* I = E * KI/s -* D = E * (KD*s)/(sτ+1) - -The continuous-time system representation can now be transformed into a discrete-time representation using [bilinear transform](https://en.wikipedia.org/wiki/Bilinear_transform) [ s = 2*(z-1) / Ts*(z+1) ]. - -This results in the following difference equations which are then implemented in software: - -* pn = KP * en -* in = 0.5KI * (en + en-1) + in-1 -* dn = [ 2KD * (en - en-1) + (2τ - Ts) * dn-1 ] / [ 2τ + Ts] - -=> outputn = pn + in + dn - -Also note that instead of using derivative of error, derivative on measurement is used. This is done to prevent a high derivative part in the event of a large change in setpoint. - -### Gain scheduling - -![K_P](https://github.com/gab-k/RP2040-Decoder/blob/main/docs/svg/adaptive_kp.svg) - -Another aspect to consider is the implementation of [gain scheduling](https://en.wikipedia.org/wiki/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](https://github.com/gab-k/RP2040-Decoder/blob/main/docs/svg/feed_forward.svg) -To achieve better control [Feed-forward](https://en.wikipedia.org/wiki/Feed_forward_(control)) 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. - -### Back-EMF voltage measurement - -To provide a feedback signal which is proportional to the motor speed the ADC is used to measure the [Back-EMF voltage](https://en.wikipedia.org/wiki/Counter-electromotive_force). The measurement works by setting the PWM duty cycle to 0%, waiting for a certain delay time (CV_62) and then measuring x times (x = CV_63). While measuring the array with measurement values are being sorted using insertion sort. Afterwards y elements (y = CV_63) from the left (lowest values) and z elements (z = CV_64) from the right (highest values) will be dismissed to mitigate the impact of potential outliers in measurement. The average value of the remaining values will be computed and fed back into the control algorithm. Considering default settings (100us delay, 100 samples, ~2µs sampling time) the complete measurement run including averaging takes about 0.3ms to 0.35ms which effectively reduces the maximum possible duty cycle to about 93% to 94%. - -## DCC signal decoding - -The detection of the DCC signal works by looking at every rising and falling edge and calculating the time between them. When the time between rising and falling edge is greater than 87μs then this is equivalent to "0", else "1" - This value then gets shifted into a 64-Bit variable. - -Decoding is done after every falling edge. It starts with an error detection which when not passed will dismiss the received command. Then the address will be decoded and compared to the address stored in the configuration. If the address matches the command/instruction will be decoded. - -Only a few instructions are currently implemented, only 128 speed step instructions are supported. - -**Implemented instructions:** -* 0011-1111 - (128 Speed Step Control) - 2 Byte length -* 10XX-XXXX - (Function Group Instruction) (F0 - F12) -* 110X-XXXX - Expansion Instruction (F13 - F31) - -All DCC instructions can be found in Section 9.2, 9.2.1 and 9.2.1.1 of the [NMRA Communications Standard ](https://www.nmra.org/index-nmra-standards-and-recommended-practices) - - diff --git a/sphinx/html/_sources/software/sw_description.rst.txt b/sphinx/html/_sources/software/sw_description.rst.txt new file mode 100644 index 0000000..ea8e113 --- /dev/null +++ b/sphinx/html/_sources/software/sw_description.rst.txt @@ -0,0 +1,151 @@ +Software Description +============================== + +Overview +------------------------------ + +Software files high level overview: + +- **core0.c / core0.h** + + - DCC package detection & decoding + - Programming mode (Modify and read CVs on programming track) + - ADC-Offset measurement + +- **core1.c / core0.h** + + - PID motor controller + - Back-EMF voltage measurement + +- **shared.c / shared.h** (used by both cores) + +- Error handling +- Helper functions for retrieving CV's + +- **CV.h** + +- Default configuration variables + +- **CMakeLists.txt** + + - CMake version, SDK version, C standard version + - Board definitions + - Compile/Build options + - Sources files, header files + - Debug logging configuration (via stdio using UART/USB) + - Linked libraries + +- **RP2040-Decoder-board.h or RP2040-Decoder-board-legacy.h** + + - Flash Size + - Pin specification + + - LED pin when available + - UART_TX/UART_RX when used + - DCC input pin + - Motor Control PWM pins + - ADC pins + + + + +Conveniently, The Raspberry Pi Foundation provides a well-documented `SDK `_ for the RP2040. The SDK provides abstraction to a higher level, and therefore there is no need to access any registers directly. Everything is written using the SDK, so hopefully, the code is easier to understand. + +Motor control +------------------------------ + +.. figure:: ../../../svg/sw/Block_Diagram_Control.svg + :alt: Block Diagram + :align: center + + Motor control - Block diagram + +The above block diagram in essence describes the functionality of the control loop. 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. + +PID Controller +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. figure:: ../../../svg/sw/Block_Diagram_PID.svg + :alt: PID Controller figure + :align: center + + PID Controller + +The block diagram above shows the PID controller in the s-domain. The derivative part contains an additional digital low-pass filter used to filter out high-frequency noise. + +.. math:: + + \begin{align} + \text{Output} &= E \cdot \left(K_P + \frac{K_I}{s} + \frac{K_D \cdot s}{s \tau + 1}\right) = P + I + D \\ + P &= E \cdot K_P \\ + I &= E \cdot \frac{K_I}{s} \\ + D &= E \cdot \frac{K_D \cdot s}{s \tau + 1} + \end{align} + +With :math:`T_s` being the sampling time / controller update rate / time step of the discrete system. +And :math:`\tau` being the filter time constant of the digital filter + +The continuous-time system representation can now be transformed into a discrete-time representation using `bilinear transform `_ :math:`s = \frac{2 \cdot (z - 1)}{T_s \cdot (z + 1)}`. + +This results in the following difference equations which are then implemented in software: + +.. math:: + + \begin{align} + p_n &= K_P \cdot e_n \\ + i_n &= 0.5 \cdot K_I \cdot \left(e_n + e_{n-1}\right) + i_{n-1} \\ + d_n &= \frac{2 K_D \cdot \left(e_n - e_{n-1}\right) + \left(2 \tau - T_s\right) \cdot d_{n-1}}{2 \tau + T_s} \\ + \text{output}_n &= p_n + i_n + d_n + \end{align} + + +Also note that instead of using the derivative of error, the derivative on measurement is used. This is done to prevent a high derivative part in the event of a large change in setpoint. + + +Gain Scheduling +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. figure:: ../../../svg/sw/adaptive_kp.svg + :alt: Gain Scheduling figure + :align: center + + Gain Scheduling + +Another aspect to consider is the implementation of `gain scheduling `_. K\ :sub:`P` is a function of the current setpoint. Often it is favorable to have a higher proportional gain K\ :sub:`P` for slow speeds, achieving better control results. The illustration above shows the default setting for K\ :sub:`P`. CV_54 & CV_55 are used to set K\ :sub:`P` @ x\ :sub:`0`, CV_56 & CV_57 for K\ :sub:`P` @ x\ :sub:`1`, and CV_58 & CV_59 for K\ :sub:`P` @ x\ :sub:`2`. Additionally, CV_60 is used to shift x\ :sub:`1` from the leftmost point (0% = 0/255) to the rightmost point (100% = 255/255). + +Feed-forward +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +.. 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 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +To provide a feedback signal proportional to the motor speed, the ADC is used to measure the `Back-EMF voltage `_. The measurement works by setting the PWM duty cycle to 0%, waiting for a certain delay time (CV_62), and then measuring x times (x = CV_63). While measuring, the array with measurement values is sorted using insertion sort. Afterwards, y elements (y = CV_63) from the left (lowest values) and z elements (z = CV_64) from the right (highest values) will be dismissed to mitigate the impact of potential outliers in measurement. The average value of the remaining values will be computed and fed back into the control algorithm. Considering default settings (100us delay, 100 samples, ~2µs sampling time), the complete measurement run, including averaging, takes about 0.3ms to 0.35ms, which effectively reduces the maximum possible duty cycle to about 93% to 94%. + +DCC signal decoding +------------------------------ + +The detection of the DCC signal works by looking at every rising and falling edge and calculating the time between them. When the time between rising and falling edge is greater than 87μs, then this is equivalent to "0"; otherwise, "1". This value then gets shifted into a 64-Bit variable. + +Decoding is done after every falling edge. It starts with an error detection, which, when not passed, dismisses the received command. Then the address will be decoded and compared to the address stored in the configuration. If the address matches, the command/instruction will be decoded. + +Only a few instructions are currently implemented; only 128 speed step instructions are supported. + +**Implemented instructions:** + +- ``0011-1111`` - (128 Speed Step Control) - 2 Byte length +- ``10XX-XXXX`` - (Function Group Instruction) (F0 - F12) +- ``110X-XXXX`` - Expansion Instruction (F13 - F31) + +All DCC instructions can be found in Section 9.2, 9.2.1, and 9.2.1.1 of the `NMRA Communications Standard `_. diff --git a/sphinx/html/hardware/rev_0_3/hw_description.html b/sphinx/html/hardware/rev_0_3/hw_description.html index b5c6bda..2c73350 100644 --- a/sphinx/html/hardware/rev_0_3/hw_description.html +++ b/sphinx/html/hardware/rev_0_3/hw_description.html @@ -102,7 +102,7 @@

Overview

-
+
Block Diagram

Harware block diagram

@@ -207,7 +207,7 @@

Input Stage

-
+
Input Stage

Input stage

@@ -218,7 +218,7 @@

Motor Driver

-
+
Motor Driver

Motor driver

@@ -228,7 +228,7 @@

Auxiliary Outputs

-
+
Auxiliary Outputs

Auxiliary Outputs

@@ -242,7 +242,7 @@

Microcontroller

-
+
Microcontroller

Microcontroller, flash memory, crystal oscillator, …

@@ -252,7 +252,7 @@

Complete Schematic

-
+
Complete Schematic

Complete Schematic

@@ -383,7 +383,7 @@

Wiring the Decoder

-
+
Wiring Diagram
diff --git a/sphinx/html/hardware/rev_1_0/hw_description.html b/sphinx/html/hardware/rev_1_0/hw_description.html index 27f634f..c0e1043 100644 --- a/sphinx/html/hardware/rev_1_0/hw_description.html +++ b/sphinx/html/hardware/rev_1_0/hw_description.html @@ -101,7 +101,7 @@

Overview

-
+
Block Diagram

Harware block diagram

@@ -208,7 +208,7 @@

Input Stage

-
+
Input Stage

Input stage

@@ -217,8 +217,8 @@

D2 Rectifies the DCC square-wave into VDC, the amplitude is not critical as long as it’s within the 25V limit. The rectified voltage VDC is then provided to the 3.3V voltage regulator and to the motor driver. The shottky diode D1 and the bridge rectifier D2 ensure a logical “or” linkage of the VBUS supply voltages and the DCC input voltage

The MOSFET on the right effectively translates the rather high DCC voltage to a suitable level for the microcontroller to process. When Q1 is turned off GPIO21 is pulled high by the RP2040 internal pull-up resistor, as soon as Q1 gets turned on (VGS> VGS,th), GPIO21 gets pulled to GND potential. R1 and R2 ensure that VGSdoesn’t exceed ±12V. Motor Driver -====================

-
+==============================

+
Motor Driver

Motor driver

@@ -228,7 +228,7 @@ Motor Driver

Auxiliary Outputs

-
+
Auxiliary Outputs

Auxiliary Outputs

@@ -242,7 +242,7 @@ Motor Driver

Microcontroller

-
+
Microcontroller

Microcontroller, flash memory, crystal oscillator, USB connector, …

@@ -252,7 +252,7 @@ Motor Driver

Complete Schematic

-
+
Complete Schematic

Complete Schematic

@@ -383,7 +383,7 @@ Motor Driver

Wiring the Decoder

-
+
Wiring Diagram
diff --git a/sphinx/html/index.html b/sphinx/html/index.html index 7b14592..bc7362e 100644 --- a/sphinx/html/index.html +++ b/sphinx/html/index.html @@ -18,6 +18,7 @@ + diff --git a/sphinx/html/other/getting_started.html b/sphinx/html/other/getting_started.html index ca3783a..f0785bf 100644 --- a/sphinx/html/other/getting_started.html +++ b/sphinx/html/other/getting_started.html @@ -108,6 +108,7 @@ In case you are ordering from JLCPCB it is recommended to use the 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

diff --git a/sphinx/html/searchindex.js b/sphinx/html/searchindex.js index f4684ad..a9d758f 100644 --- a/sphinx/html/searchindex.js +++ b/sphinx/html/searchindex.js @@ -1 +1 @@ -Search.setIndex({"alltitles": {"1. Where to get the board?": [[5, "where-to-get-the-board"]], "2. Production files?": [[5, "production-files"]], "3. Building the software": [[5, "building-the-software"]], "4. Flashing the software": [[5, "flashing-the-software"]], "4.1. Flashing the software via .uf2 file": [[5, "flashing-the-software-via-uf2-file"]], "4.2. Flashing the software via SWD": [[5, "flashing-the-software-via-swd"]], "5. Wiring": [[5, "wiring"]], "6. Resolving issues": [[5, "resolving-issues"]], "Alternative for HT7533S:": [[1, "alternative-for-ht7533s"], [2, "alternative-for-ht7533s"]], "Alternatives for BDR6133:": [[1, "alternatives-for-bdr6133"], [2, "alternatives-for-bdr6133"]], "Auxiliary Outputs": [[1, "auxiliary-outputs"], [2, "auxiliary-outputs"]], "BOM": [[1, "id8"], [2, "id8"]], "BOM & Alternative Parts": [[1, "bom-alternative-parts"], [2, "bom-alternative-parts"]], "Back-EMF voltage measurement": [[10, "back-emf-voltage-measurement"]], "CV List": [[4, "cv-list"]], "CV.h": [[8, "cv-h"]], "CV_1 - Basic address": [[4, "cv-1-basic-address"]], "CV_11 - Packet timeout": [[4, "cv-11-packet-timeout"]], "CV_112, CV_113, CV_114, CV_115 - GPIO PWM Configuration": [[4, "cv-112-cv-113-cv-114-cv-115-gpio-pwm-configuration"]], "CV_116 to CV_171 - PWM Slice configuration": [[4, "cv-116-to-cv-171-pwm-slice-configuration"]], "CV_12 - Permitted operating modes": [[4, "cv-12-permitted-operating-modes"]], "CV_17 & CV_18 - 14-Bit extended/long address": [[4, "cv-17-cv-18-14-bit-extended-long-address"]], "CV_172 - ADC Offset": [[4, "cv-172-adc-offset"]], "CV_173 - ADC offset measurement cycles": [[4, "cv-173-adc-offset-measurement-cycles"]], "CV_174 - Additional motor-PWM clock divider.": [[4, "cv-174-additional-motor-pwm-clock-divider"]], "CV_175 - speed_helper timer delay": [[4, "cv-175-speed-helper-timer-delay"]], "CV_176, CV_177, CV_178, CV_179 - Base PWM Level used in feed-forward control": [[4, "cv-176-cv-177-cv-178-cv-179-base-pwm-level-used-in-feed-forward-control"]], "CV_2 - V_min": [[4, "cv-2-v-min"]], "CV_257 to CV_512 - Function Mapping CVs": [[4, "cv-257-to-cv-512-function-mapping-cvs"]], "CV_29 - Decoder Configuration": [[4, "cv-29-decoder-configuration"]], "CV_3 - Acceleration rate": [[4, "cv-3-acceleration-rate"]], "CV_31 & CV_32 - Extended CV pointer (Read-Only)": [[4, "cv-31-cv-32-extended-cv-pointer-read-only"]], "CV_4 - Deceleration rate": [[4, "cv-4-deceleration-rate"]], "CV_47 - Feed-forward gain k_ff": [[4, "cv-47-feed-forward-gain-k-ff"]], "CV_48 - Filter time constant (tau) in ms": [[4, "cv-48-filter-time-constant-tau-in-ms"]], "CV_49 - PID Control sampling time t in ms": [[4, "cv-49-pid-control-sampling-time-t-in-ms"]], "CV_5 - V_max": [[4, "cv-5-v-max"]], "CV_50 - PID Control I Factor": [[4, "cv-50-pid-control-i-factor"]], "CV_51 - PID Control D Factor": [[4, "cv-51-pid-control-d-factor"]], "CV_52 & CV_53 - PID Integral Limits": [[4, "cv-52-cv-53-pid-integral-limits"]], "CV_54 & CV_55 - Gain scheduling config k_p @ x0": [[4, "cv-54-cv-55-gain-scheduling-config-k-p-x0"]], "CV_56 & CV_57 - Gain scheduling config k_p @ x1": [[4, "cv-56-cv-57-gain-scheduling-config-k-p-x1"]], "CV_58 & CV_59 - Gain scheduling config k_p @ x2": [[4, "cv-58-cv-59-gain-scheduling-config-k-p-x2"]], "CV_6 - V_mid": [[4, "cv-6-v-mid"]], "CV_60 - Gain scheduling config x1 shift percentage": [[4, "cv-60-gain-scheduling-config-x1-shift-percentage"]], "CV_61 - Measurement Iterations": [[4, "cv-61-measurement-iterations"]], "CV_62 - Measurement Delay": [[4, "cv-62-measurement-delay"]], "CV_63 & CV_64 - Measurement array cutoffs": [[4, "cv-63-cv-64-measurement-array-cutoffs"]], "CV_65 - New flash variable": [[4, "cv-65-new-flash-variable"]], "CV_7 - Version No. (Read-Only)": [[4, "cv-7-version-no-read-only"]], "CV_8 - Manufacturer (Read-Only)": [[4, "cv-8-manufacturer-read-only"]], "CV_9 - Motor PWM Frequency": [[4, "cv-9-motor-pwm-frequency"]], "Complete Schematic": [[1, "complete-schematic"], [2, "complete-schematic"]], "Configuration Variables (CV)": [[4, null]], "Contents:": [[3, null], [6, null], [9, null]], "DCC signal decoding": [[10, "dcc-signal-decoding"]], "Electrical Characteristics": [[1, "electrical-characteristics"], [2, "electrical-characteristics"]], "Electrical Characteristics & Absolute Maximum Ratings": [[1, "id2"], [2, "id2"]], "Feed-forward": [[10, "feed-forward"]], "GPIO": [[1, "gpio"], [2, "gpio"]], "Gain scheduling": [[10, "gain-scheduling"]], "Getting started": [[5, null]], "Hardware": [[0, null]], "Header files": [[8, null]], "Input Stage": [[1, "input-stage"], [2, "input-stage"]], "Microcontroller": [[1, "microcontroller"], [2, "microcontroller"]], "Motor Driver": [[1, "motor-driver"]], "Motor control overview": [[10, "motor-control-overview"]], "Note": [[4, "note"]], "Other": [[6, null]], "Overview": [[1, null], [2, null], [10, "overview"]], "PID Controller": [[10, "pid-controller"]], "RP2040-Decoder Documentation": [[3, null]], "Revision 0.3": [[0, "revision-0-3"]], "Revision 1.0": [[0, "revision-1-0"]], "Software": [[9, null]], "Software Description": [[10, null]], "Speed step configuration": [[4, "speed-step-configuration"]], "Troubleshooting": [[7, null]], "Wiring the Decoder": [[1, "wiring-the-decoder"], [2, "wiring-the-decoder"]], "core0.h": [[8, "core0-h"]], "core1.h": [[8, "core1-h"]], "shared.h": [[8, "shared-h"]]}, "docnames": ["hardware/index", "hardware/rev_0_3/hw_description", "hardware/rev_1_0/hw_description", "index", "other/CV_list", "other/getting_started", "other/index", "other/troubleshooting", "software/header_files", "software/index", "software/sw_description"], "envversion": {"sphinx": 64, "sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2}, "filenames": ["hardware/index.rst", "hardware/rev_0_3/hw_description.rst", "hardware/rev_1_0/hw_description.rst", "index.rst", "other/CV_list.md", "other/getting_started.rst", "other/index.rst", "other/troubleshooting.md", "software/header_files.rst", "software/index.rst", "software/sw_description.md"], "indexentries": {}, "objects": {}, "objnames": {}, "objtypes": {}, "terms": {"": [1, 2, 5, 10], "0": [1, 2, 3, 4, 5, 7, 10], "0011": 10, "0603_1608metric": [1, 2], "0xff": 4, "1": [1, 2, 3, 4, 10], "10": [1, 2, 4], "100": [4, 10], "10000": 4, "1001": 4, "100111000100": 4, "100n": [1, 2], "100u": 10, "10khz": 4, "10u": [1, 2], "10v": 7, "10xx": 10, "110000": 4, "11000011010011": 4, "11000100": 4, "11010011": 4, "110x": 10, "1111": 10, "1249": 4, "12499": 4, "125": 4, "12500": 4, "126": 4, "128": 10, "12mhz": [1, 2], "12v": 2, "13": 4, "145": [1, 2], "155": [1, 2], "16": 4, "16bit": 4, "16v": 7, "192": 4, "1ep_7x7mm_p0": [1, 2], "1k": [1, 2], "2": [1, 2, 3, 4, 10], "20": 4, "200": [1, 2], "20v": [1, 7], "23": [1, 2], "231": 4, "24": [1, 2], "25": 2, "250": 4, "2500": 4, "255": [4, 10], "25v": [1, 2], "269aa": [1, 2], "2a": [1, 2], "2k": 10, "2x2": [1, 2], "2\u00b5": 10, "2\u03c4": 10, "3": [1, 2, 3, 4, 7], "32": 4, "33p": [1, 2], "33tr3": [1, 2], "35m": 10, "3m": 10, "3v": [1, 2, 7], "3v3": 7, "4": [1, 2, 3, 4], "400": 1, "40v": [1, 2], "4a": [1, 2], "4mm": [1, 2], "4pin_3": [1, 2], "5": [1, 2, 3, 4], "50": [1, 2], "56": [1, 2], "5i": 10, "5k": 10, "5mm": [1, 2], "6": [1, 2, 3, 4], "60v": [1, 2], "64": [4, 10], "64mb": [1, 2], "6k8": [1, 2], "7": 4, "8": [1, 2, 4, 7], "87\u03bc": 10, "8a": [1, 2], "9": 10, "93": 10, "94": 10, "A": [1, 2, 4, 5, 10], "As": 5, "For": [1, 2, 4, 5], "If": [4, 5, 7, 10], "In": [5, 10], "It": [1, 2, 4, 10], "Not": 4, "On": 10, "TO": [1, 2], "That": 4, "The": [1, 2, 4, 5, 10], "Then": 10, "These": 4, "To": [1, 2, 4, 5, 7, 10], "about": 10, "abov": [1, 2, 4, 10], "abstract": 10, "acceler": 10, "access": 10, "accord": [1, 2, 10], "achiev": [4, 10], "adc": [1, 2, 10], "adc_avdd": [1, 2], "adc_emf_a": [1, 2], "adc_emf_b": [1, 2], "add": 10, "addit": 10, "addition": 10, "address": 10, "adjust": 4, "advantag": 5, "advis": 4, "after": 10, "afterward": 10, "algorithm": 10, "all": [4, 5, 10], "alreadi": 5, "also": [1, 2, 4, 5, 10], "altern": [0, 4, 5], "although": [1, 2], "alwai": [1, 2, 4], "am": 4, "amount": [1, 2, 4], "amplitud": [1, 2], "an": [1, 2, 4, 10], "analog": 7, "ani": [4, 5, 10], "anoth": [4, 5, 10], "appendix": 5, "applic": [1, 2], "ar": [1, 2, 4, 5, 10], "around": 7, "arrai": 10, "aspect": 10, "assembl": 5, "assum": [1, 2], "automat": [4, 10], "aux": [1, 2], "aux1": 4, "aux2": 4, "auxiliari": 0, "avail": [4, 5], "averag": 10, "b": 4, "back": [1, 2, 5], "base": [5, 10], "becaus": 7, "been": [1, 2], "begin": 4, "behavior": 4, "being": 10, "below": [1, 2, 10], "bemf": 4, "bennymeg": 5, "best": 5, "better": [1, 2, 10], "between": [4, 10], "bewar": 7, "bilinear": 10, "bin": 4, "bit": 10, "bit0": 4, "bit14": 4, "bit15": 4, "bit5": 4, "bit6": 4, "bit7": 4, "block": [1, 2, 10], "blue": 4, "board": [3, 4], "bom": [0, 5], "book": 5, "boot": 5, "both": [4, 10], "bridg": [1, 2, 5], "build": 3, "byte": [4, 10], "c": [2, 4, 10], "c1": [1, 2], "c10": [1, 2], "c11": [1, 2], "c12": [1, 2], "c13": [1, 2], "c14": [1, 2], "c15": [1, 2], "c16": [1, 2], "c17": [1, 2], "c2": [1, 2], "c3": [1, 2], "c4": [1, 2], "c5": [1, 2], "c6": [1, 2], "c7": [1, 2], "c8": [1, 2], "c9": [1, 2], "calcul": [4, 10], "calibr": [4, 10], "call": [4, 5, 10], "can": [1, 2, 4, 5, 7, 10], "cannot": 8, "capabl": 5, "capacitor": [1, 2], "case": [2, 5], "central": 10, "ceram": [1, 2], "certain": 10, "chang": [4, 10], "channel": [1, 2, 4], "chapter": [4, 5], "character": 4, "characterist": 0, "check": [4, 7, 10], "chip": 4, "choos": 5, "circuit": [1, 2], "clk_div": 4, "clock": [1, 2], "cmakelist": [1, 2], "code": [5, 10], "com": 5, "come": 5, "command": 10, "commun": 10, "compar": 10, "complet": [0, 7, 10], "complic": 5, "compon": [1, 2, 4, 5, 10], "comput": [4, 10], "condit": 4, "conduct": [1, 2], "configur": [1, 2, 3, 6, 10], "connect": [1, 2, 4, 5], "connector": 2, "consid": 10, "constraint": 5, "contain": [4, 10], "continu": 10, "control": [1, 2, 9], "conveni": 10, "copi": 5, "core0": [4, 9, 10], "core1": [9, 10], "correct": [4, 7, 10], "correspond": [2, 4, 10], "could": [1, 2, 5], "creat": 5, "critic": [1, 2], "crystal": [1, 2], "crystal_smd_3225": [1, 2], "current": [1, 2, 4, 10], "custom": [1, 2], "cv": [3, 6, 7, 9, 10], "cv8": [4, 7], "cv_144": 4, "cv_145": 4, "cv_146": 4, "cv_149": 4, "cv_150": 4, "cv_176": 10, "cv_179": 10, "cv_47": 10, "cv_54": 10, "cv_55": 10, "cv_56": 10, "cv_57": 10, "cv_58": 10, "cv_59": 10, "cv_60": 10, "cv_62": 10, "cv_63": 10, "cv_64": 10, "cv_setup_check": 4, "cycl": [5, 10], "d": [1, 2, 10], "d1": [1, 2], "d2": 2, "d3": 2, "datasheet": [1, 2, 4, 5], "dc": [1, 2], "dcc": [1, 2, 4, 9], "dd": [1, 2], "debug": 5, "debugprob": 5, "dec": 4, "deceler": 10, "decod": [0, 5, 7, 9], "default": [4, 10], "defin": 4, "delai": 10, "depend": [4, 10], "dependend": [1, 2], "deriv": [4, 10], "describ": [5, 10], "descript": [3, 9], "design": 5, "desold": 7, "detail": [4, 5, 10], "detect": 10, "determin": 4, "devic": 5, "diagram": [1, 2, 10], "differ": [1, 2, 10], "difficult": 5, "digit": [4, 10], "diod": [1, 2], "direct": [4, 10], "directli": [1, 2, 10], "disabl": 4, "discard": 4, "discret": [4, 10], "discuss": 5, "disk": 5, "dismiss": 10, "dissip": 2, "divid": [1, 2], "do": [4, 5, 7], "document": [5, 10], "doe": 5, "doesn": [1, 2, 7], "domain": [4, 10], "done": [1, 2, 4, 10], "dont": 7, "down": 7, "downstream": 4, "doxygenfil": 8, "drag": 5, "driver": [0, 2], "dropout": [1, 2], "duti": [4, 10], "e": [1, 2, 4, 10], "each": 4, "easier": 10, "easiest": 5, "easili": [1, 2], "edg": 10, "effect": [1, 2, 4, 10], "either": [1, 2, 4], "electr": 0, "element": [4, 10], "els": 10, "emerg": 4, "emf": [1, 2], "enabl": [2, 4], "ensur": [1, 2], "equat": 10, "equival": [4, 10], "error": 10, "essenc": 10, "establish": 10, "event": 10, "everi": [4, 10], "everyth": 10, "exampl": [1, 2, 4], "exce": [1, 2], "expans": 10, "expect": [5, 7], "explain": [1, 2, 5, 10], "explan": [4, 10], "explor": 5, "export": 5, "extens": 5, "extern": [1, 2], "f": [1, 2, 4], "f0": 10, "f12": 10, "f13": 10, "f31": 10, "fabric": 5, "facilit": [1, 2], "factori": 4, "fall": 10, "familiar": 5, "faster": 4, "favor": 10, "fed": 10, "feedback": 10, "few": 10, "file": [3, 9], "filter": [1, 2, 10], "find": 8, "first": 5, "fit": 5, "flase": 5, "flash": [1, 2, 3], "follow": [4, 5, 7, 10], "footprint": [1, 2], "forth": 4, "found": [4, 10], "foundat": 10, "four": [1, 2, 4], "free": [1, 2], "frequenc": 10, "from": [4, 5, 10], "fulli": 5, "function": [1, 2, 10], "furthermor": [1, 2], "g": [1, 2], "gener": [1, 2], "gerber": 5, "get": [1, 2, 3, 4, 10], "give": [1, 2], "gnd": [1, 2, 7], "got": 5, "gpio": 0, "gpio0": [1, 2], "gpio1": [1, 2], "gpio21": [1, 2], "gpio24": [1, 2], "gpio25": 4, "gpio27": [1, 2], "gpio5": [1, 2], "great": 5, "greater": 10, "green": 4, "group": 10, "gs7533": [1, 2], "h": [1, 2, 4, 9, 10], "ha": [1, 2, 4, 10], "hand": 5, "happen": 4, "hardwar": [3, 5], "harwar": [1, 2], "have": [4, 5, 10], "header": [3, 9], "headlight": 4, "helper": 10, "here": 4, "high": [1, 2, 4, 10], "higher": 10, "highest": [4, 10], "hold": [1, 2], "hopefulli": 10, "how": [4, 5, 10], "howev": 5, "hz": 4, "i": [1, 2, 5, 7, 10], "ic": [1, 2], "ignor": 5, "ih": [1, 2], "il": [1, 2], "illustr": [1, 2, 4, 10], "impact": 10, "implement": 10, "includ": [1, 2, 10], "inclus": 4, "independ": 4, "index": 4, "indic": 4, "induct": [1, 2], "init": 4, "input": 0, "insert": 10, "instead": 10, "instruct": [4, 5, 10], "interfac": 5, "intern": [1, 2], "iovdd": [1, 2], "irrelev": 4, "issu": [3, 7], "its": [1, 2], "itself": [1, 2, 5], "jlcpcb": 5, "job": 5, "jp1": 5, "just": 5, "k": 10, "keep": [1, 2], "kicad": 5, "kmb24f": [1, 2], "larg": 10, "lcsc": 5, "lead": 4, "led": 2, "left": [4, 10], "leftmost": 10, "length": 10, "level": [1, 2, 10], "lighter": [1, 2], "like": [5, 7], "limit": [1, 2], "linkag": 2, "list": 6, "littl": 5, "load": [1, 2, 10], "log": [1, 2], "logic": 2, "long": [1, 2], "look": 10, "loop": 10, "loss": [1, 2], "low": [1, 2, 4, 10], "lowest": 10, "ma": [1, 2], "made": [1, 2], "make": 5, "mani": 4, "manufactur": 5, "mass": 5, "match": 10, "max": [1, 2, 4, 10], "maximum": [4, 10], "mb": [1, 2], "mean": [1, 2, 4], "measur": [1, 2, 7], "memori": [1, 2, 7], "mention": 4, "mhz": 4, "microcontrol": 0, "mid": 4, "might": 5, "min": [4, 10], "mind": [1, 2], "minimum": [1, 2, 4], "mitig": 10, "mode": [2, 5, 10], "modif": 5, "modifi": 10, "more": [4, 5, 10], "mosfet": [1, 2], "most": 5, "motor": [0, 2, 7, 9], "n": [1, 2, 10], "name": [1, 2], "narrow": 7, "necessari": [1, 2], "need": [1, 2, 5, 10], "new": 5, "nmra": 10, "nois": 10, "normal": [4, 5], "note": [1, 2, 6, 10], "now": 10, "off": [1, 2], "offici": 5, "offset": 10, "often": 10, "one": 4, "onli": [5, 10], "onto": [2, 5], "open": 5, "oper": [1, 2], "option": 4, "order": 5, "oscil": [1, 2, 4], "other": [3, 4, 5], "otherwis": 4, "out": [1, 2, 10], "outlier": 10, "output": [0, 4, 10], "overview": [0, 9], "own": 5, "p": 10, "packag": [4, 10], "pad": [1, 2], "paramet": [1, 2, 4], "part": [0, 4, 5, 10], "partli": 5, "pass": [4, 10], "pcb": 5, "percent": 4, "period": 4, "pi": [5, 10], "pick": 5, "pico": 5, "pid": 9, "pid_control": 4, "pin": [1, 2, 7], "place": 5, "pleas": 5, "plug": 5, "plugin": 5, "point": [1, 2, 10], "posit": 4, "possibl": 10, "potenti": [1, 2, 10], "power": [2, 5, 7], "precompil": 5, "prefer": 5, "prevent": 10, "procedur": [4, 5], "process": [1, 2, 5], "product": 3, "program": [1, 2, 10], "proport": 10, "protect": [1, 2], "provid": [1, 2, 10], "pt2476": [1, 2], "pt5126a": [1, 2], "public": 4, "pull": [1, 2], "purpos": [1, 2], "pwm": [1, 2, 10], "q1": [1, 2], "q2": [1, 2], "q3": [1, 2], "q4": [1, 2], "q5": [1, 2], "qfn": [1, 2], "quantiti": [1, 2], "question": 5, "r": [1, 2], "r1": [1, 2], "r11": 2, "r2": [1, 2], "r3": [1, 2], "r5": [1, 2], "r6": [1, 2], "r7": [1, 2], "r8": [1, 2], "r9": [1, 2], "rang": [4, 7], "raspberri": [5, 10], "rate": 10, "rather": [1, 2], "re": 5, "reach": 10, "read": 10, "receiv": [4, 10], "recommend": 5, "rectifi": [1, 2], "red": 4, "reduc": 10, "reed": [1, 2], "ref": [1, 2], "refer": [1, 2, 4, 5], "regard": [1, 2, 4, 10], "regist": 10, "regul": [1, 2], "relat": [1, 2], "relev": 5, "remain": 10, "repeat": 5, "repres": 4, "represent": 10, "reset": [4, 7], "resist": 2, "resistor": [1, 2], "resolv": 3, "respect": 4, "rest": 5, "restart": 5, "result": 10, "rev": [4, 5], "revers": 4, "revis": 3, "right": [1, 2, 4, 10], "rightmost": 10, "rise": [2, 10], "rm": [1, 2], "rp2040": [1, 2, 4, 5, 10], "rp2350": 5, "run": [5, 10], "same": 4, "sampl": 10, "schemat": 0, "sdk": 10, "second": 4, "section": [5, 10], "see": 4, "sensit": 10, "seri": 5, "serial": 5, "set": [1, 2, 4, 10], "setpoint": 10, "sever": 4, "share": 9, "shift": [1, 2, 10], "short": 4, "shottki": 2, "should": [4, 7], "show": [4, 10], "si1308edl": 2, "side": [1, 2, 4, 5], "signal": [1, 2, 4, 9], "six": [1, 2], "slow": 10, "small": 5, "so": [4, 5, 10], "softwar": [1, 2, 3], "soic": [1, 2], "solder": [1, 2, 5], "sometim": 5, "somewhat": [1, 2], "somewher": 7, "soon": [1, 2], "sort": 10, "sot": [1, 2], "sourc": 5, "special": [1, 2], "speed": [1, 2, 6, 10], "speed_help": 10, "squar": [1, 2], "stage": 0, "standard": 10, "start": [1, 2, 3, 10], "startup": [4, 10], "state": 4, "static": [1, 2], "statu": [2, 4], "stdio": [1, 2], "step": [6, 10], "still": [4, 5], "stop": 4, "storag": 5, "store": 10, "structur": 10, "studio": 5, "subdivid": [1, 2], "suggest": 5, "suitabl": [1, 2], "suppli": [2, 5, 7], "support": [1, 2, 4, 5, 10], "switch": [1, 2, 4], "symbol": [1, 2], "system": 10, "s\u03c4": 10, "t": [1, 2, 7, 10], "t2n7002bk": [1, 2], "take": 10, "temperatur": 2, "temporarili": 5, "term": 5, "th": [1, 2], "than": 10, "thei": [1, 2], "them": [4, 10], "therefor": [4, 10], "thermal": 2, "thi": [1, 2, 4, 5, 7, 10], "threshold": 10, "time": 10, "togeth": [1, 2], "too": [4, 5], "toolkit": 5, "total": [1, 2, 4], "tp": [1, 2], "track": [7, 10], "transform": 10, "transistor": [1, 2], "translat": [1, 2], "travel": 4, "trigger": 4, "troubl": 5, "troubleshoot": [3, 5, 6], "try": 7, "turn": [1, 2], "two": [1, 2, 4, 5], "txt": [1, 2], "type": [1, 2], "u1": [1, 2], "u2": [1, 2], "u3": [1, 2], "u4": [1, 2], "uart": [1, 2], "understand": 10, "unit": [1, 2], "up": [1, 2, 5], "us": [1, 2, 5, 10], "usb": [2, 5], "usual": 4, "v": [1, 2, 7], "valid": 4, "valu": [1, 2, 4, 7, 10], "vari": 10, "variabl": [1, 2, 3, 6, 10], "vbu": 2, "vdc": 2, "via": [1, 2], "visual": 5, "voltag": [1, 2, 4, 7], "w25q64jvssiq": [1, 2], "wai": 5, "wait": 10, "want": 5, "wave": [1, 2], "well": [1, 2, 10], "wheel": [1, 2], "when": [1, 2, 4, 5, 7, 10], "where": 3, "which": [1, 2, 4, 5, 10], "while": [4, 10], "who": 5, "wire": [0, 3, 7], "within": [1, 2], "without": 5, "work": [1, 2, 4, 5, 7, 10], "would": 4, "wrap": 4, "write": [4, 5, 7], "written": [4, 10], "x": [4, 10], "x322512msb4si": [1, 2], "xxxx": 10, "y": 10, "y1": [1, 2, 4], "y2": 4, "yet": [1, 2], "you": [4, 5, 7], "your": [4, 5, 7], "yourself": [4, 5], "z": 10, "\u03b4t": 2}, "titles": ["Hardware", "Overview", "Overview", "RP2040-Decoder Documentation", "Configuration Variables (CV)", "Getting started", "Other", "Troubleshooting", "Header files", "Software", "Software Description"], "titleterms": {"0": 0, "1": [0, 5], "14": 4, "2": 5, "3": [0, 5], "4": 5, "5": 5, "6": 5, "No": 4, "absolut": [1, 2], "acceler": 4, "adc": 4, "addit": 4, "address": 4, "altern": [1, 2], "arrai": 4, "auxiliari": [1, 2], "back": 10, "base": 4, "basic": 4, "bdr6133": [1, 2], "bit": 4, "board": 5, "bom": [1, 2], "build": 5, "characterist": [1, 2], "clock": 4, "complet": [1, 2], "config": 4, "configur": 4, "constant": 4, "content": [3, 6, 9], "control": [4, 10], "core0": 8, "core1": 8, "cutoff": 4, "cv": [4, 8], "cv_1": 4, "cv_11": 4, "cv_112": 4, "cv_113": 4, "cv_114": 4, "cv_115": 4, "cv_116": 4, "cv_12": 4, "cv_17": 4, "cv_171": 4, "cv_172": 4, "cv_173": 4, "cv_174": 4, "cv_175": 4, "cv_176": 4, "cv_177": 4, "cv_178": 4, "cv_179": 4, "cv_18": 4, "cv_2": 4, "cv_257": 4, "cv_29": 4, "cv_3": 4, "cv_31": 4, "cv_32": 4, "cv_4": 4, "cv_47": 4, "cv_48": 4, "cv_49": 4, "cv_5": 4, "cv_50": 4, "cv_51": 4, "cv_512": 4, "cv_52": 4, "cv_53": 4, "cv_54": 4, "cv_55": 4, "cv_56": 4, "cv_57": 4, "cv_58": 4, "cv_59": 4, "cv_6": 4, "cv_60": 4, "cv_61": 4, "cv_62": 4, "cv_63": 4, "cv_64": 4, "cv_65": 4, "cv_7": 4, "cv_8": 4, "cv_9": 4, "cycl": 4, "d": 4, "dcc": 10, "deceler": 4, "decod": [1, 2, 3, 4, 10], "delai": 4, "descript": 10, "divid": 4, "document": 3, "driver": 1, "electr": [1, 2], "emf": 10, "extend": 4, "factor": 4, "feed": [4, 10], "file": [5, 8], "filter": 4, "flash": [4, 5], "forward": [4, 10], "frequenc": 4, "function": 4, "gain": [4, 10], "get": 5, "gpio": [1, 2, 4], "h": 8, "hardwar": 0, "header": 8, "ht7533": [1, 2], "i": 4, "input": [1, 2], "integr": 4, "issu": 5, "iter": 4, "k_ff": 4, "k_p": 4, "level": 4, "limit": 4, "list": 4, "long": 4, "m": 4, "manufactur": 4, "map": 4, "maximum": [1, 2], "measur": [4, 10], "microcontrol": [1, 2], "mode": 4, "motor": [1, 4, 10], "new": 4, "note": 4, "offset": 4, "onli": 4, "oper": 4, "other": 6, "output": [1, 2], "overview": [1, 2, 10], "packet": 4, "part": [1, 2], "percentag": 4, "permit": 4, "pid": [4, 10], "pointer": 4, "product": 5, "pwm": 4, "rate": [1, 2, 4], "read": 4, "resolv": 5, "revis": 0, "rp2040": 3, "sampl": 4, "schedul": [4, 10], "schemat": [1, 2], "share": 8, "shift": 4, "signal": 10, "slice": 4, "softwar": [5, 9, 10], "speed": 4, "speed_help": 4, "stage": [1, 2], "start": 5, "step": 4, "swd": 5, "t": 4, "tau": 4, "time": 4, "timeout": 4, "timer": 4, "troubleshoot": 7, "uf2": 5, "us": 4, "v_max": 4, "v_mid": 4, "v_min": 4, "variabl": 4, "version": 4, "via": 5, "voltag": 10, "where": 5, "wire": [1, 2, 5], "x0": 4, "x1": 4, "x2": 4}}) \ No newline at end of file +Search.setIndex({"alltitles": {"1. Where to get the board?": [[5, "where-to-get-the-board"]], "2. Production files?": [[5, "production-files"]], "3. Building the software": [[5, "building-the-software"]], "4. Flashing the software": [[5, "flashing-the-software"]], "4.1. Flashing the software via .uf2 file": [[5, "flashing-the-software-via-uf2-file"]], "4.2. Flashing the software via SWD": [[5, "flashing-the-software-via-swd"]], "5. Wiring": [[5, "wiring"]], "6. Resolving issues": [[5, "resolving-issues"]], "Alternative for HT7533S:": [[1, "alternative-for-ht7533s"], [2, "alternative-for-ht7533s"]], "Alternatives for BDR6133:": [[1, "alternatives-for-bdr6133"], [2, "alternatives-for-bdr6133"]], "Auxiliary Outputs": [[1, "auxiliary-outputs"], [2, "auxiliary-outputs"]], "BOM": [[1, "id8"], [2, "id8"]], "BOM & Alternative Parts": [[1, "bom-alternative-parts"], [2, "bom-alternative-parts"]], "Back-EMF voltage measurement": [[10, "back-emf-voltage-measurement"]], "CV List": [[4, "cv-list"]], "CV.h": [[8, "cv-h"]], "CV_1 - Basic address": [[4, "cv-1-basic-address"]], "CV_11 - Packet timeout": [[4, "cv-11-packet-timeout"]], "CV_112, CV_113, CV_114, CV_115 - GPIO PWM Configuration": [[4, "cv-112-cv-113-cv-114-cv-115-gpio-pwm-configuration"]], "CV_116 to CV_171 - PWM Slice configuration": [[4, "cv-116-to-cv-171-pwm-slice-configuration"]], "CV_12 - Permitted operating modes": [[4, "cv-12-permitted-operating-modes"]], "CV_17 & CV_18 - 14-Bit extended/long address": [[4, "cv-17-cv-18-14-bit-extended-long-address"]], "CV_172 - ADC Offset": [[4, "cv-172-adc-offset"]], "CV_173 - ADC offset measurement cycles": [[4, "cv-173-adc-offset-measurement-cycles"]], "CV_174 - Additional motor-PWM clock divider.": [[4, "cv-174-additional-motor-pwm-clock-divider"]], "CV_175 - speed_helper timer delay": [[4, "cv-175-speed-helper-timer-delay"]], "CV_176, CV_177, CV_178, CV_179 - Base PWM Level used in feed-forward control": [[4, "cv-176-cv-177-cv-178-cv-179-base-pwm-level-used-in-feed-forward-control"]], "CV_2 - V_min": [[4, "cv-2-v-min"]], "CV_257 to CV_512 - Function Mapping CVs": [[4, "cv-257-to-cv-512-function-mapping-cvs"]], "CV_29 - Decoder Configuration": [[4, "cv-29-decoder-configuration"]], "CV_3 - Acceleration rate": [[4, "cv-3-acceleration-rate"]], "CV_31 & CV_32 - Extended CV pointer (Read-Only)": [[4, "cv-31-cv-32-extended-cv-pointer-read-only"]], "CV_4 - Deceleration rate": [[4, "cv-4-deceleration-rate"]], "CV_47 - Feed-forward gain k_ff": [[4, "cv-47-feed-forward-gain-k-ff"]], "CV_48 - Filter time constant (tau) in ms": [[4, "cv-48-filter-time-constant-tau-in-ms"]], "CV_49 - PID Control sampling time t in ms": [[4, "cv-49-pid-control-sampling-time-t-in-ms"]], "CV_5 - V_max": [[4, "cv-5-v-max"]], "CV_50 - PID Control I Factor": [[4, "cv-50-pid-control-i-factor"]], "CV_51 - PID Control D Factor": [[4, "cv-51-pid-control-d-factor"]], "CV_52 & CV_53 - PID Integral Limits": [[4, "cv-52-cv-53-pid-integral-limits"]], "CV_54 & CV_55 - Gain scheduling config k_p @ x0": [[4, "cv-54-cv-55-gain-scheduling-config-k-p-x0"]], "CV_56 & CV_57 - Gain scheduling config k_p @ x1": [[4, "cv-56-cv-57-gain-scheduling-config-k-p-x1"]], "CV_58 & CV_59 - Gain scheduling config k_p @ x2": [[4, "cv-58-cv-59-gain-scheduling-config-k-p-x2"]], "CV_6 - V_mid": [[4, "cv-6-v-mid"]], "CV_60 - Gain scheduling config x1 shift percentage": [[4, "cv-60-gain-scheduling-config-x1-shift-percentage"]], "CV_61 - Measurement Iterations": [[4, "cv-61-measurement-iterations"]], "CV_62 - Measurement Delay": [[4, "cv-62-measurement-delay"]], "CV_63 & CV_64 - Measurement array cutoffs": [[4, "cv-63-cv-64-measurement-array-cutoffs"]], "CV_65 - New flash variable": [[4, "cv-65-new-flash-variable"]], "CV_7 - Version No. (Read-Only)": [[4, "cv-7-version-no-read-only"]], "CV_8 - Manufacturer (Read-Only)": [[4, "cv-8-manufacturer-read-only"]], "CV_9 - Motor PWM Frequency": [[4, "cv-9-motor-pwm-frequency"]], "Complete Schematic": [[1, "complete-schematic"], [2, "complete-schematic"]], "Configuration Variables (CV)": [[4, null]], "Contents:": [[3, null], [6, null], [9, null]], "DCC signal decoding": [[10, "dcc-signal-decoding"]], "Electrical Characteristics": [[1, "electrical-characteristics"], [2, "electrical-characteristics"]], "Electrical Characteristics & Absolute Maximum Ratings": [[1, "id2"], [2, "id2"]], "Feed-forward": [[10, "id2"]], "GPIO": [[1, "gpio"], [2, "gpio"]], "Gain Scheduling": [[10, "gain-scheduling"]], "Getting started": [[5, null]], "Hardware": [[0, null]], "Header files": [[8, null]], "Input Stage": [[1, "input-stage"], [2, "input-stage"]], "Microcontroller": [[1, "microcontroller"], [2, "microcontroller"]], "Motor Driver": [[1, "motor-driver"]], "Motor control": [[10, "motor-control"]], "Note": [[4, "note"]], "Other": [[6, null]], "Overview": [[1, null], [2, null], [10, "overview"]], "PID Controller": [[10, "pid-controller"]], "RP2040-Decoder Documentation": [[3, null]], "Revision 0.3": [[0, "revision-0-3"]], "Revision 1.0": [[0, "revision-1-0"]], "Software": [[9, null]], "Software Description": [[10, null]], "Speed step configuration": [[4, "speed-step-configuration"]], "Troubleshooting": [[7, null]], "Wiring the Decoder": [[1, "wiring-the-decoder"], [2, "wiring-the-decoder"]], "core0.h": [[8, "core0-h"]], "core1.h": [[8, "core1-h"]], "shared.h": [[8, "shared-h"]]}, "docnames": ["hardware/index", "hardware/rev_0_3/hw_description", "hardware/rev_1_0/hw_description", "index", "other/CV_list", "other/getting_started", "other/index", "other/troubleshooting", "software/header_files", "software/index", "software/sw_description"], "envversion": {"sphinx": 64, "sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2}, "filenames": ["hardware/index.rst", "hardware/rev_0_3/hw_description.rst", "hardware/rev_1_0/hw_description.rst", "index.rst", "other/CV_list.md", "other/getting_started.rst", "other/index.rst", "other/troubleshooting.md", "software/header_files.rst", "software/index.rst", "software/sw_description.rst"], "indexentries": {}, "objects": {}, "objnames": {}, "objtypes": {}, "terms": {"": [1, 2, 5, 10], "0": [1, 2, 3, 4, 5, 7, 10], "0011": 10, "0603_1608metric": [1, 2], "0xff": 4, "1": [1, 2, 3, 4, 10], "10": [1, 2, 4], "100": [4, 10], "10000": 4, "1001": 4, "100111000100": 4, "100n": [1, 2], "100u": 10, "10khz": 4, "10u": [1, 2], "10v": 7, "10xx": 10, "110000": 4, "11000011010011": 4, "11000100": 4, "11010011": 4, "110x": 10, "1111": 10, "1249": 4, "12499": 4, "125": 4, "12500": 4, "126": 4, "128": 10, "12mhz": [1, 2], "12v": 2, "13": 4, "145": [1, 2], "155": [1, 2], "16": 4, "16bit": 4, "16v": 7, "192": 4, "1ep_7x7mm_p0": [1, 2], "1k": [1, 2], "2": [1, 2, 3, 4, 10], "20": 4, "200": [1, 2], "20v": [1, 7], "23": [1, 2], "231": 4, "24": [1, 2], "25": 2, "250": 4, "2500": 4, "255": [4, 10], "25v": [1, 2], "269aa": [1, 2], "2a": [1, 2], "2x2": [1, 2], "2\u00b5": 10, "3": [1, 2, 3, 4, 7], "32": 4, "33p": [1, 2], "33tr3": [1, 2], "35m": 10, "3m": 10, "3v": [1, 2, 7], "3v3": 7, "4": [1, 2, 3, 4], "400": 1, "40v": [1, 2], "4a": [1, 2], "4mm": [1, 2], "4pin_3": [1, 2], "5": [1, 2, 3, 4, 10], "50": [1, 2], "56": [1, 2], "5i": 10, "5mm": [1, 2], "6": [1, 2, 3, 4], "60v": [1, 2], "64": [4, 10], "64mb": [1, 2], "6k8": [1, 2], "7": 4, "8": [1, 2, 4, 7], "87\u03bc": 10, "8a": [1, 2], "9": 10, "93": 10, "94": 10, "A": [1, 2, 4, 5, 10], "And": 10, "As": 5, "For": [1, 2, 4, 5], "If": [4, 5, 7, 10], "In": 5, "It": [1, 2, 4, 10], "Not": 4, "On": 10, "TO": [1, 2], "That": 4, "The": [1, 2, 4, 5, 10], "Then": 10, "These": 4, "To": [1, 2, 4, 5, 7, 10], "With": 10, "_n": 10, "about": 10, "abov": [1, 2, 4, 10], "abstract": 10, "acceler": 10, "access": 10, "accord": [1, 2, 10], "achiev": [4, 10], "adc": [1, 2, 10], "adc_avdd": [1, 2], "adc_emf_a": [1, 2], "adc_emf_b": [1, 2], "add": 10, "addit": 10, "addition": 10, "address": 10, "adjust": 4, "advantag": 5, "advis": 4, "after": 10, "afterward": 10, "algorithm": 10, "align": 10, "all": [4, 5, 10], "alreadi": 5, "also": [1, 2, 4, 5, 10], "altern": [0, 4, 5], "although": [1, 2], "alwai": [1, 2, 4], "am": 4, "amount": [1, 2, 4], "amplitud": [1, 2], "an": [1, 2, 4, 10], "analog": 7, "ani": [4, 5, 10], "anoth": [4, 5, 10], "appendix": 5, "applic": [1, 2], "ar": [1, 2, 4, 5, 10], "around": 7, "arrai": 10, "aspect": 10, "assembl": 5, "assum": [1, 2], "automat": [4, 10], "aux": [1, 2], "aux1": 4, "aux2": 4, "auxiliari": 0, "avail": [4, 5, 10], "averag": 10, "b": 4, "back": [1, 2, 5], "base": [5, 10], "becaus": 7, "been": [1, 2], "begin": [4, 10], "behavior": 4, "being": 10, "below": [1, 2, 5, 10], "bemf": 4, "bennymeg": 5, "best": 5, "better": [1, 2, 10], "between": [4, 10], "bewar": 7, "bilinear": 10, "bin": 4, "bit": 10, "bit0": 4, "bit14": 4, "bit15": 4, "bit5": 4, "bit6": 4, "bit7": 4, "block": [1, 2, 10], "blue": 4, "board": [3, 4, 10], "bom": [0, 5], "book": 5, "boot": 5, "both": [4, 10], "bridg": [1, 2, 5], "build": [3, 10], "byte": [4, 10], "c": [2, 4, 10], "c1": [1, 2], "c10": [1, 2], "c11": [1, 2], "c12": [1, 2], "c13": [1, 2], "c14": [1, 2], "c15": [1, 2], "c16": [1, 2], "c17": [1, 2], "c2": [1, 2], "c3": [1, 2], "c4": [1, 2], "c5": [1, 2], "c6": [1, 2], "c7": [1, 2], "c8": [1, 2], "c9": [1, 2], "calcul": [4, 10], "calibr": [4, 10], "call": [4, 5, 10], "can": [1, 2, 4, 5, 7, 10], "cannot": 8, "capabl": 5, "capacitor": [1, 2], "case": [2, 5], "cdot": 10, "central": 10, "ceram": [1, 2], "certain": 10, "chang": [4, 5, 10], "channel": [1, 2, 4], "chapter": [4, 5], "character": 4, "characterist": 0, "check": [4, 7, 10], "chip": 4, "choos": 5, "circuit": [1, 2], "clk_div": 4, "clock": [1, 2], "cmake": 10, "cmakelist": [1, 2, 5, 10], "code": [5, 10], "com": 5, "come": 5, "command": 10, "commun": 10, "compar": 10, "compil": 10, "complet": [0, 7, 10], "complic": 5, "compon": [1, 2, 4, 5, 10], "comput": [4, 10], "condit": 4, "conduct": [1, 2], "configur": [1, 2, 3, 6, 10], "connect": [1, 2, 4, 5], "connector": 2, "consid": 10, "constant": 10, "constraint": 5, "contain": [4, 10], "continu": 10, "control": [1, 2, 9], "conveni": 10, "copi": 5, "core": 10, "core0": [4, 9, 10], "core1": [9, 10], "correct": [4, 7, 10], "correspond": [2, 4, 10], "could": [1, 2, 5], "creat": 5, "critic": [1, 2], "crystal": [1, 2], "crystal_smd_3225": [1, 2], "current": [1, 2, 4, 10], "custom": [1, 2], "cv": [3, 6, 7, 9, 10], "cv8": [4, 7], "cv_144": 4, "cv_145": 4, "cv_146": 4, "cv_149": 4, "cv_150": 4, "cv_176": 10, "cv_179": 10, "cv_47": 10, "cv_54": 10, "cv_55": 10, "cv_56": 10, "cv_57": 10, "cv_58": 10, "cv_59": 10, "cv_60": 10, "cv_62": 10, "cv_63": 10, "cv_64": 10, "cv_setup_check": 4, "cycl": [5, 10], "d": [1, 2, 10], "d1": [1, 2], "d2": 2, "d3": 2, "d_": 10, "d_n": 10, "datasheet": [1, 2, 4, 5], "dc": [1, 2], "dcc": [1, 2, 4, 9], "dd": [1, 2], "debug": [5, 10], "debugprob": 5, "dec": 4, "deceler": 10, "decod": [0, 5, 7, 9], "default": [4, 10], "defin": 4, "definit": 10, "defint": 5, "delai": 10, "depend": [4, 10], "dependend": [1, 2], "deriv": [4, 10], "describ": [5, 10], "descript": [3, 9], "design": 5, "desold": 7, "detail": [4, 5, 10], "detect": 10, "determin": 4, "devic": 5, "diagram": [1, 2, 10], "differ": [1, 2, 10], "difficult": 5, "digit": [4, 10], "diod": [1, 2], "direct": [4, 10], "directli": [1, 2, 10], "disabl": 4, "discard": 4, "discret": [4, 10], "discuss": 5, "disk": 5, "dismiss": 10, "dissip": 2, "divid": [1, 2], "do": [4, 5, 7], "document": [5, 10], "doe": 5, "doesn": [1, 2, 7], "domain": [4, 10], "done": [1, 2, 4, 10], "dont": 7, "down": 7, "downstream": 4, "doxygenfil": 8, "drag": 5, "driver": [0, 2], "dropout": [1, 2], "duti": [4, 10], "e": [1, 2, 4, 10], "e_": 10, "e_n": 10, "each": 4, "easier": 10, "easiest": 5, "easili": [1, 2], "edg": 10, "effect": [1, 2, 4, 10], "either": [1, 2, 4], "electr": 0, "element": [4, 10], "emerg": 4, "emf": [1, 2], "enabl": [2, 4], "end": 10, "ensur": [1, 2], "equat": 10, "equival": [4, 10], "error": 10, "essenc": 10, "establish": 10, "event": 10, "everi": [4, 10], "everyth": 10, "exampl": [1, 2, 4], "exce": [1, 2], "expans": 10, "expect": [5, 7], "explain": [1, 2, 5], "explan": [4, 10], "explor": 5, "export": 5, "extens": 5, "extern": [1, 2], "f": [1, 2, 4], "f0": 10, "f12": 10, "f13": 10, "f31": 10, "fabric": 5, "facilit": [1, 2], "factori": 4, "fall": 10, "familiar": 5, "faster": 4, "favor": 10, "fed": 10, "feedback": 10, "few": 10, "file": [3, 9, 10], "filter": [1, 2, 10], "find": 8, "first": 5, "fit": 5, "flase": 5, "flash": [1, 2, 3, 10], "follow": [4, 5, 7, 10], "footprint": [1, 2], "forth": 4, "found": [4, 10], "foundat": 10, "four": [1, 2, 4], "frac": 10, "free": [1, 2], "frequenc": 10, "from": [4, 5, 10], "fulli": 5, "function": [1, 2, 10], "furthermor": [1, 2], "g": [1, 2], "gener": [1, 2], "gerber": 5, "get": [1, 2, 3, 4, 10], "give": [1, 2], "gnd": [1, 2, 7], "got": 5, "gpio": 0, "gpio0": [1, 2], "gpio1": [1, 2], "gpio21": [1, 2], "gpio24": [1, 2], "gpio25": 4, "gpio27": [1, 2], "gpio5": [1, 2], "great": 5, "greater": 10, "green": 4, "group": 10, "gs7533": [1, 2], "h": [1, 2, 4, 5, 9, 10], "ha": [1, 2, 4, 10], "hand": 5, "handl": 10, "happen": 4, "hardwar": [3, 5], "harwar": [1, 2], "have": [4, 5, 10], "header": [3, 9, 10], "headlight": 4, "helper": 10, "here": 4, "high": [1, 2, 4, 10], "higher": 10, "highest": [4, 10], "hold": [1, 2], "hopefulli": 10, "how": [4, 5, 10], "howev": 5, "hz": 4, "i": [1, 2, 5, 7, 10], "i_": 10, "i_n": 10, "ic": [1, 2], "ignor": 5, "ih": [1, 2], "il": [1, 2], "illustr": [1, 2, 4, 10], "impact": 10, "implement": 10, "includ": [1, 2, 10], "inclus": 4, "independ": 4, "index": 4, "indic": 4, "induct": [1, 2], "init": 4, "input": [0, 10], "insert": 10, "instead": 10, "instruct": [4, 5, 10], "interfac": 5, "intern": [1, 2], "iovdd": [1, 2], "irrelev": 4, "issu": [3, 7], "its": [1, 2], "itself": [1, 2, 5], "jlcpcb": 5, "job": 5, "jp1": 5, "just": 5, "k": 10, "k_d": 10, "k_i": 10, "k_p": 10, "keep": [1, 2], "kicad": 5, "kmb24f": [1, 2], "larg": 10, "lcsc": 5, "lead": 4, "led": [2, 10], "left": [4, 10], "leftmost": 10, "legaci": [5, 10], "length": 10, "level": [1, 2, 10], "librari": 10, "lighter": [1, 2], "like": [5, 7], "limit": [1, 2], "link": 10, "linkag": 2, "list": 6, "littl": 5, "load": [1, 2, 10], "log": [1, 2, 10], "logic": 2, "long": [1, 2], "look": 10, "loop": 10, "loss": [1, 2], "low": [1, 2, 4, 10], "lowest": 10, "ma": [1, 2], "made": [1, 2], "make": 5, "mani": 4, "manufactur": 5, "mass": 5, "match": 10, "max": [1, 2, 4, 10], "maximum": [4, 10], "mb": [1, 2], "mean": [1, 2, 4], "measur": [1, 2, 7], "memori": [1, 2, 7], "mention": 4, "mhz": 4, "microcontrol": 0, "mid": 4, "might": 5, "min": [4, 10], "mind": [1, 2], "minimum": [1, 2, 4], "mitig": 10, "mode": [2, 5, 10], "modif": 5, "modifi": 10, "more": [4, 5, 10], "mosfet": [1, 2], "most": 5, "motor": [0, 2, 7, 9], "n": [1, 2, 10], "name": [1, 2], "narrow": 7, "necessari": [1, 2], "need": [1, 2, 5, 10], "new": 5, "nmra": 10, "nois": 10, "normal": [4, 5], "note": [1, 2, 5, 6, 10], "now": 10, "off": [1, 2], "offici": 5, "offset": 10, "often": 10, "one": 4, "onli": [5, 10], "onto": [2, 5], "open": 5, "oper": [1, 2], "option": [4, 10], "order": 5, "oscil": [1, 2, 4], "other": [3, 4, 5], "otherwis": [4, 10], "out": [1, 2, 10], "outlier": 10, "output": [0, 4, 10], "overview": [0, 9], "own": 5, "p": 10, "p_n": 10, "packag": [4, 10], "pad": [1, 2], "paramet": [1, 2, 4], "part": [0, 4, 5, 10], "partli": 5, "pass": [4, 10], "pcb": 5, "percent": 4, "period": 4, "pi": [5, 10], "pick": 5, "pico": 5, "pid_control": 4, "pin": [1, 2, 7, 10], "place": 5, "pleas": 5, "plug": 5, "plugin": 5, "point": [1, 2, 10], "posit": 4, "possibl": 10, "potenti": [1, 2, 10], "power": [2, 5, 7], "precompil": 5, "prefer": 5, "prevent": 10, "procedur": [4, 5], "process": [1, 2, 5], "product": 3, "program": [1, 2, 10], "proport": 10, "protect": [1, 2], "provid": [1, 2, 10], "pt2476": [1, 2], "pt5126a": [1, 2], "public": 4, "pull": [1, 2], "purpos": [1, 2], "pwm": [1, 2, 10], "q1": [1, 2], "q2": [1, 2], "q3": [1, 2], "q4": [1, 2], "q5": [1, 2], "qfn": [1, 2], "quantiti": [1, 2], "question": 5, "r": [1, 2], "r1": [1, 2], "r11": 2, "r2": [1, 2], "r3": [1, 2], "r5": [1, 2], "r6": [1, 2], "r7": [1, 2], "r8": [1, 2], "r9": [1, 2], "rang": [4, 7], "raspberri": [5, 10], "rate": 10, "rather": [1, 2], "re": 5, "reach": 10, "read": 10, "receiv": [4, 10], "recommend": 5, "rectifi": [1, 2], "red": 4, "reduc": 10, "reed": [1, 2], "ref": [1, 2], "refer": [1, 2, 4, 5], "regard": [1, 2, 4, 10], "regist": 10, "regul": [1, 2], "relat": [1, 2], "relev": 5, "remain": 10, "repeat": 5, "repres": 4, "represent": 10, "reset": [4, 7], "resist": 2, "resistor": [1, 2], "resolv": 3, "respect": 4, "rest": 5, "restart": 5, "result": 10, "retriev": 10, "rev": [4, 5], "revers": 4, "revis": 3, "right": [1, 2, 4, 10], "rightmost": 10, "rise": [2, 10], "rm": [1, 2], "rp2040": [1, 2, 4, 5, 10], "rp2350": 5, "run": [5, 10], "same": 4, "sampl": 10, "schemat": 0, "sdk": 10, "second": 4, "section": [5, 10], "see": 4, "sensit": 10, "seri": 5, "serial": 5, "set": [1, 2, 4, 10], "setpoint": 10, "sever": 4, "share": [9, 10], "shift": [1, 2, 10], "short": 4, "shottki": 2, "should": [4, 7], "show": [4, 10], "si1308edl": 2, "side": [1, 2, 4, 5], "signal": [1, 2, 4, 9], "six": [1, 2], "size": 10, "slow": 10, "small": 5, "so": [4, 5, 10], "softwar": [1, 2, 3], "soic": [1, 2], "solder": [1, 2, 5], "sometim": 5, "somewhat": [1, 2], "somewher": 7, "soon": [1, 2], "sort": 10, "sot": [1, 2], "sourc": [5, 10], "special": [1, 2], "specif": 10, "speed": [1, 2, 6, 10], "speed_help": 10, "squar": [1, 2], "stage": 0, "standard": 10, "start": [1, 2, 3, 10], "startup": [4, 10], "state": 4, "static": [1, 2], "statu": [2, 4], "stdio": [1, 2, 10], "step": [6, 10], "still": [4, 5], "stop": 4, "storag": 5, "store": 10, "studio": 5, "subdivid": [1, 2], "suggest": 5, "suitabl": [1, 2], "suppli": [2, 5, 7], "support": [1, 2, 4, 5, 10], "switch": [1, 2, 4], "symbol": [1, 2], "system": 10, "t": [1, 2, 7], "t2n7002bk": [1, 2], "t_": 10, "take": 10, "tau": 10, "temperatur": 2, "temporarili": 5, "term": 5, "text": 10, "th": [1, 2], "than": 10, "thei": [1, 2], "them": [4, 10], "therefor": [4, 10], "thermal": 2, "thi": [1, 2, 4, 5, 7, 10], "threshold": 10, "time": 10, "todo": 10, "togeth": [1, 2], "too": [4, 5], "toolkit": 5, "total": [1, 2, 4], "tp": [1, 2], "track": [7, 10], "transform": 10, "transistor": [1, 2], "translat": [1, 2], "travel": 4, "trigger": 4, "troubl": 5, "troubleshoot": [3, 5, 6], "try": 7, "turn": [1, 2], "two": [1, 2, 4, 5], "txt": [1, 2, 5, 10], "type": [1, 2], "u1": [1, 2], "u2": [1, 2], "u3": [1, 2], "u4": [1, 2], "uart": [1, 2, 10], "uart_rx": 10, "uart_tx": 10, "understand": 10, "unit": [1, 2], "up": [1, 2, 5], "updat": 10, "us": [1, 2, 5, 10], "usb": [2, 5, 10], "usual": 4, "v": [1, 2, 7], "valid": 4, "valu": [1, 2, 4, 7, 10], "vari": 10, "variabl": [1, 2, 3, 6, 10], "vbu": 2, "vdc": 2, "version": 10, "via": [1, 2, 10], "visual": 5, "voltag": [1, 2, 4, 7], "w25q64jvssiq": [1, 2], "wai": 5, "wait": 10, "want": 5, "wave": [1, 2], "well": [1, 2, 10], "wheel": [1, 2], "when": [1, 2, 4, 5, 7, 10], "where": 3, "which": [1, 2, 4, 5, 10], "while": [4, 10], "who": 5, "wire": [0, 3, 7], "within": [1, 2], "without": 5, "work": [1, 2, 4, 5, 7, 10], "would": 4, "wrap": 4, "write": [4, 5, 7], "written": [4, 10], "x": [4, 10], "x322512msb4si": [1, 2], "xxxx": 10, "y": 10, "y1": [1, 2, 4], "y2": 4, "yet": [1, 2], "you": [4, 5, 7], "your": [4, 5, 7], "yourself": [4, 5], "z": 10, "\u03b4t": 2}, "titles": ["Hardware", "Overview", "Overview", "RP2040-Decoder Documentation", "Configuration Variables (CV)", "Getting started", "Other", "Troubleshooting", "Header files", "Software", "Software Description"], "titleterms": {"0": 0, "1": [0, 5], "14": 4, "2": 5, "3": [0, 5], "4": 5, "5": 5, "6": 5, "No": 4, "absolut": [1, 2], "acceler": 4, "adc": 4, "addit": 4, "address": 4, "altern": [1, 2], "arrai": 4, "auxiliari": [1, 2], "back": 10, "base": 4, "basic": 4, "bdr6133": [1, 2], "bit": 4, "board": 5, "bom": [1, 2], "build": 5, "characterist": [1, 2], "clock": 4, "complet": [1, 2], "config": 4, "configur": 4, "constant": 4, "content": [3, 6, 9], "control": [4, 10], "core0": 8, "core1": 8, "cutoff": 4, "cv": [4, 8], "cv_1": 4, "cv_11": 4, "cv_112": 4, "cv_113": 4, "cv_114": 4, "cv_115": 4, "cv_116": 4, "cv_12": 4, "cv_17": 4, "cv_171": 4, "cv_172": 4, "cv_173": 4, "cv_174": 4, "cv_175": 4, "cv_176": 4, "cv_177": 4, "cv_178": 4, "cv_179": 4, "cv_18": 4, "cv_2": 4, "cv_257": 4, "cv_29": 4, "cv_3": 4, "cv_31": 4, "cv_32": 4, "cv_4": 4, "cv_47": 4, "cv_48": 4, "cv_49": 4, "cv_5": 4, "cv_50": 4, "cv_51": 4, "cv_512": 4, "cv_52": 4, "cv_53": 4, "cv_54": 4, "cv_55": 4, "cv_56": 4, "cv_57": 4, "cv_58": 4, "cv_59": 4, "cv_6": 4, "cv_60": 4, "cv_61": 4, "cv_62": 4, "cv_63": 4, "cv_64": 4, "cv_65": 4, "cv_7": 4, "cv_8": 4, "cv_9": 4, "cycl": 4, "d": 4, "dcc": 10, "deceler": 4, "decod": [1, 2, 3, 4, 10], "delai": 4, "descript": 10, "divid": 4, "document": 3, "driver": 1, "electr": [1, 2], "emf": 10, "extend": 4, "factor": 4, "feed": [4, 10], "file": [5, 8], "filter": 4, "flash": [4, 5], "forward": [4, 10], "frequenc": 4, "function": 4, "gain": [4, 10], "get": 5, "gpio": [1, 2, 4], "h": 8, "hardwar": 0, "header": 8, "ht7533": [1, 2], "i": 4, "input": [1, 2], "integr": 4, "issu": 5, "iter": 4, "k_ff": 4, "k_p": 4, "level": 4, "limit": 4, "list": 4, "long": 4, "m": 4, "manufactur": 4, "map": 4, "maximum": [1, 2], "measur": [4, 10], "microcontrol": [1, 2], "mode": 4, "motor": [1, 4, 10], "new": 4, "note": 4, "offset": 4, "onli": 4, "oper": 4, "other": 6, "output": [1, 2], "overview": [1, 2, 10], "packet": 4, "part": [1, 2], "percentag": 4, "permit": 4, "pid": [4, 10], "pointer": 4, "product": 5, "pwm": 4, "rate": [1, 2, 4], "read": 4, "resolv": 5, "revis": 0, "rp2040": 3, "sampl": 4, "schedul": [4, 10], "schemat": [1, 2], "share": 8, "shift": 4, "signal": 10, "slice": 4, "softwar": [5, 9, 10], "speed": 4, "speed_help": 4, "stage": [1, 2], "start": 5, "step": 4, "swd": 5, "t": 4, "tau": 4, "time": 4, "timeout": 4, "timer": 4, "troubleshoot": 7, "uf2": 5, "us": 4, "v_max": 4, "v_mid": 4, "v_min": 4, "variabl": 4, "version": 4, "via": 5, "voltag": 10, "where": 5, "wire": [1, 2, 5], "x0": 4, "x1": 4, "x2": 4}}) \ No newline at end of file diff --git a/sphinx/html/software/index.html b/sphinx/html/software/index.html index 70ba412..1830b6f 100644 --- a/sphinx/html/software/index.html +++ b/sphinx/html/software/index.html @@ -18,6 +18,7 @@ + @@ -90,8 +91,7 @@
  • Software Description
  • diff --git a/sphinx/html/software/sw_description.html b/sphinx/html/software/sw_description.html index 0eef889..1d736c8 100644 --- a/sphinx/html/software/sw_description.html +++ b/sphinx/html/software/sw_description.html @@ -18,6 +18,7 @@ + @@ -53,10 +54,10 @@
  • Software
    • Software Description
      • Overview
      • -
      • Motor control overview
      • -
      • PID Controller
        @@ -99,82 +100,139 @@

        Software Description

        Overview

        -

        The Software is structured as follows:

        -
          -
        • Core0.c

          +

          Software files high level overview:

            +
          • core0.c / core0.h

            +
            +
            • DCC package detection & decoding

            • Programming mode (Modify and read CVs on programming track)

            • ADC-Offset measurement

            • -
            • Feed-forward base PWM measurement

            +
          • -
          • Core1.c

            -
              +
            • core1.c / core0.h

              +
              +
              • PID motor controller

              • +
              • Back-EMF voltage measurement

              +
            • -
            • CV.h

              -
                +
              • shared.c / shared.h (used by both cores)

              • +
              • Error handling

              • +
              • Helper functions for retrieving CV’s

              • +
              • CV.h

              • Default configuration variables

              • +
              • CMakeLists.txt

                +
                +
                  +
                • CMake version, SDK version, C standard version

                • +
                • Board definitions

                • +
                • Compile/Build options

                • +
                • Sources files, header files

                • +
                • Debug logging configuration (via stdio using UART/USB)

                • +
                • Linked libraries

                +
                +
              • +
              • RP2040-Decoder-board.h or RP2040-Decoder-board-legacy.h

                +
                +
                  +
                • Flash Size

                • +
                • Pin specification

                  +
                  +
                    +
                  • LED pin when available

                  • +
                  • UART_TX/UART_RX when used

                  • +
                  • DCC input pin

                  • +
                  • Motor Control PWM pins

                  • +
                  • ADC pins

                  • +
                  +
                -

                Conveniently The Raspberry Pi Foundation provides a well documented SDK for the RP2040. The SDK provides abstraction to a higher level and therefore there is no need to access any registers directly. Everything is written using the SDK so hopefully the code is easier to understand. In the following, the motor control and the decoding of the DCC signals will be explained.

                -
        -
        -

        Motor control overview

        -

        Block Diagram

        -
        -

        Block diagram - Motor control

        -

        The above block diagram in essence describes the functionality of the control loop. 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 is corresponding to the speed_helper() function which delays changing the setpoint according to the configured deceleration/acceleration rates.

        + +
      • +
      +

      Conveniently, The Raspberry Pi Foundation provides a well-documented SDK for the RP2040. The SDK provides abstraction to a higher level, and therefore there is no need to access any registers directly. Everything is written using the SDK, so hopefully, the code is easier to understand.

+
+

Motor control

+
+Block Diagram +
+

Motor control - Block diagram

+
+
+

The above block diagram in essence describes the functionality of the control loop. 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.

-

PID Controller

-

PID Controller

-

The block diagram above shows the PID controller in the s-domain. The derivative part contains an additional digital low pass filter used to filter out high-frequency noise.

-

Output = E * (KP + KI/s + (KD*s)/(sτ+1)) = P + I + D

-
    -
  • P = E * KP

  • -
  • I = E * KI/s

  • -
  • D = E * (KD*s)/(sτ+1)

  • -
-

The continuous-time system representation can now be transformed into a discrete-time representation using bilinear transform [ s = 2*(z-1) / Ts*(z+1) ].

+

PID Controller

+
+PID Controller figure +
+

PID Controller

+
+
+

The block diagram above shows the PID controller in the s-domain. The derivative part contains an additional digital low-pass filter used to filter out high-frequency noise.

+
+\[\begin{split}\begin{align} +\text{Output} &= E \cdot \left(K_P + \frac{K_I}{s} + \frac{K_D \cdot s}{s \tau + 1}\right) = P + I + D \\ +P &= E \cdot K_P \\ +I &= E \cdot \frac{K_I}{s} \\ +D &= E \cdot \frac{K_D \cdot s}{s \tau + 1} +\end{align}\end{split}\]
+

With \(T_s\) being the sampling time / controller update rate / time step of the discrete system. +And \(\tau\) being the filter time constant of the digital filter

+

The continuous-time system representation can now be transformed into a discrete-time representation using bilinear transform \(s = \frac{2 \cdot (z - 1)}{T_s \cdot (z + 1)}\).

This results in the following difference equations which are then implemented in software:

-
    -
  • pn = KP * en

  • -
  • in = 0.5KI * (en + en-1) + in-1

  • -
  • dn = [ 2KD * (en - en-1) + (2τ - Ts) * dn-1 ] / [ 2τ + Ts]

  • -
-

=> outputn = pn + in + dn

-

Also note that instead of using derivative of error, derivative on measurement is used. This is done to prevent a high derivative part in the event of a large change in setpoint.

-
-

Gain scheduling

-

K_P

-

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).

+
+\[\begin{split}\begin{align} +p_n &= K_P \cdot e_n \\ +i_n &= 0.5 \cdot K_I \cdot \left(e_n + e_{n-1}\right) + i_{n-1} \\ +d_n &= \frac{2 K_D \cdot \left(e_n - e_{n-1}\right) + \left(2 \tau - T_s\right) \cdot d_{n-1}}{2 \tau + T_s} \\ +\text{output}_n &= p_n + i_n + d_n +\end{align}\end{split}\]
+

Also note that instead of using the derivative of error, the derivative on measurement is used. This is done to prevent a high derivative part in the event of a large change in setpoint.

-
-

Feed-forward

-

Feed-forward -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.

+
+

Gain Scheduling

+
+Gain Scheduling figure +
+

Gain Scheduling

+
+
+

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.

Back-EMF voltage measurement

-

To provide a feedback signal which is proportional to the motor speed the ADC is used to measure the Back-EMF voltage. The measurement works by setting the PWM duty cycle to 0%, waiting for a certain delay time (CV_62) and then measuring x times (x = CV_63). While measuring the array with measurement values are being sorted using insertion sort. Afterwards y elements (y = CV_63) from the left (lowest values) and z elements (z = CV_64) from the right (highest values) will be dismissed to mitigate the impact of potential outliers in measurement. The average value of the remaining values will be computed and fed back into the control algorithm. Considering default settings (100us delay, 100 samples, ~2µs sampling time) the complete measurement run including averaging takes about 0.3ms to 0.35ms which effectively reduces the maximum possible duty cycle to about 93% to 94%.

+

To provide a feedback signal proportional to the motor speed, the ADC is used to measure the Back-EMF voltage. The measurement works by setting the PWM duty cycle to 0%, waiting for a certain delay time (CV_62), and then measuring x times (x = CV_63). While measuring, the array with measurement values is sorted using insertion sort. Afterwards, y elements (y = CV_63) from the left (lowest values) and z elements (z = CV_64) from the right (highest values) will be dismissed to mitigate the impact of potential outliers in measurement. The average value of the remaining values will be computed and fed back into the control algorithm. Considering default settings (100us delay, 100 samples, ~2µs sampling time), the complete measurement run, including averaging, takes about 0.3ms to 0.35ms, which effectively reduces the maximum possible duty cycle to about 93% to 94%.

DCC signal decoding

-

The detection of the DCC signal works by looking at every rising and falling edge and calculating the time between them. When the time between rising and falling edge is greater than 87μs then this is equivalent to “0”, else “1” - This value then gets shifted into a 64-Bit variable.

-

Decoding is done after every falling edge. It starts with an error detection which when not passed will dismiss the received command. Then the address will be decoded and compared to the address stored in the configuration. If the address matches the command/instruction will be decoded.

-

Only a few instructions are currently implemented, only 128 speed step instructions are supported.

+

The detection of the DCC signal works by looking at every rising and falling edge and calculating the time between them. When the time between rising and falling edge is greater than 87μs, then this is equivalent to “0”; otherwise, “1”. This value then gets shifted into a 64-Bit variable.

+

Decoding is done after every falling edge. It starts with an error detection, which, when not passed, dismisses the received command. Then the address will be decoded and compared to the address stored in the configuration. If the address matches, the command/instruction will be decoded.

+

Only a few instructions are currently implemented; only 128 speed step instructions are supported.

Implemented instructions:

    -
  • 0011-1111 - (128 Speed Step Control) - 2 Byte length

  • -
  • 10XX-XXXX - (Function Group Instruction) (F0 - F12)

  • -
  • 110X-XXXX - Expansion Instruction (F13 - F31)

  • +
  • 0011-1111 - (128 Speed Step Control) - 2 Byte length

  • +
  • 10XX-XXXX - (Function Group Instruction) (F0 - F12)

  • +
  • 110X-XXXX - Expansion Instruction (F13 - F31)

-

All DCC instructions can be found in Section 9.2, 9.2.1 and 9.2.1.1 of the NMRA Communications Standard

+

All DCC instructions can be found in Section 9.2, 9.2.1, and 9.2.1.1 of the NMRA Communications Standard.