diff options
Diffstat (limited to 'docs')
-rw-r--r-- | docs/FAQ.md | 45 | ||||
-rw-r--r-- | docs/img/tmc2208.svg | 110 | ||||
-rw-r--r-- | docs/img/tmc2208.svg.png | bin | 5858 -> 0 bytes |
3 files changed, 5 insertions, 150 deletions
diff --git a/docs/FAQ.md b/docs/FAQ.md index 1cf89f08..2c7af7c7 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -256,46 +256,11 @@ configured in Marlin. ### My TMC motor driver turns off in the middle of a print -Short answer: Do not use the TMC2208 driver in "standalone mode" with -Klipper! Do not use the TMC2224 driver in "stealthchop standalone -mode" with Klipper! - -Long answer: Klipper implements very precise timing. - - - -In the above picture, if Klipper is requested to move along the red -line and if each black line represents the nominal location to step a -stepper, then in the middle of that movement Klipper will arrange to -take a step, change the step direction, and then step back. Klipper -can perform this step, direction change, and step back in a very small -amount of time. - -It is our current understanding that the TMC2208 and TMC2224 will -react poorly to this when they are in "stealthchop" mode. (It is not -believed any other TMC drivers are impacted.) It is believed that when -the driver sees the two step requests in a small time frame that it -dramatically increases current in anticipation of high acceleration. -That high current can trip the driver's internal "over current" -detection which causes the driver to disable itself. - -This pattern of steps can occur on all stepper motors and on all -robot kinematics. - -The TMC2208 and TMC2224 do work well with Klipper when run-time -configuration mode is used (that is, when a wire is routed from the -micro-controller to the PDN-UART pin and the printer config file has a -corresponding [tmc2208] config section). When using run-time -configuration, either configure the drivers to use "spreadcycle mode" -or configure them to use "stealthchop mode" with a reasonable -"stealthchop threshold". If one wishes to exclusively use -"stealthchop" mode with run-time UART configuration then make sure the -stealthchop_threshold is no more than about 10% greater than the -maximum velocity of the given axis. It is speculated that with a -reasonable stealthchop threshold, then if Klipper sends a "step, -direction change, step back" sequence, the driver will briefly -transition from stealthchop mode, to spreadcycle mode, and back to -stealthchop mode, which should be harmless. +If using the TMC2208 (or TMC2224) driver in "standalone mode" then +make sure to use the +[latest version of Klipper](#how-do-i-upgrade-to-the-latest-software). A +workaround for a TMC2208 "stealthchop" driver problem was added to +Klipper in mid-March of 2020. ### I keep getting random "Lost communication with MCU" errors diff --git a/docs/img/tmc2208.svg b/docs/img/tmc2208.svg deleted file mode 100644 index 50b27735..00000000 --- a/docs/img/tmc2208.svg +++ /dev/null @@ -1,110 +0,0 @@ -<?xml version="1.0" encoding="UTF-8" standalone="no"?> -<!-- Created with Inkscape (http://www.inkscape.org/) --> - -<svg - xmlns:osb="http://www.openswatchbook.org/uri/2009/osb" - xmlns:dc="http://purl.org/dc/elements/1.1/" - xmlns:cc="http://creativecommons.org/ns#" - xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" - xmlns:svg="http://www.w3.org/2000/svg" - xmlns="http://www.w3.org/2000/svg" - xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" - xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" - width="210mm" - height="297mm" - viewBox="0 0 210 297" - version="1.1" - id="svg8" - inkscape:export-filename="/home/kevin/src/reprap/firmware/klipper/docs/img/tmc2208.svg.png" - inkscape:export-xdpi="96" - inkscape:export-ydpi="96" - inkscape:version="0.92.4 (unknown)" - sodipodi:docname="tmc2208.svg"> - <defs - id="defs2"> - <linearGradient - id="linearGradient4609" - osb:paint="solid"> - <stop - style="stop-color:#ffffff;stop-opacity:1;" - offset="0" - id="stop4607" /> - </linearGradient> - </defs> - <sodipodi:namedview - id="base" - pagecolor="#ffffff" - bordercolor="#666666" - borderopacity="1.0" - inkscape:pageopacity="1" - inkscape:pageshadow="2" - inkscape:zoom="0.98994949" - inkscape:cx="385.77852" - inkscape:cy="710.19584" - inkscape:document-units="mm" - inkscape:current-layer="layer1" - showgrid="true" - inkscape:pagecheckerboard="false" - inkscape:window-width="1182" - inkscape:window-height="699" - inkscape:window-x="237" - inkscape:window-y="79" - inkscape:window-maximized="0"> - <inkscape:grid - type="xygrid" - id="grid4530" /> - </sodipodi:namedview> - <metadata - id="metadata5"> - <rdf:RDF> - <cc:Work - rdf:about=""> - <dc:format>image/svg+xml</dc:format> - <dc:type - rdf:resource="http://purl.org/dc/dcmitype/StillImage" /> - <dc:title /> - </cc:Work> - </rdf:RDF> - </metadata> - <g - inkscape:label="Layer 1" - inkscape:groupmode="layer" - id="layer1"> - <path - style="fill:none;fill-rule:evenodd;stroke:#fc0000;stroke-width:0.30706427px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" - d="m 66.149367,77.39651 c 30.339928,59.83134 53.090253,40.04114 74.076273,0" - id="path4613" - inkscape:connector-curvature="0" - sodipodi:nodetypes="cc" /> - <path - style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" - d="m 39.6875,93.270833 127,0" - id="path4534" - inkscape:connector-curvature="0" - sodipodi:nodetypes="cc" /> - <path - style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" - d="m 39.6875,103.85417 127,0" - id="path4534-2" - inkscape:connector-curvature="0" - sodipodi:nodetypes="cc" /> - <path - style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" - d="m 39.6875,114.4375 127,0" - id="path4534-4" - inkscape:connector-curvature="0" - sodipodi:nodetypes="cc" /> - <path - style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" - d="m 39.6875,125.02083 127,0" - id="path4534-4-7" - inkscape:connector-curvature="0" - sodipodi:nodetypes="cc" /> - <path - style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" - d="m 39.6875,82.6875 127,0" - id="path4534-4-75" - inkscape:connector-curvature="0" - sodipodi:nodetypes="cc" /> - </g> -</svg> diff --git a/docs/img/tmc2208.svg.png b/docs/img/tmc2208.svg.png Binary files differdeleted file mode 100644 index 0bfb37a8..00000000 --- a/docs/img/tmc2208.svg.png +++ /dev/null |