From a3274cc50b2a81fce08f09dd4a208d2e482c5731 Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Sun, 16 Jan 2022 21:28:14 +0100 Subject: [PATCH 001/559] Start of new version --- res/config/6.00/info.xml | 1175 +++++++ res/config/6.00/parameters_appconf.xml | 4244 ++++++++++++++++++++++ res/config/6.00/parameters_mcconf.xml | 4490 ++++++++++++++++++++++++ res_config.qrc | 3 + vesc_tool.pro | 4 +- 5 files changed, 9914 insertions(+), 2 deletions(-) create mode 100644 res/config/6.00/info.xml create mode 100644 res/config/6.00/parameters_appconf.xml create mode 100644 res/config/6.00/parameters_mcconf.xml diff --git a/res/config/6.00/info.xml b/res/config/6.00/info.xml new file mode 100644 index 000000000..036cd5cda --- /dev/null +++ b/res/config/6.00/info.xml @@ -0,0 +1,1175 @@ + + + + + Firmware Version + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The firmware version(s) that this version of VESC Tool supports.</span></p></body></html> + + 0 + 6.00 + + + Soft Battery Cutoff Calculator + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Parameters for a soft battery cutoff can be calculated here. To do that, select the battery type and amount of cells. When the battery voltage is at the start value, the battery current will start to get reduced. At the end value battery current draw (and thus motor current) is disabled completely. In between the current is limited proportionally to where between the start and end values the input voltage is.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Notice that braking always is possible, even when the battery current is limited. That is because braking does not draw any current from the battery, it only charges the battery.</span></p></body></html> + + + + Detect BLDC Parameters + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Spin up the motor in delay commutation mode and try to measure the following parameters:</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<ul style="margin-top: 0px; margin-bottom: 0px; margin-left: 0px; margin-right: 0px; -qt-list-indent: 1;"><li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Cycle Integrator Limit</li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">BEMF Coupling</li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Hall Sensor Table</li></ul> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The settings mean the following:</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Current (I)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The current to use for spinning up the motor.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">ERPM (ω)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The minimum speed for the delay commutation mode to start the motor.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Duty (D)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The duty cycle to measure the BEMF coupling at. This value should be as low as possible, but not so low that the motor cannot spin at the end of the detection sequence.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">If the motor is not able to spin up properly these settings can be tweaked. Symptoms:</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-style:italic;">The motor starts to spin, but is too weak to reach enough speed.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto'; font-style:italic;"><br /></p> +<ul style="margin-top: 0px; margin-bottom: 0px; margin-left: 0px; margin-right: 0px; -qt-list-indent: 1;"><li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Increase the current setting.</li></ul> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-style:italic;">The motor cogs and is unable to spin up.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto'; font-style:italic;"><br /></p> +<ul style="margin-top: 0px; margin-bottom: 0px; margin-left: 0px; margin-right: 0px; -qt-list-indent: 1;"><li style=" font-family:'Roboto'; font-style:italic;" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-style:normal;">Increase or decrease the current.</span></li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">If the motor has high inertia decrease ERPM. E-bike hub motors tend to have high inertia.</li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">If the motor has low inertia increase ERPM.</li></ul> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-style:italic;">The motor spins up properly, but does not spin at the end of the detection.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto'; font-style:italic;"><br /></p> +<ul style="margin-top: 0px; margin-bottom: 0px; margin-left: 0px; margin-right: 0px; -qt-list-indent: 1;"><li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Increase the duty and try again. This is usually needed for low KV motor when using low voltage, such as ebike motors.</li></ul></body></html> + + + + Detect FOC Parameters + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><img src="data:image/25639.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAADgAAAAqCAYAAADmmJiOAAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAAEpFAABKRQGliBQaAAAEAklEQVRog +e2az0tjVxTHP/fFJEYS0AR107E6lrhQDCjiwkUpClHsxkV0IylU0JVTEERciOBGURH7B3QhuIi6q1KXp +W4Ef4IuNBlEZ1pwJfHnM+bXnUWKNCTGNyaZNIMfeJuTc+/5ntx7cg83T/AvUspK4B3wI/AGKCS/CAD/A +KvAr0KIDwACQErZCvwGfJszeZnlDPhZCPGnkFK+Bf4CvsmtpozzAfhBIbYtv7bkILYb3wkp5Xvgu1yry +RLvhZQyCOhzrSRLBIWUUuZaRTZRci0g27wmmO8UaHGSUnJzc0MkEnnSR1EUhBDo9XqMRiOK8vx3d39/T +yAQiLPp9XrMZrMWWZrQlODNzQ0dHR0cHR096aPX6zEYDJSWlmK323E6nXR2dlJWVvbkmPn5eWZmZuJsr +a2trKysaJSvAamBy8tLWVtbK4HPempqauTGxsaT846NjSWMaW9v1yJJM1mtQa/XS09PDz6fL5thUpJWg +g6HA6fTSVtbG83NzUlr5/z8nMXFRWSOjltNNZgMIQQjIyN0d3cjpSQUCuHz+ejq6uL09DTOd2dnh0gkQ +kHBi8O9mLRWUFEUdDodBQUFmEwmHA4Hbrc7we/q6irlL3A2yXgN2my2BJvFYkGn02U6lCYymmA0GmV7e +zvB3tLSkrMEX1wUUkrOzs7Y398H4O7ujvX1dZaXl+P8qqqq6O3tRQiRntIXklbVj4+PMzExAUAoFCIUC +sV9XlFRwcLCApWVlemESYu0Enx4eEhq1+l0uN1u5ubmKC4uTidE2mTloI9EIiwtLTE1NZWwql+atFawr +6+PhoYG/H4/q6urbG1tPR7oqqoyOzuL1WpleHg4ZzX44l5UCCE9Hs+jj6qqsr+/Xwoh4vxsNps8ODhIO +m9e9aImk4nJyUmqq6vj7BcXF8zOzhIOhzMV6rPIaA1arVZGR0cT7B6Ph8PDQ01zhEIh/H5/yuf6+lpzb +5vx5tDlcjE9PY3X6320BYNBpqam8Hg8z9bi5uYmTU1NKX3sdjtLS0tYLJZn9WQ8QbPZzNDQEAMDA3H2t +bU19vb2aGxsTDleVVVOTk5S+hQWFhKNRjXpyfgxIYTA5XJRX18fZ1dVlenp6S9ei5pWUAiBzWajvLw8z +mY0GpP6l5SUMDg4yNjYWFyt7O7ucnx8TF1dHRBb7f/OqRWbzab52NF08Sul5Pb2NmFbmEwmDAZD0jHhc +Ji7u7sEe1FREXp97CI9EAg82Q2lQlEUzGazpiRfb7bzndcE8x0FyG27n12CCrH/s79WzhTg91yryCKrQ +kpZQewlhMoci8k0Z8D3ihDiI/ATcJraP684BdxCiI+PrYCU8g3wC9AJvAWStyj/X4LACfAHsReB/gb4B +JEpnqH32l33AAAAAElFTkSuQmCC" width="56" height="42" /> <img src="data:image/21963.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAAFAAAAAfCAYAAABwH0oUAAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAAEzkAABM5AGniRJxAAACu0lEQVRog +e2auWsVURSHv2OeCy7gEkGxcQFtxM7KwhW1ESwtopWChf4NLmBrJWinELQQNS7grqiFKMEVEUVMcIEUR +sUlLo8kn8VMQI0xLy95b2YgH1xeM/ee3/zenTN37rmQQ9R56h31pbpXXaZOyFpXYVAXq+0m9Kjv1NvqT +nWJOjFrjblGbVB3q93+Sa/6Vj2rblVnq2Oz1ptL1JnqrdS0gehQj6gb1ClZa84d6tr0Ef4fvWqX2qYeU +leqU+ulMeoVqBrUBuAGsIzKtAp8Ap4AF4HTwJuI+FwrjblHbUpnWDV8VS+q29XGrO8lE9QZ6uMqDex7x +HvSP+GculmdnfV91RV1/zAM/Jtv6nP1gEmOnaPmOpUNG3W9/Zc0I8FP9YG6y2TtOX6o2grhvLoAuALMq +2GYMnAXaAGuAk8iwsE6FcXAacAJYFUdwnUDH4FW4CiJqe0R0fuvi4tiYAk4DDTVOXQZaAfuAcfS386I6 +O67oGRx3khfM4g5DliUtk3AC+CC2gw8ioieUL9nIKwaSmnLGklm5lPgYKiDJspRBqSjROJmEWhIW9b0m +4FLMxZUKTuALRnG7wYeAteA46Q5sBQRrRmKqgiTTYUsUk0ZaANuAs3AM+Dj70uaPCTlSpgMzKpTrDLwA +bhPBevAohg4HZhf4xh9XyLHgAsR8aqSTkUxcD4wtwbjdpHMtKvAKeBFRPwcygBFMXA1MFK1j+/AG5Jv6 +xbgYUS8r3aw3Btosj2/bjhDpO0LcAY4D9yKiI4RkJd/A4E1wMIq+knyMrgBXAZORUTnCOoCcm5gutG5D +ZhUaRf+rImcBF5HxLfaKMw56gq1PMimaF9V7qm6T11uHatyucWkFnLd0brw0FHHqHsc+GTCSXWj2ujoy +YT+pPWJttS0XJ+NyetLpAvoJNkxbwYuAfci4kemqv7BL3J+bihPHgUNAAAAAElFTkSuQmCC" width="80" height="31" /> <img src="data:image/23317.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAADgAAAAqCAYAAADmmJiOAAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAAEpHAABKRwHadteTAAADVklEQVRog +e2av0tjWRTHPzfP+IMkWFgEZGZ3jAsWacROCKzLNoJCWkHcyCDYzfwJ+i/YibAgDyR2isEFLdQBGwsFj +ZXjGpOZIhELQwjKeyZni+w+eJvRbe41m8EPpHjnnuR8vy/33fNy8xR/IyLvgA/AJPAW6Ka9eAC+AhlgS +SmVB1AAIvIr8DvwY8vk6eUaeK+U2lciEgM+AW9aq0k7eeCXAI1p+b2Zg8Zs/KBE5DPwU6vVGOKzEhEHC +LZaiSEcJSLSahUmCbRagGleDbY7Hbo/sFKpYNs2AJZlEQ6HGRwcJB6PE4lEUErpLvk8oplcLidA0ysWi +4lt2+K6ru6Sz/JiBgHp6emRtbU1qdfruss+ifY2USqVSKVSOI5DsVjk8vIS13W98Wg0ysnJCf39/TrLP +o3Js+c4jiwsLDR9k4uLiybL+jBqUESkWCxKLBbzGRwYGJBqtWq6tIiIGG8T0WiUZDLpixUKBXZ2dkyXB +l6oDyaTSTo7O73jWq1GOp2mXq8br/0iBrPZrG+hAdjf3+fq6sp4beMGK5UKq6uryL8W69vbWzKZTFNcN +8YNHh4ecnp6+s2x9fV1HMcxK8DkCua6rkxOTj7Z+AE5OjoyKcHsKnpxccHu7u6zOf/ct5rCmEERYWVlx +TcFQ6EQ4XDYl7exscHd3Z0pGeYM3tzckE6nfbHx8XHm5+d9sWKxyPb2tikZ5q7BpaUlUUp511pHR4dsb +W3J8fGxdHd3+67DiYkJY78yjBgsl8syPDzsMzE0NCQPDw9Sr9clkUj4xnp7e+X8/NyEFDOLzMHBAdls1 +hebnZ2lq6sLpRSpVMo3Vi6X2dzcNNMTdZ+xb7WGcDgs+XzeyymVStLX1+fLicfjcn9/r1uO/il6dnYml +mX5xE9PT8vj46OXU6vVZG5urqkn7u3t6Zajf4ouLy9Tq9W842AwyMzMDJZlebFAIMDU1BTBoH+/2URP1 +LrpJCKMjY0xMjLixUKhEIlEoil3dHQU27apVqteLBKJICJaN6Zed7bbnVeD7U4AcP8zq31xAjT+z/5eu +Q4AW61WYZCMEpEfaDyE8K7FYnRzDfwcUEoVgBSQa60ereSA35RSBe+WQUTeAh+BCSAGdD7x5v8rDvAn8 +AeNB4G+APwFVLbWeU1YPxwAAAAASUVORK5CYII=" width="56" height="42" /> <img src="data:image/19116.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAAFAAAAAfCAYAAABwH0oUAAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAAEzkAABM5AGniRJxAAACu0lEQVRog +e2auWsVURSHv2OeCy7gEkGxcQFtxM7KwhW1ESwtopWChf4NLmBrJWinELQQNS7grqiFKMEVEUVMcIEUR +sUlLo8kn8VMQI0xLy95b2YgH1xeM/ee3/zenTN37rmQQ9R56h31pbpXXaZOyFpXYVAXq+0m9Kjv1NvqT +nWJOjFrjblGbVB3q93+Sa/6Vj2rblVnq2Oz1ptL1JnqrdS0gehQj6gb1ClZa84d6tr0Ef4fvWqX2qYeU +leqU+ulMeoVqBrUBuAGsIzKtAp8Ap4AF4HTwJuI+FwrjblHbUpnWDV8VS+q29XGrO8lE9QZ6uMqDex7x +HvSP+GculmdnfV91RV1/zAM/Jtv6nP1gEmOnaPmOpUNG3W9/Zc0I8FP9YG6y2TtOX6o2grhvLoAuALMq +2GYMnAXaAGuAk8iwsE6FcXAacAJYFUdwnUDH4FW4CiJqe0R0fuvi4tiYAk4DDTVOXQZaAfuAcfS386I6 +O67oGRx3khfM4g5DliUtk3AC+CC2gw8ioieUL9nIKwaSmnLGklm5lPgYKiDJspRBqSjROJmEWhIW9b0m +4FLMxZUKTuALRnG7wYeAteA46Q5sBQRrRmKqgiTTYUsUk0ZaANuAs3AM+Dj70uaPCTlSpgMzKpTrDLwA +bhPBevAohg4HZhf4xh9XyLHgAsR8aqSTkUxcD4wtwbjdpHMtKvAKeBFRPwcygBFMXA1MFK1j+/AG5Jv6 +xbgYUS8r3aw3Btosj2/bjhDpO0LcAY4D9yKiI4RkJd/A4E1wMIq+knyMrgBXAZORUTnCOoCcm5gutG5D +ZhUaRf+rImcBF5HxLfaKMw56gq1PMimaF9V7qm6T11uHatyucWkFnLd0brw0FHHqHsc+GTCSXWj2ujoy +YT+pPWJttS0XJ+NyetLpAvoJNkxbwYuAfci4kemqv7BL3J+bihPHgUNAAAAAElFTkSuQmCC" width="80" height="31" /> <img src="data:image/11868.PNG;base64,i +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" width="120" height="41" /></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Detect and calculate the necessary FOC motor and control parameters. The procedure is the following:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<ol style="margin-top: 0px; margin-bottom: 0px; margin-left: 0px; margin-right: 0px; -qt-list-indent: 1;"><li style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Measure <span style=" font-weight:600;">R</span> and <span style=" font-weight:600;">L</span> and wait for the detection result. When the detection result arrives, <span style=" font-weight:600;">KP</span>, <span style=" font-weight:600;">KI</span> and <span style=" font-weight:600;">Observer Gain</span> will be calculated.</li> +<li style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Measure <span style=" font-weight:600;">λ</span> and wait for the detection result. If the detections fails, tweak <span style=" font-weight:600;">I</span>, <span style=" font-weight:600;">D</span> and <span style=" font-weight:600;">ω </span>as described below and try again until it works.</li> +<li style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Use the <span style=" font-weight:600;">Apply</span> button to apply the measured and calculated parameters.</li></ol> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The following parameters are measured:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<ul style="margin-top: 0px; margin-bottom: 0px; margin-left: 0px; margin-right: 0px; -qt-list-indent: 1;"><li style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Resistance (R)</li> +<li style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Inductance (L)</li> +<li style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Flux Linkage (λ)</li></ul> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The following parameter are calculated from <span style=" font-weight:600;">R</span> and <span style=" font-weight:600;">L</span>:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<ul style="margin-top: 0px; margin-bottom: 0px; margin-left: 0px; margin-right: 0px; -qt-list-indent: 1;"><li style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Proportional gain for the current controller (KP)</li> +<li style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Integral gain for the current controller (KI)</li> +<li style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Gain for the observer</li></ul> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">For measuring resistance and inductance, signals are injected into the motor. Nothing requires configuration for doing that and the motor does not need to spin up.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">For measuring the flux linkage the motor needs to spin up, which is controlled by the <span style=" font-weight:600;">I</span>, <span style=" font-weight:600;">D</span> and <span style=" font-weight:600;">ω</span> startup settings. Notice that the resistance has to be measured first. The startup settings mean the following:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Current (I)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The current to use for spinning up the motor.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Duty (D)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The duty cycle where to measure the flux linkage.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">ERPM (ω)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The minimum speed for the delay commutation mode to start the motor.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">If the motor is not able to spin up properly these settings can be tweaked. Symptoms:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-style:italic;">The motor starts to spin, but is too weak to reach enough speed.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-style:italic;"><br /></p> +<ul style="margin-top: 0px; margin-bottom: 0px; margin-left: 0px; margin-right: 0px; -qt-list-indent: 1;"><li style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Increase the current setting.</li> +<li style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">If the load increases with speed (e.g. a propeller) you can decrease the duty cycle. This makes the detection slightly less accurate, but that does not matter in general.</li></ul> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-style:italic;">The motor cogs and is unable to spin up.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-style:italic;"><br /></p> +<ul style="margin-top: 0px; margin-bottom: 0px; margin-left: 0px; margin-right: 0px; -qt-list-indent: 1;"><li style=" font-style:italic;" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-style:normal;">Increase or decrease the current.</span></li> +<li style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">If the motor has high inertia decrease ERPM. E-bike hub motors tend to have high inertia.</li> +<li style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">If the motor has low inertia increase ERPM.</li></ul> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">After measuring the motor parameters, gain factors for the current PI control loop and the observer gain should be calculated. KP and KI are calculated based on a desired time constant of the current controller and the motor parameters R and L, which have to be measured first. The observer gain is calculated based on the motor inductance, which also has to be measured first.</p></body></html> + + + + Detect FOC Encoder Parameters + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Detect the following encoder parameters:</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<ul style="margin-top: 0px; margin-bottom: 0px; margin-left: 0px; margin-right: 0px; -qt-list-indent: 1;"><li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Offset</li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Ratio</li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Inverted</li></ul> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">To do that, the motor is turned slowly in open loop while the encoder output is sampled, once for the ratio and once for the offset. This is done in both directions for one full mechanical revolution to get rid off possible offsets and nonlinearities.</span></p></body></html> + + + + Detect FOC Hall Sensor Parameters + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Detect the hall sensor table. To do that, the motor is turned slowly in open loop while the hall sensor outputs are sampled. This is done in both directions to get rid of offsets.</span></p></body></html> + + + + Detect IMU Calibration + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Calibrate the IMU. This will set the curent IMU orientation to level. If your Pitch/Roll axes don't end up in the desired orientation, you can supply a yaw value.</span></p></body></html> + + + + NRF Pairing + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Set the VESC in NRF pairing mode for the amount of time specified in the Time box (default 10 seconds). Afer that, you should put the device to pair in pairing mode before the time runs out. A popup should appear and show that pairing was successful, or that it timed out. After a sucessful pairing, the NRF settings will be updated according to the unique ID of the paired NRF device and stored to the VESC.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">NRF Nunchuk</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">For pairing the NRF nunchuk, set the VESC in pairing mode and switch on a nunchuk (that was switched off previously) before the pairing time runs out.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Notice that the unique ID of the NRF nunchuk is based on a hashed version of its microcontroller UUID, so the pairing should still be valid even after updating firmware. The chance of collisions between NRF nunchuks is practically non-existent.</p></body></html> + + + + CAN Forwarding + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">When CAN forwarding is enabled, all communication will be forwarded over CAN bus to the VESC with the ID selected in the ID box in the connection page.</p></body></html> + + + + RT data logging + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">VESC Tool (mobile and desktop) can log realtime data to CSV files. The output directory has to be chosen, which is where the log files are stored. Each time the logging checkbox is checked, a new CSV file with the current date and time is created in the output directory. This means that toggling the box will store the current file create a new one, which can be convenient to split the logs.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The output format is as follows:</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><span style=" font-family:'Roboto';">ms_today;v_in;temp_mos;temp_mos_1;temp_mos_2;temp_mos_3;</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><span style=" font-family:'Roboto';">temp_motor;current_motor;current_in;id;iq;rpm;duty_now;amp_hours;</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><span style=" font-family:'Roboto';">amp_hours_charged;watt_hours;watt_hours_charged;tachometer;</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><span style=" font-family:'Roboto';">tachometer_abs;position;fault_code;vesc_id</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The values mean the following:</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">ms_today</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Time today in milliseconds. This time is sampled in VESC Tool, so it can contain jitter compared to the data values depending in transmission latency.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">temp_mos</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">MOSFET temperature in °C.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">temp_mos_1, temp_mos_2, temp_mos_3</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Individual MOSFET temperatures for the legs in the power stage in </span><span style=" font-family:'Roboto';">°C. Only available on hardware with individual temperature sensors, such as the VESC 75/300.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">temp_motor</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Motor temperature in °C.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">current_motor</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Motor current in A. The sign is the same as the input current, thus positive when the motor is driving and negative when the motor is generating.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">current_in</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Input current in A.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">id, iq</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">D-axis and Q-axis current of the motor. Only available in FOC mode.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">rpm</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Motor speed in electrical rouds per minute. Has to be divided by the number of pole pairs to get the mechanical speed.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">duty_now</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Modulation, range -1.0 to 1.0</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">amp_hours</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Ampere hours consumed from the input.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">amp_hours_charged</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Ampere hours fed back to the input.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">watt_hours</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Watt hours consumed from the input.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">watt_hours_charged</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Watt hours fed back to the input.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">tachometer</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">1/6 electrical revolution counter. Will count 6 steps for every electrical revolution of the motor. Has to be multiplied by the number of pole pairs to get 6 times the counts per mechanical revolution. Will count backwards when the motor is turning backwards.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">tachometer_abs</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Same as </span><span style=" font-family:'Roboto'; font-weight:600;">tachometer</span><span style=" font-family:'Roboto';">, but couts the absolute value</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">position</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Motor position in degrees. It is the mechanical position when using an encoder, the electrical position otherwise. In sensorless mode the position is not valid when the motor is not turning.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">fault_code</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Current fault code.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">vesc_id</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">CAN ID of this VESC.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p></body></html> + + + + Motor Setting Description + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p align="center" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Motor Settings</span></p> +<p align="center" style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-weight:600;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">This is where you can edit your motor settings. It is <span style=" color:#00A1E4;">very important</span> to setup your VESC every time you connect a different motor, otherwise the VESC and/or the motor are likely to get damaged. The easiest way to set up your VESC for your motor is to use the <span style=" font-weight:600;">Motor Setup Wizard</span>. This wizard can be accessed from the welcome page, from the help menu or using the button at the bottom of this page.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The motor settings are stored in their own configuration structure. Every time you make changes to the motor configuration you have to write the configuration to the VESC in order to apply the new settings. Reading/writing the motor configuration can be done using the buttons on the toolbar to the right. The functions of these toolbar buttons are the following:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><img src="data:image/18336.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAABLCAAASwgGgauYuAAABVklEQVRIi +e2TzSvsURzGP8eMWbGTndj4A2zE9iYlkZWSW2RjZeU/IOnGxn8wC3XLy9KCErYslNW9jZTU2LCQl8Toc +xeO+s2PMZPc3Tyrc57vc57vyzkH6qjjv0HtS+1n1E11sYJ+NsbnajH/od6qnQkur5bUB7UjpW9Wr9Qnd +T8Za/jAPAcsAU3Acip8AZwCYyl+GHgGjtN+7xIAU0BXXA+p/YlYCVgFxtVsgp8ANoC7D/zKqm9Ri5bjR +M3FERXU9jim3nimQ31Uu9XdaiMaBa6Bs7j/AwRg4E0QQjgH9oDJSP0E/gJHn1af6qQnVt+a4PJqIa5H4 +6U2x65mI1+1g1qxBbwAv4A24Hcl4ZcShBDugXVgGtgJIRQrabOVAjVgBbgEtj8TlSVQM0AGaIxULv6LU +vpgCKEALFSrIt3BCDAYk6wB84BAHjgEbqr4HfD66uqo4xvxDxCS2gMcR6zcAAAAAElFTkSuQmCC" width="24" height="24" /><br /><span style=" font-weight:600;">Read Motor Configuration</span>. This button will read the current motor configuration from the VESC to VESC Tool.</p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><span style=" color:#00A1E4;">Warning</span>: All of the motor settings currently in VESC Tool will be overwritten by pressing this button.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><img src="data:image/15613.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAABLCAAASwgGgauYuAAAB0ElEQVRIi +e2TP0iVURjGf+/VMhRpyGhxUaigyUGsCEKJ/kizNCQJbhG0FgXR2NgalHAdkjalqSGIaAhqKMLaCi80S +mZ5Ky/5a7jnk9Ptuy1tcR84fN/3PM95n/e8nA86+O8Rahcw3EZfiYjNf0pQu9SnaqNlvVJ3lviH1LdpH +S/RR9TlpI8U5JFUtMCWeibbdFYdS+8Hk+erWi0JuJ001aMF2a/WsoAlNbJNd9VPqbsiYF79ovZnvj71o +1otAipJuwbsAtaAOnA1Iswauwg8B+4AOxL3CFgHpjLfaaAHeFgQ3WoPMAvcSuLeiHiXHzsiGuoV4CUwl +uhNYAGYAeYSNwMsAp+3A4AhYE/q6EPiyrAM1IDDGVcFLqv7gW/ACWAyTWM7oA/YAjYiot6mOBHxU60Dv +Rn3Rn0NTNMcV43mKMcLTwVYSc8D7YoDqLuBQeB9i1QFLtAcz/2IaORiBVgFngGX8ptTgunkf9zCPwD2p +QYX2nV3TP2uXi8LUcfVdfVGdk2nMn1CPZV9n/ztP0jkbAp5op5XR9VJ9Z76Q51Tu8sCShr6MyAJo+qiu +paKbqgv1HPFydQB9aZ66C8Bw8kzWDpztRcYoHmzVtsV6qADAH4B7oGeIcdpjWQAAAAASUVORK5CYII=" width="24" height="24" /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><span style=" font-weight:600;">Read Default Motor Configuration</span>. This button will read the default motor configuration from the VESC to VESC Tool. The default configuration is hard-coded in firmware, and is how the VESC is configured right after uploading new firmware.</p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><span style=" color:#00A1E4;">Warning</span>: All of the motor settings currently in VESC Tool will be overwritten by pressing this button.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><img src="data:image/2057.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAABLCAAASwgGgauYuAAABcUlEQVRIi +e3UvY9McRTG8c8Zq5L5C0SIbK+hEZH9A0TIVkJCRaXaSiNRKv0Fxku8hEJBQbKxCo0tVLLBNiKhofCaM +GMfxdxiXDMZsu18m5vz3HPOc84vv3uZMWOz1GiQZBGHsAXb8AXBZezBAl5V1bl2oyRL2I8XVXV+rFuST +pKtSQ5kyPYm7iTpJRkk+Z5kV6uum+RDkp9JVkbfdf5Yp2qjqvoYNFK/qvpVtdHEb7GOY63ZDqOP5+2hO +21hCgNcx/EkcyP6SdzF180awG3sxj5ojusgro1L/m+DqnqDxzjVSCfwEqtTDZKcTbKGW430NMlakqOtu +itYTNI1PJ6rVZV/2eAGutjZxPP4gfutvAf4hYvYgZvjmv9lUFUfccHw7mueS83NGs37hjs4g0dV9W6Sw +dwYrYfT2It7VbU8ofYS3uPhpOYTSbKQ5HOS+RGtl+T1lLrl9oc2bgNVtZLkSFWtj8jP8GnKbE+0fj8zZ +mye3xJypFIwh222AAAAAElFTkSuQmCC" width="24" height="24" /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><span style=" font-weight:600;">Write Motor Configuration</span>. This button will write the motor configuration that currently is in VESC Tool to the VESC. Every time you make a change to the motor configuration in VESC Tool you must use this button to apply the new settings. The new settings will be used as soon as you write them to the VESC, and they will be stored in the flash memory of the VESC persistently.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Every motor setting has three small buttons to the right of its value. They have the following functions:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><img src="data:image/29987.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAAA7DAAAOwwHHb6hkAAAAtUlEQVQ4j +e2TOwrCQBRF7xO7kB24hCzA7EPBMuAKXIkrML1uJNZZg41lwDaeNKMGNXHyERsPDNyBx3mXgZF+ARAAg +c+sechM0s5d12bGkHICEuDqTjJUFgEFDwog6isLgZxXciDsI0zfyG6kXWUJULYIy6b3nDY4z5JWLm8kx +S5nkrYuXzq1rLXd15odPs1Pem35C78qHB2TJGAmaT7QdTSzk5xw0fIrfFk+N4ybl3uR3RuOSQVo+Pcrl +OWFigAAAABJRU5ErkJggg==" width="20" height="20" /><br /><span style=" font-weight:600;">Read Current Value</span>. This button will read the current value for this setting from the VESC.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><img src="data:image/2982.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAAA7DAAAOwwHHb6hkAAACCElEQVQ4j +a2US0uVURSGn3U0yy6W3a+DEqNJCU4iMioEIZo0iKioHEiTJo2aNG7UH8hBRdQsgm5YFAgFEREhRAQ1q +bygBTXITE3Jp8HZR0/H76gDX/jY7L32ete71rfWhnlGZB2qK4GtwHpgATAMdAPdETE6J2a1Qj2mdqq/1 +Qn/x4T6Tb2uNsyoUM0BN4BTSU0n8BroA8aApUA9cABoBMaB1oi4XU7d3qTgrrpmlkx2qz1qX5Y9l9YNl +KnnDJltyjJUluyPAC3qM+Al0Av8AWqA7UAzsAuoKBeplPAqsA3YDxwqUT0BfAduAjuAPXMh/BQRZ9UVQ +B2wEagChoAvwGfyP6Q9BciGejS1xl/1kXparVer1Zy6Sm1UK4t8lqg1sxG+VUecjmG1qcSnJdkG1Sup9 +aalfBl4ChwEGoDNwCKgA+hX2yLiWro7kNZlwIuImCpBkcIetVWtzcjiTlJfl/ar1VfqgNqrLs4iHEvrk +NqlPlQvpbEcUTuKfEJdrl5IQ9EEU41dwDmgDXhMftya01cFLAS+Fi5GhBHxM51FSn0y2r4U5V650VPfq +/3q2qKznPpEHVW3UGK4lUh/qffVi+oZ8y/QTvVEaqt36kn1sPog+bRnKahQj6vPnf58fUj1Op/apIBx8 +89Z9WQpyqRXS34EC5MyCHRFxA91HdBEvp3eRMTHLI55wz/tOPCh0cJ7OwAAAABJRU5ErkJggg==" width="20" height="20" /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><span style=" font-weight:600;">Read Default Value</span>. This button will read the default value for this setting from the VESC.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><img src="data:image/3626.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAAA7DAAAOwwHHb6hkAAABsUlEQVQ4j +a2Uu25TURBF10RIETVKAo1BRMJIQco34IrOHcqroEbwDbTg9PxBREEVBC30KYOJYiqIgo2QoEt4CLwoP +E6uTm6s8Jjqas+efebM3WfgP0dMSqrTQBNoJLQH9CLi+x+dos6p62pfHXocw8TW1bkzdajeBJ4As0AX2 +ATeZvoa0AZuAJ+A5Yh4NamzlnqoflaX1KkazpS6nJxDtXWa2Iw6UL+oC4XAVbVR8BeSO1Bn6gQ7OaOlC +nZB3VJ/qT/V5+r5Sn45azql2HQOe7t6TfVe/oy76v38vlN0v61+SEcwLr4OXAQ2I2JYOeslcBvYALYSm +x0nk/sMuJQaR4KXGf3xXrXziNiJiKfAN+AB8BV4UUyrl7UNgHMnhlkfD4FbwFpEvJlEHHf4HpDRq6iLH +8BjRv4so5m1e1XBXWAAtOu8lwfuRIRVMLntrN2lSI5ts1KqqV21W4OvZs2jEy2ksftp1sUiN6/OF9hic +vu1xk5SSz1I4sqEp7eWnIN8+0dx2nLYYOTL14x8NrZTk+Pl8BFYnbgciut31P2a9bWfudprnnXBXknoH +X+zYP8lfgOHlZEKN7DBYwAAAABJRU5ErkJggg==" width="20" height="20" /><br /><span style=" font-weight:600;">Show Help</span>. This button will show a help dialog describing what this setting does. If you are not sure about a setting the help dialog can be very useful.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The full motor configuration, including the notes you make on the <span style=" font-weight:600;">Description</span> page, can also be written to and read from XML files using the <span style=" font-weight:600;">File</span> menu. This is a good way to keep your settings when going between different VESC Tool versions, to share your settings and to store your configuration in general.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Notice that uploading new firmware to the VESC will reset all its settings to their default values for that firmware. This means that after uploading firmware to the VESC you have to perform the motor configuration again.</p></body></html> + + + + App Setting Description + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p align="center" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">App Settings</span></p> +<p align="center" style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-weight:600;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">This is where you can edit your app settings. The VESC can run one or more apps, and the apps are used to enable different functions on the communication interfaces of the VESC. If you are going to use your VESC with USB or CAN-bus you don't have to change the app configuration since these interfaces always are active. If you want to use conventional input devices such as nunchuks, ebike throttles or RC remote controllers you have to configure the apps accordingly.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The easiest way to configure your VESC for conventional input devices is to use the <span style=" font-weight:600;">Input Setup Wizard</span>. This wizard can be accessed from the welcome page, from the help menu or using the button at the bottom of this page.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The app settings are stored in their own configuration structure. Every time you make changes to the app configuration you have to write the configuration to the VESC in order to apply the new settings. Reading/writing the app configuration can be done using the buttons on the toolbar to the right. The functions of these toolbar buttons are the following:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><img src="data:image/7220.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAABLCAAASwgGgauYuAAABQklEQVRIi +e2SvyvFURyGn3O7UUQGUZSUkiwMMjLK4C+4IoPVZDCxyMBAKf+ATBjMMpso+QMkSoQU8rMewz1yffteX +Ve2+9Sp8znv2/t2TgcqVPg31EE1+4M+q26rPeWEN6jn6mQRvUl9UN/VtXIKFs1zpTak6FPqffTdqLW/C +e9SH/1iOaFn1AN1Q22Lt8iVGh7UHb/zpHYXePpi6FCc99TdUgt61SP1OIacxf1SgWdVPVWr4zymvqgdJ +ZUUBN2q44mzOvUiUViv3qlzaTlFv2ERhoFmoFWdj2cBuAVy6kII4e0vBRPANdAS1yeXQD8wAOyVlJR8I +rVdfVanU7xV6om6ntQyCWOI5iryV8/GOQuMAgJbyZAQwiuwCYyojd+0REEnMBPHGuAVeAcOyT9JJoQwQ +wrxK88BKyGE/TRPhQrl8QHWazO2mBBwJwAAAABJRU5ErkJggg==" width="24" height="24" /><br /><span style=" font-weight:600;">Read App Configuration</span>. This button will read the current app configuration from the VESC to VESC Tool.</p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><span style=" color:#00A1E4;">Warning</span>: All of the app settings currently in VESC Tool will be overwritten by pressing this button.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><img src="data:image/863.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAABLCAAASwgGgauYuAAABr0lEQVRIi +e3Ty4vPURgG8Ocwl0y5l2Q3YeGyURS2yIYsLCj3CIvZKFlI/gS7ScqClZ1LlMWsLKRsSEhMWUiYyaUI4 +zIfmzP19ev3G8pO89Rbp/d53ts5502m8N+jJAnmJ5nXhv9cSnn5z1WwFl/xvcUG/iL2FB7j6J+EF/yOh ++ip3HQcw4yWmC68wic8wLTJCuxpJP+JzQ2uH29wBV0N/7Y66UH8wPpOyWfhJZ5iHNdQWjSra6cHGr6ru +F0neYJznQrsxfva6X0s76A7i7soWIQvOFK50xjB7HaBgxiq54WTXONWfMQcHMdnzK3cUoxhdzNm4lH6k +nxMklLK604Fqqan2r4kN0op7ys3nOROkv3N6514sOdJdmJaKWV8kgIrk4wmWZFkWZJxXG7wC5P0J1mS5 +FlzguvVuTkdgN4kh5LcTLIjyYfa8ZuG3UryLcmudgku4gVWtOG6cB7vsAqjGOzQyCUMo7uVmImh+ohns +AFrcBj36i/bVPdlHOs6FNhS+Y3tyG4M4FH9IWN4W7d8cdVsx4nmwrXk6MPJiUUt7URVuCBJb5KRUspYJ +90UppBfSZTT+9DAGgIAAAAASUVORK5CYII=" width="24" height="24" /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><span style=" font-weight:600;">Read Default App Configuration</span>. This button will read the default app configuration from the VESC to VESC Tool. The default configuration is hard-coded in firmware, and is how the VESC is configured right after uploading new firmware.</p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><span style=" color:#00A1E4;">Warning</span>: All of the app settings currently in VESC Tool will be overwritten by pressing this button.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><img src="data:image/17702.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAABLCAAASwgGgauYuAAABZ0lEQVRIi +e2SP0vVYRTHP8c/DYreJVwTRJeG4L4AF99ALWU4KORLaBHCoCkyBEGctZaWFpdWXWxqcIiaMgpTRMggu +BfulY+DR/j146o/yPF+4cBz/ny/5znPc6CLLv4XUXTUCWAh3SGgCbSATxGxWqpdBO4BLyJit1I3NdT+t +N/qkzz3lupG1L9qW127SrPnn3EijIhWRLQAgXb6pyXedOaXgUfqYKUGVaD2ALPAJrAK1ID7N9YAqHP+9 +m8i4gewDczdZINZYB/YSn8DmFTHrmWqdfWz+iU/8FeelzM/pB6oSwXOsHqiPu+kWV7TAN4DDwrhBlCPi +K/qQ+Bd2reCxmOgDdzNBblyiolcwQu8LuQ+qEfqVsk+qqfq1LXPlEIvU/xQrWVsVG2qTzvU31L31LdVG +9TUn+p8IfZMbaijl3Be5V/cLsb7OhVHxB91BthJcgADwEpEfL/kXuvAHWAcOK40SRddVMIZ9sYKkh40m +jAAAAAASUVORK5CYII=" width="24" height="24" /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><span style=" font-weight:600;">Write App Configuration</span>. This button will write the app configuration that currently is in VESC Tool to the VESC. Every time you make a change to the app configuration in VESC Tool you must use this button to apply the new settings. The new settings will be used as soon as you write them to the VESC, and they will be stored in the flash memory of the VESC persistently.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Every app setting has three small buttons to the right of its value. They have the following functions:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><img src="data:image/19309.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAAA7DAAAOwwHHb6hkAAAAtUlEQVQ4j +e2TOwrCQBRF7xO7kB24hCzA7EPBMuAKXIkrML1uJNZZg41lwDaeNKMGNXHyERsPDNyBx3mXgZF+ARAAg +c+sechM0s5d12bGkHICEuDqTjJUFgEFDwog6isLgZxXciDsI0zfyG6kXWUJULYIy6b3nDY4z5JWLm8kx +S5nkrYuXzq1rLXd15odPs1Pem35C78qHB2TJGAmaT7QdTSzk5xw0fIrfFk+N4ybl3uR3RuOSQVo+Pcrl +OWFigAAAABJRU5ErkJggg==" width="20" height="20" /><br /><span style=" font-weight:600;">Read Current Value</span>. This button will read the current value for this setting from the VESC.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><img src="data:image/31745.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAAA7DAAAOwwHHb6hkAAACCElEQVQ4j +a2US0uVURSGn3U0yy6W3a+DEqNJCU4iMioEIZo0iKioHEiTJo2aNG7UH8hBRdQsgm5YFAgFEREhRAQ1q +bygBTXITE3Jp8HZR0/H76gDX/jY7L32ete71rfWhnlGZB2qK4GtwHpgATAMdAPdETE6J2a1Qj2mdqq/1 +Qn/x4T6Tb2uNsyoUM0BN4BTSU0n8BroA8aApUA9cABoBMaB1oi4XU7d3qTgrrpmlkx2qz1qX5Y9l9YNl +KnnDJltyjJUluyPAC3qM+Al0Av8AWqA7UAzsAuoKBeplPAqsA3YDxwqUT0BfAduAjuAPXMh/BQRZ9UVQ +B2wEagChoAvwGfyP6Q9BciGejS1xl/1kXparVer1Zy6Sm1UK4t8lqg1sxG+VUecjmG1qcSnJdkG1Sup9 +aalfBl4ChwEGoDNwCKgA+hX2yLiWro7kNZlwIuImCpBkcIetVWtzcjiTlJfl/ar1VfqgNqrLs4iHEvrk +NqlPlQvpbEcUTuKfEJdrl5IQ9EEU41dwDmgDXhMftya01cFLAS+Fi5GhBHxM51FSn0y2r4U5V650VPfq +/3q2qKznPpEHVW3UGK4lUh/qffVi+oZ8y/QTvVEaqt36kn1sPog+bRnKahQj6vPnf58fUj1Op/apIBx8 +89Z9WQpyqRXS34EC5MyCHRFxA91HdBEvp3eRMTHLI55wz/tOPCh0cJ7OwAAAABJRU5ErkJggg==" width="20" height="20" /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><span style=" font-weight:600;">Read Default Value</span>. This button will read the default value for this setting from the VESC.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:1; text-indent:0px;"><img src="data:image/29590.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAAA7DAAAOwwHHb6hkAAABsUlEQVQ4j +a2Uu25TURBF10RIETVKAo1BRMJIQco34IrOHcqroEbwDbTg9PxBREEVBC30KYOJYiqIgo2QoEt4CLwoP +E6uTm6s8Jjqas+efebM3WfgP0dMSqrTQBNoJLQH9CLi+x+dos6p62pfHXocw8TW1bkzdajeBJ4As0AX2 +ATeZvoa0AZuAJ+A5Yh4NamzlnqoflaX1KkazpS6nJxDtXWa2Iw6UL+oC4XAVbVR8BeSO1Bn6gQ7OaOlC +nZB3VJ/qT/V5+r5Sn45azql2HQOe7t6TfVe/oy76v38vlN0v61+SEcwLr4OXAQ2I2JYOeslcBvYALYSm +x0nk/sMuJQaR4KXGf3xXrXziNiJiKfAN+AB8BV4UUyrl7UNgHMnhlkfD4FbwFpEvJlEHHf4HpDRq6iLH +8BjRv4so5m1e1XBXWAAtOu8lwfuRIRVMLntrN2lSI5ts1KqqV21W4OvZs2jEy2ksftp1sUiN6/OF9hic +vu1xk5SSz1I4sqEp7eWnIN8+0dx2nLYYOTL14x8NrZTk+Pl8BFYnbgciut31P2a9bWfudprnnXBXknoH +X+zYP8lfgOHlZEKN7DBYwAAAABJRU5ErkJggg==" width="20" height="20" /><br /><span style=" font-weight:600;">Show Help</span>. This button will show a help dialog describing what this setting does. If you are not sure about a setting the help dialog can be very useful.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The full app configuration can also be written to and read from XML files using the <span style=" font-weight:600;">File</span> menu. This is a good way to keep your settings when going between different VESC Tool versions, to share your settings and to store your configuration in general.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Notice that uploading new firmware to the VESC will reset all its settings to their default values for that firmware. This means that after uploading firmware to the VESC you have to perform the app configuration again.</p></body></html> + + + + Data Analysis Description + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p align="center" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Data Analysis</span></p> +<p align="center" style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-weight:600;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Here you can stream and plot data from the VESC to analyze what is going on. Next to all plots the following buttons are available:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><img src="data:image/14240.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAACKZAAAimQETZNpHAAAA6UlEQVRIi +e2TPUoEQRCFv1o8wAZ7BBMz9QzKgoGBibF6CFNjD7DpZv6cwU30AJ7AQ8hgsozOZ1JgC73LKIog86CgK +arfq3rVDQMG/B+oW7XzTwrM1FHGrO+9jTWEm8Ax0EbE5Yqa8+S4jYinPl1O1FP1Xl2qrbq9agJ1J2uW6 +oN6pk5qxFP1Sm3Uzg806pF6qN4UAtfqQeabor5TX7J2CjBKjRYQ6CqDvWZY5CKtqVn8ljxtbZKxeqLeF +Rbt9rRokfaOS85PHUTEMzAH5sWS94DHSqcA+8AFfZe8Dt99pl8R+N2PNmDA3+EdH2UCNWAhxgQAAAAAS +UVORK5CYII=" width="24" height="24" /> <img src="data:image/25743.PNG;base64,i +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" width="24" height="24" /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">If this button is toggled active (blue), scolling with the mouse on the graph will zoom the graph horizontally.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><img src="data:image/31963.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAACKZAAAimQETZNpHAAABJUlEQVRIi +c2VMUoDURCGv6exEAQTD2AVGxtB8ARpJEVAGz2AtXZi6xG0t/IKtoYcwNrSKxhjobHws8gTF4vsvLCIP +zyYnd3v/cvsvFn4T1J7aq+EaRV6nAAC94VcvdSOOsmrE+WWCjwOgbW8DkpfsFbqyB+Nmt58S51WDKbqV +oSNlug4P/sKTHJ8FAGjXfQB7AGbwDLwBOwH2bjUvjooYVLNhtvAWSW1nplxJXeVUnpcyCCbzP1OKaXPe +fdLzsFCipTotJLaYDYqniu563klKpI6UPslTKhE6rm6w6ytW+quehFho+dgBXgA3vL1KnAZZOuldtX3X +6Oi25hBNhlWDIZRrqRNb5l1kDluVmpbfcmrHeXCv8yU0li9+44bN8i6ITBe/lRfq0es4mlJfQ0AAAAAS +UVORK5CYII=" width="24" height="24" /> <img src="data:image/17175.PNG;base64,i +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" width="24" height="24" /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">If this button is toggled active (blue), scolling with the mouse on the graph will zoom the graph vertically. Often it is useful to deactivate this button and only zoom in the horizontal direction because the sampled data can be squeezed together horizontally for long sampling sequences.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"> <img src="data:image/839.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAACdiAAAnYgHPiuanAAABbklEQVRIi +bXVPWsUURSH8f8NMUTBLqTSRMUXbEMEC0FQsLMVwc4PFhAUxMJGhAiiAQubaCd+B9lGiLhgsj+L3IVxd +hd39uU0d+49l+c558zAFMgSY7WukvTruogoSdaTlKGgn2Q3SW9Bgo0kh0nONjvolVJ+zEPFzSQnOS1Uk +qzMA2yA7+B1ks9JBu0k/MJmR+gKHuITTirnRc1tVqbOAqzjKb75N/5gZxGC5/htNPYbd2YXVMBVfGzAB +7g/TjDrSx4kOUpyUPdfknyYVE3XEV3CW2zjOvp41Loz24iwhX1sNc72cKazAGvYa+wvV/iFKQqZSvC4t +n8DV+pYLv4PPpUABYc1d4A32J4G3hZM+oruJdmpz3eTnE9yblpB2zaug3dGo49nXTsYEWAXxy34VzzB2 +iIEL+vZMd7jAUrHqYwX4Bp+4hVudYFOEqy2ciXJ7VLK91nh7RgKSk5/c71hBXNyNyozBbLEn/5QsLT4C +1/GbmAhMxLfAAAAAElFTkSuQmCC" width="24" height="24" /> <img src="data:image/13894.PNG;base64,i +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" width="24" height="24" /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">This is the auto fit button. If the toggle verion of the button is active (blue), new realtime data that drops in will cause a rezoom in the graph to fit all data. Deactivating this button can be useful of you want to zoom in on the realtime data manually while samples are dropping in.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><img src="data:image/23239.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAACdiAAAnYgHPiuanAAABbklEQVRIi +bXVPWsUURSH8f8NMUTBLqTSRMUXbEMEC0FQsLMVwc4PFhAUxMJGhAiiAQubaCd+B9lGiLhgsj+L3IVxd +hd39uU0d+49l+c558zAFMgSY7WukvTruogoSdaTlKGgn2Q3SW9Bgo0kh0nONjvolVJ+zEPFzSQnOS1Uk +qzMA2yA7+B1ks9JBu0k/MJmR+gKHuITTirnRc1tVqbOAqzjKb75N/5gZxGC5/htNPYbd2YXVMBVfGzAB +7g/TjDrSx4kOUpyUPdfknyYVE3XEV3CW2zjOvp41Loz24iwhX1sNc72cKazAGvYa+wvV/iFKQqZSvC4t +n8DV+pYLv4PPpUABYc1d4A32J4G3hZM+oruJdmpz3eTnE9yblpB2zaug3dGo49nXTsYEWAXxy34VzzB2 +iIEL+vZMd7jAUrHqYwX4Bp+4hVudYFOEqy2ciXJ7VLK91nh7RgKSk5/c71hBXNyNyozBbLEn/5QsLT4C +1/GbmAhMxLfAAAAAElFTkSuQmCC" width="24" height="24" /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">This is the non-toggle version of the auto fit button. Pressing it will zoom the plots so that all data fits in them.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Realtime Data</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The realtime data page can be used to stream and plot filtered data continuously, which can be useful for visualizing things in real time while they are happening. For example, if you run a motor and put some load on it, you can see that reflected right away in the current and RPM graphs. Tuning the position and speed PID control parameters is also a lot easier when looking at the step response in a graph.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">In ordet to stream realtime data, the <span style=" font-style:italic;">Stream realtime data</span> button in the main toolbar to the right has to be activated:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><img src="data:image/9960.PNG;base64,i +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 +II=" width="32" height="32" /></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Sampled Data</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The sampled data page can be used to sample data at high rate internally on the VESC and send it back for plotting after that. This page can be used to visualize all samples taken by the ADCs to analyze the current and voltage waveforms in detail. Since this data is sampled at such a high rate it cannot be streamed in real time, which is why sampling and plotting has to be toggled manually. There are two buttons for starting the sampling in the lower toolbar in this page:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><img src="data:image/3365.PNG;base64,i +VBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAA4WlDQ1BzUkdCAAAYlWNgYDzNAARMDgwMu +XklRUHuTgoRkVEKDEggMbm4gAE3YGRg+HYNRDIwXNYNLGHlx6MWG+AsAloIpD8AsUg6mM3IAmInQdgSI +HZ5SUEJkK0DYicXFIHYQBcz8BSFBDkD2T5AtkI6EjsJiZ2SWpwMZOcA2fEIv+XPZ2Cw+MLAwDwRIZY0j +YFhezsDg8QdhJjKQgYG/lYGhm2XEWKf/cH+ZRQ7VJJaUQIS8dN3ZChILEoESzODAjQtjYHh03IGBt5IB +gbhCwwMXNEQd4ABazEwoEkMJ0IAAHLYNoSjH0ezAAAACXBIWXMAAA7DAAAOwwHHb6hkAAAAy0lEQVRYh +e2VsRGCQBRE9xwjarACKtA+1JQarMQSiLURLIASzEwxfiYy6sEhyHEE3otufvB3b3ZnvhQZAZAAyZwGc +iCfSzzjRRZaPAWqNwMVkIYST4CSJmWQPjxzdzFtH6zcXUzTh5bcXfjvQ0fuLvz2ge7cXfjpA/1yd/G1D +8seHm6S9tbsIGljzQpJR2t277F/OMCp5bfnX3YtfJuLBqKBaCAaiAzF1A9gJWkdSPdijLl+TIDtiLM7l +F2tO3sJ7QjsGz8VRSOCv+UBobYCfWgtZnEAAAAASUVORK5CYII=" width="32" height="32" /> </p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Sample data now and send it when this is done.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><img src="data:image/22333.PNG;base64,i +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 +Z6fygf3f6rVX1TOmrF1AAAAAElFTkSuQmCC" width="32" height="32" /> </p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Sample data the next time the motor starts moving. This can be useful to analyze the startup behaviour in real time.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">There are also options to apply filters to the sampled data and/or to plot a FFT of all samples if desired.</p></body></html> + + + + App ADC Information + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The cruise control button will maintain the current speed while pressed when current control is used and no throttle is given. The reverse button is used to reverse the throttle when one of the corresponding control modes is used.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">When only the ADC app is used, the TX pin is used for the cruise control button and the RX pin is used for the reverse button. When the ADC and UART apps are used at the same time, the servo input will be used as the button. In this case it will be used for the reverse button when a control mode with button is selected, otherwise it will be used for the cruise control button.</span></p></body></html> + + + + Chuk Info + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">This app has been tested with the wireless Nyko Kama nunchuk. The receiver can be connected directly to the I2C port on the ESC. The y-axis on the joystick is used for acceleration/braking. The buttons have the following functions:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">C-Button:</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Cruise control. If the C-button is pressed, the ESC will maintail the current speed with a PID control loop. The joystick can still be used to accelerate and brake, but as soon as it is returned to the center position the new speed will be maintained, as long as the C-button remains pressed.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Z-Button:</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The Z-button is used to change the direction of the motor if reverse is activated. Without reverse, Z has no effect.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">There is also a safety function. If nothing received from the nunchuk (including the accelerometers) changes for longer than the timeout value in the <span style=" font-style:italic;">APP General</span> page, the timeout function will be activated and either release the motor or brake with the current specified next to the timeout value.</p></body></html> + + + + PPM Pulselength Mapping + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">PPM pulselength mapping is used to map the minimum and maximum throttle values from the PPM remote to the minimum and maximum throttle values of the VESC. The following procedure can be used:</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<ol style="margin-top: 0px; margin-bottom: 0px; margin-left: 0px; margin-right: 0px; -qt-list-indent: 1;"><li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Activate the PPM app and reboot the VESC.</li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Set the PPM control mode to disabled to avoid motor movement and write the configuration.</li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Connect the remote.</li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Activate app realtime data streaming in the main toolbar. The input display should show the decoded input value and pulse length if the remote is connected and on.</li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Move the throttle between the minimum and maximum values to get them sampled.</li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Apply the result.</li></ol> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Input mapping should also be usable for those oneshot pulselengths that are popular for some multirotor flight controllers that don't have support for proper ESC communication such as CAN-bus or UART.</span></p></body></html> + + + + ADC Voltage Mapping + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">ADC voltage mapping is used to map the minimum and maximum throttle values from the analog throttle to the minimum and maximum throttle values of the VESC. The following procedure can be used:</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<ol style="margin-top: 0px; margin-bottom: 0px; margin-left: 0px; margin-right: 0px; -qt-list-indent: 1;"><li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Activate the ADC app and write the app configuration to the VESC.</li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Set the ADC control mode to disabled to avoid motor movement and write the configuration.</li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Connect the throttle(s).</li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Activate realtime <span style=" font-weight:600;">app</span> data streaming in the main toolbar. The input displays should show the decoded input value and voltage if the throttle is connected.</li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Move the throttle between the minimum and maximum values to get them sampled.</li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Apply the result.</li></ol> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p></body></html> + + + + Welcome to VESC® Tool + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Welcome to <span style=" font-weight:600;">VESC</span> <span style=" font-weight:600;">Tool</span>. Since this is the first time you start this version of VESC Tool, the introduction is shown. Please read all instructions carefully for your own safety.</p></body></html> + + + + Usage + 3 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'arial,helvetica,sans-serif'; font-weight:600;">VESC® Tool</span><span style=" font-family:'arial,helvetica,sans-serif';"> and the </span><span style=" font-family:'arial,helvetica,sans-serif'; font-weight:600;">VESC® firmware</span><span style=" font-family:'arial,helvetica,sans-serif';"> are experimental software designed to develop and test electrical systems incorporating electric motors or actuators. Electrical systems can cause danger to humans, property and nature; therefore precautions shall be taken to avoid any risk. Under no circumstances shall the software be used where humans or property are put to risk without </span><span style=" font-family:'arial,helvetica,sans-serif';">thoroughly</span><span style=" font-family:'arial,helvetica,sans-serif';"> validating and testing the whole system. Software and hardware interact in various ways, and software developers cannot foresee all possible combinations of hardware used together with their software, nor problems that can occur in these different combinations.</span> </p> +<p style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'arial,helvetica,sans-serif';">Things that can happen, even when using the correct settings, are</span></p> +<ul style="margin-top: 0px; margin-bottom: 0px; margin-left: 0px; margin-right: 0px; -qt-list-indent: 1;"><li style=" font-family:'arial,helvetica,sans-serif';" style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">electrical failure</li> +<li style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'arial,helvetica,sans-serif';">fire</span></li> +<li style=" font-family:'arial,helvetica,sans-serif';" style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">electric shock</li> +<li style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'arial,helvetica,sans-serif';">hazardous smoke</span></li> +<li style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'arial,helvetica,sans-serif';">overheating motors and actuators</span></li> +<li style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'arial,helvetica,sans-serif';">overstrained power sources, causing fire or explosions (e.g. Lithium Ion Batteries)</span></li> +<li style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'arial,helvetica,sans-serif';">motors or actuators stopping from spinning/moving</span></li> +<li style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'arial,helvetica,sans-serif';">motors or actuators locking in, acting like a brake (full stop)</span></li> +<li style=" font-family:'arial,helvetica,sans-serif';" style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">motors or actuators losing control over torque production (uncontrolled acceleration or braking)</li> +<li style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'arial,helvetica,sans-serif';">interferences with other systems</span></li> +<li style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'arial,helvetica,sans-serif';">other non-intended or unforeseeable behavior of the system</span></li></ul> +<p style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'arial,helvetica,sans-serif';">VESC Tool and the VESC firmware are developer tools that for safety reasons may only be used</span></p> +<ul style="margin-top: 0px; margin-bottom: 0px; margin-left: 0px; margin-right: 0px; -qt-list-indent: 1;"><li style=" font-family:'arial,helvetica,sans-serif';" style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">by experts and experienced users, knowing exactly what they do.</li> +<li style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'arial,helvetica,sans-serif';">following safety standards applicable in the area of usage.</span></li> +<li style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'arial,helvetica,sans-serif';">under safe conditions where software or hardware malfunction will not lead to death, injuries or severe property damage.</span></li> +<li style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'arial,helvetica,sans-serif';">keeping in mind that software and hardware failures can happen. Although we design our products to minimize such issues, you should always operate with the understanding that a failure can occur at any point of time and without warning. As such, you shall take the appropriate precautions to minimize danger in case of failure.</span> </li></ul></body></html> + + Important usage information + + + Warranty + 3 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">LIMITED WARRANTY STATEMENT </span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">1. Warranty</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">1.1 THERE IS NO WARRANTY FOR THE VESC® SOFTWARE (VESC TOOL AND THE VESC FIRMWARE - PROGRAM FOR SHORT) TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. </span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">1.2 Benjamin Vedder and contributors (the publisher(s) for short) shall not be liable for any defects that are caused by neglect, misuse or mistreatment by the Customer, including improper installation or testing, or for any products that have been altered or modified in any way by the Customer. Moreover, the publisher(s) shall not be liable for any defects that result from the Customers design, specifications or instructions for such products. Testing and other quality control techniques are used to the extent the publisher(s) deems necessary. </span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">1.3 The Customer agrees that prior to using any systems that include Open Source VESC® Software, the Customer will test such systems and the functionality of the products as used in such systems. The publisher(s) may provide technical, applications or design advice, quality characterization, reliability data or other services. The Customer acknowledges and agrees that providing these services shall not expand or otherwise alter the publisher(s) warranties, as set forth above, and that no additional obligations or liabilities shall arise from the publisher(s) providing such services. </span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">1.4 VESC® software products are not authorized for use in safety-critical applications where a failure of the Open Source VESC® software would reasonably be expected to cause severe personal injury or death. Safety-critical applications include, without limitation, life support devices and systems, equipment or systems for the operation of nuclear facilities and weapons systems. Open Source VESC® software is neither designed nor intended for use in military or aerospace applications or environments, nor for automotive applications or the automotive environment. The Customer acknowledges and agrees that any such use of VESC® software is solely at the Customer's risk, and that the Customer is solely responsible for compliance with all legal and regulatory requirements in connection with such use. </span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">1.5 The Customer acknowledges and agrees that the Customer is solely responsible for compliance with all legal, regulatory and safety-related requirements concerning the products and any use of the publisher(s) softwrae products in the Customer's applications, not withstanding any applications-related information or support that may be provided by the publisher(s). </span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">2. Limitation of Liability </span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED THROUGH THE GNU GENERAL PUBLIC LICENSE (GNU GPL), BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. </span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">This section will survive the termination of the warranty period. </span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">3. Consequential Damages Waiver.</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">In no event shall the publisher(s) be liable to the Customer or any third parties for any special, collateral, indirect, punitive, incidental, consequential or exemplary damages in connection with or arising out of the products provided hereunder, regardless of whether the publisher(s) has been advised of the possibility of such damages. </span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">This section will survive the termination of the warranty period. </span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">4. Changes to Specifications.</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">The publisher(s) may make changes to specifications and product descriptions at any time, without notice. The Customer must not rely on the absence or characteristics of any features or instructions marked, reserved or undefined. The publisher(s) reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The product information on the Web Site or Materials is subject to change without notice. Do not finalize a design with this information. </span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">5. Statutory laws. *</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">(i) some countries, regions, states or provinces do not allow the exclusion or limitation of remedies or of incidental, punitive, or consequential damages, or the applicable time periods, so the above limitations or exclusions may not apply.</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">(ii) except to the extent lawfully permitted, this limited warranty does not exclude, restrict or modify statutory rights applicable to where the product is sold but, rather, is in addition to these rights.</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">(*) European Consumer Centres provide information on EU-wide consumer laws as well as consumer laws for specific countries: http://ec.europa.eu/consumers/ecc/contact_en.htm </span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Times New Roman,serif';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">The LIMITED WARRANTY STATEMENT is released as Creative Commons Attribution ShareAlike 3.0. </span></p> +<p style=" margin-top:0px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Times New Roman,serif';">This means you can use it on your own derived works, in part or completely, as long as you also adopt the same license. You find the complete text of the license at https://creativecommons.org/licenses/by-sa/3.0/legalcode</span></p></body></html> + + LIMITED WARRANTY STATEMENT + + + Conclusion + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">You are now ready to start using VESC Tool. If you have any questions, visit </span></p> +<p style=" margin-top:12px; margin-bottom:12px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><a href="http://vesc-project.com/forum"><span style=" font-family:'Roboto'; text-decoration: underline; color:#5555ff;">http://vesc-project.com/forum</span></a></p></body></html> + + + + License + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">GNU GENERAL PUBLIC LICENSE</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Version 3, 29 June 2007</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Copyright © 2007 Free Software Foundation, Inc. &lt;</span><a href="https://fsf.org/"><span style=" font-family:'Helvetica, serif'; text-decoration: underline; color:#0000ff;">https://fsf.org/</span></a><span style=" font-family:'Helvetica, serif';">&gt;</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">Preamble</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">The GNU General Public License is a free, copyleft license for software and other kinds of works.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You can apply it to your programs, too.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">The precise terms and conditions for copying, distribution and modification follow.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">TERMS AND CONDITIONS</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">0. Definitions.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">“<span style=" font-family:'Helvetica, serif';">This License” refers to version 3 of the GNU General Public License.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">“<span style=" font-family:'Helvetica, serif';">Copyright” also means copyright-like laws that apply to other kinds of works, such as semiconductor masks.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">“<span style=" font-family:'Helvetica, serif';">The Program” refers to any copyrightable work licensed under this License. Each licensee is addressed as “you”. “Licensees” and “recipients” may be individuals or organizations.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">To “modify” a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a “modified version” of the earlier work or a work “based on” the earlier work.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">A “covered work” means either the unmodified Program or a work based on the Program.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">To “propagate” a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">To “convey” a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">An interactive user interface displays “Appropriate Legal Notices” to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">1. Source Code.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">The “source code” for a work means the preferred form of the work for making modifications to it. “Object code” means any non-source form of a work.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">A “Standard Interface” means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">The “System Libraries” of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A “Major Component”, in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">The “Corresponding Source” for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">The Corresponding Source for a work in source code form is that same work.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">2. Basic Permissions.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">3. Protecting Users' Legal Rights From Anti-Circumvention Law.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">4. Conveying Verbatim Copies.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">5. Conveying Modified Source Versions.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions:</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">•<span style=" font-family:'Helvetica, serif';"> a) The work must carry prominent notices stating that you modified it, and giving a relevant date.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">•<span style=" font-family:'Helvetica, serif';"> b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to “keep intact all notices”.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">•<span style=" font-family:'Helvetica, serif';"> c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">•<span style=" font-family:'Helvetica, serif';"> d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an “aggregate” if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">6. Conveying Non-Source Forms.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways:</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">•<span style=" font-family:'Helvetica, serif';"> a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">•<span style=" font-family:'Helvetica, serif';"> b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">•<span style=" font-family:'Helvetica, serif';"> c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">•<span style=" font-family:'Helvetica, serif';"> d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">•<span style=" font-family:'Helvetica, serif';"> e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">A “User Product” is either (1) a “consumer product”, which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, “normally used” refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">“<span style=" font-family:'Helvetica, serif';">Installation Information” for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM).</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">7. Additional Terms.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">“<span style=" font-family:'Helvetica, serif';">Additional permissions” are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms:</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">•<span style=" font-family:'Helvetica, serif';"> a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">•<span style=" font-family:'Helvetica, serif';"> b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">•<span style=" font-family:'Helvetica, serif';"> c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">•<span style=" font-family:'Helvetica, serif';"> d) Limiting the use for publicity purposes of names of licensors or authors of the material; or</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">•<span style=" font-family:'Helvetica, serif';"> e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;">•<span style=" font-family:'Helvetica, serif';"> f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">All other non-permissive additional terms are considered “further restrictions” within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">8. Termination.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11).</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">9. Acceptance Not Required for Having Copies.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">10. Automatic Licensing of Downstream Recipients.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">An “entity transaction” is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">11. Patents.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">A “contributor” is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's “contributor version”.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">A contributor's “essential patent claims” are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, “control” includes the right to grant patent sublicenses in a manner consistent with the requirements of this License.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">In the following three paragraphs, a “patent license” is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To “grant” such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. “Knowingly relying” means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">A patent license is “discriminatory” if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">12. No Surrender of Others' Freedom.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">13. Use with the GNU Affero General Public License.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">14. Revised Versions of this License.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License “or any later version” applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">15. Disclaimer of Warranty.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">16. Limitation of Liability.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">17. Interpretation of Sections 15 and 16.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">END OF TERMS AND CONDITIONS</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif'; font-weight:600;">How to Apply These Terms to Your New Programs</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the “copyright” line and a pointer to where the full notice is found.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Courier, serif';">&lt;one line to give the program's name and a brief idea of what it does.&gt;</span><br /><span style=" font-family:'Courier, serif';">Copyright (C) &lt;year&gt; &lt;name of author&gt;</span><br /><br /><span style=" font-family:'Courier, serif';">This program is free software: you can redistribute it and/or modify</span><br /><span style=" font-family:'Courier, serif';">it under the terms of the GNU General Public License as published by</span><br /><span style=" font-family:'Courier, serif';">the Free Software Foundation, either version 3 of the License, or</span><br /><span style=" font-family:'Courier, serif';">(at your option) any later version.</span><br /><br /><span style=" font-family:'Courier, serif';">This program is distributed in the hope that it will be useful,</span><br /><span style=" font-family:'Courier, serif';">but WITHOUT ANY WARRANTY; without even the implied warranty of</span><br /><span style=" font-family:'Courier, serif';">MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the</span><br /><span style=" font-family:'Courier, serif';">GNU General Public License for more details.</span><br /><br /><span style=" font-family:'Courier, serif';">You should have received a copy of the GNU General Public License</span><br /><span style=" font-family:'Courier, serif';">along with this program. If not, see &lt;https://www.gnu.org/licenses/&gt;.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">Also add information on how to contact you by electronic and paper mail.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">If the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode:</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Courier, serif';">&lt;program&gt; Copyright (C) &lt;year&gt; &lt;name of author&gt;</span><br /><span style=" font-family:'Courier, serif';">This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.</span><br /><span style=" font-family:'Courier, serif';">This is free software, and you are welcome to redistribute it</span><br /><span style=" font-family:'Courier, serif';">under certain conditions; type `show c' for details.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, your program's commands might be different; for a GUI interface, you would use an “about box”.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">You should also get your employer (if you work as a programmer) or school, if any, to sign a “copyright disclaimer” for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see &lt;</span><a href="https://www.gnu.org/licenses/"><span style=" font-family:'Helvetica, serif'; text-decoration: underline; color:#0000ff;">https://www.gnu.org/licenses/</span></a><span style=" font-family:'Helvetica, serif';">&gt;.</span></p> +<p style=" margin-top:12px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; line-height:100%;"><span style=" font-family:'Helvetica, serif';">The GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read &lt;</span><a href="https://www.gnu.org/licenses/why-not-lgpl.html"><span style=" font-family:'Helvetica, serif'; text-decoration: underline; color:#0000ff;">https://www.gnu.org/licenses/why-not-lgpl.html</span></a><span style=" font-family:'Helvetica, serif';">&gt;.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p></body></html> + + + + License + 0 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">This app is distributed under the Apple EULA for this platform. This license is issued by Benjamin Vedder, Benjamin@vedder.se. Distribution and maintenance of the application is managed by Jeffrey Friesen and questions and correspondence should be directed to Jfriesen222@gmail.com.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">All source code for this application is also available open-source under the GPLv3 license and is available for compilation across many platforms here: </p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><a href="https://github.com/vedderb/vesc_tool"><span style=" text-decoration: underline; color:#419cff;">https://github.com/vedderb/vesc_tool</span></a></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; text-decoration: underline; color:#419cff;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">All libraries and appropriate licensing information can be found within this repository as well. </p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; text-decoration: underline; color:#419cff;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">More informati<span style=" color:#dcdcdc;">on regarding the VESC®</span> Project can be found here:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><a href="https://vesc-project.com/"><span style=" text-decoration: underline; color:#419cff;">https://vesc-project.com/</span></a></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; text-decoration: underline; color:#419cff;"><br /></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; color:#dcdcdc;"><br /></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; color:#dcdcdc;"><br /></p></body></html> + + + + + + diff --git a/res/config/6.00/parameters_appconf.xml b/res/config/6.00/parameters_appconf.xml new file mode 100644 index 000000000..42c1dcbc6 --- /dev/null +++ b/res/config/6.00/parameters_appconf.xml @@ -0,0 +1,4244 @@ + + + + + VESC ID + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">VESC ID. Used to identify this VESC on the CAN-bus.</span></p></body></html> + APPCONF_CONTROLLER_ID + 1 + 0 + 255 + 0 + 0 + 1 + 74 + + 1 + + + Timeout + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Switch off the motor when no input has beed received for this amount of time. Notice that VESC Tool will send alive packets while connected, so the timeout won't occur before you disconnect VESC Tool even if the input gets disconnected.</p></body></html> + APPCONF_TIMEOUT_MSEC + 1 + 0 + 30000000 + 0 + 0 + 1 + 1000 + ms + 5 + + + Timeout Brake Current + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Apply brake with this amount of current after a timeout.</p></body></html> + APPCONF_TIMEOUT_BRAKE_CURRENT + 2 + 1 + 0 + 500 + 0 + 0 + 1 + 0 + 1000 + A + 9 + + + Can Status Message Mode + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Send a status message on the CAN bus with a periodic interval. Useful for letting other VESCs know which VESCs are on the CAN-bus. This is required by some apps to function with multiple VESCs. The master VESC of the app does not need this option checked.</span></p></body></html> + APPCONF_SEND_CAN_STATUS + 0 + CAN_STATUS_DISABLED + CAN_STATUS_1 + CAN_STATUS_1_2 + CAN_STATUS_1_2_3 + CAN_STATUS_1_2_3_4 + CAN_STATUS_1_2_3_4_5 + + + Can Status Rate + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Rate at which CAN status messages are sent on the CAN-bus.</span></p></body></html> + APPCONF_SEND_CAN_STATUS_RATE_HZ + 1 + 0 + 10000 + 0 + 0 + 1 + 50 + Hz + 3 + + + CAN Baud Rate + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The baud rate of the CAN-Bus. Note that all devices on the bus must have the same baud rate.</span></p></body></html> + APPCONF_CAN_BAUD_RATE + 2 + CAN_BAUD_125K + CAN_BAUD_250K + CAN_BAUD_500K + CAN_BAUD_1M + CAN_BAUD_10K + CAN_BAUD_20K + CAN_BAUD_50K + CAN_BAUD_75K + CAN_BAUD_100K + + + Pairing Done + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Pairing done flag. If this flag is set, a bluetooth connection can only be made if the VESC Tool instance making the connection has been paired to this VESC. The pairing is done by storing the UUID of the VESC in the pairing list.</span></p></body></html> + APPCONF_PAIRING_DONE + 0 + + + Enable Permanent UART + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Enable the permanent UART port (if the hardware has one). This port can be connected to e.g. the NRF51 for providing a BLE link. You may want to disable this to prevent access to your VESC over BLE.</span></p></body></html> + APPCONF_PERMANENT_UART_ENABLED + 1 + + + Shutdown Mode + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Shutdown mode for hardware that supports it (such as the VESC HD). Determines how the VESC shuts itself off, which eliminates the need for an external switch.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">NOTE:</span> Most VESCs with this feature also support push to start, which means that the VESC will switch on as soon as the motor is turned at a minimum speed.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The available modes are:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">ALWAYS_OFF</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The VESC power is only determined by the inverted state of the shutdown input.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">ALWAYS_ON</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The VESC always stays on ofter being powered.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">TOGGLE_BUTTON_ONLY</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">A normally closed (NC) momentary button can be connected to the shutfown input to toggle the power on or off. The VESC will sample the button and determine whether it is pressed, which can be used to shut down after the button is released.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">OFF_AFTER_x</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Same as the TOGGLE_BUTTON_ONLY mode, but the VESC will shut down after X time of inactivity. This mode is useful for setups without any switch at all if the hardware suports push to start, such as the VESC HD.</p></body></html> + APPCONF_SHUTDOWN_MODE + 7 + ALWAYS_OFF + ALWAYS_ON + TOGGLE_BUTTON_ONLY + OFF_AFTER_10S + OFF_AFTER_1M + OFF_AFTER_5M + OFF_AFTER_10M + OFF_AFTER_30M + OFF_AFTER_1H + OFF_AFTER_5H + + + CAN Mode + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">CAN-bus mode.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">VESC</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Default VESC CAN-bus. Required for CAN forwarding and configuring multiple VESCs using VESC Tool.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">UAVCAN</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Basic implementation of UAVCAN. Currently needs some work.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Comm Brigde</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Bridge CAN-bus to commands. Useful for using the VESC as a generic CAN interface.</span></p></body></html> + APPCONF_CAN_MODE + 0 + VESC + UAVCAN + Comm Bridge + + + UAVCAN ESC Index + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">ESC index in UAVCAN messages.</span></p></body></html> + APPCONF_UAVCAN_ESC_INDEX + 1 + 0 + 255 + 0 + 0 + 1 + 0 + + 1 + + + UAVCAN Raw Throttle Mode + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Drive mode for the raw throttle command in UAVCAN.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Current Control</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The raw command corresponds to a fraction of the configured current limit. 1.0 is maximum current forwards and -1.0 is maximum current reverse.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-weight:600;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Current No Reverse Brake</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Same as current control, but negative values only give braking and don't start the motor in the other direction.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-weight:600;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Duty Cycle Control</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Duty cycle control.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-weight:600;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">RPM Control</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">RPM control. Use the raw command times the maximum configured ERPM value. Negative values will run the motor in reverse. Note that this will set the value in ERPM, so the RPM will be scaled by the number of pole pairs.</p></body></html> + APPCONF_UAVCAN_RAW_MODE + 0 + Current Control + Current No Reverse Brake + Duty Cycle Control + RPM Control + + + UAVCAN Raw RPM Max + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Maximum ERPM for the RPM mode of the raw command.</p></body></html> + APPCONF_UAVCAN_RAW_RPM_MAX + 0 + 1 + 0 + 400000 + 0 + 0 + 100 + 50000 + 1 + + 9 + + + Enable Servo Output + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Enable servo output on PPM-port when PPM-app is disabled.</span></p></body></html> + APPCONF_SERVO_OUT_ENABLE + 0 + + + Kill Switch Mode + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Kill switch input. When this input is active the motor is disabled and optionally braking if timeout_brake_current is greater than 0. The kill switch overrides all other inputs and can be used as an emergency stop.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The following modes can be used:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Disabled</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">No kill switch is used.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">PPM Low</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The kill switch is active when the PPM input goes low.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">PPM High</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The kill switch is active when the PPM input goes high.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">ADC2 Low</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The kill switch is active when the ADC2 input goes low.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">ADC2 High</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The kill switch is active when the ADC2 input goes high.</p></body></html> + APPCONF_KILL_SW_MODE + 0 + Disabled + PPM Low + PPM High + ADC2 Low + ADC2 High + + + APP to Use + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The APP to use. With multiple VESC connected over CAN only the master needs to have an app to use set up. Notice that using the NRF nunchuk needs the NRF app.</span></p></body></html> + APPCONF_APP_TO_USE + 3 + No App + PPM + ADC + UART + PPM and UART + ADC and UART + Nunchuk (I2C, Nyko Kama) + NRF + Custom User App + Balance + PAS + ADC and PAS + + + Control Type + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Off</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The output is switched off regardless of the input.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Current</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Current control. The output is off when the input is centered. Input less than center brakes until the motor stops, at which point it it starts in the reverse direction.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Current No Reverse</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Current control. The output is off when the input is at minimum.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Current No Reverse With Brake</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Current control. The output is off when the input is centered. Input less than center brakes until the motor stops, but not further.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Duty Cycle</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Current control. The output is off when the input is centered. Input less than center gives negative duty cycle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Duty Cycle No Reverse</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Duty cycle control. The output is off when the input is at minimum.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">PID Speed Control</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">PID speed control. The output is off when the input is centered. Input less than center gives negative set speed.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">PID Speed Control No Reverse</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Duty cycle control. The output is off when the input is at minimum.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Current Hyst Reverse With Brake</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Current Hyst Reverse With Brake. The output is off when the input is centered. Input less than center brakes until the motor stops, at which point it starts in the reverse direction, but if Max dir switch ERPM is enabled it will stop the reverse when it reaches the Max ERPM for direction switch.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Current Smart Reverse</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Similar to the </span><span style=" font-family:'Roboto'; font-weight:600;">Current No Reverse With Brake </span><span style=" font-family:'Roboto';">mode, but</span><span style=" font-family:'Roboto';"> holding full brake will switch to duty cycle mode in the reverse direction when the speed is so low that not enough brake torque can be produced. This is useful when trying to stop downhill where you normally would roll forwards slowly even at full brake. Instead, the board will start to go reverse slowly in duty cycle mode if this mode is activated.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto'; font-weight:600;"><br /></p></body></html> + APPCONF_PPM_CTRL_TYPE + 0 + Off + Current + Current No Reverse + Current No Reverse With Brake + Duty Cycle + Duty Cycle No Reverse + PID Speed Control + PID Speed Control No Reverse + Current Hyst Reverse With Brake + Current Smart Reverse + + + PID Max ERPM + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The ERPM setpoint corresponding to max input when using PID Speed Control.</p></body></html> + APPCONF_PPM_PID_MAX_ERPM + 2 + 1 + 0 + 1e+06 + 0 + 0 + 100 + 15000 + 1000 + + 9 + + + Input Deadband + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; ;">Deadband region for the input.</span></p></body></html> + APPCONF_PPM_HYST + 0 + 100 + 0 + 1 + 0 + 1 + 1 + 0.15 + 1000 + % + 9 + + + Pulselength Start + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The shortest pulse length for the PPM input </span><span style=" font-family:'Roboto';">in milliseconds</span><span style=" font-family:'Roboto';">. Can be checked by enabling display and giving the minimum input.</span></p></body></html> + APPCONF_PPM_PULSE_START + 4 + 1 + 0 + 100 + 0 + 0 + 0.1 + 1 + 1000 + ms + 9 + + + Pulselength End + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The longest pulse length for the PPM input </span><span style=" font-family:'Roboto';">in milliseconds</span><span style=" font-family:'Roboto';">. Can be checked by enabling display and giving the maximum input.</span></p></body></html> + APPCONF_PPM_PULSE_END + 4 + 1 + 0 + 100 + 0 + 0 + 0.1 + 2 + 1000 + ms + 9 + + + Pulselength Center + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The PPM input in milliseconds at which the throttle is centered. Can be checked by enabling display and leaving the throttle centered. This setting has no effect in control modes where the output is not off when the stick is centered.</span></p></body></html> + APPCONF_PPM_PULSE_CENTER + 4 + 1 + 0 + 100 + 0 + 0 + 0.1 + 1.5 + 1000 + ms + 9 + + + Median Filter + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Use a median filter on the decoded pulses. Will delay the signal slightly, but rejects outliers caused by noise.</p></body></html> + APPCONF_PPM_MEDIAN_FILTER + 1 + + + Safe Start + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Prevent motor from starting in some unsafe conditions. Modes:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Disabled</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Motor can always start.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Regular</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Only allow starting the motor when the input has beed zero for long enough after boot, after configuration updates and after faults.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">No Faults</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Same as regular, but the motor can start directly after fault codes are cleared.</p></body></html> + APPCONF_PPM_SAFE_START + 1 + Disabled + Regular + No Fault + + + Throttle Expo + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Exponential gain for the throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Zero (0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Linear throttle</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Negative (&lt;0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The throttle is softer close to 0 and increases exponentially towards full throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Positive (&gt;0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The throttle reacts fast around 0 and decreases exponentially towards full throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Increasing the magnitude of this value will increase the exponential effect. The full throttle curve can be seen in the throttle curve plot.</span></p></body></html> + APPCONF_PPM_THROTTLE_EXP + 2 + 1 + 1 + 5 + -5 + 1 + 1 + 0 + 1 + + 9 + + + Throttle Expo Brake + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Exponential gain for the throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Zero (0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Linear throttle</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Negative (&lt;0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The throttle is softer close to 0 and increases exponentially towards full throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Positive (&gt;0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The throttle reacts fast around 0 and decreases exponentially towards full throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Increasing the magnitude of this value will increase the exponential effect. The full throttle curve can be seen in the throttle curve plot.</span></p></body></html> + APPCONF_PPM_THROTTLE_EXP_BRAKE + 2 + 1 + 1 + 5 + -5 + 1 + 1 + 0 + 1 + + 9 + + + Throttle Expo Mode + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The throttle curve mode.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Exponential</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">y = x^(1 + c)</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Natural</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">y = (e^(cx) - 1) / (e^c - 1)</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Polynomial</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">y = x / (1 + c(1 - x))</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">where</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">y:</span> output</p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">x:</span> input</p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">c:</span> curve</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The curve parameter, offsets and signs are mapped accordingly for each mode.</p></body></html> + APPCONF_PPM_THROTTLE_EXP_MODE + 2 + Exponential + Natural + Polynomial + + + Positive Ramping Time + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Positive ramping time constant. This filters the input with ramping. This constant represents the amount of secods it takes to ramp from zero to full output.</span></p></body></html> + APPCONF_PPM_RAMP_TIME_POS + 2 + 1 + 0 + 1000 + 0 + 0 + 0.1 + 0.4 + 1000 + s + 9 + + + Negative Ramping Time + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Negative ramping time constant. This filters the input with ramping. This constant represents the amount of secods it takes to ramp from full output (acceleration or braking) back to zero.</span></p></body></html> + APPCONF_PPM_RAMP_TIME_NEG + 2 + 1 + 0 + 1000 + 0 + 0 + 0.1 + 0.2 + 1000 + s + 9 + + + Multiple VESCs Over CAN + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Listen for other VESCs on the CAN-bus and send the same control commands to them. Notice that the application only has to be set up on the master VESC.</p></body></html> + APPCONF_PPM_MULTI_ESC + 1 + + + Traction Control + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Enable traction control between multiple VESCs connected over CAN-bus. This is only is only used for current control modes.</p></body></html> + APPCONF_PPM_TC + 0 + + + TC Max ERPM Difference + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The ERPM difference at which the fastest motor gets swtiched off completely. If the difference in ERPM is lower than that the current to faster motors is scaled down proportionally to the difference.</p></body></html> + APPCONF_PPM_TC_MAX_DIFF + 2 + 1 + 0 + 100000 + 0 + 0 + 100 + 3000 + 1000 + + 9 + + + Max ERPM for direction switch + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The Max ERPM where the direction can be switched to reverse by braking 2 times.</p></body></html> + APPCONF_PPM_MAX_ERPM_FOR_DIR + 0 + 1 + 0 + 30000 + 0 + 0 + 10 + 4000 + 1 + + 7 + + + Smart Reverse Max Duty Cycle + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Maximum duty cycle to use in smart reverse mode.</span></p></body></html> + APPCONF_PPM_SMART_REV_MAX_DUTY + 3 + 1 + 1 + 1 + 0 + 1 + 0.01 + 0.07 + 1000 + + 9 + + + Smart Reverse Ramp Time + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Time to ramp to maximum duty cycle in smart reverse mode.</span></p></body></html> + APPCONF_PPM_SMART_REV_RAMP_TIME + 2 + 1 + 0 + 100 + 0 + 0 + 0.1 + 3 + 1000 + s + 9 + + + Control Type + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Off</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The output is switched off regardless of the input.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Current</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Current control. The output is off when the input is at minimum.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Current Reverse Center</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Current control. The output is off when the input is centered. Input less than center brakes until the motor stops, at which point it it starts in the reverse direction.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Current Reverse Button</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Current control with a button for reversing the throttle. The output is off when the input is at minimum.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Current Reverse ADC2 Brake Button</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Current control with a button for reversing the throttle. The output is off when the input is at minimum. The second ADC channel acs as a brake.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">ADC_CTRL_TYPE_CURRENT_REV_BUTTON_BRAKE_CENTER</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Current control with a button for reversing throttle. The output is off when the input is centered. Input less than center brakes until the motor stops, but not further.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Current No Reverse Brake Center</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Current control. The output is off when the input is centered. Input less than center brakes until the motor stops, but not further.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Current No Reverse Brake Button</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Current control with a button for turning the throttle into a brake. The output is off when the input is at minimum.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Current No Reverse Brake ADC2</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Current control with one separate throttle connected to ADC2 for braking.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Duty Cycle</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Duty cycle control. The output is off when the input is at minimum.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Duty Cycle Reverse Center</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Current control. The output is off when the input is centered. Input less than center gives negative duty cycle.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Duty Cycle Reverse Button</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Duty cycle control with a button on UART RX for inverting the throttle. The output is off when the input is at minimum.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">PID Speed</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">PID speed control. The speed setpoint is mapped between 0 and the configured maximum motor speed limit.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">PID Speed Reverse Center</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">PID speed control. The output is mapped between the minimum and maximum motor speed limits. Throttle center corresponds to 0 speed.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">PID Speed Reverse Button</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">PID speed control with a button for reversing the throttle. The speed setpoint is mapped between 0 and the configured maximum motor speed limit, or between 0 and the minimum motor speed limit when the UART RX input is high.</p></body></html> + APPCONF_ADC_CTRL_TYPE + 8 + Off + Current + Current Reverse Center + Current Reverse Button + Current Reverse ADC2 Brake Button + Current Reverse Button Brake Center + Current No Reverse Brake Center + Current No Reverse Brake Button + Current No Reverse Brake ADC2 + Duty Cycle + Duty Cycle Reverse Center + Duty Cycle Reverse Button + PID Speed + PID Speed Reverse Center + PID Speed Reverse Button + + + Input Deadband + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Deadband region for the input.</span></p></body></html> + APPCONF_ADC_HYST + 0 + 100 + 0 + 1 + 0 + 1 + 1 + 0.05 + 1000 + % + 9 + + + ADC1 Min Voltage + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" ;">Input voltage at the start of the throttle range for ADC1. Can be checked by enabling display and giving the minimum input. If </span><span style=" ; font-weight:600;">Control Type</span><span style=" ;"> is set to off while doing that the motor won't turn.</span></p></body></html> + APPCONF_ADC_VOLTAGE_START + 2 + 1 + 0 + 3.3 + 0 + 1 + 0.01 + 0.6 + 1000 + V + 9 + + + ADC1 Max Voltage + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" ;">Input voltage at the end of the throttle range for ADC1. Can be checked by enabling display and giving the maximum input. If </span><span style=" ; font-weight:600;">Control Type</span><span style=" ;"> is set to off while doing that the motor won't turn.</span></p></body></html> + APPCONF_ADC_VOLTAGE_END + 2 + 1 + 0 + 3.3 + 0 + 1 + 0.01 + 2.54 + 1000 + V + 9 + + + ADC1 Center Voltage + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Input voltage at the center of the throttle range for ADC1. Can be checked by enabling display and centering the input. If <span style=" font-weight:600;">Control Type</span> is set to off while doing that the motor won't turn.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Notice that this parameter only is used for the contered control types. For the other types the voltage will always be mapped linearly between start and end.</p></body></html> + APPCONF_ADC_VOLTAGE_CENTER + 2 + 1 + 0 + 3.3 + 0 + 1 + 0.01 + 0.6 + 1000 + V + 9 + + + ADC2 Min Voltage + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Input voltage at the start of the throttle range for ADC2. Can be checked by enabling display and giving the minimum input. If <span style=" font-weight:600;">Control Type</span> is set to off while doing that the motor won't turn.</p></body></html> + APPCONF_ADC_VOLTAGE2_START + 2 + 1 + 0 + 3.3 + 0 + 1 + 0.01 + 0 + 1000 + V + 9 + + + ADC2 Max Voltage + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Input voltage at the end of the throttle range for ADC2. Can be checked by enabling display and giving the maximum input. If <span style=" font-weight:600;">Control Type</span> is set to off while doing that the motor won't turn.</p></body></html> + APPCONF_ADC_VOLTAGE2_END + 2 + 1 + 0 + 3.3 + 0 + 1 + 0.01 + 2 + 1000 + V + 9 + + + Use Filter + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Use a low-pass filter to reject noise. This will introduce a slight delay.</p></body></html> + APPCONF_ADC_USE_FILTER + 1 + + + Safe Start + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Prevent motor from starting in some unsafe conditions. Modes:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Disabled</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Motor can always start.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Regular</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Only allow starting the motor when the input has beed zero for long enough after boot, after configuration updates and after faults.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">No Faults</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Same as regular, but the motor can start directly after fault codes are cleared.</p></body></html> + APPCONF_ADC_SAFE_START + 1 + Disabled + Regular + No Fault + + + Invert Cruise Control Button + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Invert the cruise control button. For supporting both normally-closed and normally-open buttons.</p></body></html> + APPCONF_ADC_CC_BUTTON_INVERTED + 1 + + + Invert Reverse Button + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Invert the reverse button. For supporting both normally-closed and normally-open buttons.</p></body></html> + APPCONF_ADC_REV_BUTTON_INVERTED + 0 + + + Invert ADC1 Voltage + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Invert the voltage from ADC1.</span></p></body></html> + APPCONF_ADC_VOLTAGE_INVERTED + 0 + + + Invert ADC2 Voltage + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Invert the voltage from ADC2.</span></p></body></html> + APPCONF_ADC_VOLTAGE2_INVERTED + 1 + + + Throttle Expo + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Exponential gain for the throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Zero (0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Linear throttle</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Negative (&lt;0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The throttle is softer close to 0 and increases exponentially towards full throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Positive (&gt;0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The throttle reacts fast around 0 and decreases exponentially towards full throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Increasing the magnitude of this value will increase the exponential effect. The full throttle curve can be seen in the throttle curve plot.</span></p></body></html> + APPCONF_ADC_THROTTLE_EXP + 2 + 1 + 1 + 5 + -5 + 1 + 1 + -0.5 + 1 + + 9 + + + Throttle Expo Brake + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Exponential gain for the throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Zero (0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Linear throttle</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Negative (&lt;0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The throttle is softer close to 0 and increases exponentially towards full throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Positive (&gt;0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The throttle reacts fast around 0 and decreases exponentially towards full throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Increasing the magnitude of this value will increase the exponential effect. The full throttle curve can be seen in the throttle curve plot.</span></p></body></html> + APPCONF_ADC_THROTTLE_EXP_BRAKE + 2 + 1 + 1 + 5 + -5 + 1 + 1 + 0 + 1 + + 9 + + + Throttle Expo Mode + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The throttle curve mode.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Exponential</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">y = x^(1 + c)</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Natural</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">y = (e^(cx) - 1) / (e^c - 1)</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Polynomial</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">y = x / (1 + c(1 - x))</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">where</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">y:</span> output</p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">x:</span> input</p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">c:</span> curve</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The curve parameter, offsets and signs are mapped accordingly for each mode.</p></body></html> + APPCONF_ADC_THROTTLE_EXP_MODE + 2 + Exponential + Natural + Polynomial + + + Positive Ramping Time + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Positive ramping time constant. This filters the input with ramping. This constant represents the amount of secods it takes to ramp from zero to full output.</span></p></body></html> + APPCONF_ADC_RAMP_TIME_POS + 2 + 1 + 0 + 1000 + 0 + 0 + 0.1 + 0.3 + 1000 + s + 9 + + + Negative Ramping Time + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Negative ramping time constant. This filters the input with ramping. This constant represents the amount of secods it takes to ramp from full output (acceleration or braking) back to zero.</span></p></body></html> + APPCONF_ADC_RAMP_TIME_NEG + 2 + 1 + 0 + 1000 + 0 + 0 + 0.1 + 0.1 + 1000 + s + 9 + + + Multiple VESCs Over CAN + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Listen for other VESCs on the CAN-bus and send the same control commands to them. Notice that the application only has to be set up on the master VESC.</p></body></html> + APPCONF_ADC_MULTI_ESC + 1 + + + Traction Control + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Enable traction control between multiple VESCs connected over CAN-bus. This is only is only used for current control modes.</p></body></html> + APPCONF_ADC_TC + 0 + + + TC Max ERPM Difference + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The ERPM difference at which the fastest motor gets swtiched off completely. If the difference in ERPM is lower than that the current to faster motors is scaled down proportionally to the difference.</p></body></html> + APPCONF_ADC_TC_MAX_DIFF + 2 + 1 + 0 + 100000 + 0 + 0 + 100 + 3000 + 1000 + + 9 + + + Update Rate + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Rate at which the input is sampled.</p></body></html> + APPCONF_ADC_UPDATE_RATE_HZ + 1 + 0 + 100000 + 0 + 0 + 10 + 500 + Hz + 3 + + + Baudrate + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">UART Baudrate.</p></body></html> + APPCONF_UART_BAUDRATE + 1 + 0 + 20000000 + 0 + 0 + 1 + 115200 + bps + 5 + + + Control Type + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Off</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The output is switched off regardless of the input.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Current</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Current control. The output is off when the joystick is centered. Positive input gives acceleration and negative input braking. To go reverse the Z button can be used to toggle direction.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Current No Reverse</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Current control. The output is off when the joystick is centered. Positive input gives acceleration and negative input braking. The reverse function of the Z button is disabled.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Current Bidirectional</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Current control. The output is off when the joystick is centered. Positive input always gives forward current and negative current always gives reverse current. This means that when current is applied through 0 speed, the motor will accelerate in the other direction.</span></p></body></html> + APPCONF_CHUK_CTRL_TYPE + 1 + Off + Current + Current No Reverse + Current Bidirectional + + + Input Deadband + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Deadband region for the input.</span></p></body></html> + APPCONF_CHUK_HYST + 0 + 100 + 0 + 1 + 0 + 1 + 1 + 0.15 + 1000 + % + 9 + + + Positive Ramping Time + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Positive ramping time constant. This filters the joystick input with ramping. This constant represents the amount of secods it takes to ramp from zero to full output.</p></body></html> + APPCONF_CHUK_RAMP_TIME_POS + 2 + 1 + 0 + 1000 + 0 + 0 + 0.1 + 0.4 + 1000 + s + 9 + + + Negative Ramping Time + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Negative ramping time constant. This filters the joystick input with ramping. This constant represents the amount of secods it takes to ramp from full output (acceleration or braking) back to zero.</p></body></html> + APPCONF_CHUK_RAMP_TIME_NEG + 2 + 1 + 0 + 1000 + 0 + 0 + 0.1 + 0.2 + 1000 + s + 9 + + + ERPM Per Second Cruise Control + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The amount of ERPM per second the setpoint changes when giving full joystick input with criuse control activated.</p></body></html> + APPCONF_STICK_ERPM_PER_S_IN_CC + 2 + 1 + 0 + 1e+06 + 0 + 0 + 500 + 3000 + 1000 + + 9 + + + Throttle Expo + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Exponential gain for the throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Zero (0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Linear throttle</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Negative (&lt;0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The throttle is softer close to 0 and increases exponentially towards full throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Positive (&gt;0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The throttle reacts fast around 0 and decreases exponentially towards full throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Increasing the magnitude of this value will increase the exponential effect. The full throttle curve can be seen in the throttle curve plot.</span></p></body></html> + APPCONF_CHUK_THROTTLE_EXP + 2 + 1 + 1 + 5 + -5 + 1 + 1 + 0 + 1 + + 9 + + + Throttle Expo Brake + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Exponential gain for the throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Zero (0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Linear throttle</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Negative (&lt;0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The throttle is softer close to 0 and increases exponentially towards full throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Positive (&gt;0)</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The throttle reacts fast around 0 and decreases exponentially towards full throttle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Increasing the magnitude of this value will increase the exponential effect. The full throttle curve can be seen in the throttle curve plot.</span></p></body></html> + APPCONF_CHUK_THROTTLE_EXP_BRAKE + 2 + 1 + 1 + 5 + -5 + 1 + 1 + 0 + 1 + + 9 + + + Throttle Expo Mode + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The throttle curve mode.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Exponential</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">y = x^(1 + c)</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Natural</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">y = (e^(cx) - 1) / (e^c - 1)</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Polynomial</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">y = x / (1 + c(1 - x))</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">where</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">y:</span> output</p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">x:</span> input</p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">c:</span> curve</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The curve parameter, offsets and signs are mapped accordingly for each mode.</p></body></html> + APPCONF_CHUK_THROTTLE_EXP_MODE + 2 + Exponential + Natural + Polynomial + + + Multiple VESCs Over CAN + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Listen for other VESCs on the CAN-bus and send the same control commands to them. Notice that the application only has to be set up on the master VESC.</p></body></html> + APPCONF_CHUK_MULTI_ESC + 1 + + + Traction Control + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Enable traction control between multiple VESCs connected over CAN-bus. This is only is only used for current control modes.</p></body></html> + APPCONF_CHUK_TC + 0 + + + TC Max ERPM Difference + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The ERPM difference at which the fastest motor gets swtiched off completely. If the difference in ERPM is lower than that the current to faster motors is scaled down proportionally to the difference.</p></body></html> + APPCONF_CHUK_TC_MAX_DIFF + 2 + 1 + 0 + 100000 + 0 + 0 + 100 + 3000 + 1000 + + 9 + + + Use Smart Reverse + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Use smart reverse function. If enabled, holding full brake will switch to duty cycle mode in the reverse direction when the speed is so low that not enough brake torque can be produced.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">This is useful when trying to stop downhill where you normally would roll forwards slowly even at full brake. Instead, the board will start to go reverse slowly in duty cycle mode if this mode is activated.</span></p></body></html> + APPCONF_CHUK_USE_SMART_REV + 1 + + + Smart Reverse Max Duty Cycle + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Maximum duty cycle to use in smart reverse mode.</span></p></body></html> + APPCONF_CHUK_SMART_REV_MAX_DUTY + 3 + 1 + 1 + 1 + 0 + 1 + 0.01 + 0.07 + 1000 + + 9 + + + Smart Reverse Ramp Time + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Time to ramp to maximum duty cycle in smart reverse mode.</span></p></body></html> + APPCONF_CHUK_SMART_REV_RAMP_TIME + 2 + 1 + 0 + 100 + 0 + 0 + 0.1 + 3 + 1000 + s + 9 + + + Speed + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The air bit rate.</p></body></html> + APPCONF_NRF_SPEED + 1 + 250 Kbit/s + 1 MBit/s + 2 MBit/s + + + TX Power + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Transmit power or power off setting.</p></body></html> + APPCONF_NRF_POWER + 3 + -18 dBm + -12 dBm + -6 dBm + 0 dBm + OFF + + + CRC + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">CRC checksum type.</p></body></html> + APPCONF_NRF_CRC + 1 + Disabled + 1 Byte + 2 Byte + + + Retry Delay + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Delay between retries when no ack is received. If the speed is lower than 2MBit, at least 500 µS should be used.</span></p></body></html> + APPCONF_NRF_RETR_DELAY + 0 + 250 µS + 500 µS + 750 µS + 1000 µS + 1250 µS + 1500 µS + 1750 µS + 2000 µS + 2250 µS + 2500 µS + 2750 µS + 3000 µS + 3250 µS + 3500 µS + 3750 µS + 4000 µS + + + Retries + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Maximum number of retries when no ack is received before giving up on the current packet.</p></body></html> + APPCONF_NRF_RETRIES + 1 + 0 + 15 + 0 + 0 + 1 + 3 + + 2 + + + Radio Channel + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Radio channel.</p></body></html> + APPCONF_NRF_CHANNEL + 1 + 0 + 125 + 0 + 0 + 1 + 76 + + 2 + + + Address 0 + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Address byte 0.</p></body></html> + APPCONF_NRF_ADDR_B0 + 1 + 0 + 255 + 0 + 0 + 1 + 198 + + 1 + + + Address 1 + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Address byte 1.</p></body></html> + APPCONF_NRF_ADDR_B1 + 1 + 0 + 255 + 0 + 0 + 1 + 199 + + 1 + + + Address 2 + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Address byte 2.</p></body></html> + APPCONF_NRF_ADDR_B2 + 1 + 0 + 255 + 0 + 0 + 1 + 0 + + 1 + + + Send ACK + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Send ACK when valid packets are received.</p></body></html> + APPCONF_NRF_SEND_CRC_ACK + 1 + + + P + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">P value for the PID balance loop.</p></body></html> + APPCONF_BALANCE_KP + 4 + 1 + 0 + 1e+06 + 0 + 0 + 0.1 + 0 + 1000 + + 9 + + + I + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">I value for the PID balance loop.</p></body></html> + APPCONF_BALANCE_KI + 4 + 1 + 0 + 1e+06 + 0 + 0 + 0.1 + 0 + 1000 + + 9 + + + D + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">D value for the PID balance loop.</p></body></html> + APPCONF_BALANCE_KD + 4 + 1 + 0 + 1e+06 + 0 + 0 + 0.1 + 0 + 1000 + + 9 + + + Loop Hertz + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Loop Hertz.</p></body></html> + APPCONF_BALANCE_HERTZ + 1 + 0 + 4000 + 50 + 0 + 100 + 1000 + Hz + 3 + + + Loop Time Correction Filter + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Filter overshoot and correct for it.</p></body></html> + APPCONF_BALANCE_LOOP_TIME_FILTER + 1 + 0 + 1000 + 0 + 0 + 10 + 0 + Hz + 3 + + + Pitch Axis Fault Cutoff + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Angle to turn off driving (on the pitch axis).</span></p></body></html> + APPCONF_BALANCE_FAULT_PITCH + 1 + 1 + 0 + 180 + -180 + 0 + 1 + 20 + 1000 + ° + 9 + + + Roll Axis Fault Cutoff + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Angle to turn off driving (on the roll axis).</span></p></body></html> + APPCONF_BALANCE_FAULT_ROLL + 1 + 1 + 0 + 180 + -180 + 0 + 1 + 45 + 1000 + ° + 9 + + + Duty Cycle Fault Cutoff + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Duty cycle value to trigger a safety cutoff 0-1% (This cutoff will lock the app untill another fault occurs).</span></p></body></html> + APPCONF_BALANCE_FAULT_DUTY + 2 + 1 + 0 + 1 + 0 + 0 + 0.01 + 0.9 + 1000 + + 9 + + + ADC1 Switch Voltage + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Voltage below this value will trigger a fault. To disable this switch set this value to 0. Hint: consider a pulldown resisitor!</span></p></body></html> + APPCONF_BALANCE_FAULT_ADC1 + 2 + 1 + 0 + 3.3 + 0 + 1 + 0.1 + 0 + 1000 + V + 9 + + + ADC2 Switch Voltage + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Voltage below this value will trigger a fault. To disable this switch set this value to 0. Hint: consider a pulldown resisitor!</span></p></body></html> + APPCONF_BALANCE_FAULT_ADC2 + 2 + 1 + 0 + 3.3 + 0 + 1 + 0.1 + 0 + 1000 + V + 9 + + + Pitch Fault Delay + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Pitch fault cutoff time delay in ms.</p></body></html> + APPCONF_BALANCE_FAULT_DELAY_PITCH + 1 + 0 + 10000 + 0 + 0 + 10 + 0 + ms + 3 + + + Roll Fault Delay + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Roll fault cutoff time delay in ms.</p></body></html> + APPCONF_BALANCE_FAULT_DELAY_ROLL + 1 + 0 + 10000 + 0 + 0 + 10 + 0 + ms + 3 + + + Duty Fault Delay + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Duty cycle cutoff time delay in ms.</p></body></html> + APPCONF_BALANCE_FAULT_DELAY_DUTY + 1 + 0 + 10000 + 0 + 0 + 10 + 0 + ms + 3 + + + Half Switch Fault Delay + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Half switch cutoff time delay in ms.</p></body></html> + APPCONF_BALANCE_FAULT_DELAY_SWITCH_HALF + 1 + 0 + 10000 + 0 + 0 + 10 + 0 + ms + 3 + + + Full Switch Fault Delay + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Full switch cutoff time delay in ms.</p></body></html> + APPCONF_BALANCE_FAULT_DELAY_SWITCH_FULL + 1 + 0 + 10000 + 0 + 0 + 10 + 0 + ms + 3 + + + ADC Half State Fault ERPM + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">ERPM (absoulte value) below which a half state on the ADC switches will be considered a fault.</p></body></html> + APPCONF_BALANCE_FAULT_ADC_HALF_ERPM + 1 + 0 + 100000 + 0 + 0 + 10 + 1000 + ERPM + 3 + + + Angle + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Angle of rise for duty cycle tiltback.</p></body></html> + APPCONF_BALANCE_TILTBACK_DUTY_ANGLE + 1 + 1 + 0 + 45 + 0 + 0 + 1 + 10 + 100 + ° + 7 + + + Speed + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Speed at which vehicle is being tilted back when exceeding duty cycle limit (fast tiltback can be dangerous!).</p></body></html> + APPCONF_BALANCE_TILTBACK_DUTY_SPEED + 1 + 1 + 0 + 100 + 0 + 0 + 0.5 + 3 + 100 + °/s + 7 + + + Duty Cycle + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Duty cycle threshold to trigger a safety tiltback (Tiltback raises the nose of the vehicle informing you to slow down).</p></body></html> + APPCONF_BALANCE_TILTBACK_DUTY + 2 + 1 + 0 + 1 + 0 + 0 + 0.01 + 0.75 + 1000 + + 7 + + + Angle + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Angle of rise for high voltage tiltback.</p></body></html> + APPCONF_BALANCE_TILTBACK_HV_ANGLE + 1 + 1 + 0 + 45 + 0 + 0 + 1 + 10 + 100 + ° + 7 + + + Speed + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Speed at which vehicle is being tilted back when exceeding high voltage limit (fast tiltback can be dangerous!).</p></body></html> + APPCONF_BALANCE_TILTBACK_HV_SPEED + 1 + 1 + 0 + 100 + 0 + 0 + 0.5 + 3 + 100 + °/s + 7 + + + High Voltage + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">High voltage threshold to trigger a safety tiltback (Tiltback raises the nose of the vehicle to alert you). High voltage tiltback is most likely to be triggered when braking or going downhill on a full battery, sometimes resulting in a tail drag on board shaped vehicles. </p></body></html> + APPCONF_BALANCE_TILTBACK_HV + 2 + 1 + 0 + 700 + 0 + 0 + 0.1 + 100 + 1000 + V + 9 + + + Angle + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Angle of rise for low voltage tiltback.</p></body></html> + APPCONF_BALANCE_TILTBACK_LV_ANGLE + 1 + 1 + 0 + 45 + 0 + 0 + 1 + 10 + 100 + ° + 7 + + + Speed + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Speed at which vehicle is being tilted back when below low voltage threshold (fast tiltback can be dangerous and further contribute to voltage sag!).</p></body></html> + APPCONF_BALANCE_TILTBACK_LV_SPEED + 1 + 1 + 0 + 100 + 0 + 0 + 0.5 + 3 + 100 + °/s + 7 + + + Low Voltage + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Low voltage threshold to trigger a safety tiltback (Tiltback raises the nose of the vehicle informing you to slow down). </p></body></html> + APPCONF_BALANCE_TILTBACK_LV + 2 + 1 + 0 + 700 + 0 + 0 + 0.1 + 0 + 1000 + V + 9 + + + Return To Level Speed + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Speed at which vehicle is being returned back to normal after a tiltback condition has been cleared (should be equal to or slower than slowest tiltback speed).</p></body></html> + APPCONF_BALANCE_TILTBACK_RETURN_SPEED + 1 + 1 + 0 + 100 + 0 + 0 + 0.5 + 1 + 100 + °/s + 7 + + + Constant Tiltback + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Tiltback that will be applied above a configurable minimum ERPM. AKA nose angle adjustment, can be downwards too.</p></body></html> + APPCONF_BALANCE_TILTBACK_CONSTANT + 2 + 1 + 0 + 80 + -80 + 0 + 1 + 0 + 1 + ° + 9 + + + Constant Tiltback ERPM + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; APPCONF_BALANCE_FAULT_ADC_HALF_ERPMmargin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">ERPM (absolute value) above which constant tiltback will be applied.</p></body></html> + APPCONF_BALANCE_TILTBACK_CONSTANT_ERPM + 1 + 0 + 100000 + 200 + 0 + 100 + 500 + ERPM + 3 + + + Variable Tiltback + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Nose angle adjustment that will be applied depending on speed, specified in degrees per 1000 erpm, applied linearly up to a maximum set in Variable Tiltback Maximum. Can be downwards (negative) too. Applies in addition to constant tiltback.</p></body></html> + APPCONF_BALANCE_TILTBACK_VARIABLE + 2 + 1 + 0 + 1 + -1 + 0 + 0.01 + 0 + 1 + °/1000 ERPM + 9 + + + Variable Tiltback Maximum + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Maximum angle which variable tiltback is permitted to add (in addition to constant tiltback). Does not affect or prevent alert tiltbacks.</p></body></html> + APPCONF_BALANCE_TILTBACK_VARIABLE_MAX + 2 + 1 + 0 + 80 + -80 + 0 + 0.5 + 0 + 1 + ° + 9 + + + Nose Angling Speed + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Speed at which vehicle will tilt to the desired angle.</p></body></html> + APPCONF_BALANCE_NOSEANGLING_SPEED + 1 + 1 + 0 + 100 + 0 + 0 + 0.5 + 5 + 100 + °/s + 7 + + + Startup Pitch Axis Angle Tolerance + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Angle at which balancing will start (on the main axis). Measured in degrees from upright (0).</span></p></body></html> + APPCONF_BALANCE_STARTUP_PITCH_TOLERANCE + 1 + 1 + 0 + 80 + 0 + 0 + 0.1 + 20 + 1000 + ° + 9 + + + Startup Roll Axis Angle Tolerance + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Angle at which balancing will start (on the cross axis). Measured in degrees from upright (0).</span></p></body></html> + APPCONF_BALANCE_STARTUP_ROLL_TOLERANCE + 1 + 1 + 0 + 80 + 0 + 0 + 0.1 + 8 + 1000 + ° + 9 + + + Startup Centering Speed + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Speed at which wheel will center itself on startup.</p></body></html> + APPCONF_BALANCE_STARTUP_SPEED + 1 + 1 + 0 + 100 + 0 + 0 + 0.1 + 30 + 1000 + °/s + 9 + + + Deadzone + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Deadzone disables balancing at center.</p></body></html> + APPCONF_BALANCE_DEADZONE + 2 + 1 + 0 + 5 + 0 + 0 + 0.01 + 0 + 1000 + ° + 9 + + + Multiple VESCs Over CAN + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Listen for other VESCs on the CAN-bus and send the same control commands to them. Notice that the application only has to be set up on the master VESC.</p></body></html> + APPCONF_BALANCE_MULTI_ESC + 0 + + + Yaw P + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">P value for yaw PID stabilization.</p></body></html> + APPCONF_BALANCE_YAW_KP + 3 + 1 + 0 + 10000 + -10000 + 0 + 0.01 + 0 + 1000 + + 9 + + + Yaw I + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">I value for yaw PID stabilization.</p></body></html> + APPCONF_BALANCE_YAW_KI + 3 + 1 + 0 + 10000 + -10000 + 0 + 0.01 + 0 + 1000 + + 9 + + + Yaw D + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">D value for yaw PID stabilization.</p></body></html> + APPCONF_BALANCE_YAW_KD + 3 + 1 + 0 + 10000 + -10000 + 0 + 0.01 + 0 + 1000 + + 9 + + + Roll Steer KP + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Roll angle to yaw setpoint adjustment proportion. This is a constant turning speed regardless of forward travel speed. It will turn tighter at low speeds</p></body></html> + APPCONF_BALANCE_ROLL_STEER_KP + 3 + 1 + 0 + 10000 + -10000 + 0 + 0.01 + 0 + 1000 + + 9 + + + Roll Steer ERPM KP + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Roll angle multiplied by ERPM to yaw setpoint adjustment proportion. Scaling turn speed by erpm will give a constant turning radius at all speeds, like a normal vehicle.</p></body></html> + APPCONF_BALANCE_ROLL_STEER_ERPM_KP + 5 + 1 + 0 + 10000 + -10000 + 0 + 0.0001 + 0 + 1000 + + 9 + + + Brake Current + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Breaking current to be applied when balance app is not actively balancing.</p></body></html> + APPCONF_BALANCE_BRAKE_CURRENT + 2 + 1 + 0 + 100 + 0 + 0 + 2 + 0 + 1000 + A + 9 + + + Brake Timeout + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Turn off the brake after this many seconds. It will automatically reactivate if the motor moves. 0 = Disabled.</p></body></html> + APPCONF_BALANCE_BRAKE_TIMEOUT + 1 + 0 + 10000 + 0 + 0 + 5 + 10 + s + 3 + + + Yaw Current Clamp + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Maximum current to be applied to yaw motions. This lets you overpower the pid traction.</p></body></html> + APPCONF_BALANCE_YAW_CURRENT_CLAMP + 2 + 1 + 0 + 100 + 0 + 0 + 0.01 + 0 + 1000 + A + 9 + + + D term PT1 Low Pass Filter + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">D term filter above this frequency. 0 = Disabled.</p></body></html> + APPCONF_BALANCE_KD_PT1_LOWPASS_FREQUENCY + 1 + 0 + 4000 + 0 + 0 + 10 + 0 + Hz + 3 + + + D term PT1 High Pass Filter + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">D term filter below this frequency. 0 = Disabled.</p></body></html> + APPCONF_BALANCE_KD_PT1_HIGHPASS_FREQUENCY + 1 + 0 + 4000 + 0 + 0 + 10 + 0 + Hz + 3 + + + D term Biquad Low Pass Filter + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">D term filter above this frequency. 0 = Disabled.</p></body></html> + APPCONF_BALANCE_KD_BIQUAD_LOWPASS + 1 + 1 + 0 + 500 + 0 + 0 + 1 + 0 + 1000 + Hz + 9 + + + D term Biquad High Pass Filter + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">D term filter below this frequency. 0 = Disabled.</p></body></html> + APPCONF_BALANCE_KD_BIQUAD_HIGHPASS + 1 + 1 + 0 + 500 + 0 + 0 + 1 + 0 + 1000 + Hz + 9 + + + Start Angle + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Angle at which booster is applied (actually measued as absolute deviation from setpoint).</p></body></html> + APPCONF_BALANCE_BOOSTER_ANGLE + 1 + 1 + 0 + 80 + 0 + 0 + 0.5 + 8 + 1 + ° + 9 + + + Ramp Up + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Degrees over which booster will ramp from 0A to the Configured Current, starting at start Angle.</p></body></html> + APPCONF_BALANCE_BOOSTER_RAMP + 1 + 1 + 0 + 80 + 1 + 0 + 0.5 + 1 + 1 + ° + 9 + + + Current Boost + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Extra current to be applied when booster angle is reached.</p></body></html> + APPCONF_BALANCE_BOOSTER_CURRENT + 1 + 1 + 0 + 100 + 0 + 0 + 1 + 0 + 1000 + A + 9 + + + Start Current Threshold + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Minimum output current threshold for torque tiltback to start applying.</p></body></html> + APPCONF_BALANCE_TORQUETILT_START_CURRENT + 1 + 1 + 0 + 100 + 0 + 0 + 2 + 10 + 1000 + A + 9 + + + Tilitback Angle Limit + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Max angle to which torque tiltback will tilt.</p></body></html> + APPCONF_BALANCE_TORQUETILT_ANGLE_LIMIT + 1 + 1 + 0 + 80 + 0 + 0 + 0.5 + 5 + 1 + ° + 9 + + + Max Tiltback Speed + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Max speed at which torque tiltback will tilt to the desired angle (tilt will be slower if current increases slowly).</p></body></html> + APPCONF_BALANCE_TORQUETILT_ON_SPEED + 1 + 1 + 0 + 100 + 0 + 0 + 0.5 + 5 + 1000 + °/s + 9 + + + Max Tiltback Release Speed + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Max speed at which torque tiltback will release to the desired angle back to 0 (tilt will be slower if current decreases slowly).</p></body></html> + APPCONF_BALANCE_TORQUETILT_OFF_SPEED + 1 + 1 + 0 + 100 + 0 + 0 + 0.5 + 3 + 1000 + °/s + 9 + + + Strength + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">How much tiltback should be applied based on output current.</p></body></html> + APPCONF_BALANCE_TORQUETILT_STRENGTH + 2 + 1 + 0 + 1 + 0 + 0 + 0.05 + 0 + 1000 + °/A + 9 + + + Current Filter + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Biquad Low pass filter on the current used for calculating the torquetilt. This smooths out spikes in the current, and prevents torquetilt from being twitchy.</p></body></html> + APPCONF_BALANCE_TORQUETILT_FILTER + 1 + 1 + 0 + 500 + 0 + 0 + 0.5 + 2 + 1000 + Hz + 9 + + + Strength + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">How much tiltback should be applied based on the sine of the roll angle. A strength value of N will give N degrees of tiltback when the vehicle is rolled to 90 degrees.</p></body></html> + APPCONF_BALANCE_TURNTILT_STRENGTH + 1 + 1 + 0 + 90 + 0 + 0 + 0.5 + 0 + 1000 + + 9 + + + Tilitback Angle Limit + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Max angle to which turn tiltback will tilt. This wont change the power curve, only stop it at the limit.</p></body></html> + APPCONF_BALANCE_TURNTILT_ANGLE_LIMIT + 1 + 1 + 0 + 30 + 0 + 0 + 0.5 + 5 + 1000 + ° + 9 + + + Roll Angle Threshold + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Min angle threshold to apply turntilt. Similar to a deadzone, except after reaching the angle, it will apply as if it started from 0.</p></body></html> + APPCONF_BALANCE_TURNTILT_START_ANGLE + 1 + 1 + 0 + 45 + 0 + 0 + 0.5 + 1 + 1 + ° + 9 + + + ERPM Threshold + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">ERPM threshold to apply turntilt.</p></body></html> + APPCONF_BALANCE_TURNTILT_START_ERPM + 1 + 0 + 100000 + 100 + 0 + 100 + 100 + ERPM + 3 + + + Max Tiltback Speed + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Max speed at which turntilt will tilt to the desired angle (tilt will be slower if roll angle increases slowly).</p></body></html> + APPCONF_BALANCE_TURNTILT_SPEED + 1 + 1 + 0 + 100 + 0 + 0 + 0.5 + 5 + 1000 + °/s + 9 + + + Speed Boost % + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Increase the strength based on ERPM. Boost percent is added linearly from 0 erpm (0% boost) to max erpm (Full configured boost % is applied).</p></body></html> + APPCONF_BALANCE_TURNTILT_ERPM_BOOST + 1 + 0 + 10000 + 0 + 0 + 5 + 20 + % + 3 + + + Speed Boost Max ERPM + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">ERPM (absolute value) to end boosting the turn tilt effect, above this erpm there will be constant boost % (at your configured boost %).</p></body></html> + APPCONF_BALANCE_TURNTILT_ERPM_BOOST_END + 1 + 0 + 100000 + 100 + 0 + 100 + 20000 + ERPM + 3 + + + Control Type + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Off</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The output is switched off regardless of the input.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Cadence</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Cadence control. The output is proportional to the pedalling speed, off when there is no pedalling.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Constant Torque</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Constant Torque control. Pedalling provides constant output, off when no pedalling. Suited for gearless setup.</p></body></html> + APPCONF_PAS_CTRL_TYPE + 1 + Off + Cadence + Constant Torque + + + Sensor Type + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Quadrature</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">This interface provides 2 signals that can be decoded to know the pedalling direction (forward of backwards).</p></body></html> + APPCONF_PAS_SENSOR_TYPE + 0 + Quadrature + + + Pedal RPM Start + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Pedal RPM at which the assist starts. Below this value the output current is zero.</p></body></html> + APPCONF_PAS_PEDAL_RPM_START + 1 + 1 + 0 + 200 + 1 + 0 + 1 + 10 + 10 + + 7 + + + Pedal RPM End + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Pedal RPM at which the assist stops increasing. Above this pedal speed the assist output will stay at its maximum.</p></body></html> + APPCONF_PAS_PEDAL_RPM_END + 1 + 1 + 0 + 300 + 1 + 0 + 1 + 120 + 10 + + 7 + + + Invert Pedal Direction + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Inverts pedal direction</p></body></html> + APPCONF_PAS_INVERT_PEDAL_DIRECTION + 0 + + + Sensor Magnets + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">How many magnets the PAS sensor assembly has. 24 magnets would provide 24 pulses per pedal revolution.</p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">12 and 24 magnet setups are typical.</p></body></html> + APPCONF_PAS_MAGNETS + 1 + 0 + 128 + 6 + 0 + 6 + 24 + + 3 + + + Use Filter + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Use a low pass filter in the PAS input signal</p></body></html> + APPCONF_PAS_USE_FILTER + 1 + + + PAS Max Current + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Maximum PAS output current will be limited to this percentage of the global output current.</p></body></html> + APPCONF_PAS_CURRENT_SCALING + 2 + 1 + 1 + 1 + 0 + 1 + 0.05 + 0.08 + 1000 + + 7 + + + Positive Ramping Time + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Positive ramping time constant. This filters the PAS input with ramping and represents the amount of secods it takes to ramp from zero to full output.</span></p></body></html> + APPCONF_PAS_RAMP_TIME_POS + 2 + 1 + 0 + 5 + 0.2 + 0 + 0.05 + 0.3 + 100 + s + 7 + + + Negative Ramping Time + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Negative ramping time constant. This filters the PAS input with ramping and represents the amount of secods it takes to ramp from full to zero output.</span></p></body></html> + APPCONF_PAS_RAMP_TIME_NEG + 2 + 1 + 0 + 5 + 0.2 + 0 + 0.05 + 0.2 + 100 + s + 7 + + + Update Rate + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Frequency at which the PAS control loop is executed</span></p></body></html> + APPCONF_PAS_UPDATE_RATE_HZ + 1 + 0 + 1000 + 10 + 0 + 10 + 500 + Hz + 3 + + + IMU Type + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">IMU type. The internal IMU is only available if the hardware supports it. External IMUs can be connected to the SDA and SCL pins. If using an external IMU, make sure that no app that uses the same pins is selected.</p></body></html> + APPCONF_IMU_TYPE + 1 + IMU_TYPE_OFF + IMU_TYPE_INTERNAL + IMU_TYPE_EXTERNAL_MPU9X50 + IMU_TYPE_EXTERNAL_ICM20948 + IMU_TYPE_EXTERNAL_BMI160 + IMU_TYPE_EXTERNAL_LSM6DS3 + + + IMU AHRS Mode + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Use the Madgwick or Mahony AHRS filter.</p></body></html> + APPCONF_IMU_AHRS_MODE + 0 + AHRS_MODE_MADGWICK + AHRS_MODE_MAHONY + AHRS_MODE_MADGWICK_FUSION + + + Sample Rate + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">IMU sample rate. Higher sample rates use more CPU cycles, but perform better.</p></body></html> + APPCONF_IMU_SAMPLE_RATE_HZ + 1 + 0 + 1000 + 1 + 0 + 10 + 200 + Hz + 3 + + + Accelerometer Confidence Decay + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">This factor sets how fast the accelerometer confidence will be decreased if the acceleration vector differs from 1.0.</p></body></html> + APPCONF_IMU_ACCEL_CONFIDENCE_DECAY + 3 + 1 + 0 + 999 + 0 + 0 + 0.1 + 1 + 1 + + 9 + + + Mahony KP + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">KP for Mahony filter. Decides how much the accelerometer is used for attitude estimation. Increasing this value helps against gyro offsets, but makes the output noisier.</p></body></html> + APPCONF_IMU_MAHONY_KP + 3 + 1 + 0 + 999 + 0 + 0 + 0.1 + 0.3 + 1 + + 9 + + + Mahony KI + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">KI for Mahony filter. Integrates gyro offsets over time.</p></body></html> + APPCONF_IMU_MAHONY_KI + 3 + 1 + 0 + 999 + 0 + 0 + 0.1 + 0 + 1 + + 9 + + + Madgwick Beta + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Beta for Madgwick filter. Decides how much the accelerometer is used for attitude estimation. Increasing this value helps against gyro offsets, but makes the output noisier.</p></body></html> + APPCONF_IMU_MADGWICK_BETA + 3 + 1 + 0 + 999 + 0 + 0 + 0.01 + 0.1 + 1 + + 9 + + + Imu Rotation Roll + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Roll rotation of IMU. Can be adjusted if the IMU is not aligned with the vehicle.</p></body></html> + APPCONF_IMU_ROT_ROLL + 3 + 1 + 0 + 360 + -360 + 0 + 1 + 0 + 1 + ° + 9 + + + Imu Rotation Pitch + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Pitch rotation of IMU. Can be adjusted if the IMU is not aligned with the vehicle.</p></body></html> + APPCONF_IMU_ROT_PITCH + 3 + 1 + 0 + 360 + -360 + 0 + 1 + 0 + 1 + ° + 9 + + + Imu Rotation Yaw + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Yaw rotation of IMU. Can be adjusted if the IMU is not aligned with the vehicle.</p></body></html> + APPCONF_IMU_ROT_YAW + 3 + 1 + 0 + 360 + -360 + 0 + 1 + 0 + 1 + ° + 9 + + + Accel Offset X + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Accelerometer offset X.</p></body></html> + APPCONF_IMU_A_OFFSET_0 + 3 + 1 + 0 + 16 + -16 + 0 + 0.01 + 0 + 1 + G + 9 + + + Accel Offset Y + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Accelerometer offset Y.</p></body></html> + APPCONF_IMU_A_OFFSET_1 + 3 + 1 + 0 + 16 + -16 + 0 + 0.01 + 0 + 1 + G + 9 + + + Accel Offset Z + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Accelerometer offset Z.</p></body></html> + APPCONF_IMU_A_OFFSET_2 + 3 + 1 + 0 + 16 + -16 + 0 + 0.01 + 0 + 1 + G + 9 + + + Gyro Offset X + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Gyro offset (drift) X.</p></body></html> + APPCONF_IMU_G_OFFSET_0 + 3 + 1 + 0 + 1000 + -1000 + 0 + 0.01 + 0 + 1 + °/s + 9 + + + Gyro Offset Y + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Gyro offset (drift) Y.</p></body></html> + APPCONF_IMU_G_OFFSET_1 + 3 + 1 + 0 + 1000 + -1000 + 0 + 0.01 + 0 + 1 + °/s + 9 + + + Gyro Offset Z + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Gyro offset (drift) Z.</p></body></html> + APPCONF_IMU_G_OFFSET_2 + 3 + 1 + 0 + 1000 + -1000 + 0 + 0.01 + 0 + 1 + °/s + 9 + + + + controller_id + timeout_msec + timeout_brake_current + send_can_status + send_can_status_rate_hz + can_baud_rate + pairing_done + permanent_uart_enabled + shutdown_mode + can_mode + uavcan_esc_index + uavcan_raw_mode + uavcan_raw_rpm_max + servo_out_enable + kill_sw_mode + app_to_use + app_ppm_conf.ctrl_type + app_ppm_conf.pid_max_erpm + app_ppm_conf.hyst + app_ppm_conf.pulse_start + app_ppm_conf.pulse_end + app_ppm_conf.pulse_center + app_ppm_conf.median_filter + app_ppm_conf.safe_start + app_ppm_conf.throttle_exp + app_ppm_conf.throttle_exp_brake + app_ppm_conf.throttle_exp_mode + app_ppm_conf.ramp_time_pos + app_ppm_conf.ramp_time_neg + app_ppm_conf.multi_esc + app_ppm_conf.tc + app_ppm_conf.tc_max_diff + app_ppm_conf.max_erpm_for_dir + app_ppm_conf.smart_rev_max_duty + app_ppm_conf.smart_rev_ramp_time + app_adc_conf.ctrl_type + app_adc_conf.hyst + app_adc_conf.voltage_start + app_adc_conf.voltage_end + app_adc_conf.voltage_center + app_adc_conf.voltage2_start + app_adc_conf.voltage2_end + app_adc_conf.use_filter + app_adc_conf.safe_start + app_adc_conf.cc_button_inverted + app_adc_conf.rev_button_inverted + app_adc_conf.voltage_inverted + app_adc_conf.voltage2_inverted + app_adc_conf.throttle_exp + app_adc_conf.throttle_exp_brake + app_adc_conf.throttle_exp_mode + app_adc_conf.ramp_time_pos + app_adc_conf.ramp_time_neg + app_adc_conf.multi_esc + app_adc_conf.tc + app_adc_conf.tc_max_diff + app_adc_conf.update_rate_hz + app_uart_baudrate + app_chuk_conf.ctrl_type + app_chuk_conf.hyst + app_chuk_conf.ramp_time_pos + app_chuk_conf.ramp_time_neg + app_chuk_conf.stick_erpm_per_s_in_cc + app_chuk_conf.throttle_exp + app_chuk_conf.throttle_exp_brake + app_chuk_conf.throttle_exp_mode + app_chuk_conf.multi_esc + app_chuk_conf.tc + app_chuk_conf.tc_max_diff + app_chuk_conf.use_smart_rev + app_chuk_conf.smart_rev_max_duty + app_chuk_conf.smart_rev_ramp_time + app_nrf_conf.speed + app_nrf_conf.power + app_nrf_conf.crc_type + app_nrf_conf.retry_delay + app_nrf_conf.retries + app_nrf_conf.channel + app_nrf_conf.address__0 + app_nrf_conf.address__1 + app_nrf_conf.address__2 + app_nrf_conf.send_crc_ack + app_balance_conf.kp + app_balance_conf.ki + app_balance_conf.kd + app_balance_conf.hertz + app_balance_conf.loop_time_filter + app_balance_conf.fault_pitch + app_balance_conf.fault_roll + app_balance_conf.fault_duty + app_balance_conf.fault_adc1 + app_balance_conf.fault_adc2 + app_balance_conf.fault_delay_pitch + app_balance_conf.fault_delay_roll + app_balance_conf.fault_delay_duty + app_balance_conf.fault_delay_switch_half + app_balance_conf.fault_delay_switch_full + app_balance_conf.fault_adc_half_erpm + app_balance_conf.tiltback_duty_angle + app_balance_conf.tiltback_duty_speed + app_balance_conf.tiltback_duty + app_balance_conf.tiltback_hv_angle + app_balance_conf.tiltback_hv_speed + app_balance_conf.tiltback_hv + app_balance_conf.tiltback_lv_angle + app_balance_conf.tiltback_lv_speed + app_balance_conf.tiltback_lv + app_balance_conf.tiltback_return_speed + app_balance_conf.tiltback_constant + app_balance_conf.tiltback_constant_erpm + app_balance_conf.tiltback_variable + app_balance_conf.tiltback_variable_max + app_balance_conf.noseangling_speed + app_balance_conf.startup_pitch_tolerance + app_balance_conf.startup_roll_tolerance + app_balance_conf.startup_speed + app_balance_conf.deadzone + app_balance_conf.multi_esc + app_balance_conf.yaw_kp + app_balance_conf.yaw_ki + app_balance_conf.yaw_kd + app_balance_conf.roll_steer_kp + app_balance_conf.roll_steer_erpm_kp + app_balance_conf.brake_current + app_balance_conf.brake_timeout + app_balance_conf.yaw_current_clamp + app_balance_conf.kd_pt1_lowpass_frequency + app_balance_conf.kd_pt1_highpass_frequency + app_balance_conf.kd_biquad_lowpass + app_balance_conf.kd_biquad_highpass + app_balance_conf.booster_angle + app_balance_conf.booster_ramp + app_balance_conf.booster_current + app_balance_conf.torquetilt_start_current + app_balance_conf.torquetilt_angle_limit + app_balance_conf.torquetilt_on_speed + app_balance_conf.torquetilt_off_speed + app_balance_conf.torquetilt_strength + app_balance_conf.torquetilt_filter + app_balance_conf.turntilt_strength + app_balance_conf.turntilt_angle_limit + app_balance_conf.turntilt_start_angle + app_balance_conf.turntilt_start_erpm + app_balance_conf.turntilt_speed + app_balance_conf.turntilt_erpm_boost + app_balance_conf.turntilt_erpm_boost_end + app_pas_conf.ctrl_type + app_pas_conf.sensor_type + app_pas_conf.current_scaling + app_pas_conf.pedal_rpm_start + app_pas_conf.pedal_rpm_end + app_pas_conf.invert_pedal_direction + app_pas_conf.magnets + app_pas_conf.use_filter + app_pas_conf.ramp_time_pos + app_pas_conf.ramp_time_neg + app_pas_conf.update_rate_hz + imu_conf.type + imu_conf.mode + imu_conf.sample_rate_hz + imu_conf.accel_confidence_decay + imu_conf.mahony_kp + imu_conf.mahony_ki + imu_conf.madgwick_beta + imu_conf.rot_roll + imu_conf.rot_pitch + imu_conf.rot_yaw + imu_conf.accel_offsets__0 + imu_conf.accel_offsets__1 + imu_conf.accel_offsets__2 + imu_conf.gyro_offsets__0 + imu_conf.gyro_offsets__1 + imu_conf.gyro_offsets__2 + + + + General + + General + + app_to_use + controller_id + timeout_msec + timeout_brake_current + send_can_status + send_can_status_rate_hz + can_baud_rate + pairing_done + permanent_uart_enabled + shutdown_mode + can_mode + uavcan_esc_index + uavcan_raw_mode + uavcan_raw_rpm_max + servo_out_enable + kill_sw_mode + + + + + PPM + + General + + app_ppm_conf.ctrl_type + app_ppm_conf.median_filter + app_ppm_conf.safe_start + app_ppm_conf.pid_max_erpm + app_ppm_conf.ramp_time_pos + app_ppm_conf.ramp_time_neg + app_ppm_conf.max_erpm_for_dir + app_ppm_conf.smart_rev_max_duty + app_ppm_conf.smart_rev_ramp_time + ::sep::Multiple VESCs over CAN + app_ppm_conf.multi_esc + app_ppm_conf.tc + app_ppm_conf.tc_max_diff + + + + Mapping + + app_ppm_conf.pulse_start + app_ppm_conf.pulse_end + app_ppm_conf.pulse_center + app_ppm_conf.hyst + + + + Throttle Curve + + app_ppm_conf.throttle_exp + app_ppm_conf.throttle_exp_brake + app_ppm_conf.throttle_exp_mode + + + + + ADC + + General + + app_adc_conf.ctrl_type + app_adc_conf.use_filter + app_adc_conf.safe_start + app_adc_conf.cc_button_inverted + app_adc_conf.rev_button_inverted + app_adc_conf.update_rate_hz + app_adc_conf.ramp_time_pos + app_adc_conf.ramp_time_neg + ::sep::Multiple VESCs over CAN-bus + app_adc_conf.multi_esc + app_adc_conf.tc + app_adc_conf.tc_max_diff + + + + Mapping + + app_adc_conf.hyst + ::sep::ADC 1 + app_adc_conf.voltage_start + app_adc_conf.voltage_end + app_adc_conf.voltage_center + app_adc_conf.voltage_inverted + ::sep::ADC 2 + app_adc_conf.voltage2_start + app_adc_conf.voltage2_end + app_adc_conf.voltage2_inverted + + + + Throttle Curve + + app_adc_conf.throttle_exp + app_adc_conf.throttle_exp_brake + app_adc_conf.throttle_exp_mode + + + + + UART + + General + + app_uart_baudrate + + + + + VESC Remote + + General + + app_chuk_conf.ctrl_type + app_chuk_conf.ramp_time_pos + app_chuk_conf.ramp_time_neg + app_chuk_conf.stick_erpm_per_s_in_cc + app_chuk_conf.hyst + app_chuk_conf.use_smart_rev + app_chuk_conf.smart_rev_max_duty + app_chuk_conf.smart_rev_ramp_time + ::sep::Multiple VESCs over CAN-bus + app_chuk_conf.multi_esc + app_chuk_conf.tc + app_chuk_conf.tc_max_diff + + + + Throttle Curve + + app_chuk_conf.throttle_exp + app_chuk_conf.throttle_exp_brake + app_chuk_conf.throttle_exp_mode + + + + + NRF + + General + + ::sep::Radio + app_nrf_conf.power + app_nrf_conf.speed + app_nrf_conf.channel + ::sep::Integrity + app_nrf_conf.crc_type + app_nrf_conf.send_crc_ack + app_nrf_conf.retry_delay + app_nrf_conf.retries + ::sep::Address + app_nrf_conf.address__0 + app_nrf_conf.address__1 + app_nrf_conf.address__2 + + + + + Balance + + Tune + + ::sep::PID + app_balance_conf.kp + app_balance_conf.ki + app_balance_conf.kd + ::sep::Main Loop + app_balance_conf.hertz + app_balance_conf.loop_time_filter + ::sep::Filters + app_balance_conf.kd_pt1_lowpass_frequency + app_balance_conf.kd_pt1_highpass_frequency + app_balance_conf.kd_biquad_lowpass + app_balance_conf.kd_biquad_highpass + ::sep::Experimental + app_balance_conf.deadzone + + + + Tune Modifiers + + ::sep::Nose Angling + app_balance_conf.tiltback_constant + app_balance_conf.tiltback_constant_erpm + app_balance_conf.tiltback_variable + app_balance_conf.tiltback_variable_max + app_balance_conf.noseangling_speed + ::sep::Booster + app_balance_conf.booster_angle + app_balance_conf.booster_ramp + app_balance_conf.booster_current + ::sep::Torque Tiltback + app_balance_conf.torquetilt_strength + app_balance_conf.torquetilt_start_current + app_balance_conf.torquetilt_angle_limit + app_balance_conf.torquetilt_on_speed + app_balance_conf.torquetilt_off_speed + app_balance_conf.torquetilt_filter + ::sep::Turn/Roll Tiltback + app_balance_conf.turntilt_strength + app_balance_conf.turntilt_angle_limit + app_balance_conf.turntilt_start_angle + app_balance_conf.turntilt_start_erpm + app_balance_conf.turntilt_speed + app_balance_conf.turntilt_erpm_boost + app_balance_conf.turntilt_erpm_boost_end + + + + Startup + + ::sep::Tolerances + app_balance_conf.startup_pitch_tolerance + app_balance_conf.startup_roll_tolerance + ::sep::Centering + app_balance_conf.startup_speed + ::sep::Holding + app_balance_conf.brake_current + app_balance_conf.brake_timeout + + + + Tiltback + + ::sep::General Config + app_balance_conf.tiltback_return_speed + ::sep::Duty Cycle Tiltback + app_balance_conf.tiltback_duty + app_balance_conf.tiltback_duty_angle + app_balance_conf.tiltback_duty_speed + ::sep::High Voltage Tiltback + app_balance_conf.tiltback_hv + app_balance_conf.tiltback_hv_angle + app_balance_conf.tiltback_hv_speed + ::sep::Low Voltage Tiltback + app_balance_conf.tiltback_lv + app_balance_conf.tiltback_lv_angle + app_balance_conf.tiltback_lv_speed + + + + Fault + + ::sep::Angle Faults + app_balance_conf.fault_pitch + app_balance_conf.fault_delay_pitch + app_balance_conf.fault_roll + app_balance_conf.fault_delay_roll + ::sep::Speed Faults + app_balance_conf.fault_duty + app_balance_conf.fault_delay_duty + ::sep::Switches + app_balance_conf.fault_adc1 + app_balance_conf.fault_adc2 + app_balance_conf.fault_delay_switch_half + app_balance_conf.fault_delay_switch_full + app_balance_conf.fault_adc_half_erpm + + + + Multi ESC + + ::sep::Multi ESC + app_balance_conf.multi_esc + ::sep::Stabilization PID + app_balance_conf.yaw_kp + app_balance_conf.yaw_ki + app_balance_conf.yaw_kd + ::sep::Steering + app_balance_conf.roll_steer_kp + app_balance_conf.roll_steer_erpm_kp + app_balance_conf.yaw_current_clamp + + + + + IMU + + General + + imu_conf.type + imu_conf.sample_rate_hz + ::sep::Filters + imu_conf.mode + imu_conf.accel_confidence_decay + imu_conf.mahony_kp + imu_conf.mahony_ki + imu_conf.madgwick_beta + ::sep::Rotation + imu_conf.rot_roll + imu_conf.rot_pitch + imu_conf.rot_yaw + ::sep::Offsets + imu_conf.accel_offsets__0 + imu_conf.accel_offsets__1 + imu_conf.accel_offsets__2 + imu_conf.gyro_offsets__0 + imu_conf.gyro_offsets__1 + imu_conf.gyro_offsets__2 + + + + + PAS + + General + + app_pas_conf.ctrl_type + app_pas_conf.sensor_type + app_pas_conf.pedal_rpm_start + app_pas_conf.pedal_rpm_end + app_pas_conf.invert_pedal_direction + app_pas_conf.magnets + app_pas_conf.use_filter + app_pas_conf.current_scaling + app_pas_conf.ramp_time_pos + app_pas_conf.ramp_time_neg + app_pas_conf.update_rate_hz + + + + + diff --git a/res/config/6.00/parameters_mcconf.xml b/res/config/6.00/parameters_mcconf.xml new file mode 100644 index 000000000..51c010e63 --- /dev/null +++ b/res/config/6.00/parameters_mcconf.xml @@ -0,0 +1,4490 @@ + + + + + PWM Mode + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The PWM mode to use for BLDC motors. Synchronous is the most tested and recommended mode. The others are likely to cause problems.</span></p></body></html> + MCCONF_PWM_MODE + 1 + Nonsynchronous HISW + Synchronous + Bipolar + + + Commutation Mode + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Delay</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">This is what most cheap hobby ESCs use, which is detecting a BEMF zero crossing and adding a delay</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Integrate</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The back-EMF is sampled continuously after a zero crossing and the area under it is integrated. This is more robust and works better at low speed. For this mode the BEMF coupling and integration limit has to be know. The detect function can be used to measure these parameters.</p></body></html> + MCCONF_COMM_MODE + 0 + Integrate + Delay + + + Motor Type + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">BLDC</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Trapezoidal commutation mode for PMSM motors.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">DC</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">DC motor. A DC motor is connected to phase 1 and phase 3.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">FOC</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Field Oriented Control (FOC) for PMSM (or BLDC) motors. The motor is commutated with sine waves instead of a trapezoidal waveform as is the case for BLDC commutation. FOC runs the motors more quietly (especially at low speed and high load), is slightly more efficient and provides automatic optimal timing.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">GPD</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">General Purpose Drive between phase 1 and 3. Should be used with a custom application on the VESC, or on the computer with the VESC Tool backend providing samples.</span></p></body></html> + MCCONF_DEFAULT_MOTOR_TYPE + 2 + BLDC + DC + FOC + GPD + + + Sensor Mode + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Sensor mode for BLDC commutation. Hybrid means that sensors will be used at low speed and sensorless at high speed.</p></body></html> + MCCONF_SENSOR_MODE + 0 + Sensorless + Sensored + Hybrid + + + Motor Current Max + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Maximum motor current.</span></p></body></html> + MCCONF_L_CURRENT_MAX + 2 + 1 + 0 + 1000 + 0 + 0 + 1 + 60 + 1000 + A + 9 + + + Motor Current Max Brake + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Maximum (braking) motor current. The is the maximum current that will be fed back to the VESC and when braking, thus negative. The energy from the braking current will be fed back to the battery.</span></p></body></html> + MCCONF_L_CURRENT_MIN + 2 + 1 + 0 + 0 + -1000 + 0 + 1 + -60 + 1000 + A + 9 + + + Battery Current Max + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The maximum current that can be drawn from the battery. The battery current is always lower than or equal to the motor current.</span></p></body></html> + MCCONF_L_IN_CURRENT_MAX + 2 + 1 + 0 + 1000 + 0 + 0 + 1 + 99 + 1000 + A + 9 + + + Battery Current Max Regen + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The maximum regenerative current that can be fed to the battery (thus negative). The battery current is always lower than or equal to the motor current.</span></p></body></html> + MCCONF_L_IN_CURRENT_MIN + 2 + 1 + 0 + 0 + -1000 + 0 + 1 + -60 + 1000 + A + 9 + + + Absolute Maximum Current + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The current magnitute above which all output will be switched off and a fault code thrown. Usually the current control loops take care of limiting the current, but in some conditions short current spikes can appear very quickly. The system can handle them quite well in most cased, so this value can be set relatively high compared to the other current values to avoid cutouts.</span></p></body></html> + MCCONF_L_MAX_ABS_CURRENT + 2 + 1 + 0 + 1000 + 0 + 0 + 1 + 150 + 1000 + A + 9 + + + Max ERPM Reverse + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The maximum reverse electrical RPM.</p></body></html> + MCCONF_L_RPM_MIN + 2 + 1 + 0 + 0 + -1e+06 + 0 + 100 + -100000 + 1000 + + 9 + + + Max ERPM + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The maximum electrical RPM.</p></body></html> + MCCONF_L_RPM_MAX + 2 + 1 + 0 + 1e+06 + 0 + 0 + 100 + 100000 + 1000 + + 9 + + + ERPM Limit Start + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Start to reduce the current at this fraction of the ERPM limit. Lowering this number will make the ERPM limit softer.</span></p></body></html> + MCCONF_L_RPM_START + 2 + 1 + 1 + 1 + 0 + 1 + 0.01 + 0.8 + 10000 + + 7 + + + Max ERPM Full Brake + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The maximum ERPM at which a full brake is allowed (BLDC Only).</p></body></html> + MCCONF_L_CURR_MAX_RPM_FBRAKE + 2 + 1 + 0 + 1e+06 + 0 + 0 + 100 + 300 + 1000 + + 9 + + + Max ERPM Full Brake Current Control + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The ERPM below which a direction change is allowed in current control (BLDC Only).</p></body></html> + MCCONF_L_CURR_MAX_RPM_FBRAKE_CC + 2 + 1 + 0 + 1e+06 + 0 + 0 + 100 + 1500 + 1000 + + 9 + + + Minimum Input Voltage + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The input voltage below which a fault code is thrown.</p></body></html> + MCCONF_L_MIN_VOLTAGE + 2 + 1 + 0 + 700 + 0 + 0 + 1 + 8 + 1000 + V + 9 + + + Maximum Input Voltage + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The input voltage above which a fault code is thrown.</p></body></html> + MCCONF_L_MAX_VOLTAGE + 2 + 1 + 0 + 700 + 0 + 0 + 1 + 57 + 1000 + V + 9 + + + Battery Voltage Cutoff Start + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The input voltage where current starts to get reduced. There is still full braking current available as braking only charges the battery.</p></body></html> + MCCONF_L_BATTERY_CUT_START + 2 + 1 + 0 + 700 + 0 + 0 + 1 + 10 + 1000 + V + 9 + + + Battery Voltage Cutoff End + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The input voltage below which current draw is not allowed anymore. There is still full braking current available as braking only charges the battery.</p></body></html> + MCCONF_L_BATTERY_CUT_END + 2 + 1 + 0 + 700 + 0 + 0 + 1 + 8 + 1000 + V + 9 + + + Slow ABS Current Limit + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Use the filtered current for the ABS max fault code. Will not trigger as easily on very short spikes.</p></body></html> + MCCONF_L_SLOW_ABS_OVERCURRENT + 1 + + + MOSFET Temp Cutoff Start + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The MOSFET temperature at which motor current starts to get reduced.</span></p></body></html> + MCCONF_L_LIM_TEMP_FET_START + 1 + 1 + 0 + 190 + 0 + 1 + 1 + 85 + 10 + °C + 7 + + + MOSFET Temp Cutoff End + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The MOSFET temperature above which motor current is not allowed and a fault is thrown.</span></p></body></html> + MCCONF_L_LIM_TEMP_FET_END + 1 + 1 + 0 + 190 + 0 + 1 + 1 + 100 + 10 + °C + 7 + + + Motor Temp Cutoff Start + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The motor temperature at which motor current starts to get reduced.</span></p></body></html> + MCCONF_L_LIM_TEMP_MOTOR_START + 1 + 1 + 0 + 190 + 0 + 1 + 1 + 85 + 10 + °C + 7 + + + Motor Temp Cutoff End + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The motor temperature above which motor current is not allowed and a fault is thrown.</span></p></body></html> + MCCONF_L_LIM_TEMP_MOTOR_END + 1 + 1 + 0 + 190 + 0 + 1 + 1 + 100 + 10 + °C + 7 + + + Acceleration Temperature Decrease + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Decrease the motor and MOSFET temperature limits by this amount during acceleration. This is useful to still have braking torque left when the components get warm. A decrease of 0 % means that the acceleration temperature limits are the same as the braking temperature limits, and a decrease of 100 % meanse that the acceleration temperature limits are at 25 °C.</span></p></body></html> + MCCONF_L_LIM_TEMP_ACCEL_DEC + 0 + 100 + 1 + 1 + 0 + 1 + 1 + 0.15 + 10000 + % + 7 + + + Minimum Duty Cycle + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Minimum allowed duty cycle.</span></p></body></html> + MCCONF_L_MIN_DUTY + 1 + 100 + 0 + 1 + 0 + 1 + 0.5 + 0.005 + 10000 + % + 7 + + + Maximum Duty Cycle + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Maximum allowed duty cycle.</span></p></body></html> + MCCONF_L_MAX_DUTY + 1 + 100 + 0 + 1 + 0 + 1 + 0.5 + 0.95 + 10000 + % + 7 + + + Maximum Wattage + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Maximum allowed wattage output. If your region has laws that only allow a limited wattage, this parameter can be useful. However, keep in mind that limiting the wattage does not make much sense in practise since torque, heat losses, mechanical wear and component load are all current dependent.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Notice that setting this parameter to a very high value essentially disables it, which is why the default value is high. The other limits will still apply.</p></body></html> + MCCONF_L_WATT_MAX + 1 + 1 + 0 + 2e+06 + 0 + 0 + 1 + 1.5e+06 + 1 + W + 9 + + + Maximum Braking Wattage + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Maximum allowed braking wattage (thus negative). There usuallt aren't any laws limiting how much braking is allowed, and limiting the wattage does not make much sense in general, so this parameter is present mostly for the sake of completeness. There might be some applications where limiting the braking wattage is useful though.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Notice that setting this parameter to a very high value essentially disables it, which is why the default value is high. The other limits will still apply.</p></body></html> + MCCONF_L_WATT_MIN + 1 + 1 + 0 + 0 + -2e+06 + 0 + 1 + -1.5e+06 + 1 + W + 9 + + + Max Current Scale + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Maximum current scale. This value is multiplied with the maximum current. It is a convenient method to scale the current limits without forgetting the actual maximum value.</span></p></body></html> + MCCONF_L_CURRENT_MAX_SCALE + 2 + 1 + 1 + 1 + 0 + 1 + 0.05 + 1 + 10000 + + 7 + + + Min Current Scale + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Minimum current scale. This value is multiplied with the minimum current. It is a convenient method to scale the current limits without forgetting the actual maximum value.</span></p></body></html> + MCCONF_L_CURRENT_MIN_SCALE + 2 + 1 + 1 + 1 + 0 + 1 + 0.05 + 1 + 10000 + + 7 + + + Duty Cycle Current Limit Start + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Start to reduce the current at this duty cycle. Lowering this number will make the motor limit the torque softly when reaching max speed, however, it will also decrease the top speed a bit.</span></p></body></html> + MCCONF_L_DUTY_START + 2 + 1 + 1 + 1 + 0 + 1 + 0.01 + 1 + 10000 + + 7 + + + Minimum ERPM + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Minimum sensorless ERPM (BLDC Only). Run the motor in open loop when the estimated ERPM is below this value.</p></body></html> + MCCONF_SL_MIN_RPM + 2 + 1 + 0 + 1e+06 + 0 + 0 + 100 + 150 + 1000 + + 9 + + + Minimum ERPM Integrator + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The minimum ERPM for which the integrator limit is calculated. Setting this too low will make the coupling compensation too large at low speed resulting in bad startup.</span></p></body></html> + MCCONF_SL_MIN_ERPM_CYCLE_INT_LIMIT + 2 + 1 + 0 + 1e+06 + 0 + 0 + 100 + 1100 + 1000 + + 9 + + + Max Brake Current at Direction Change + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Only allow motor direction change below this current.</p></body></html> + MCCONF_SL_MAX_FB_CURR_DIR_CHANGE + 2 + 1 + 0 + 500 + 0 + 0 + 1 + 10 + 1000 + A + 9 + + + Cycle Integrator Limit + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Cycle ingegrator limit. This is how much area will be integrated under the back EMF after a zero crossing before doing a commutation. A too low value will cause a too early commutation, and a too high value will cause a too late commutation. A too late commutation will cause more problems than too early commutations.</span></p></body></html> + MCCONF_SL_CYCLE_INT_LIMIT + 1 + 1 + 0 + 3000 + 0 + 0 + 1 + 62 + 10 + + 7 + + + Phase Advance at BR ERPM + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Phase (timing) advance at the BR ERPM value. Below that value the advance will be less proportional to the current ERPM.</span></p></body></html> + MCCONF_SL_PHASE_ADVANCE_AT_BR + 2 + 1 + 0 + 1 + 0 + 0 + 0.05 + 0.8 + 10000 + + 7 + + + BR ERPM + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The ERPM at which phase advance (timing) is the maximum.</p></body></html> + MCCONF_SL_CYCLE_INT_BR + 2 + 1 + 0 + 1e+06 + 0 + 0 + 100 + 80000 + 1000 + + 9 + + + BEMF Coupling + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">BEMF coupling. Roughly describes how much of the input voltage is seen on the BEMF at low modulation. Compensating for that at low speed helps the startup a lot.</p></body></html> + MCCONF_SL_BEMF_COUPLING_K + 2 + 1 + 0 + 5000 + 0 + 0 + 1 + 600 + 1000 + + 9 + + + Hall Table [0] + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Hall sensor table entry for sensor output 0.</p></body></html> + MCCONF_HALL_TAB_0 + 1 + 0 + 6 + -1 + 0 + 1 + -1 + + 2 + + + Hall Table [1] + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Hall sensor table entry for sensor output 1.</p></body></html> + MCCONF_HALL_TAB_1 + 1 + 0 + 6 + -1 + 0 + 1 + 1 + + 2 + + + Hall Table [2] + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Hall sensor table entry for sensor output 2.</p></body></html> + MCCONF_HALL_TAB_2 + 1 + 0 + 6 + -1 + 0 + 1 + 3 + + 2 + + + Hall Table [3] + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Hall sensor table entry for sensor output 3.</p></body></html> + MCCONF_HALL_TAB_3 + 1 + 0 + 6 + -1 + 0 + 1 + 2 + + 2 + + + Hall Table [4] + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Hall sensor table entry for sensor output 4.</p></body></html> + MCCONF_HALL_TAB_4 + 1 + 0 + 6 + -1 + 0 + 1 + 5 + + 2 + + + Hall Table [5] + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Hall sensor table entry for sensor output 5.</p></body></html> + MCCONF_HALL_TAB_5 + 1 + 0 + 6 + -1 + 0 + 1 + 6 + + 2 + + + Hall Table [6] + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Hall sensor table entry for sensor output 6.</p></body></html> + MCCONF_HALL_TAB_6 + 1 + 0 + 6 + -1 + 0 + 1 + 4 + + 2 + + + Hall Table [7] + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Hall sensor table entry for sensor output 7.</p></body></html> + MCCONF_HALL_TAB_7 + 1 + 0 + 6 + -1 + 0 + 1 + -1 + + 2 + + + Sensorless ERPM Hybrid + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">ERPM above which sensorless commutation is used in hybrid mode.</p></body></html> + MCCONF_HALL_ERPM + 2 + 1 + 0 + 1e+06 + 0 + 0 + 100 + 2000 + 1000 + + 9 + + + Current KP + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Current controller proportional gain.</span></p></body></html> + MCCONF_FOC_CURRENT_KP + 4 + 1 + 0 + 100000 + 0 + 0 + 0.01 + 0.03 + 100000 + + 9 + + + Current KI + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Current controller integral gain.</span></p></body></html> + MCCONF_FOC_CURRENT_KI + 2 + 1 + 0 + 100000 + 0 + 0 + 0.01 + 50 + 100000 + + 9 + + + Zero Vector Frequency + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The frequency at which the output toggles between the zero vectors (V0 and V7) in the space vector modulation.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The controllers and estimators run at half of this frequency. If the option <span style=" font-weight:600;">Sample in V0 and V7</span> is active the controllers and estimators run at the full zero vector frequency, but this option is only available on hardware with phase shunts.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">NOTE</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">There has been some confusion on what the zero vector frequency is referring to. It is the rate between the zero vectors V0 (when all low-side switches are on) and V7 (when all high-side switches are on).</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">If you scope one of the phases you will see a signal at half the set frequency, which is what the timer runs at. That is because the motor phases will be shorted both when the signal is low and when it is high. This is one of the core concepts of space-vector modulation and how you can effectively double the switching frequency with the same amount of switching.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">There is also some frequency content at half of this frequency depending on the modulated vector, but it is mainly at the set switching frequency and this is also what matters when e.g. calculating ripple current due to motor inductance.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Some links to discussions about this:</p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">https://vesc-project.com/node/3278</p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">https://github.com/vedderb/bldc/pull/397</p></body></html> + MCCONF_FOC_F_ZV + 1 + 0.001 + 0 + 150000 + 0 + 0 + 1 + 25000 + 1000 + kHz + 9 + + + Dead Time Compensation + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Compensation for dead time distortion. Makes some difference at low speed.</p></body></html> + MCCONF_FOC_DT_US + 3 + 1 + 0 + 1000 + 0 + 0 + 0.01 + 0.12 + 1e+06 + µS + 9 + + + Encoder Inverted + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The encoder is inverted if it counts backwards while the motor is turning forwards.</p></body></html> + MCCONF_FOC_ENCODER_INVERTED + 0 + + + Encoder Offset + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Offset between the encoder zero and motor zero points.</p></body></html> + MCCONF_FOC_ENCODER_OFFSET + 2 + 1 + 0 + 360 + 0 + 0 + 1 + 180 + 1000 + + 9 + + + Encoder Ratio + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Ratio between encoder and motor. E.g. a 14 pole motor with a directly attached encoder has ratio 7.</p></body></html> + MCCONF_FOC_ENCODER_RATIO + 2 + 1 + 0 + 10000 + 0 + 0 + 1 + 7 + 1000 + + 9 + + + Sin/Cos Sine Gain Compensation + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Sin/Cos Encoder Sine gain compensation to reduce nonlinearity errors in the signal path.</span></p></body></html> + MCCONF_FOC_ENCODER_SIN_GAIN + 2 + 1 + 0 + 2 + 0 + 0 + 0.01 + 1 + 1000 + + 9 + + + Sin/Cos Cosine Gain Compensation + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Sin/Cos Encoder Cosine gain compensation to reduce nonlinearity errors in the signal path.</span></p></body></html> + MCCONF_FOC_ENCODER_COS_GAIN + 2 + 1 + 0 + 2 + 0 + 0 + 0.01 + 1 + 1000 + + 9 + + + Sin/Cos Sine Offset + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Sin/Cos Encoder Sine Offset.</span></p></body></html> + MCCONF_FOC_ENCODER_SIN_OFFSET + 2 + 1 + 0 + 3.3 + 0 + 0 + 0.01 + 1.65 + 1000 + + 9 + + + Sin/Cos Cosine Offset + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Sin/Cos Encoder Sine Offset.</span></p></body></html> + MCCONF_FOC_ENCODER_COS_OFFSET + 2 + 1 + 0 + 3.3 + 0 + 0 + 0.01 + 1.65 + 1000 + + 9 + + + Sin/Cos Filter Constant + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Sin/Cos Encoder low pass filter constant. </span><span style=" font-family:'Roboto';">Will affect the ratio between lag and noise on the encoder position feedback. Range 0 to 1, where 0 has the lowest noise and most phase lag, and 1 has no lag and unfiltered noise.</span></p></body></html> + MCCONF_FOC_ENCODER_SINCOS_FILTER + 2 + 1 + 0 + 1 + 0 + 0 + 0.01 + 0.5 + 1000 + + 9 + + + Sensor Mode + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Sensor mode for the motor.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Sensorless</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Don't use any position sensor on the motor and only rely on the observer and starting algorithm. Works well for most applications (not position control), but the start can be a bit delayed.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Encoder</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Use an encoder on the motor shaft. Works well for position control applications such as CNC mills.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Hall Sensors</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Use hall sensors with 60 or 120 degree spacing in the motor. Gives starts without any delay at all, but does not work that well for most position control applications.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">HFI</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">High Frequency Injection. Track the position down to 0 speed by injecting voltage pulses and analyzing the response of the motor. Works on most motors that have enough difference in D-axis and Q-axis inductance.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">VSS</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Vedder Sensorless Start. Use HFI just after starting the motor to resolve the initial position and set the observer state to that position. This can help the observer track the motor correctly from 0 speed. As this also is based on saturation it can help start some motors with low saliency.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">NOTE:</span> HFI and VSS only work when the FOC switching frequency is at or below 30 KHz. </p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-weight:600;"><br /></p></body></html> + MCCONF_FOC_SENSOR_MODE + 0 + Sensorless + Encoder + Hall Sensors + HFI + VSS + + + Speed Tracker Kp + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Speed tracker proportional gain. The speed tracker estimates the motor speed by tracking the phase angle.</p></body></html> + MCCONF_FOC_PLL_KP + 2 + 1 + 0 + 1e+06 + 0 + 0 + 1 + 2000 + 1000 + + 9 + + + Speed Tracker Ki + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Speed tracker integral gain. The speed tracker estimates the motor speed by tracking the phase angle.</p></body></html> + MCCONF_FOC_PLL_KI + 2 + 1 + 0 + 1e+06 + 0 + 0 + 1 + 30000 + 1000 + + 9 + + + Motor Inductance (L) + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The average of LD and LQ inductance.</p></body></html> + MCCONF_FOC_MOTOR_L + 2 + 1e+06 + 0 + 10 + 0 + 0 + 0.1 + 7e-06 + 1e+08 + µH + 9 + + + Motor Inductance Difference (Ld - Lq) + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The difference between Ld and Lq inductance. It represents the motor saliency. This can be measured using the <span style=" font-style:italic;">measure_ind</span> terminal command, but the regular detection interface does not print it yet.</p></body></html> + MCCONF_FOC_MOTOR_LD_LQ_DIFF + 2 + 1e+06 + 0 + 10 + 0 + 0 + 0.1 + 0 + 1e+08 + µH + 9 + + + Motor Resistance (R) + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The motor winding resistance. Should be half of what is measured between two motor wires.</span></p></body></html> + MCCONF_FOC_MOTOR_R + 1 + 1000 + 0 + 1000 + 0 + 0 + 0.1 + 0.015 + 100000 + + 9 + + + Motor Flux Linkage (λ) + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The flux linkage of the motor (λ) [mWb]</span></p></body></html> + MCCONF_FOC_MOTOR_FLUX_LINKAGE + 3 + 1000 + 0 + 1000 + 0 + 0 + 0.01 + 0.00245 + 100000 + mWb + 9 + + + Observer Gain (x1M) + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The observer gain. If the motor does not run smoothly with the calculated value, this value can be tweaked. Try with doubling or halving it in that case.</span></p></body></html> + MCCONF_FOC_OBSERVER_GAIN + 2 + 1e-06 + 0 + 2e+10 + 0 + 0 + 1 + 9e+07 + 0.01 + + 9 + + + Observer Gain At Minimum Duty + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The observer gain scaled at minimum duty cycle. Decreasing this parameter will make observer gain lower at lower modulation, which can help tracking the motor. Setting this parameter to 1 will make the observer gain constant at all modulations.</span></p></body></html> + MCCONF_FOC_OBSERVER_GAIN_SLOW + 2 + 1 + 1 + 1 + 0 + 1 + 0.01 + 0.05 + 0.01 + + 9 + + + Observer Offset + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Observer offset in switching cycles.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">There is some delay between when the current ant voltage measurements are taken and when the output is applied. This will cause the observer phase to lag behind the motor phase at high speed when the zero vector frequency is low in comparison.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">This parameter adds an offset to the observer phase in multiples of the zero vector frequency to compensate for that delay. The default value should be good for most hardwares, but if needed this value can be fine-tuned using and encoder and/or a power analyzer.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Important Note</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Before changing this value, make sure that any phase delay is not caused by incorrect motor parameters or incorrect measurements. Only change this value if you have excluded other possible causes and you know what you are doing.</p></body></html> + MCCONF_FOC_OBSERVER_OFFSET + 2 + 1 + 0 + 5 + -5 + 0 + 0.01 + -1 + 1000 + + 7 + + + Duty Downramp Kp + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The proportional gain for the duty downramp controller. This controller is used in duty cycle mode when the duty cycle is decreased. Since this is done by limiting the modulation, very large current spikes can be caused. By using a controller these current spikes can be limited.</p></body></html> + MCCONF_FOC_DUTY_DOWNRAMP_KP + 2 + 1 + 0 + 1e+06 + 0 + 0 + 1 + 10 + 1000 + + 9 + + + Duty Downramp Ki + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The integral gain for the duty downramp controller. This controller is used in duty cycle mode when the duty cycle is decreased. Since this is done by limiting the modulation, very large current spikes can be caused. By using a controller these current spikes can be limited.</p></body></html> + MCCONF_FOC_DUTY_DOWNRAMP_KI + 2 + 1 + 0 + 1e+06 + 0 + 0 + 1 + 200 + 1000 + + 9 + + + Openloop ERPM + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">ERPM below which openloop commutation is used when running sensorless. Can be tweaked for the best startup depending on e.g. the load inertia.</p></body></html> + MCCONF_FOC_OPENLOOP_RPM + 2 + 1 + 0 + 1e+06 + 0 + 0 + 100 + 400 + 1000 + + 9 + + + Openloop ERPM at Min Current + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The openloop ERPM is scaled with the set motor current. This is the fraction of Openloop ERPM at the minimum current.</span></p></body></html> + MCCONF_FOC_OPENLOOP_RPM_LOW + 2 + 1 + 1 + 1 + 0 + 1 + 0.01 + 0.1 + 1000 + + 7 + + + D Axis Gain Scaling Start + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Start decreasing the D axis current controller gain at this modulation.</span></p></body></html> + MCCONF_FOC_D_GAIN_SCALE_START + 2 + 1 + 1 + 1 + 0 + 1 + 0.01 + 0.9 + 1000 + + 9 + + + D Axis Gain Scaling at Max Mod + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">D axis current controller gain at maximum modulation.</span></p></body></html> + MCCONF_FOC_D_GAIN_SCALE_MAX_MOD + 2 + 1 + 1 + 1 + 0 + 1 + 0.01 + 0.2 + 1000 + + 9 + + + Openloop Hysteresis + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Go to openloop mode if the ERPM has been below the openloop RPM for this amount of time.</span></p></body></html> + MCCONF_FOC_SL_OPENLOOP_HYST + 2 + 1 + 0 + 100 + 0 + 0 + 0.05 + 0.1 + 100 + S + 7 + + + Openloop Lock Time + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Lock motor for this amount of time in the beginning of the open loop sequence.</span></p></body></html> + MCCONF_FOC_SL_OPENLOOP_T_LOCK + 2 + 1 + 0 + 100 + 0 + 0 + 0.05 + 0 + 100 + S + 7 + + + Openloop Ramp Time + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Ramp up the openloop speed in the openloop sequence for this amount of time.</span></p></body></html> + MCCONF_FOC_SL_OPENLOOP_T_RAMP + 2 + 1 + 0 + 100 + 0 + 0 + 0.05 + 0 + 100 + S + 7 + + + Openloop Time + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Stay in openloop for this amount of time after finishing the ramp.</span></p></body></html> + MCCONF_FOC_SL_OPENLOOP_TIME + 2 + 1 + 0 + 100 + 0 + 0 + 0.05 + 0.1 + 100 + S + 7 + + + Hall Table [0] + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Hall sensor table entry for sensor output 0.</p></body></html> + MCCONF_FOC_HALL_TAB_0 + 1 + 0 + 255 + 0 + 0 + 1 + 255 + + 1 + + + Hall Table [1] + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Hall sensor table entry for sensor output 1.</p></body></html> + MCCONF_FOC_HALL_TAB_1 + 1 + 0 + 255 + 0 + 0 + 1 + 255 + + 1 + + + Hall Table [2] + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Hall sensor table entry for sensor output 2.</p></body></html> + MCCONF_FOC_HALL_TAB_2 + 1 + 0 + 255 + 0 + 0 + 1 + 255 + + 1 + + + Hall Table [3] + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Hall sensor table entry for sensor output 3.</p></body></html> + MCCONF_FOC_HALL_TAB_3 + 1 + 0 + 255 + 0 + 0 + 1 + 255 + + 1 + + + Hall Table [4] + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Hall sensor table entry for sensor output 4.</p></body></html> + MCCONF_FOC_HALL_TAB_4 + 1 + 0 + 255 + 0 + 0 + 1 + 255 + + 1 + + + Hall Table [5] + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Hall sensor table entry for sensor output 5.</p></body></html> + MCCONF_FOC_HALL_TAB_5 + 1 + 0 + 255 + 0 + 0 + 1 + 255 + + 1 + + + Hall Table [6] + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Hall sensor table entry for sensor output 6.</p></body></html> + MCCONF_FOC_HALL_TAB_6 + 1 + 0 + 255 + 0 + 0 + 1 + 255 + + 1 + + + Hall Table [7] + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Hall sensor table entry for sensor output 7.</p></body></html> + MCCONF_FOC_HALL_TAB_7 + 1 + 0 + 255 + 0 + 0 + 1 + 255 + + 1 + + + Hall Interpolation ERPM + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">ERPM above which hall sensors are interpolated.</span></p></body></html> + MCCONF_FOC_HALL_INTERP_ERPM + 2 + 1 + 0 + 1e+06 + 0 + 0 + 10 + 500 + 1 + + 9 + + + Sensorless ERPM + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">ERPM above which sensorless commutation is used in sensored modes.</p></body></html> + MCCONF_FOC_SL_ERPM + 2 + 1 + 0 + 1e+06 + 0 + 0 + 100 + 2500 + 1000 + + 9 + + + Sample in V0 and V7 + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Sample currents and voltages in both V0 and V7 of the space vector modulation, and run the control loop at twice the rate. Can be useful for high speed motors at limited switching frequency, or in order to decrease the modulation noise. Notice that this option will require twice the amount of computational power for a given switching frequency.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Note</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">This option is only valid for hardware with phase shunts, such as the VESC Six. For other shunt configurations it is ignored.</span></p></body></html> + MCCONF_FOC_SAMPLE_V0_V7 + 0 + + + High Current Sampling Mode + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Choose the lowest currents during sampling to derive the highest current. Since the motor currents are balanced and sum to 0, two of the phase currents can be used to derive the third one. Enabling this option will make the current measurement compare all motor currents and derive the highest one from the two lower currents. This way higher currents can be measured than the ADC gain allows by a factor of 2 / sqrt(3), or roughly 1.15. For example, for the VESC6 this increases the current measurement capability from 165A to roughly 190A.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Note</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">This option is only valid for hardware with three shunts, such as the VESC Six. For other shunt configurations it is ignored.</span></p></body></html> + MCCONF_FOC_SAMPLE_HIGH_CURRENT + 0 + + + Stator Saturation Compensation + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Stator saturation compensation.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">When using high currents the stator of the motor can get saturated. This will change the motor parameters, making it difficult for the sensorless observer to track the rotor position. The effect is most noticeable when running the motor with high current at low speed - it will get stuck and then &quot;cog&quot; when open loop operation tries to restart the motor. If you observe this behavior you can try to increase this parameter. This parameter attempts to compensate for effects of stator saturation, making it possible to run motors sensorlessly even at high current and low speed.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Reasonable values for this parameters are 15 % or less. If going higher than that gives good results something else is most likely wrong in your configuration.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Consider the following:</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<ul style="margin-top: 0px; margin-bottom: 0px; margin-left: 0px; margin-right: 0px; -qt-list-indent: 1;"><li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Motors that run at low speed and high torque tend to get saturated, such as e-bike direct drive hub motors.</li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Coreless motors should in theory never get saturated.</li> +<li style=" font-family:'Roboto';" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The effect of this parameter is proportional to the maximum motor current limit, meaning that this parameter has no effect at zero current and full effect at full current. If you change the maximum motor current limit you have to adapt this parameter accordingly.</li></ul></body></html> + MCCONF_FOC_SAT_COMP + 2 + 1 + 1 + 1 + 0 + 1 + 0.01 + 0 + 1000 + + 7 + + + Temp Comp + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Use temperature compensation for the motor resistance used by the observer. Should help at low speed when the motor temperature is far away from the temperature at which the resistance was measured.</p></body></html> + MCCONF_FOC_TEMP_COMP + 0 + + + Temp Comp Base Temp + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Motor temperature at which the motor resistance was measured.</span></p></body></html> + MCCONF_FOC_TEMP_COMP_BASE_TEMP + 1 + 1 + 0 + 120 + -120 + 0 + 1 + 25 + 100 + °C + 7 + + + Current Filter Constant + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Constant for the filtered current in the FOC implementation. Will affect how fast the slow abs max current fault triggers. Range 0 to 1, where 0 is the slowest and 1 is no filtering.</span></p></body></html> + MCCONF_FOC_CURRENT_FILTER_CONST + 3 + 1 + 0 + 1 + 0 + 0 + 0.01 + 0.1 + 10000 + + 7 + + + Current Controller Decoupling + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">FOC current controller decoupling using feed forward. This will make the current controller perform better during transient conditions; it may also introduce some noise. The available modes are:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">FOC_CC_DECOUPLING_DISABLED</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Decoupling is disabled</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">FOC_CC_DECOUPLING_CROSS</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Cross decoupling between the D and Q axes is enabled.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">FOC_CC_DECOUPLING_BEMF</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Back EMF decoupling on the Q axis is enabled. This improves perfomance significantly if the motor speed changes rapidly, but makes the current controller depend on the speed tracker.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">FOC_CC_DECOUPLING_CROSS_BEMF</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Both options above are enabled.</p></body></html> + MCCONF_FOC_CC_DECOUPLING + 2 + FOC_CC_DECOUPLING_DISABLED + FOC_CC_DECOUPLING_CROSS + FOC_CC_DECOUPLING_BEMF + FOC_CC_DECOUPLING_CROSS_BEMF + + + Observer Type + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Type of rotor position observer for field oriented control (FOC). The options are:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">FOC_OBSERVER_ORTEGA_ORIGINAL</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The observer described here:</p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><a href="http://cas.ensmp.fr/~praly/Telechargement/Journaux/2010-IEEE_TPEL-Lee-Hong-Nam-Ortega-Praly-Astolfi.pdf"><span style=" text-decoration: underline; color:#0000ff;">http://cas.ensmp.fr/~praly/Telechargement/Journaux/2010-IEEE_TPEL-Lee-Hong-Nam-Ortega-Praly-Astolfi.pdf</span></a></p></body></html> + MCCONF_FOC_OBSERVER_TYPE + 0 + FOC_OBSERVER_ORTEGA_ORIGINAL + + + HFI Start Voltage + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">HFI voltage at start to resolve ambiguity. This voltage has to cause a current that is high enough to see signs of saturation in the motor.</span></p></body></html> + MCCONF_FOC_HFI_VOLTAGE_START + 2 + 1 + 0 + 700 + 0 + 0 + 1 + 20 + 1000 + V + 9 + + + HFI Run Voltage + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">HFI voltage during operation, after ambiguity has been resolved.</span></p></body></html> + MCCONF_FOC_HFI_VOLTAGE_RUN + 2 + 1 + 0 + 700 + 0 + 0 + 1 + 4 + 1000 + V + 9 + + + HFI Max Voltage + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">HFI voltage during operation, at maximum current. Increasing the voltage at higher currents helps with tracking. A higher voltage makes HFI noisier and wastes more power, which is why this option allows increasing it at high motor currents when it is needed.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The HFI voltage is mapped between voltage_run and voltage_max, relative to the motor current.</span></p></body></html> + MCCONF_FOC_HFI_VOLTAGE_MAX + 2 + 1 + 0 + 700 + 0 + 0 + 1 + 10 + 1000 + V + 9 + + + Sensorless ERPM HFI + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">ERPM below which HFI is used.</span></p></body></html> + MCCONF_FOC_SL_ERPM_HFI + 2 + 1 + 0 + 1e+06 + 0 + 0 + 100 + 2000 + 1000 + + 9 + + + HFI Start Samples + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Number of HFI samples to resolve ambiguity at start. Every sample takes a bit more than 0.5 ms, and no throttle can be applied during this time. The default value is barely noticeable.</p></body></html> + MCCONF_FOC_HFI_START_SAMPLES + 1 + 0 + 60000 + 2 + 0 + 1 + 65 + + 3 + + + HFI Observer Override Time + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Override HFI position with observer position for this amount of time after dropping below the HFI ERPM threshold. This can prevent oscillating between the two at a transition. Settings this value too high can make HFI catch the motor 180 electrical degrees off, as the observer position might degrade too much.</p></body></html> + MCCONF_FOC_HFI_OBS_OVR_SEC + 1 + 1000 + 0 + 5000 + 0 + 0 + 1 + 0.001 + 1000 + ms + 9 + + + HFI Samples + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Number of HFI samples for each motor revolution. This can't be an arbitrary number as the size of fourier transforms and sine tables depends on it.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Fewer samples will give noisier measurements, but allows estimating the position at a higher rate. The noise can be reduced by increasing the HFI voltage.</p></body></html> + MCCONF_FOC_HFI_SAMPLES + 1 + 8 + 16 + 32 + + + Run calibration at boot + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Run calibration every boot.</p></body></html> + MCCONF_FOC_OFFSETS_CAL_ON_BOOT + 1 + + + Current Offset 0 + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Current channel 0 offset in ADC counts.</p></body></html> + MCCONF_FOC_OFFSETS_CURRENT_0 + 2 + 1 + 0 + 8192 + 0 + 0 + 1 + 2048 + 1 + + 9 + + + Current Offset 1 + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Current channel 1 offset in ADC counts.</p></body></html> + MCCONF_FOC_OFFSETS_CURRENT_1 + 2 + 1 + 0 + 8192 + 0 + 0 + 1 + 2048 + 1 + + 9 + + + Current Offset 2 + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Current channel 2 offset in ADC counts.</p></body></html> + MCCONF_FOC_OFFSETS_CURRENT_2 + 2 + 1 + 0 + 8192 + 0 + 0 + 1 + 2048 + 1 + + 9 + + + Voltage Offset 0 + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Voltage channel 0 offset. This is at the ADC input, so it is not scaled with the voltage dividers.</p></body></html> + MCCONF_FOC_OFFSETS_VOLTAGE_0 + 4 + 1 + 0 + 2 + -2 + 0 + 0.0005 + 0 + 10000 + V + 7 + + + Voltage Offset 1 + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Voltage channel 1 offset. This is at the ADC input, so it is not scaled with the voltage dividers.</p></body></html> + MCCONF_FOC_OFFSETS_VOLTAGE_1 + 4 + 1 + 0 + 2 + -2 + 0 + 0.0005 + 0 + 10000 + V + 7 + + + Voltage Offset 2 + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Voltage channel 2 offset. This is at the ADC input, so it is not scaled with the voltage dividers.</p></body></html> + MCCONF_FOC_OFFSETS_VOLTAGE_2 + 4 + 1 + 0 + 2 + -2 + 0 + 0.0005 + 0 + 10000 + V + 7 + + + Voltage Offset Undriven 0 + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Voltage channel 0 offset when the motor is undriven. This is at the ADC input, so it is not scaled with the voltage dividers.</p></body></html> + MCCONF_FOC_OFFSETS_VOLTAGE_UNDRIVEN_0 + 4 + 1 + 0 + 2 + -2 + 0 + 0.0005 + 0 + 10000 + V + 7 + + + Voltage Offset Undriven 1 + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Voltage channel 1 offset when the motor is undriven. This is at the ADC input, so it is not scaled with the voltage dividers.</p></body></html> + MCCONF_FOC_OFFSETS_VOLTAGE_UNDRIVEN_1 + 4 + 1 + 0 + 2 + -2 + 0 + 0.0005 + 0 + 10000 + V + 7 + + + Voltage Offset Undriven 2 + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Voltage channel 2 offset when the motor is undriven. This is at the ADC input, so it is not scaled with the voltage dividers.</p></body></html> + MCCONF_FOC_OFFSETS_VOLTAGE_UNDRIVEN_2 + 4 + 1 + 0 + 2 + -2 + 0 + 0.0005 + 0 + 10000 + V + 7 + + + Enable Phase Filters + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">This enables the use of phase voltage filters on hardware that supports it. Instead of calculating the phase voltage from the input voltage and modulation, it is measured directly by low-pass filtering the power stage output. The advantage of doing so is that it eliminates dead-time distortion, which helps track the motor at very low speeds. It should also be very useful on hardware with an IGBT output stage, as it compensated for the effect of IGBT voltage drop too.</p></body></html> + MCCONF_FOC_PHASE_FILTER_ENABLE + 1 + + + Maximum ERPM for phase filters + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Use the filtered phase voltage up until this ERPM, then use the value derived from the input voltage and the modilation. The delay and attenuation from the phase filters increases with the motor speed, while the dead-time distortion becomes less significant. The delay and attenuation is partly compensated for, but at some point it is still better to derive the phase voltages from the input voltage and modulation. This parameter sets that point.</p></body></html> + MCCONF_FOC_PHASE_FILTER_MAX_ERPM + 0 + 1 + 0 + 100000 + 0 + 0 + 10 + 10000 + 10000 + ERPM + 9 + + + MTPA Algorithm Mode + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">This parameter will enable the Maximum Torque Per Amp (MTPA) algorithm that injects a negative d axis current to follow the optimum torque trajectory. This is specially valuable on Interior Permanent Magnet (IPM) motors because they have large saliency and can yield a substantial torque increase.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The available modes are:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Disabled</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">This disables the MTPA algorithm.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">IQ Target</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The D-axis current is based on the set Q-axis current. This makes the target value less noisy, but relies on the current controller keeping keeping the Q-axis current close to the set value. This mode does not work well with duty cycle control.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">IQ Measured</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The D-axis current is based on the measured Q-axis current. The commanded D-axis current will be more affected by noise, but it does not rely on the Q-axis current controller to keep the current at the set value.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Note:</span> Only enable this feature if you know very well what you are doing. IPM motors are not popular and injecting negative id current can increase the motor speed. If id current suddenly collapses (under a fault condition for example) the DC Bus voltage can increase well beyond the powerstage rating causing a fire and maximum braking power at the motor shaft.</p></body></html> + MCCONF_FOC_MTPA_MODE + 0 + Disabled + IQ Target + IQ Measured + + + Field Weakening Current Max + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Maximum field weakening (FW) current.</span></p></body></html> + MCCONF_FOC_FW_CURRENT_MAX + 2 + 1 + 0 + 1000 + 0 + 0 + 1 + 0 + 1000 + A + 9 + + + Field Weakening Duty Start + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Start field weakening at this fraction of maximum duty cycle. </span></p></body></html> + MCCONF_FOC_FW_DUTY_START + 1 + 100 + 0 + 1 + 0 + 1 + 0.5 + 0.9 + 10000 + % + 7 + + + Q Axis Current Factor + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Give the q axis current this much of the field weakening current as braking current (opposite to the current direction). This helps slow the motor down when commanding 0 current in case the position has an offset and the field weakening current contributes with torque.</span></p></body></html> + MCCONF_FOC_FW_Q_CURRENT_FACTOR + 1 + 100 + 0 + 1 + 0 + 1 + 0.5 + 0.02 + 10000 + % + 7 + + + Field Weakening Ramp Time + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Minimum time to ramp the field weakening current. Setting this to 0 will make the field weakening respond instantly (limited by the D axis current controller).</p></body></html> + MCCONF_FOC_FW_RAMP_TIME + 0 + 1000 + 0 + 30 + 0 + 0 + 10 + 0 + 1000 + ms + 7 + + + Buffer Notification Length + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Send notification when the sample fifo buffer has less than this amount of samples left.</p></body></html> + MCCONF_GPD_BUFFER_NOTIFY_LEFT + 1 + 0 + 2048 + 0 + 0 + 10 + 200 + + 4 + + + Buffer Sampling Interpolation + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Interpolate buffer samples, meaning that they are used for several pwm cycles. This number defines for how many samples a sample is reused. 0 means that a new sample is picked every cycle, 1 means that one sample is used twice etc.</p></body></html> + MCCONF_GPD_BUFFER_INTERPOL + 1 + 0 + 2048 + 0 + 0 + 1 + 0 + + 4 + + + Current Filter Constant + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Constant for the filtered current in the GPD implementation. Will affect how fast the slow abs max current fault triggers. Range 0 to 1, where 0 is the slowest and 1 is no filtering.</span></p></body></html> + MCCONF_GPD_CURRENT_FILTER_CONST + 3 + 1 + 0 + 1 + 0 + 0 + 0.01 + 0.1 + 10000 + + 7 + + + Current KP + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Current controller proportional gain.</span></p></body></html> + MCCONF_GPD_CURRENT_KP + 4 + 1 + 0 + 100000 + 0 + 0 + 0.01 + 0.03 + 100000 + + 9 + + + Current KI + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Current controller integral gain.</span></p></body></html> + MCCONF_GPD_CURRENT_KI + 2 + 1 + 0 + 100000 + 0 + 0 + 0.01 + 50 + 100000 + + 9 + + + PID Loop Rate + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Rate at which the position and speed controllers run.</p></body></html> + MCCONF_SP_PID_LOOP_RATE + 5 + 25 Hz + 50 Hz + 100 Hz + 250 Hz + 500 Hz + 1000 Hz + 2500 Hz + 5000 Hz + 10000 Hz + + + Speed PID Kp + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Proportional gain for the speed controller. FOC and BLDC need different parameters because their speed controllers differ.</p></body></html> + MCCONF_S_PID_KP + 5 + 1 + 0 + 10000 + 0 + 0 + 0.0001 + 0.004 + 1e+06 + + 9 + + + Speed PID Ki + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Integral gain for the speed controller. FOC and BLDC need different parameters because their speed controllers differ.</p></body></html> + MCCONF_S_PID_KI + 5 + 1 + 0 + 10000 + 0 + 0 + 0.0001 + 0.004 + 1e+06 + + 9 + + + Speed PID Kd + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Derivative gain for the speed controller. FOC and BLDC need different parameters because their speed controllers differ.</p></body></html> + MCCONF_S_PID_KD + 5 + 1 + 0 + 10000 + 0 + 0 + 0.0001 + 0.0001 + 1e+06 + + 9 + + + Speed PID Kd Filter + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Filter on derivative term for speed controller. The range is 0 to 1, where 0 is the maximum amount of filtering (infinite) and 1 is no filtering.</span></p></body></html> + MCCONF_S_PID_KD_FILTER + 3 + 1 + 0 + 1 + 0 + 0 + 0.01 + 0.2 + 10000 + + 7 + + + Minimum ERPM + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">ERPM below which the speed controller is disabled.</p></body></html> + MCCONF_S_PID_MIN_RPM + 1 + 1 + 0 + 1e+06 + 0 + 0 + 100 + 900 + 1000 + + 9 + + + Allow Braking + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Allow the speed controller to to apply braking current. In general this option should be enabled, but for some applications it might make sense to disable braking during speed control.</p></body></html> + MCCONF_S_PID_ALLOW_BRAKING + 1 + + + Ramp eRPMs per second + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">This allows to control how fast the input of the speed command is allowed to increase each second. If user does not want to use this ramp, just apply a negative value such as -1.0. Only positive values are considered.</span></p></body></html> + MCCONF_S_PID_RAMP_ERPMS_S + 2 + 1 + 0 + 100000 + -1 + 0 + 1 + 25000 + 1000 + + 9 + + + Position PID Kp + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Proportional gain for the position controller.</p></body></html> + MCCONF_P_PID_KP + 5 + 1 + 0 + 10000 + 0 + 0 + 0.001 + 0.03 + 1e+06 + + 9 + + + Position PID Ki + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Integral gain for the position controller.</p></body></html> + MCCONF_P_PID_KI + 5 + 1 + 0 + 10000 + 0 + 0 + 0.001 + 0 + 1e+06 + + 9 + + + Position PID Kd + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Derivative gain for the position controller.</p></body></html> + MCCONF_P_PID_KD + 5 + 1 + 0 + 10000 + 0 + 0 + 0.0001 + 0.0004 + 1e+06 + + 9 + + + Position PID Offset Angle + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Angle offset for the position controller.</p></body></html> + MCCONF_P_PID_OFFSET + 4 + 1 + 0 + 360 + -360 + 0 + 1 + 0 + 1e+06 + ° + 9 + + + Position PID Kd Process + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Derivative gain for the position controller. This derivative term is applied on the process variable (position_now) only and not on the error term (position_set - position_now). This way oscillations can be dampened without amplifying control signal input.</p></body></html> + MCCONF_P_PID_KD_PROC + 5 + 1 + 0 + 10000 + 0 + 0 + 0.0001 + 0.0004 + 1e+06 + + 9 + + + Position PID Kd Filter + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Filter on derivative term for position controller. The range is 0 to 1, where 0 is the maximum amount of filtering (infinite) and 1 is no filtering.</span></p></body></html> + MCCONF_P_PID_KD_FILTER + 3 + 1 + 0 + 1 + 0 + 0 + 0.01 + 0.2 + 1e+06 + + 9 + + + Position Angle Division + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Angle division for the position controller. Can be used to map one control rotation to several motor rotations.</p></body></html> + MCCONF_P_PID_ANG_DIV + 3 + 1 + 0 + 10000 + 0 + 0 + 1 + 1 + 100000 + + 9 + + + Gain Decrease Angle + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Decrease position PID-gains when the erros is below this angle in electrical degrees. Helps at low speed when using low resolution encoders, such as hall sensors. A value of around 300 seems to work ok with hall sensors.</span></p></body></html> + MCCONF_P_PID_GAIN_DEC_ANGLE + 1 + 1 + 0 + 3000 + 0 + 0 + 1 + 0 + 10 + ° + 7 + + + Startup boost + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Startup boost in current control. Essentially defines the lowest duty cycle to be used in current control mode, to give a bit more punch when starting.</p></body></html> + MCCONF_CC_STARTUP_BOOST_DUTY + 3 + 1 + 0 + 1 + 0 + 0 + 0.005 + 0.01 + 1e+06 + + 9 + + + Minimum Current + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Minimum current used by the current controller. Commanded currents below this value will release the motor.</p></body></html> + MCCONF_CC_MIN_CURRENT + 2 + 1 + 0 + 500 + 0 + 0 + 1 + 0.05 + 1000 + A + 9 + + + Current Controller Gain + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Gain for the BLDC and DC current controller. Should be lower for low inductance motors.</p></body></html> + MCCONF_CC_GAIN + 5 + 1 + 0 + 5 + 0 + 0 + 0.0005 + 0.0046 + 1e+06 + + 9 + + + Current Control Ramp Step Max + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Maximum duty cycle ramp step in current control mode for DC and BLDC motors.</p></body></html> + MCCONF_CC_RAMP_STEP + 4 + 1 + 0 + 1 + 0 + 0 + 0.005 + 0.04 + 1e+06 + + 9 + + + Fault Stop Time + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Amount of time to leave the motor disabled after a fault code.</p></body></html> + MCCONF_M_FAULT_STOP_TIME + 1 + 0 + 30000000 + -1 + 0 + 500 + 500 + ms + 6 + + + Duty Ramp Step Max + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Maximum duty cycle ramp step for DC and BLDC motors.</p></body></html> + MCCONF_M_RAMP_STEP + 4 + 1 + 0 + 1 + 0 + 0 + 0.005 + 0.02 + 1e+06 + + 9 + + + Current Backoff Gain + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Gain for the BLDC and DC current backoff. Used to limit the current in duty cycle mode.</p></body></html> + MCCONF_M_CURRENT_BACKOFF_GAIN + 4 + 1 + 0 + 50 + 0 + 0 + 0.01 + 0.5 + 1e+06 + + 9 + + + ABI Encoder Counts + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Number of counts for the A-B-Index encoder. This usually is the encoder resolution times 4, since every edge in the quadrature signal is counted. This setting only matters when using an ABI encoder.</p></body></html> + MCCONF_M_ENCODER_COUNTS + 1 + 0 + 30000000 + 0 + 0 + 1 + 8192 + + 5 + + + Sensor Port Mode + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Mode for the sensor port. Can be changed for compatibility with different rotor position sensors. Notice that this setting does not have any impact when running sensorless. </span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The modes are:</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Hall Sensors</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The motor has hall sensors built in which give a position resolution of 120 degrees.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">ABI Encoder</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">A rotary encoder with A-B-Index output. Notice that this encoder does not help until the index pulse is found, so when running FOC open loop mode will be used for up to one mechanical revolution to find the index position when trying to run a motor for the first time after a power cycle.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Notice that you also have to set the number of encoder counts in order to use this type of encoder. This usually is the number of pulses per revolution times 4, since every edge of both pulse trains is counted.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">AS5047 Encoder</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">An AS5047 magnetic encoder connected over SPI. This one provides absolute positions from start, but tends to have a bit of nonlinearity.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">SIN/COS Encoder</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">A Sin/Cos encoder is a position feedback device similar to a quadrature encoder, except instead of outputting digital pulses, it outputs analog voltages with sinusoidal shapes offset by 90°. Provides absolute positions from the start, but its sensitive to EMI and requires special filtering, transient protections and shielded wiring.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">TS5700N8501 Encoder</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">This encoder uses RS485, so it has to be connected to the COMM port. A RS485-transceiver such as the </span><span style=" font-family:'sans-serif';">ADM485 is required, where RX and TX are used as the data lines. ADC1 is used to trigger between RX and TX, which is needed as the communication is half duplex. To use this encoder, you have to make sure that no app uses UART or ADC1.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'sans-serif';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">TS5700N8501 Encoder Multiturn</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Same as above, but uses the multiturn function. The angle is divided by 10000, thus can be used for up to 10000 revolutions. The position PID parameters need to be increased by a factor of around 10000 for this to work similarly to the single turn mode. Note that this is not a good implementation and needs improvement in the future. 180 degrees PID setpoint corresponds to multiturn position 0.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'sans-serif';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">MT6816 Encoder</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">A magnetic encoder using a high speed SPI communication. Provides absolute position from start. It has to be connected to a hardware-based SPI peripheral.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p></body></html> + MCCONF_M_SENSOR_PORT_MODE + 0 + Hall Sensors + ABI Encoder + AS5047 Encoder + AD2S1205 Resolver + Sin/Cos Encoder + TS5700N8501 Encoder + TS5700N8501 Encoder (Multiturn) + MT6816 Encoder (SPI) + + + Invert Motor Direction + 5 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Invert the motor direction. This option can be used to make the motor turn in the opposite direction. All state and control commands in <span style=" font-weight:600;">mc_interface</span> will respect this setting, so it should work as well as swithcing two motor cables for all applications.</p></body></html> + MCCONF_M_INVERT_DIRECTION + 0 + + + DRV8301 OC Mode + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The mode for the over current protection feature of the DRV8301. The over current protection in the DRV8301 works by measuring the voltage drop across the MOSFETs and shuts them off of it exceeds a configurable limit.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Notice</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">This setting only has impact on hardware with the DRV8301</p></body></html> + MCCONF_M_DRV8301_OC_MODE + 0 + Current Limit + OC Latch Shutdown + Report Only + Disabled + + + DRV8301 OC Adjustment + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The threshold for the over current protection feature of the DRV8301. Lower values correspond to lower currents. See the datasheet for more imformation about this setting.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Notice</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">This setting only has impact on hardware with the DRV8301</p></body></html> + MCCONF_M_DRV8301_OC_ADJ + 1 + 0 + 31 + 0 + 0 + 1 + 16 + + 1 + + + Minimum Switching Frequency + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The minimum switching frequency in BLDC mode.</p></body></html> + MCCONF_M_BLDC_F_SW_MIN + 2 + 0.001 + 0 + 40000 + 3000 + 0 + 1 + 3000 + 1 + kHz + 9 + + + Maximum Switching Frequency + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The maximum switching frequency in BLDC mode.</p></body></html> + MCCONF_M_BLDC_F_SW_MAX + 2 + 0.001 + 0 + 40000 + 3000 + 0 + 1 + 35000 + 1 + kHz + 9 + + + Switching Frequency + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The switching frequency in DC mode.</p></body></html> + MCCONF_M_DC_F_SW + 2 + 0.001 + 0 + 25000 + 3000 + 0 + 1 + 25000 + 1 + kHz + 9 + + + Beta Value for Motor Thermistor + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Beta Value for Motor Thermistor.</p></body></html> + MCCONF_M_NTC_MOTOR_BETA + 1 + 1 + 0 + 100000 + 100 + 0 + 1 + 3380 + 1 + K + 9 + + + Auxiliary Output Mode + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Auxiliary output mode. Can be used to e.g. activate a relay after a certain delay for bus capacitor precharging.</p></body></html> + MCCONF_M_OUT_AUX_MODE + 0 + Off + On after 2 seconds + On after 5 seconds + On after 10 seconds + Unused + On when running + On when not running + Temp motor > 50 C + Temp mosfet > 50 C + Temp motor > 70 C + Temp mosfet > 70 C + Temp motor or mosfet > 50 C + Temp motor or mosfet > 70 C + + + Motor Temperature Sensor Type + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Motor temperature sensor type. Most small hobby motors have a 10K NTC thermistor, whereas some larger motors have 1K PTC thermistors (such as the KTY84).</p></body></html> + MCCONF_M_MOTOR_TEMP_SENS_TYPE + 0 + NTC 10K at 25°C + PTC 1K at 100 °C + KTY83/122 + NTC 100K at 25°C + KTY84/130 + + + Coefficient for PTC Motor Thermistor + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Coefficient for PTC Motor Thermistor. Unit: %/K</span></p></body></html> + MCCONF_M_PTC_MOTOR_COEFF + 3 + 1 + 0 + 100 + 0.05 + 0 + 0.01 + 0.61 + 1 + %/K + 9 + + + Hall Sensor Extra Samples + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Read the hall sensor port this many extra samples and use a median filter. Increasing this number will reduce noise on the hall sensor readings, but makes the motor control interrupt take longer and thus limits the maximum switching frequency.</p></body></html> + MCCONF_M_HALL_EXTRA_SAMPLES + 1 + 0 + 99 + 0 + 0 + 1 + 1 + + 1 + + + Motor Poles + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Motor pole count. Most outrunners have 14 poles. Inrunners usually have 2 or 4 poles. The motor pole count is required for speed and travel distance calculation.</p></body></html> + MCCONF_SI_MOTOR_POLES + 1 + 0 + 254 + 2 + 0 + 2 + 14 + + 1 + + + Gear Ratio + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Gear ratio. For example, if the motor has a 12 tooth pulley and the wheel has a 36 tooth pulley, the gear ratio is:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">36 / 12 = <span style=" font-weight:600;">3.0</span></p></body></html> + MCCONF_SI_GEAR_RATIO + 3 + 1 + 0 + 9999 + 0 + 0 + 0.1 + 3 + 1 + + 9 + + + Wheel Diameter + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Wheel diameter, in mm.</p></body></html> + MCCONF_SI_WHEEL_DIAMETER + 2 + 1000 + 0 + 9999 + 0 + 0 + 1 + 0.083 + 1 + mm + 9 + + + Battery Type + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Battery Type</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">BATTERY_TYPE_LIION_3_0__4_2</span>,</p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Lithoium ion, voltage range: 3.0 to 4.2</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">BATTERY_TYPE_LIIRON_2_6__3_6</span>,</p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Lithoium iron phosphate, voltage range: 2.6 to 3.6</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">BATTERY_TYPE_LEAD_ACID</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Lead Acic, voltage range: 2.1 to 2.36</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p></body></html> + MCCONF_SI_BATTERY_TYPE + 0 + BATTERY_TYPE_LIION_3_0__4_2 + BATTERY_TYPE_LIIRON_2_6__3_6 + BATTERY_TYPE_LEAD_ACID + + + Battery Cells Series + 2 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Battery cells in series.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p></body></html> + MCCONF_SI_BATTERY_CELLS + 1 + 0 + 255 + 1 + 0 + 1 + 3 + + 1 + + + Battery Capacity + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Battery capacity in ampere hours.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p></body></html> + MCCONF_SI_BATTERY_AH + 3 + 1 + 0 + 1000 + 0 + 0 + 0.1 + 6 + 1 + Ah + 9 + + + Motor No Load Current + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">No load current for the motor. Can be measured by running the motor at around 50% duty cycle without load and noting the motor current draw.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The no load current can be used in the motor comparison tool for calculating efficiencies and comparing different motors, gear ratios etc.</p></body></html> + MCCONF_SI_MOTOR_NL_CURRENT + 4 + 1 + 0 + 999 + 0 + 0 + 0.1 + 1 + 1 + A + 9 + + + Motor Brand + 3 + 0 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The motor brand, e.g. Turnigy.</p></body></html> + + Unnamed + + + Motor Model + 3 + 0 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The motor model, e.g. 6374 168KV.</p></body></html> + + Not Specified + + + Motor Weight + 1 + 0 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The weight of the motor in grams.</span></p></body></html> + + 2 + 1 + 0 + 500000 + 0 + 0 + 1 + 0 + 1 + g + 9 + + + Position Sensor + 4 + 0 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Does this motor come with some kind of position sensor?</p></body></html> + + 0 + No sensor + Hall Sensors + ABI Encoder + AS5047 Encoder + Other Sensor + + + Motor Description + 3 + 0 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">This is an editor where a description can be stored for your motor configuration. Images can also be inserted. Notice that this information is not written to the VESC, so it has to be stored in an XML file.</span></p></body></html> + + A motor description can be edited here. + + + Bearing Quality + 2 + 0 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Motor bearing quality. 0 is neutral/unknown, negative is bad and positive is good.</span></p></body></html> + + 1 + 0 + 5 + -5 + 1 + 1 + 0 + + 2 + + + Magnet Quality + 2 + 0 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Motor magnet quality. 0 is neutral/unknown, negative is bad and positive is good.</span></p></body></html> + + 1 + 0 + 5 + -5 + 1 + 1 + 0 + + 2 + + + Construction Quality + 2 + 0 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Motor construction quality. 0 is neutral/unknown, negative is bad and positive is good.</span></p></body></html> + + 1 + 0 + 5 + -5 + 1 + 1 + 0 + + 2 + + + Quality Description + 3 + 0 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">A text summary of the motor quality.</p></body></html> + + Some comments about the motor quality. Images can be added as well. + + + BMS Type + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Type of BMS. This determines how BMS-related messages on the CAN-bus are interpreted. Options are:</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">None</span>:</p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">No BMS is used. All messages on the CAN-bus are ignored by the BMS module.</p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">VESC BMS:</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">The VESC BMS is used.</p></body></html> + MCCONF_BMS_TYPE + 1 + None + VESC BMS + + + Temperature Limit Start + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The battery temperature above which battery current starts to get reduced.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">If there is more than one BMS on the CAN-bus, the one with the highest value will be ued.</span></p></body></html> + MCCONF_BMS_T_LIMIT_START + 1 + 1 + 0 + 99 + 0 + 1 + 1 + 45 + 100 + °C + 7 + + + Temperature Limit End + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The battery temperature above which battery current is not allowed and a fault is thrown.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">If there is more than one BMS on the CAN-bus, the one with the highest value will be ued.</span></p></body></html> + MCCONF_BMS_T_LIMIT_END + 1 + 1 + 0 + 99 + 0 + 1 + 1 + 65 + 100 + °C + 7 + + + SOC Limit Start + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The battery state of charge (SOC) below which battery current starts to get reduced.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">If there is more than one BMS on the CAN-bus, the one with the lowest value will be ued.</span></p></body></html> + MCCONF_BMS_SOC_LIMIT_START + 2 + 1 + 1 + 1 + 0 + 1 + 0.01 + 0.05 + 1000 + + 7 + + + SOC Limit End + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">The battery state of charge (SOC) below which battery current is not allowed anymore.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">If there is more than one BMS on the CAN-bus, the one with the lowest value will be ued.</span></p></body></html> + MCCONF_BMS_SOC_LIMIT_END + 2 + 1 + 1 + 1 + 0 + 1 + 0.01 + 0 + 1000 + + 7 + + + Forward CAN to Local + 4 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Forward CAN-frames to local device as they are received. This is useful when many BMSes are connected on a CAN-bus to avoid polling the state from each one of them.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">This can cause a lot of data if there are many BMSes on the CAN-bus, so it is recommended to only do it over the USB-connection.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Options:</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Disabled</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">This function is disabled.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">USB Only</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Only forward frames to device connected over USB.</span></p> +<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Roboto';"><br /></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto'; font-weight:600;">Any Interface</span></p> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Roboto';">Forward frames to device connected using any interface.</span></p></body></html> + MCCONF_BMS_FWD_CAN_MODE + 0 + Disabled + USB Only + Any Interface + + + + pwm_mode + comm_mode + motor_type + sensor_mode + l_current_max + l_current_min + l_in_current_max + l_in_current_min + l_abs_current_max + l_min_erpm + l_max_erpm + l_erpm_start + l_max_erpm_fbrake + l_max_erpm_fbrake_cc + l_min_vin + l_max_vin + l_battery_cut_start + l_battery_cut_end + l_slow_abs_current + l_temp_fet_start + l_temp_fet_end + l_temp_motor_start + l_temp_motor_end + l_temp_accel_dec + l_min_duty + l_max_duty + l_watt_max + l_watt_min + l_current_max_scale + l_current_min_scale + l_duty_start + sl_min_erpm + sl_min_erpm_cycle_int_limit + sl_max_fullbreak_current_dir_change + sl_cycle_int_limit + sl_phase_advance_at_br + sl_cycle_int_rpm_br + sl_bemf_coupling_k + hall_table__0 + hall_table__1 + hall_table__2 + hall_table__3 + hall_table__4 + hall_table__5 + hall_table__6 + hall_table__7 + hall_sl_erpm + foc_current_kp + foc_current_ki + foc_f_zv + foc_dt_us + foc_encoder_inverted + foc_encoder_offset + foc_encoder_ratio + foc_encoder_sin_gain + foc_encoder_cos_gain + foc_encoder_sin_offset + foc_encoder_cos_offset + foc_encoder_sincos_filter_constant + foc_sensor_mode + foc_pll_kp + foc_pll_ki + foc_motor_l + foc_motor_ld_lq_diff + foc_motor_r + foc_motor_flux_linkage + foc_observer_gain + foc_observer_gain_slow + foc_observer_offset + foc_duty_dowmramp_kp + foc_duty_dowmramp_ki + foc_openloop_rpm + foc_openloop_rpm_low + foc_d_gain_scale_start + foc_d_gain_scale_max_mod + foc_sl_openloop_hyst + foc_sl_openloop_time_lock + foc_sl_openloop_time_ramp + foc_sl_openloop_time + foc_hall_table__0 + foc_hall_table__1 + foc_hall_table__2 + foc_hall_table__3 + foc_hall_table__4 + foc_hall_table__5 + foc_hall_table__6 + foc_hall_table__7 + foc_hall_interp_erpm + foc_sl_erpm + foc_sample_v0_v7 + foc_sample_high_current + foc_sat_comp + foc_temp_comp + foc_temp_comp_base_temp + foc_current_filter_const + foc_cc_decoupling + foc_observer_type + foc_hfi_voltage_start + foc_hfi_voltage_run + foc_hfi_voltage_max + foc_sl_erpm_hfi + foc_hfi_start_samples + foc_hfi_obs_ovr_sec + foc_hfi_samples + foc_offsets_cal_on_boot + foc_offsets_current__0 + foc_offsets_current__1 + foc_offsets_current__2 + foc_offsets_voltage__0 + foc_offsets_voltage__1 + foc_offsets_voltage__2 + foc_offsets_voltage_undriven__0 + foc_offsets_voltage_undriven__1 + foc_offsets_voltage_undriven__2 + foc_phase_filter_enable + foc_phase_filter_max_erpm + foc_mtpa_mode + foc_fw_current_max + foc_fw_duty_start + foc_fw_ramp_time + foc_fw_q_current_factor + gpd_buffer_notify_left + gpd_buffer_interpol + gpd_current_filter_const + gpd_current_kp + gpd_current_ki + sp_pid_loop_rate + s_pid_kp + s_pid_ki + s_pid_kd + s_pid_kd_filter + s_pid_min_erpm + s_pid_allow_braking + s_pid_ramp_erpms_s + p_pid_kp + p_pid_ki + p_pid_kd + p_pid_kd_proc + p_pid_kd_filter + p_pid_ang_div + p_pid_gain_dec_angle + p_pid_offset + cc_startup_boost_duty + cc_min_current + cc_gain + cc_ramp_step_max + m_fault_stop_time_ms + m_duty_ramp_step + m_current_backoff_gain + m_encoder_counts + m_sensor_port_mode + m_invert_direction + m_drv8301_oc_mode + m_drv8301_oc_adj + m_bldc_f_sw_min + m_bldc_f_sw_max + m_dc_f_sw + m_ntc_motor_beta + m_out_aux_mode + m_motor_temp_sens_type + m_ptc_motor_coeff + m_hall_extra_samples + si_motor_poles + si_gear_ratio + si_wheel_diameter + si_battery_type + si_battery_cells + si_battery_ah + si_motor_nl_current + bms.type + bms.t_limit_start + bms.t_limit_end + bms.soc_limit_start + bms.soc_limit_end + bms.fwd_can_mode + + + + General + + General + + motor_type + m_invert_direction + m_sensor_port_mode + m_encoder_counts + + + + Current + + ::sep::Motor + l_current_max + l_current_min + l_abs_current_max + l_slow_abs_current + l_current_max_scale + l_current_min_scale + ::sep::Battery + l_in_current_max + l_in_current_min + ::sep::DRV8301 + m_drv8301_oc_mode + m_drv8301_oc_adj + + + + Voltage + + l_battery_cut_start + l_battery_cut_end + + + + RPM + + l_max_erpm + l_min_erpm + l_erpm_start + + + + Wattage + + l_watt_max + l_watt_min + + + + Temperature + + ::sep::General + l_temp_accel_dec + ::sep::MOSFET + l_temp_fet_start + l_temp_fet_end + ::sep::Motor + l_temp_motor_start + l_temp_motor_end + + + + BMS + + bms.type + bms.t_limit_start + bms.t_limit_end + bms.soc_limit_start + bms.soc_limit_end + bms.fwd_can_mode + + + + Advanced + + l_min_vin + l_max_vin + l_min_duty + l_max_duty + cc_min_current + m_fault_stop_time_ms + m_out_aux_mode + m_motor_temp_sens_type + m_ntc_motor_beta + m_ptc_motor_coeff + l_duty_start + m_hall_extra_samples + + + + + BLDC + + General + + sensor_mode + comm_mode + cc_startup_boost_duty + + + + Sensorless + + sl_cycle_int_limit + sl_min_erpm + sl_min_erpm_cycle_int_limit + sl_bemf_coupling_k + + + + Sensors + + hall_sl_erpm + hall_table__0 + hall_table__1 + hall_table__2 + hall_table__3 + hall_table__4 + hall_table__5 + hall_table__6 + hall_table__7 + + + + Advanced + + sl_phase_advance_at_br + sl_cycle_int_rpm_br + l_max_erpm_fbrake + pwm_mode + cc_gain + cc_ramp_step_max + m_duty_ramp_step + m_current_backoff_gain + m_bldc_f_sw_min + m_bldc_f_sw_max + + + + + DC + + General + + cc_gain + cc_ramp_step_max + m_duty_ramp_step + m_current_backoff_gain + m_dc_f_sw + + + + + FOC + + General + + foc_sensor_mode + foc_motor_r + foc_motor_l + foc_motor_ld_lq_diff + foc_motor_flux_linkage + foc_current_kp + foc_current_ki + foc_observer_gain + + + + Sensorless + + foc_openloop_rpm + foc_openloop_rpm_low + foc_sl_openloop_hyst + foc_sl_openloop_time_lock + foc_sl_openloop_time_ramp + foc_sl_openloop_time + foc_sat_comp + foc_temp_comp + foc_temp_comp_base_temp + + + + Hall Sensors + + foc_sl_erpm + foc_hall_interp_erpm + foc_hall_table__0 + foc_hall_table__1 + foc_hall_table__2 + foc_hall_table__3 + foc_hall_table__4 + foc_hall_table__5 + foc_hall_table__6 + foc_hall_table__7 + m_hall_extra_samples + + + + Encoder + + foc_sl_erpm + foc_encoder_offset + foc_encoder_ratio + foc_encoder_inverted + foc_encoder_sin_gain + foc_encoder_sin_offset + foc_encoder_cos_gain + foc_encoder_cos_offset + foc_encoder_sincos_filter_constant + + + + HFI + + foc_hfi_samples + foc_hfi_voltage_start + foc_hfi_voltage_run + foc_hfi_voltage_max + foc_sl_erpm_hfi + foc_hfi_start_samples + foc_hfi_obs_ovr_sec + + + + VSS + + foc_hfi_samples + foc_hfi_voltage_start + foc_hfi_start_samples + foc_openloop_rpm + + + + Filters + + foc_phase_filter_enable + foc_phase_filter_max_erpm + + + + Offsets + + foc_offsets_cal_on_boot + ::sep::Current + foc_offsets_current__0 + foc_offsets_current__1 + foc_offsets_current__2 + ::sep::Voltage + foc_offsets_voltage__0 + foc_offsets_voltage__1 + foc_offsets_voltage__2 + ::sep::Voltage Undriven + foc_offsets_voltage_undriven__0 + foc_offsets_voltage_undriven__1 + foc_offsets_voltage_undriven__2 + + + + Field Weakening + + foc_fw_current_max + foc_fw_duty_start + foc_fw_ramp_time + foc_fw_q_current_factor + + + + Advanced + + foc_f_zv + foc_dt_us + foc_pll_kp + foc_pll_ki + foc_duty_dowmramp_kp + foc_duty_dowmramp_ki + foc_sample_v0_v7 + foc_sample_high_current + foc_observer_gain_slow + foc_current_filter_const + foc_cc_decoupling + foc_observer_type + foc_d_gain_scale_start + foc_d_gain_scale_max_mod + foc_mtpa_mode + foc_observer_offset + + + + + GPD + + General + + pwm_mode + gpd_buffer_notify_left + gpd_buffer_interpol + gpd_current_filter_const + gpd_current_kp + gpd_current_ki + + + + + PID Controllers + + General + + ::sep::Common + sp_pid_loop_rate + ::sep::Speed Controller + s_pid_kp + s_pid_ki + s_pid_kd + s_pid_kd_filter + s_pid_min_erpm + s_pid_allow_braking + s_pid_ramp_erpms_s + ::sep::Position Controller + p_pid_kp + p_pid_ki + p_pid_kd + p_pid_kd_proc + p_pid_kd_filter + p_pid_ang_div + p_pid_gain_dec_angle + p_pid_offset + + + + + Additional Info + + Setup + + si_motor_poles + si_gear_ratio + si_wheel_diameter + si_battery_type + si_battery_cells + si_battery_ah + si_motor_nl_current + + + + General + + motor_brand + motor_model + motor_weight + motor_sensor_type + + + + Quality + + motor_quality_bearings + motor_quality_magnets + motor_quality_construction + + + + + diff --git a/res_config.qrc b/res_config.qrc index dc988333e..b5fa06689 100755 --- a/res_config.qrc +++ b/res_config.qrc @@ -58,5 +58,8 @@ res/config/5.03/info.xml res/config/5.03/parameters_appconf.xml res/config/5.03/parameters_mcconf.xml + res/config/6.00/info.xml + res/config/6.00/parameters_appconf.xml + res/config/6.00/parameters_mcconf.xml diff --git a/vesc_tool.pro b/vesc_tool.pro index 64e42a1e7..daa68d914 100644 --- a/vesc_tool.pro +++ b/vesc_tool.pro @@ -5,12 +5,12 @@ #------------------------------------------------- # Version -VT_VERSION = 3.01 +VT_VERSION = 4.00 VT_INTRO_VERSION = 1 VT_CONFIG_VERSION = 2 # Set to 0 for stable versions and to test version number for development versions. -VT_IS_TEST_VERSION = 0 +VT_IS_TEST_VERSION = 1 VT_ANDROID_VERSION_ARMV7 = 98 VT_ANDROID_VERSION_ARM64 = 99 From fb861792817632d064286f052ebcd03dab505919 Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Tue, 18 Jan 2022 19:41:05 +0100 Subject: [PATCH 002/559] Added firmware compression support + updated bootloaders --- heatshrink/LICENSE | 14 + heatshrink/README.md | 138 ++++ heatshrink/heatshrink.pri | 12 + heatshrink/heatshrink_common.h | 20 + heatshrink/heatshrink_config.h | 26 + heatshrink/heatshrink_decoder.c | 367 +++++++++++ heatshrink/heatshrink_decoder.h | 108 ++++ heatshrink/heatshrink_encoder.c | 604 ++++++++++++++++++ heatshrink/heatshrink_encoder.h | 117 ++++ heatshrink/heatshrinkif.cpp | 113 ++++ heatshrink/heatshrinkif.h | 23 + ...0_o_47_o_48_o_410_o_411_o_412_o_DAS_RS.bin | Bin 4272 -> 5728 bytes ...0_o_75_300_R3_o_60_MK4_o_60_MK5_o_HD75.bin | Bin 4288 -> 5744 bytes res/bootloaders/generic.bin | Bin 3792 -> 5248 bytes vesc_tool.pro | 1 + vescinterface.cpp | 22 +- 16 files changed, 1564 insertions(+), 1 deletion(-) create mode 100644 heatshrink/LICENSE create mode 100644 heatshrink/README.md create mode 100644 heatshrink/heatshrink.pri create mode 100644 heatshrink/heatshrink_common.h create mode 100644 heatshrink/heatshrink_config.h create mode 100644 heatshrink/heatshrink_decoder.c create mode 100644 heatshrink/heatshrink_decoder.h create mode 100644 heatshrink/heatshrink_encoder.c create mode 100644 heatshrink/heatshrink_encoder.h create mode 100644 heatshrink/heatshrinkif.cpp create mode 100644 heatshrink/heatshrinkif.h diff --git a/heatshrink/LICENSE b/heatshrink/LICENSE new file mode 100644 index 000000000..6b6963415 --- /dev/null +++ b/heatshrink/LICENSE @@ -0,0 +1,14 @@ +Copyright (c) 2013-2015, Scott Vokes +All rights reserved. + +Permission to use, copy, modify, and/or distribute this software for any +purpose with or without fee is hereby granted, provided that the above +copyright notice and this permission notice appear in all copies. + +THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES +WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR +ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES +WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN +ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF +OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. diff --git a/heatshrink/README.md b/heatshrink/README.md new file mode 100644 index 000000000..617c64b37 --- /dev/null +++ b/heatshrink/README.md @@ -0,0 +1,138 @@ +# heatshrink + +A data compression/decompression library for embedded/real-time systems. + + +## Key Features: + +- **Low memory usage (as low as 50 bytes)** + It is useful for some cases with less than 50 bytes, and useful + for many general cases with < 300 bytes. +- **Incremental, bounded CPU use** + You can chew on input data in arbitrarily tiny bites. + This is a useful property in hard real-time environments. +- **Can use either static or dynamic memory allocation** + The library doesn't impose any constraints on memory management. +- **ISC license** + You can use it freely, even for commercial purposes. + + +## Getting Started: + +There is a standalone command-line program, `heatshrink`, but the +encoder and decoder can also be used as libraries, independent of each +other. To do so, copy `heatshrink_common.h`, `heatshrink_config.h`, and +either `heatshrink_encoder.c` or `heatshrink_decoder.c` (and their +respective header) into your project. For projects that use both, +static libraries are built that use static and dynamic allocation. + +Dynamic allocation is used by default, but in an embedded context, you +probably want to statically allocate the encoder/decoder. Set +`HEATSHRINK_DYNAMIC_ALLOC` to 0 in `heatshrink_config.h`. + + +### Basic Usage + +1. Allocate a `heatshrink_encoder` or `heatshrink_decoder` state machine +using their `alloc` function, or statically allocate one and call their +`reset` function to initialize them. (See below for configuration +options.) + +2. Use `sink` to sink an input buffer into the state machine. The +`input_size` pointer argument will be set to indicate how many bytes of +the input buffer were actually consumed. (If 0 bytes were conusmed, the +buffer is full.) + +3. Use `poll` to move output from the state machine into an output +buffer. The `output_size` pointer argument will be set to indicate how +many bytes were output, and the function return value will indicate +whether further output is available. (The state machine may not output +any data until it has received enough input.) + +Repeat steps 2 and 3 to stream data through the state machine. Since +it's doing data compression, the input and output sizes can vary +significantly. Looping will be necessary to buffer the input and output +as the data is processed. + +4. When the end of the input stream is reached, call `finish` to notify +the state machine that no more input is available. The return value from +`finish` will indicate whether any output remains. if so, call `poll` to +get more. + +Continue calling `finish` and `poll`ing to flush remaining output until +`finish` indicates that the output has been exhausted. + +Sinking more data after `finish` has been called will not work without +calling `reset` on the state machine. + + +## Configuration + +heatshrink has a couple configuration options, which impact its resource +usage and how effectively it can compress data. These are set when +dynamically allocating an encoder or decoder, or in `heatshrink_config.h` +if they are statically allocated. + +- `window_sz2`, `-w` in the CLI: Set the window size to 2^W bytes. + +The window size determines how far back in the input can be searched for +repeated patterns. A `window_sz2` of 8 will only use 256 bytes (2^8), +while a `window_sz2` of 10 will use 1024 bytes (2^10). The latter uses +more memory, but may also compress more effectively by detecting more +repetition. + +The `window_sz2` setting currently must be between 4 and 15. + +- `lookahead_sz2`, `-l` in the CLI: Set the lookahead size to 2^L bytes. + +The lookahead size determines the max length for repeated patterns that +are found. If the `lookahead_sz2` is 4, a 50-byte run of 'a' characters +will be represented as several repeated 16-byte patterns (2^4 is 16), +whereas a larger `lookahead_sz2` may be able to represent it all at +once. The number of bits used for the lookahead size is fixed, so an +overly large lookahead size can reduce compression by adding unused +size bits to small patterns. + +The `lookahead_sz2` setting currently must be between 3 and the +`window_sz2` - 1. + +- `input_buffer_size` - How large an input buffer to use for the +decoder. This impacts how much work the decoder can do in a single +step, and a larger buffer will use more memory. An extremely small +buffer (say, 1 byte) will add overhead due to lots of suspend/resume +function calls, but should not change how well data compresses. + + +### Recommended Defaults + +For embedded/low memory contexts, a `window_sz2` in the 8 to 10 range is +probably a good default, depending on how tight memory is. Smaller or +larger window sizes may make better trade-offs in specific +circumstances, but should be checked with representative data. + +The `lookahead_sz2` should probably start near the `window_sz2`/2, e.g. +-w 8 -l 4 or -w 10 -l 5. The command-line program can be used to measure +how well test data works with different settings. + + +## More Information and Benchmarks: + +heatshrink is based on [LZSS], since it's particularly suitable for +compression in small amounts of memory. It can use an optional, small +[index] to make compression significantly faster, but otherwise can run +in under 100 bytes of memory. The index currently adds 2^(window size+1) +bytes to memory usage for compression, and temporarily allocates 512 +bytes on the stack during index construction (if the index is enabled). + +For more information, see the [blog post] for an overview, and the +`heatshrink_encoder.h` / `heatshrink_decoder.h` header files for API +documentation. + +[blog post]: http://spin.atomicobject.com/2013/03/14/heatshrink-embedded-data-compression/ +[index]: http://spin.atomicobject.com/2014/01/13/lightweight-indexing-for-embedded-systems/ +[LZSS]: http://en.wikipedia.org/wiki/Lempel-Ziv-Storer-Szymanski + + +## Build Status + + [![Build Status](https://travis-ci.org/atomicobject/heatshrink.png)](http://travis-ci.org/atomicobject/heatshrink) diff --git a/heatshrink/heatshrink.pri b/heatshrink/heatshrink.pri new file mode 100644 index 000000000..364f82243 --- /dev/null +++ b/heatshrink/heatshrink.pri @@ -0,0 +1,12 @@ +HEADERS += \ + $$PWD/heatshrink_common.h \ + $$PWD/heatshrink_config.h \ + $$PWD/heatshrink_decoder.h \ + $$PWD/heatshrink_encoder.h \ + $$PWD/heatshrinkif.h + +SOURCES += \ + $$PWD/heatshrink_decoder.c \ + $$PWD/heatshrink_encoder.c \ + $$PWD/heatshrinkif.cpp + diff --git a/heatshrink/heatshrink_common.h b/heatshrink/heatshrink_common.h new file mode 100644 index 000000000..243f44702 --- /dev/null +++ b/heatshrink/heatshrink_common.h @@ -0,0 +1,20 @@ +#ifndef HEATSHRINK_H +#define HEATSHRINK_H + +#define HEATSHRINK_AUTHOR "Scott Vokes " +#define HEATSHRINK_URL "https://github.com/atomicobject/heatshrink" + +/* Version 0.4.1 */ +#define HEATSHRINK_VERSION_MAJOR 0 +#define HEATSHRINK_VERSION_MINOR 4 +#define HEATSHRINK_VERSION_PATCH 1 + +#define HEATSHRINK_MIN_WINDOW_BITS 4 +#define HEATSHRINK_MAX_WINDOW_BITS 15 + +#define HEATSHRINK_MIN_LOOKAHEAD_BITS 3 + +#define HEATSHRINK_LITERAL_MARKER 0x01 +#define HEATSHRINK_BACKREF_MARKER 0x00 + +#endif diff --git a/heatshrink/heatshrink_config.h b/heatshrink/heatshrink_config.h new file mode 100644 index 000000000..3daa79608 --- /dev/null +++ b/heatshrink/heatshrink_config.h @@ -0,0 +1,26 @@ +#ifndef HEATSHRINK_CONFIG_H +#define HEATSHRINK_CONFIG_H + +/* Should functionality assuming dynamic allocation be used? */ +#ifndef HEATSHRINK_DYNAMIC_ALLOC +#define HEATSHRINK_DYNAMIC_ALLOC 0 +#endif + +#if HEATSHRINK_DYNAMIC_ALLOC + /* Optional replacement of malloc/free */ + #define HEATSHRINK_MALLOC(SZ) malloc(SZ) + #define HEATSHRINK_FREE(P, SZ) free(P) +#else + /* Required parameters for static configuration */ + #define HEATSHRINK_STATIC_INPUT_BUFFER_SIZE 32 + #define HEATSHRINK_STATIC_WINDOW_BITS 13 + #define HEATSHRINK_STATIC_LOOKAHEAD_BITS 5 +#endif + +/* Turn on logging for debugging. */ +#define HEATSHRINK_DEBUGGING_LOGS 0 + +/* Use indexing for faster compression. (This requires additional space.) */ +#define HEATSHRINK_USE_INDEX 1 + +#endif diff --git a/heatshrink/heatshrink_decoder.c b/heatshrink/heatshrink_decoder.c new file mode 100644 index 000000000..0f118cf98 --- /dev/null +++ b/heatshrink/heatshrink_decoder.c @@ -0,0 +1,367 @@ +#include +#include +#include "heatshrink_decoder.h" + +/* States for the polling state machine. */ +typedef enum { + HSDS_TAG_BIT, /* tag bit */ + HSDS_YIELD_LITERAL, /* ready to yield literal byte */ + HSDS_BACKREF_INDEX_MSB, /* most significant byte of index */ + HSDS_BACKREF_INDEX_LSB, /* least significant byte of index */ + HSDS_BACKREF_COUNT_MSB, /* most significant byte of count */ + HSDS_BACKREF_COUNT_LSB, /* least significant byte of count */ + HSDS_YIELD_BACKREF, /* ready to yield back-reference */ +} HSD_state; + +#if HEATSHRINK_DEBUGGING_LOGS +#include +#include +#include +#define LOG(...) fprintf(stderr, __VA_ARGS__) +#define ASSERT(X) assert(X) +static const char *state_names[] = { + "tag_bit", + "yield_literal", + "backref_index_msb", + "backref_index_lsb", + "backref_count_msb", + "backref_count_lsb", + "yield_backref", +}; +#else +#define LOG(...) /* no-op */ +#define ASSERT(X) /* no-op */ +#endif + +typedef struct { + uint8_t *buf; /* output buffer */ + size_t buf_size; /* buffer size */ + size_t *output_size; /* bytes pushed to buffer, so far */ +} output_info; + +#define NO_BITS ((uint16_t)-1) + +/* Forward references. */ +static uint16_t get_bits(heatshrink_decoder *hsd, uint8_t count); +static void push_byte(heatshrink_decoder *hsd, output_info *oi, uint8_t byte); + +#if HEATSHRINK_DYNAMIC_ALLOC +heatshrink_decoder *heatshrink_decoder_alloc(uint16_t input_buffer_size, + uint8_t window_sz2, + uint8_t lookahead_sz2) { + if ((window_sz2 < HEATSHRINK_MIN_WINDOW_BITS) || + (window_sz2 > HEATSHRINK_MAX_WINDOW_BITS) || + (input_buffer_size == 0) || + (lookahead_sz2 < HEATSHRINK_MIN_LOOKAHEAD_BITS) || + (lookahead_sz2 >= window_sz2)) { + return NULL; + } + size_t buffers_sz = (1 << window_sz2) + input_buffer_size; + size_t sz = sizeof(heatshrink_decoder) + buffers_sz; + heatshrink_decoder *hsd = HEATSHRINK_MALLOC(sz); + if (hsd == NULL) { return NULL; } + hsd->input_buffer_size = input_buffer_size; + hsd->window_sz2 = window_sz2; + hsd->lookahead_sz2 = lookahead_sz2; + heatshrink_decoder_reset(hsd); + LOG("-- allocated decoder with buffer size of %zu (%zu + %u + %u)\n", + sz, sizeof(heatshrink_decoder), (1 << window_sz2), input_buffer_size); + return hsd; +} + +void heatshrink_decoder_free(heatshrink_decoder *hsd) { + size_t buffers_sz = (1 << hsd->window_sz2) + hsd->input_buffer_size; + size_t sz = sizeof(heatshrink_decoder) + buffers_sz; + HEATSHRINK_FREE(hsd, sz); + (void)sz; /* may not be used by free */ +} +#endif + +void heatshrink_decoder_reset(heatshrink_decoder *hsd) { + size_t buf_sz = 1 << HEATSHRINK_DECODER_WINDOW_BITS(hsd); + size_t input_sz = HEATSHRINK_DECODER_INPUT_BUFFER_SIZE(hsd); + memset(hsd->buffers, 0, buf_sz + input_sz); + hsd->state = HSDS_TAG_BIT; + hsd->input_size = 0; + hsd->input_index = 0; + hsd->bit_index = 0x00; + hsd->current_byte = 0x00; + hsd->output_count = 0; + hsd->output_index = 0; + hsd->head_index = 0; +} + +/* Copy SIZE bytes into the decoder's input buffer, if it will fit. */ +HSD_sink_res heatshrink_decoder_sink(heatshrink_decoder *hsd, + uint8_t *in_buf, size_t size, size_t *input_size) { + if ((hsd == NULL) || (in_buf == NULL) || (input_size == NULL)) { + return HSDR_SINK_ERROR_NULL; + } + + size_t rem = HEATSHRINK_DECODER_INPUT_BUFFER_SIZE(hsd) - hsd->input_size; + if (rem == 0) { + *input_size = 0; + return HSDR_SINK_FULL; + } + + size = rem < size ? rem : size; + LOG("-- sinking %zd bytes\n", size); + /* copy into input buffer (at head of buffers) */ + memcpy(&hsd->buffers[hsd->input_size], in_buf, size); + hsd->input_size += size; + *input_size = size; + return HSDR_SINK_OK; +} + + +/***************** + * Decompression * + *****************/ + +#define BACKREF_COUNT_BITS(HSD) (HEATSHRINK_DECODER_LOOKAHEAD_BITS(HSD)) +#define BACKREF_INDEX_BITS(HSD) (HEATSHRINK_DECODER_WINDOW_BITS(HSD)) + +// States +static HSD_state st_tag_bit(heatshrink_decoder *hsd); +static HSD_state st_yield_literal(heatshrink_decoder *hsd, + output_info *oi); +static HSD_state st_backref_index_msb(heatshrink_decoder *hsd); +static HSD_state st_backref_index_lsb(heatshrink_decoder *hsd); +static HSD_state st_backref_count_msb(heatshrink_decoder *hsd); +static HSD_state st_backref_count_lsb(heatshrink_decoder *hsd); +static HSD_state st_yield_backref(heatshrink_decoder *hsd, + output_info *oi); + +HSD_poll_res heatshrink_decoder_poll(heatshrink_decoder *hsd, + uint8_t *out_buf, size_t out_buf_size, size_t *output_size) { + if ((hsd == NULL) || (out_buf == NULL) || (output_size == NULL)) { + return HSDR_POLL_ERROR_NULL; + } + *output_size = 0; + + output_info oi; + oi.buf = out_buf; + oi.buf_size = out_buf_size; + oi.output_size = output_size; + + while (1) { + LOG("-- poll, state is %d (%s), input_size %d\n", + hsd->state, state_names[hsd->state], hsd->input_size); + uint8_t in_state = hsd->state; + switch (in_state) { + case HSDS_TAG_BIT: + hsd->state = st_tag_bit(hsd); + break; + case HSDS_YIELD_LITERAL: + hsd->state = st_yield_literal(hsd, &oi); + break; + case HSDS_BACKREF_INDEX_MSB: + hsd->state = st_backref_index_msb(hsd); + break; + case HSDS_BACKREF_INDEX_LSB: + hsd->state = st_backref_index_lsb(hsd); + break; + case HSDS_BACKREF_COUNT_MSB: + hsd->state = st_backref_count_msb(hsd); + break; + case HSDS_BACKREF_COUNT_LSB: + hsd->state = st_backref_count_lsb(hsd); + break; + case HSDS_YIELD_BACKREF: + hsd->state = st_yield_backref(hsd, &oi); + break; + default: + return HSDR_POLL_ERROR_UNKNOWN; + } + + /* If the current state cannot advance, check if input or output + * buffer are exhausted. */ + if (hsd->state == in_state) { + if (*output_size == out_buf_size) { return HSDR_POLL_MORE; } + return HSDR_POLL_EMPTY; + } + } +} + +static HSD_state st_tag_bit(heatshrink_decoder *hsd) { + uint32_t bits = get_bits(hsd, 1); // get tag bit + if (bits == NO_BITS) { + return HSDS_TAG_BIT; + } else if (bits) { + return HSDS_YIELD_LITERAL; + } else if (HEATSHRINK_DECODER_WINDOW_BITS(hsd) > 8) { + return HSDS_BACKREF_INDEX_MSB; + } else { + hsd->output_index = 0; + return HSDS_BACKREF_INDEX_LSB; + } +} + +static HSD_state st_yield_literal(heatshrink_decoder *hsd, + output_info *oi) { + /* Emit a repeated section from the window buffer, and add it (again) + * to the window buffer. (Note that the repetition can include + * itself.)*/ + if (*oi->output_size < oi->buf_size) { + uint16_t byte = get_bits(hsd, 8); + if (byte == NO_BITS) { return HSDS_YIELD_LITERAL; } /* out of input */ + uint8_t *buf = &hsd->buffers[HEATSHRINK_DECODER_INPUT_BUFFER_SIZE(hsd)]; + uint16_t mask = (1 << HEATSHRINK_DECODER_WINDOW_BITS(hsd)) - 1; + uint8_t c = byte & 0xFF; + LOG("-- emitting literal byte 0x%02x ('%c')\n", c, isprint(c) ? c : '.'); + buf[hsd->head_index++ & mask] = c; + push_byte(hsd, oi, c); + return HSDS_TAG_BIT; + } else { + return HSDS_YIELD_LITERAL; + } +} + +static HSD_state st_backref_index_msb(heatshrink_decoder *hsd) { + uint8_t bit_ct = BACKREF_INDEX_BITS(hsd); + ASSERT(bit_ct > 8); + uint16_t bits = get_bits(hsd, bit_ct - 8); + LOG("-- backref index (msb), got 0x%04x (+1)\n", bits); + if (bits == NO_BITS) { return HSDS_BACKREF_INDEX_MSB; } + hsd->output_index = bits << 8; + return HSDS_BACKREF_INDEX_LSB; +} + +static HSD_state st_backref_index_lsb(heatshrink_decoder *hsd) { + uint8_t bit_ct = BACKREF_INDEX_BITS(hsd); + uint16_t bits = get_bits(hsd, bit_ct < 8 ? bit_ct : 8); + LOG("-- backref index (lsb), got 0x%04x (+1)\n", bits); + if (bits == NO_BITS) { return HSDS_BACKREF_INDEX_LSB; } + hsd->output_index |= bits; + hsd->output_index++; + uint8_t br_bit_ct = BACKREF_COUNT_BITS(hsd); + hsd->output_count = 0; + return (br_bit_ct > 8) ? HSDS_BACKREF_COUNT_MSB : HSDS_BACKREF_COUNT_LSB; +} + +static HSD_state st_backref_count_msb(heatshrink_decoder *hsd) { + uint8_t br_bit_ct = BACKREF_COUNT_BITS(hsd); + ASSERT(br_bit_ct > 8); + uint16_t bits = get_bits(hsd, br_bit_ct - 8); + LOG("-- backref count (msb), got 0x%04x (+1)\n", bits); + if (bits == NO_BITS) { return HSDS_BACKREF_COUNT_MSB; } + hsd->output_count = bits << 8; + return HSDS_BACKREF_COUNT_LSB; +} + +static HSD_state st_backref_count_lsb(heatshrink_decoder *hsd) { + uint8_t br_bit_ct = BACKREF_COUNT_BITS(hsd); + uint16_t bits = get_bits(hsd, br_bit_ct < 8 ? br_bit_ct : 8); + LOG("-- backref count (lsb), got 0x%04x (+1)\n", bits); + if (bits == NO_BITS) { return HSDS_BACKREF_COUNT_LSB; } + hsd->output_count |= bits; + hsd->output_count++; + return HSDS_YIELD_BACKREF; +} + +static HSD_state st_yield_backref(heatshrink_decoder *hsd, + output_info *oi) { + size_t count = oi->buf_size - *oi->output_size; + if (count > 0) { + size_t i = 0; + if (hsd->output_count < count) count = hsd->output_count; + uint8_t *buf = &hsd->buffers[HEATSHRINK_DECODER_INPUT_BUFFER_SIZE(hsd)]; + uint16_t mask = (1 << HEATSHRINK_DECODER_WINDOW_BITS(hsd)) - 1; + uint16_t neg_offset = hsd->output_index; + LOG("-- emitting %zu bytes from -%u bytes back\n", count, neg_offset); + ASSERT(neg_offset <= mask + 1); + ASSERT(count <= (size_t)(1 << BACKREF_COUNT_BITS(hsd))); + + for (i=0; ihead_index - neg_offset) & mask]; + push_byte(hsd, oi, c); + buf[hsd->head_index & mask] = c; + hsd->head_index++; + LOG(" -- ++ 0x%02x\n", c); + } + hsd->output_count -= count; + if (hsd->output_count == 0) { return HSDS_TAG_BIT; } + } + return HSDS_YIELD_BACKREF; +} + +/* Get the next COUNT bits from the input buffer, saving incremental progress. + * Returns NO_BITS on end of input, or if more than 15 bits are requested. */ +static uint16_t get_bits(heatshrink_decoder *hsd, uint8_t count) { + uint16_t accumulator = 0; + int i = 0; + if (count > 15) { return NO_BITS; } + LOG("-- popping %u bit(s)\n", count); + + /* If we aren't able to get COUNT bits, suspend immediately, because we + * don't track how many bits of COUNT we've accumulated before suspend. */ + if (hsd->input_size == 0) { + if (hsd->bit_index < (1 << (count - 1))) { return NO_BITS; } + } + + for (i = 0; i < count; i++) { + if (hsd->bit_index == 0x00) { + if (hsd->input_size == 0) { + LOG(" -- out of bits, suspending w/ accumulator of %u (0x%02x)\n", + accumulator, accumulator); + return NO_BITS; + } + hsd->current_byte = hsd->buffers[hsd->input_index++]; + LOG(" -- pulled byte 0x%02x\n", hsd->current_byte); + if (hsd->input_index == hsd->input_size) { + hsd->input_index = 0; /* input is exhausted */ + hsd->input_size = 0; + } + hsd->bit_index = 0x80; + } + accumulator <<= 1; + if (hsd->current_byte & hsd->bit_index) { + accumulator |= 0x01; + if (0) { + LOG(" -- got 1, accumulator 0x%04x, bit_index 0x%02x\n", + accumulator, hsd->bit_index); + } + } else { + if (0) { + LOG(" -- got 0, accumulator 0x%04x, bit_index 0x%02x\n", + accumulator, hsd->bit_index); + } + } + hsd->bit_index >>= 1; + } + + if (count > 1) { LOG(" -- accumulated %08x\n", accumulator); } + return accumulator; +} + +HSD_finish_res heatshrink_decoder_finish(heatshrink_decoder *hsd) { + if (hsd == NULL) { return HSDR_FINISH_ERROR_NULL; } + switch (hsd->state) { + case HSDS_TAG_BIT: + return hsd->input_size == 0 ? HSDR_FINISH_DONE : HSDR_FINISH_MORE; + + /* If we want to finish with no input, but are in these states, it's + * because the 0-bit padding to the last byte looks like a backref + * marker bit followed by all 0s for index and count bits. */ + case HSDS_BACKREF_INDEX_LSB: + case HSDS_BACKREF_INDEX_MSB: + case HSDS_BACKREF_COUNT_LSB: + case HSDS_BACKREF_COUNT_MSB: + return hsd->input_size == 0 ? HSDR_FINISH_DONE : HSDR_FINISH_MORE; + + /* If the output stream is padded with 0xFFs (possibly due to being in + * flash memory), also explicitly check the input size rather than + * uselessly returning MORE but yielding 0 bytes when polling. */ + case HSDS_YIELD_LITERAL: + return hsd->input_size == 0 ? HSDR_FINISH_DONE : HSDR_FINISH_MORE; + + default: + return HSDR_FINISH_MORE; + } +} + +static void push_byte(heatshrink_decoder *hsd, output_info *oi, uint8_t byte) { + LOG(" -- pushing byte: 0x%02x ('%c')\n", byte, isprint(byte) ? byte : '.'); + oi->buf[(*oi->output_size)++] = byte; + (void)hsd; +} diff --git a/heatshrink/heatshrink_decoder.h b/heatshrink/heatshrink_decoder.h new file mode 100644 index 000000000..63211e417 --- /dev/null +++ b/heatshrink/heatshrink_decoder.h @@ -0,0 +1,108 @@ +#ifndef HEATSHRINK_DECODER_H +#define HEATSHRINK_DECODER_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include +#include "heatshrink_common.h" +#include "heatshrink_config.h" + +typedef enum { + HSDR_SINK_OK, /* data sunk, ready to poll */ + HSDR_SINK_FULL, /* out of space in internal buffer */ + HSDR_SINK_ERROR_NULL=-1, /* NULL argument */ +} HSD_sink_res; + +typedef enum { + HSDR_POLL_EMPTY, /* input exhausted */ + HSDR_POLL_MORE, /* more data remaining, call again w/ fresh output buffer */ + HSDR_POLL_ERROR_NULL=-1, /* NULL arguments */ + HSDR_POLL_ERROR_UNKNOWN=-2, +} HSD_poll_res; + +typedef enum { + HSDR_FINISH_DONE, /* output is done */ + HSDR_FINISH_MORE, /* more output remains */ + HSDR_FINISH_ERROR_NULL=-1, /* NULL arguments */ +} HSD_finish_res; + +#if HEATSHRINK_DYNAMIC_ALLOC +#define HEATSHRINK_DECODER_INPUT_BUFFER_SIZE(BUF) \ + ((BUF)->input_buffer_size) +#define HEATSHRINK_DECODER_WINDOW_BITS(BUF) \ + ((BUF)->window_sz2) +#define HEATSHRINK_DECODER_LOOKAHEAD_BITS(BUF) \ + ((BUF)->lookahead_sz2) +#else +#define HEATSHRINK_DECODER_INPUT_BUFFER_SIZE(_) \ + HEATSHRINK_STATIC_INPUT_BUFFER_SIZE +#define HEATSHRINK_DECODER_WINDOW_BITS(_) \ + (HEATSHRINK_STATIC_WINDOW_BITS) +#define HEATSHRINK_DECODER_LOOKAHEAD_BITS(BUF) \ + (HEATSHRINK_STATIC_LOOKAHEAD_BITS) +#endif + +typedef struct { + uint16_t input_size; /* bytes in input buffer */ + uint16_t input_index; /* offset to next unprocessed input byte */ + uint16_t output_count; /* how many bytes to output */ + uint16_t output_index; /* index for bytes to output */ + uint16_t head_index; /* head of window buffer */ + uint8_t state; /* current state machine node */ + uint8_t current_byte; /* current byte of input */ + uint8_t bit_index; /* current bit index */ + +#if HEATSHRINK_DYNAMIC_ALLOC + /* Fields that are only used if dynamically allocated. */ + uint8_t window_sz2; /* window buffer bits */ + uint8_t lookahead_sz2; /* lookahead bits */ + uint16_t input_buffer_size; /* input buffer size */ + + /* Input buffer, then expansion window buffer */ + uint8_t buffers[]; +#else + /* Input buffer, then expansion window buffer */ + uint8_t buffers[(1 << HEATSHRINK_DECODER_WINDOW_BITS(_)) + + HEATSHRINK_DECODER_INPUT_BUFFER_SIZE(_)]; +#endif +} heatshrink_decoder; + +#if HEATSHRINK_DYNAMIC_ALLOC +/* Allocate a decoder with an input buffer of INPUT_BUFFER_SIZE bytes, + * an expansion buffer size of 2^WINDOW_SZ2, and a lookahead + * size of 2^lookahead_sz2. (The window buffer and lookahead sizes + * must match the settings used when the data was compressed.) + * Returns NULL on error. */ +heatshrink_decoder *heatshrink_decoder_alloc(uint16_t input_buffer_size, + uint8_t expansion_buffer_sz2, uint8_t lookahead_sz2); + +/* Free a decoder. */ +void heatshrink_decoder_free(heatshrink_decoder *hsd); +#endif + +/* Reset a decoder. */ +void heatshrink_decoder_reset(heatshrink_decoder *hsd); + +/* Sink at most SIZE bytes from IN_BUF into the decoder. *INPUT_SIZE is set to + * indicate how many bytes were actually sunk (in case a buffer was filled). */ +HSD_sink_res heatshrink_decoder_sink(heatshrink_decoder *hsd, + uint8_t *in_buf, size_t size, size_t *input_size); + +/* Poll for output from the decoder, copying at most OUT_BUF_SIZE bytes into + * OUT_BUF (setting *OUTPUT_SIZE to the actual amount copied). */ +HSD_poll_res heatshrink_decoder_poll(heatshrink_decoder *hsd, + uint8_t *out_buf, size_t out_buf_size, size_t *output_size); + +/* Notify the dencoder that the input stream is finished. + * If the return value is HSDR_FINISH_MORE, there is still more output, so + * call heatshrink_decoder_poll and repeat. */ +HSD_finish_res heatshrink_decoder_finish(heatshrink_decoder *hsd); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/heatshrink/heatshrink_encoder.c b/heatshrink/heatshrink_encoder.c new file mode 100644 index 000000000..edf4abebc --- /dev/null +++ b/heatshrink/heatshrink_encoder.c @@ -0,0 +1,604 @@ +#include +#include +#include +#include "heatshrink_encoder.h" + +typedef enum { + HSES_NOT_FULL, /* input buffer not full enough */ + HSES_FILLED, /* buffer is full */ + HSES_SEARCH, /* searching for patterns */ + HSES_YIELD_TAG_BIT, /* yield tag bit */ + HSES_YIELD_LITERAL, /* emit literal byte */ + HSES_YIELD_BR_INDEX, /* yielding backref index */ + HSES_YIELD_BR_LENGTH, /* yielding backref length */ + HSES_SAVE_BACKLOG, /* copying buffer to backlog */ + HSES_FLUSH_BITS, /* flush bit buffer */ + HSES_DONE, /* done */ +} HSE_state; + +#if HEATSHRINK_DEBUGGING_LOGS +#include +#include +#include +#define LOG(...) fprintf(stderr, __VA_ARGS__) +#define ASSERT(X) assert(X) +static const char *state_names[] = { + "not_full", + "filled", + "search", + "yield_tag_bit", + "yield_literal", + "yield_br_index", + "yield_br_length", + "save_backlog", + "flush_bits", + "done", +}; +#else +#define LOG(...) /* no-op */ +#define ASSERT(X) /* no-op */ +#endif + +// Encoder flags +enum { + FLAG_IS_FINISHING = 0x01, +}; + +typedef struct { + uint8_t *buf; /* output buffer */ + size_t buf_size; /* buffer size */ + size_t *output_size; /* bytes pushed to buffer, so far */ +} output_info; + +#define MATCH_NOT_FOUND ((uint16_t)-1) + +static uint16_t get_input_offset(heatshrink_encoder *hse); +static uint16_t get_input_buffer_size(heatshrink_encoder *hse); +static uint16_t get_lookahead_size(heatshrink_encoder *hse); +static void add_tag_bit(heatshrink_encoder *hse, output_info *oi, uint8_t tag); +static int can_take_byte(output_info *oi); +static int is_finishing(heatshrink_encoder *hse); +static void save_backlog(heatshrink_encoder *hse); + +/* Push COUNT (max 8) bits to the output buffer, which has room. */ +static void push_bits(heatshrink_encoder *hse, uint8_t count, uint8_t bits, + output_info *oi); +static uint8_t push_outgoing_bits(heatshrink_encoder *hse, output_info *oi); +static void push_literal_byte(heatshrink_encoder *hse, output_info *oi); + +#if HEATSHRINK_DYNAMIC_ALLOC +heatshrink_encoder *heatshrink_encoder_alloc(uint8_t window_sz2, + uint8_t lookahead_sz2) { + if ((window_sz2 < HEATSHRINK_MIN_WINDOW_BITS) || + (window_sz2 > HEATSHRINK_MAX_WINDOW_BITS) || + (lookahead_sz2 < HEATSHRINK_MIN_LOOKAHEAD_BITS) || + (lookahead_sz2 >= window_sz2)) { + return NULL; + } + + /* Note: 2 * the window size is used because the buffer needs to fit + * (1 << window_sz2) bytes for the current input, and an additional + * (1 << window_sz2) bytes for the previous buffer of input, which + * will be scanned for useful backreferences. */ + size_t buf_sz = (2 << window_sz2); + + heatshrink_encoder *hse = HEATSHRINK_MALLOC(sizeof(*hse) + buf_sz); + if (hse == NULL) { return NULL; } + hse->window_sz2 = window_sz2; + hse->lookahead_sz2 = lookahead_sz2; + heatshrink_encoder_reset(hse); + +#if HEATSHRINK_USE_INDEX + size_t index_sz = buf_sz*sizeof(uint16_t); + hse->search_index = HEATSHRINK_MALLOC(index_sz + sizeof(struct hs_index)); + if (hse->search_index == NULL) { + HEATSHRINK_FREE(hse, sizeof(*hse) + buf_sz); + return NULL; + } + hse->search_index->size = index_sz; +#endif + + LOG("-- allocated encoder with buffer size of %zu (%u byte input size)\n", + buf_sz, get_input_buffer_size(hse)); + return hse; +} + +void heatshrink_encoder_free(heatshrink_encoder *hse) { + size_t buf_sz = (2 << HEATSHRINK_ENCODER_WINDOW_BITS(hse)); +#if HEATSHRINK_USE_INDEX + size_t index_sz = sizeof(struct hs_index) + hse->search_index->size; + HEATSHRINK_FREE(hse->search_index, index_sz); + (void)index_sz; +#endif + HEATSHRINK_FREE(hse, sizeof(heatshrink_encoder) + buf_sz); + (void)buf_sz; +} +#endif + +void heatshrink_encoder_reset(heatshrink_encoder *hse) { + size_t buf_sz = (2 << HEATSHRINK_ENCODER_WINDOW_BITS(hse)); + memset(hse->buffer, 0, buf_sz); + hse->input_size = 0; + hse->state = HSES_NOT_FULL; + hse->match_scan_index = 0; + hse->flags = 0; + hse->bit_index = 0x80; + hse->current_byte = 0x00; + hse->match_length = 0; + + hse->outgoing_bits = 0x0000; + hse->outgoing_bits_count = 0; + + #ifdef LOOP_DETECT + hse->loop_detect = (uint32_t)-1; + #endif +} + +HSE_sink_res heatshrink_encoder_sink(heatshrink_encoder *hse, + uint8_t *in_buf, size_t size, size_t *input_size) { + if ((hse == NULL) || (in_buf == NULL) || (input_size == NULL)) { + return HSER_SINK_ERROR_NULL; + } + + /* Sinking more content after saying the content is done, tsk tsk */ + if (is_finishing(hse)) { return HSER_SINK_ERROR_MISUSE; } + + /* Sinking more content before processing is done */ + if (hse->state != HSES_NOT_FULL) { return HSER_SINK_ERROR_MISUSE; } + + uint16_t write_offset = get_input_offset(hse) + hse->input_size; + uint16_t ibs = get_input_buffer_size(hse); + uint16_t rem = ibs - hse->input_size; + uint16_t cp_sz = rem < size ? rem : size; + + memcpy(&hse->buffer[write_offset], in_buf, cp_sz); + *input_size = cp_sz; + hse->input_size += cp_sz; + + LOG("-- sunk %u bytes (of %zu) into encoder at %d, input buffer now has %u\n", + cp_sz, size, write_offset, hse->input_size); + if (cp_sz == rem) { + LOG("-- internal buffer is now full\n"); + hse->state = HSES_FILLED; + } + + return HSER_SINK_OK; +} + + +/*************** + * Compression * + ***************/ + +static uint16_t find_longest_match(heatshrink_encoder *hse, uint16_t start, + uint16_t end, const uint16_t maxlen, uint16_t *match_length); +static void do_indexing(heatshrink_encoder *hse); + +static HSE_state st_step_search(heatshrink_encoder *hse); +static HSE_state st_yield_tag_bit(heatshrink_encoder *hse, + output_info *oi); +static HSE_state st_yield_literal(heatshrink_encoder *hse, + output_info *oi); +static HSE_state st_yield_br_index(heatshrink_encoder *hse, + output_info *oi); +static HSE_state st_yield_br_length(heatshrink_encoder *hse, + output_info *oi); +static HSE_state st_save_backlog(heatshrink_encoder *hse); +static HSE_state st_flush_bit_buffer(heatshrink_encoder *hse, + output_info *oi); + +HSE_poll_res heatshrink_encoder_poll(heatshrink_encoder *hse, + uint8_t *out_buf, size_t out_buf_size, size_t *output_size) { + if ((hse == NULL) || (out_buf == NULL) || (output_size == NULL)) { + return HSER_POLL_ERROR_NULL; + } + if (out_buf_size == 0) { + LOG("-- MISUSE: output buffer size is 0\n"); + return HSER_POLL_ERROR_MISUSE; + } + *output_size = 0; + + output_info oi; + oi.buf = out_buf; + oi.buf_size = out_buf_size; + oi.output_size = output_size; + + while (1) { + LOG("-- polling, state %u (%s), flags 0x%02x\n", + hse->state, state_names[hse->state], hse->flags); + + uint8_t in_state = hse->state; + switch (in_state) { + case HSES_NOT_FULL: + return HSER_POLL_EMPTY; + case HSES_FILLED: + do_indexing(hse); + hse->state = HSES_SEARCH; + break; + case HSES_SEARCH: + hse->state = st_step_search(hse); + break; + case HSES_YIELD_TAG_BIT: + hse->state = st_yield_tag_bit(hse, &oi); + break; + case HSES_YIELD_LITERAL: + hse->state = st_yield_literal(hse, &oi); + break; + case HSES_YIELD_BR_INDEX: + hse->state = st_yield_br_index(hse, &oi); + break; + case HSES_YIELD_BR_LENGTH: + hse->state = st_yield_br_length(hse, &oi); + break; + case HSES_SAVE_BACKLOG: + hse->state = st_save_backlog(hse); + break; + case HSES_FLUSH_BITS: + hse->state = st_flush_bit_buffer(hse, &oi); + case HSES_DONE: + return HSER_POLL_EMPTY; + default: + LOG("-- bad state %s\n", state_names[hse->state]); + return HSER_POLL_ERROR_MISUSE; + } + + if (hse->state == in_state) { + /* Check if output buffer is exhausted. */ + if (*output_size == out_buf_size) return HSER_POLL_MORE; + } + } +} + +HSE_finish_res heatshrink_encoder_finish(heatshrink_encoder *hse) { + if (hse == NULL) { return HSER_FINISH_ERROR_NULL; } + LOG("-- setting is_finishing flag\n"); + hse->flags |= FLAG_IS_FINISHING; + if (hse->state == HSES_NOT_FULL) { hse->state = HSES_FILLED; } + return hse->state == HSES_DONE ? HSER_FINISH_DONE : HSER_FINISH_MORE; +} + +static HSE_state st_step_search(heatshrink_encoder *hse) { + uint16_t window_length = get_input_buffer_size(hse); + uint16_t lookahead_sz = get_lookahead_size(hse); + uint16_t msi = hse->match_scan_index; + LOG("## step_search, scan @ +%d (%d/%d), input size %d\n", + msi, hse->input_size + msi, 2*window_length, hse->input_size); + + bool fin = is_finishing(hse); + if (msi > hse->input_size - (fin ? 1 : lookahead_sz)) { + /* Current search buffer is exhausted, copy it into the + * backlog and await more input. */ + LOG("-- end of search @ %d\n", msi); + return fin ? HSES_FLUSH_BITS : HSES_SAVE_BACKLOG; + } + + uint16_t input_offset = get_input_offset(hse); + uint16_t end = input_offset + msi; + uint16_t start = end - window_length; + + uint16_t max_possible = lookahead_sz; + if (hse->input_size - msi < lookahead_sz) { + max_possible = hse->input_size - msi; + } + + uint16_t match_length = 0; + uint16_t match_pos = find_longest_match(hse, + start, end, max_possible, &match_length); + + if (match_pos == MATCH_NOT_FOUND) { + LOG("ss Match not found\n"); + hse->match_scan_index++; + hse->match_length = 0; + return HSES_YIELD_TAG_BIT; + } else { + LOG("ss Found match of %d bytes at %d\n", match_length, match_pos); + hse->match_pos = match_pos; + hse->match_length = match_length; + ASSERT(match_pos <= 1 << HEATSHRINK_ENCODER_WINDOW_BITS(hse) /*window_length*/); + + return HSES_YIELD_TAG_BIT; + } +} + +static HSE_state st_yield_tag_bit(heatshrink_encoder *hse, + output_info *oi) { + if (can_take_byte(oi)) { + if (hse->match_length == 0) { + add_tag_bit(hse, oi, HEATSHRINK_LITERAL_MARKER); + return HSES_YIELD_LITERAL; + } else { + add_tag_bit(hse, oi, HEATSHRINK_BACKREF_MARKER); + hse->outgoing_bits = hse->match_pos - 1; + hse->outgoing_bits_count = HEATSHRINK_ENCODER_WINDOW_BITS(hse); + return HSES_YIELD_BR_INDEX; + } + } else { + return HSES_YIELD_TAG_BIT; /* output is full, continue */ + } +} + +static HSE_state st_yield_literal(heatshrink_encoder *hse, + output_info *oi) { + if (can_take_byte(oi)) { + push_literal_byte(hse, oi); + return HSES_SEARCH; + } else { + return HSES_YIELD_LITERAL; + } +} + +static HSE_state st_yield_br_index(heatshrink_encoder *hse, + output_info *oi) { + if (can_take_byte(oi)) { + LOG("-- yielding backref index %u\n", hse->match_pos); + if (push_outgoing_bits(hse, oi) > 0) { + return HSES_YIELD_BR_INDEX; /* continue */ + } else { + hse->outgoing_bits = hse->match_length - 1; + hse->outgoing_bits_count = HEATSHRINK_ENCODER_LOOKAHEAD_BITS(hse); + return HSES_YIELD_BR_LENGTH; /* done */ + } + } else { + return HSES_YIELD_BR_INDEX; /* continue */ + } +} + +static HSE_state st_yield_br_length(heatshrink_encoder *hse, + output_info *oi) { + if (can_take_byte(oi)) { + LOG("-- yielding backref length %u\n", hse->match_length); + if (push_outgoing_bits(hse, oi) > 0) { + return HSES_YIELD_BR_LENGTH; + } else { + hse->match_scan_index += hse->match_length; + hse->match_length = 0; + return HSES_SEARCH; + } + } else { + return HSES_YIELD_BR_LENGTH; + } +} + +static HSE_state st_save_backlog(heatshrink_encoder *hse) { + LOG("-- saving backlog\n"); + save_backlog(hse); + return HSES_NOT_FULL; +} + +static HSE_state st_flush_bit_buffer(heatshrink_encoder *hse, + output_info *oi) { + if (hse->bit_index == 0x80) { + LOG("-- done!\n"); + return HSES_DONE; + } else if (can_take_byte(oi)) { + LOG("-- flushing remaining byte (bit_index == 0x%02x)\n", hse->bit_index); + oi->buf[(*oi->output_size)++] = hse->current_byte; + LOG("-- done!\n"); + return HSES_DONE; + } else { + return HSES_FLUSH_BITS; + } +} + +static void add_tag_bit(heatshrink_encoder *hse, output_info *oi, uint8_t tag) { + LOG("-- adding tag bit: %d\n", tag); + push_bits(hse, 1, tag, oi); +} + +static uint16_t get_input_offset(heatshrink_encoder *hse) { + return get_input_buffer_size(hse); +} + +static uint16_t get_input_buffer_size(heatshrink_encoder *hse) { + return (1 << HEATSHRINK_ENCODER_WINDOW_BITS(hse)); + (void)hse; +} + +static uint16_t get_lookahead_size(heatshrink_encoder *hse) { + return (1 << HEATSHRINK_ENCODER_LOOKAHEAD_BITS(hse)); + (void)hse; +} + +static void do_indexing(heatshrink_encoder *hse) { +#if HEATSHRINK_USE_INDEX + /* Build an index array I that contains flattened linked lists + * for the previous instances of every byte in the buffer. + * + * For example, if buf[200] == 'x', then index[200] will either + * be an offset i such that buf[i] == 'x', or a negative offset + * to indicate end-of-list. This significantly speeds up matching, + * while only using sizeof(uint16_t)*sizeof(buffer) bytes of RAM. + * + * Future optimization options: + * 1. Since any negative value represents end-of-list, the other + * 15 bits could be used to improve the index dynamically. + * + * 2. Likewise, the last lookahead_sz bytes of the index will + * not be usable, so temporary data could be stored there to + * dynamically improve the index. + * */ + struct hs_index *hsi = HEATSHRINK_ENCODER_INDEX(hse); + int16_t last[256]; + memset(last, 0xFF, sizeof(last)); + + uint8_t * const data = hse->buffer; + int16_t * const index = hsi->index; + + const uint16_t input_offset = get_input_offset(hse); + const uint16_t end = input_offset + hse->input_size; + + for (uint16_t i=0; iflags & FLAG_IS_FINISHING; +} + +static int can_take_byte(output_info *oi) { + return *oi->output_size < oi->buf_size; +} + +/* Return the longest match for the bytes at buf[end:end+maxlen] between + * buf[start] and buf[end-1]. If no match is found, return -1. */ +static uint16_t find_longest_match(heatshrink_encoder *hse, uint16_t start, + uint16_t end, const uint16_t maxlen, uint16_t *match_length) { + LOG("-- scanning for match of buf[%u:%u] between buf[%u:%u] (max %u bytes)\n", + end, end + maxlen, start, end + maxlen - 1, maxlen); + uint8_t *buf = hse->buffer; + + uint16_t match_maxlen = 0; + uint16_t match_index = MATCH_NOT_FOUND; + + uint16_t len = 0; + uint8_t * const needlepoint = &buf[end]; +#if HEATSHRINK_USE_INDEX + struct hs_index *hsi = HEATSHRINK_ENCODER_INDEX(hse); + int16_t pos = hsi->index[end]; + + while (pos - (int16_t)start >= 0) { + uint8_t * const pospoint = &buf[pos]; + len = 0; + + /* Only check matches that will potentially beat the current maxlen. + * This is redundant with the index if match_maxlen is 0, but the + * added branch overhead to check if it == 0 seems to be worse. */ + if (pospoint[match_maxlen] != needlepoint[match_maxlen]) { + pos = hsi->index[pos]; + continue; + } + + for (len = 1; len < maxlen; len++) { + if (pospoint[len] != needlepoint[len]) break; + } + + if (len > match_maxlen) { + match_maxlen = len; + match_index = pos; + if (len == maxlen) { break; } /* won't find better */ + } + pos = hsi->index[pos]; + } +#else + for (int16_t pos=end - 1; pos - (int16_t)start >= 0; pos--) { + uint8_t * const pospoint = &buf[pos]; + if ((pospoint[match_maxlen] == needlepoint[match_maxlen]) + && (*pospoint == *needlepoint)) { + for (len=1; len cmp buf[%d] == 0x%02x against %02x (start %u)\n", + pos + len, pospoint[len], needlepoint[len], start); + } + if (pospoint[len] != needlepoint[len]) { break; } + } + if (len > match_maxlen) { + match_maxlen = len; + match_index = pos; + if (len == maxlen) { break; } /* don't keep searching */ + } + } + } +#endif + + const size_t break_even_point = + (1 + HEATSHRINK_ENCODER_WINDOW_BITS(hse) + + HEATSHRINK_ENCODER_LOOKAHEAD_BITS(hse)); + + /* Instead of comparing break_even_point against 8*match_maxlen, + * compare match_maxlen against break_even_point/8 to avoid + * overflow. Since MIN_WINDOW_BITS and MIN_LOOKAHEAD_BITS are 4 and + * 3, respectively, break_even_point/8 will always be at least 1. */ + if (match_maxlen > (break_even_point / 8)) { + LOG("-- best match: %u bytes at -%u\n", + match_maxlen, end - match_index); + *match_length = match_maxlen; + return end - match_index; + } + LOG("-- none found\n"); + return MATCH_NOT_FOUND; +} + +static uint8_t push_outgoing_bits(heatshrink_encoder *hse, output_info *oi) { + uint8_t count = 0; + uint8_t bits = 0; + if (hse->outgoing_bits_count > 8) { + count = 8; + bits = hse->outgoing_bits >> (hse->outgoing_bits_count - 8); + } else { + count = hse->outgoing_bits_count; + bits = hse->outgoing_bits; + } + + if (count > 0) { + LOG("-- pushing %d outgoing bits: 0x%02x\n", count, bits); + push_bits(hse, count, bits, oi); + hse->outgoing_bits_count -= count; + } + return count; +} + +/* Push COUNT (max 8) bits to the output buffer, which has room. + * Bytes are set from the lowest bits, up. */ +static void push_bits(heatshrink_encoder *hse, uint8_t count, uint8_t bits, + output_info *oi) { + ASSERT(count <= 8); + LOG("++ push_bits: %d bits, input of 0x%02x\n", count, bits); + + /* If adding a whole byte and at the start of a new output byte, + * just push it through whole and skip the bit IO loop. */ + if (count == 8 && hse->bit_index == 0x80) { + oi->buf[(*oi->output_size)++] = bits; + } else { + for (int i=count - 1; i>=0; i--) { + bool bit = bits & (1 << i); + if (bit) { hse->current_byte |= hse->bit_index; } + if (0) { + LOG(" -- setting bit %d at bit index 0x%02x, byte => 0x%02x\n", + bit ? 1 : 0, hse->bit_index, hse->current_byte); + } + hse->bit_index >>= 1; + if (hse->bit_index == 0x00) { + hse->bit_index = 0x80; + LOG(" > pushing byte 0x%02x\n", hse->current_byte); + oi->buf[(*oi->output_size)++] = hse->current_byte; + hse->current_byte = 0x00; + } + } + } +} + +static void push_literal_byte(heatshrink_encoder *hse, output_info *oi) { + uint16_t processed_offset = hse->match_scan_index - 1; + uint16_t input_offset = get_input_offset(hse) + processed_offset; + uint8_t c = hse->buffer[input_offset]; + LOG("-- yielded literal byte 0x%02x ('%c') from +%d\n", + c, isprint(c) ? c : '.', input_offset); + push_bits(hse, 8, c, oi); +} + +static void save_backlog(heatshrink_encoder *hse) { + size_t input_buf_sz = get_input_buffer_size(hse); + + uint16_t msi = hse->match_scan_index; + + /* Copy processed data to beginning of buffer, so it can be + * used for future matches. Don't bother checking whether the + * input is less than the maximum size, because if it isn't, + * we're done anyway. */ + uint16_t rem = input_buf_sz - msi; // unprocessed bytes + uint16_t shift_sz = input_buf_sz + rem; + + memmove(&hse->buffer[0], + &hse->buffer[input_buf_sz - rem], + shift_sz); + + hse->match_scan_index = 0; + hse->input_size -= input_buf_sz - rem; +} diff --git a/heatshrink/heatshrink_encoder.h b/heatshrink/heatshrink_encoder.h new file mode 100644 index 000000000..d9d2ad427 --- /dev/null +++ b/heatshrink/heatshrink_encoder.h @@ -0,0 +1,117 @@ +#ifndef HEATSHRINK_ENCODER_H +#define HEATSHRINK_ENCODER_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include +#include "heatshrink_common.h" +#include "heatshrink_config.h" + +typedef enum { + HSER_SINK_OK, /* data sunk into input buffer */ + HSER_SINK_ERROR_NULL=-1, /* NULL argument */ + HSER_SINK_ERROR_MISUSE=-2, /* API misuse */ +} HSE_sink_res; + +typedef enum { + HSER_POLL_EMPTY, /* input exhausted */ + HSER_POLL_MORE, /* poll again for more output */ + HSER_POLL_ERROR_NULL=-1, /* NULL argument */ + HSER_POLL_ERROR_MISUSE=-2, /* API misuse */ +} HSE_poll_res; + +typedef enum { + HSER_FINISH_DONE, /* encoding is complete */ + HSER_FINISH_MORE, /* more output remaining; use poll */ + HSER_FINISH_ERROR_NULL=-1, /* NULL argument */ +} HSE_finish_res; + +#if HEATSHRINK_DYNAMIC_ALLOC +#define HEATSHRINK_ENCODER_WINDOW_BITS(HSE) \ + ((HSE)->window_sz2) +#define HEATSHRINK_ENCODER_LOOKAHEAD_BITS(HSE) \ + ((HSE)->lookahead_sz2) +#define HEATSHRINK_ENCODER_INDEX(HSE) \ + ((HSE)->search_index) +struct hs_index { + uint16_t size; + int16_t index[]; +}; +#else +#define HEATSHRINK_ENCODER_WINDOW_BITS(_) \ + (HEATSHRINK_STATIC_WINDOW_BITS) +#define HEATSHRINK_ENCODER_LOOKAHEAD_BITS(_) \ + (HEATSHRINK_STATIC_LOOKAHEAD_BITS) +#define HEATSHRINK_ENCODER_INDEX(HSE) \ + (&(HSE)->search_index) +struct hs_index { + uint16_t size; + int16_t index[2 << HEATSHRINK_STATIC_WINDOW_BITS]; +}; +#endif + +typedef struct { + uint16_t input_size; /* bytes in input buffer */ + uint16_t match_scan_index; + uint16_t match_length; + uint16_t match_pos; + uint16_t outgoing_bits; /* enqueued outgoing bits */ + uint8_t outgoing_bits_count; + uint8_t flags; + uint8_t state; /* current state machine node */ + uint8_t current_byte; /* current byte of output */ + uint8_t bit_index; /* current bit index */ +#if HEATSHRINK_DYNAMIC_ALLOC + uint8_t window_sz2; /* 2^n size of window */ + uint8_t lookahead_sz2; /* 2^n size of lookahead */ +#if HEATSHRINK_USE_INDEX + struct hs_index *search_index; +#endif + /* input buffer and / sliding window for expansion */ + uint8_t buffer[]; +#else + #if HEATSHRINK_USE_INDEX + struct hs_index search_index; + #endif + /* input buffer and / sliding window for expansion */ + uint8_t buffer[2 << HEATSHRINK_ENCODER_WINDOW_BITS(_)]; +#endif +} heatshrink_encoder; + +#if HEATSHRINK_DYNAMIC_ALLOC +/* Allocate a new encoder struct and its buffers. + * Returns NULL on error. */ +heatshrink_encoder *heatshrink_encoder_alloc(uint8_t window_sz2, + uint8_t lookahead_sz2); + +/* Free an encoder. */ +void heatshrink_encoder_free(heatshrink_encoder *hse); +#endif + +/* Reset an encoder. */ +void heatshrink_encoder_reset(heatshrink_encoder *hse); + +/* Sink up to SIZE bytes from IN_BUF into the encoder. + * INPUT_SIZE is set to the number of bytes actually sunk (in case a + * buffer was filled.). */ +HSE_sink_res heatshrink_encoder_sink(heatshrink_encoder *hse, + uint8_t *in_buf, size_t size, size_t *input_size); + +/* Poll for output from the encoder, copying at most OUT_BUF_SIZE bytes into + * OUT_BUF (setting *OUTPUT_SIZE to the actual amount copied). */ +HSE_poll_res heatshrink_encoder_poll(heatshrink_encoder *hse, + uint8_t *out_buf, size_t out_buf_size, size_t *output_size); + +/* Notify the encoder that the input stream is finished. + * If the return value is HSER_FINISH_MORE, there is still more output, so + * call heatshrink_encoder_poll and repeat. */ +HSE_finish_res heatshrink_encoder_finish(heatshrink_encoder *hse); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/heatshrink/heatshrinkif.cpp b/heatshrink/heatshrinkif.cpp new file mode 100644 index 000000000..db3eebf32 --- /dev/null +++ b/heatshrink/heatshrinkif.cpp @@ -0,0 +1,113 @@ +#include "heatshrinkif.h" + +#include +#include +#include + +HeatshrinkIf::HeatshrinkIf() +{ + hse = new heatshrink_encoder; + hsd = new heatshrink_decoder; + + test("/home/benjamin/Nextcloud/Dokument/ARM/STM_Eclipse/BLDC_4_ChibiOS/build/BLDC_4_ChibiOS.bin"); +} + +HeatshrinkIf::~HeatshrinkIf() +{ + delete hse; + delete hsd; +} + +QByteArray HeatshrinkIf::encode(QByteArray in) +{ + heatshrink_encoder_reset(hse); + + size_t input_size = in.size(); + size_t comp_sz = input_size + (input_size/2) + 4; + uint8_t *comp = new uint8_t[comp_sz]; + uint8_t *input = (uint8_t*)in.data(); + + memset(comp, 0, comp_sz); + + size_t count = 0; + uint32_t sunk = 0; + uint32_t polled = 0; + + while (sunk < input_size) { + heatshrink_encoder_sink(hse, &input[sunk], input_size - sunk, &count); + sunk += count; + if (sunk == input_size) { + heatshrink_encoder_finish(hse); + } + + HSE_poll_res pres; + do { + pres = heatshrink_encoder_poll(hse, &comp[polled], comp_sz - polled, &count); + polled += count; + } while (pres == HSER_POLL_MORE); + + if (sunk == input_size) { + heatshrink_encoder_finish(hse); + } + } + + QByteArray res = QByteArray((char*)comp, polled); + delete[] comp; + + return res; +} + +QByteArray HeatshrinkIf::decode(QByteArray in) +{ + heatshrink_decoder_reset(hsd); + + uint32_t compressed_size = in.size(); + size_t count = 0; + uint32_t sunk = 0; + uint32_t polled = 0; + uint8_t *input = (uint8_t*)in.data(); + QByteArray res; + + while (sunk < compressed_size) { + heatshrink_decoder_sink(hsd, &input[sunk], compressed_size - sunk, &count); + sunk += count; + if (sunk == compressed_size) { + heatshrink_decoder_finish(hsd); + } + + HSD_poll_res pres; + do { + uint8_t chunk[16]; + pres = heatshrink_decoder_poll(hsd, chunk, 16, &count); + res.append((char*)chunk, count); + polled += count; + } while (pres == HSDR_POLL_MORE); + if (sunk == compressed_size) { + heatshrink_decoder_finish(hsd); + } + } + + return res; +} + +void HeatshrinkIf::test(QString fileName) +{ + qDebug() << sizeof(heatshrink_encoder) << sizeof(heatshrink_decoder); + + QFile file(fileName); + if (!file.open(QIODevice::ReadOnly)) { + qWarning() << "Could not open" << fileName; + return; + } + auto dataIn = file.readAll(); + file.close(); + + auto comp = encode(dataIn); + + qDebug() << "In:" << dataIn.size() << "Out:" << comp.size() << "Final size:" + << (100.0 * double(comp.size()) / double(dataIn.size())) << "%"; + + auto decomp = decode(comp); + qDebug() << "DecompSz:" << decomp.size(); + qDebug() << "Compare:" << decomp.compare(dataIn); +} diff --git a/heatshrink/heatshrinkif.h b/heatshrink/heatshrinkif.h new file mode 100644 index 000000000..3f5136789 --- /dev/null +++ b/heatshrink/heatshrinkif.h @@ -0,0 +1,23 @@ +#ifndef HEATSHRINKIF_H +#define HEATSHRINKIF_H + +#include "heatshrink_encoder.h" +#include "heatshrink_decoder.h" +#include + +class HeatshrinkIf +{ +public: + HeatshrinkIf(); + ~HeatshrinkIf(); + + QByteArray encode(QByteArray in); + QByteArray decode(QByteArray in); + void test(QString fileName); + +private: + heatshrink_encoder *hse; + heatshrink_decoder *hsd; +}; + +#endif // HEATSHRINKIF_H diff --git a/res/bootloaders/40_o_47_o_48_o_410_o_411_o_412_o_DAS_RS.bin b/res/bootloaders/40_o_47_o_48_o_410_o_411_o_412_o_DAS_RS.bin index 0108891ddad68d36bf6adf0541867e56cf5b5cfb..18b3306c8fee81e37325a37b28c90f7d011fa25d 100755 GIT binary patch delta 3405 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 bF+;(_;Atuu83`@K==~XaP2u3V2xRp)l(bp? diff --git a/res/bootloaders/60_o_75_300_o_HD60_o_UAVC_OMEGA_o_75_300_R2_o_60_MK3_o_100_250_o_75_300_R3_o_60_MK4_o_60_MK5_o_HD75.bin b/res/bootloaders/60_o_75_300_o_HD60_o_UAVC_OMEGA_o_75_300_R2_o_60_MK3_o_100_250_o_75_300_R3_o_60_MK4_o_60_MK5_o_HD75.bin index d53db114be133bb274171e5c3a771867c8d76641..ae5fa1658dfc966c5e897c9b7aac9490aeb881b9 100755 GIT binary patch delta 2401 zcmcIke{2)?6@T9!XJ1I-xOJKZNa5@wt-+x)33Q!N!MWHMRFa}GsD!F*DYO$}YU{$J zv81Zcq?(*|MO4>zg|rD*ruOu?Ct8kr|;fFJp;qN8~eK3dL(tB4|##HlD)!wHCtNQ-{KbX8Sl zyQ5vk8Vgt3CvTMP{maIwCSU`a=>Lg8V zbzuZ}ln+YnO&g4TO_?m^Z{-rOPfKCmnfSyk$hWFQKd7FuU>FY~9SxG{Dzq&^UOPHn zg>BH}Ecov_O9l@{x}r5%Z=M{Y$LzKqEs6eImK-{1qPklmHCeZhyjDAnk?r%@?63(7 zF8sN!_!Rqnp(|Q%OiU85O~vHNe?6Cc^y;Va0^wV4@vT=%0$+{r)xlED24JsVEfgSq zv;Y~n2zj754B!%Dt9b|zMG$d#bG=I}x2!_TxDD5XbT7A1d7f0;KL_Grggl%LhuU-B z;XMg+xz@(7-S~gKheKl%!Pc9uB@+K1M()tXiJDg7KR_C~GC^BKW5U^#xyeFnfeXr2 zCyCah#yTM*uJGiZc0Oacd96 zU3{|x>>v* z?ogq=xq|nwY@^D47wdE;A5BG*k2L)zEkso9;l9(mf2+`pqG3(DE$sVS zVbho8J@ZIDqm{>fT$zzDRl!>u1lCvtSx)Ro$a`dMhjv8!IIg+J{tLE!@+s^1iPT7n zCO_zEC-g;AOOtJ`0uj)MHS>fS`du)_fqv6s!MeQVCEg|+k>`}|kaHNxpHY6M~;SNHdLh55@{WrsQN>rCxm2-hZ$#UvsYFbIF*afPIniG-{I*`>d5<`+{#_tMAGY3k6)JJ(kcQ*t<_oejiv zW90(fs$9TZ-K}ZG%2HNG(YHtonRa?=rQ$niE_{6qM~qsA{|&7jHtPTY delta 936 zcmbu6O=uHA6vy98HrvV4jH!mw_{DAniBS7tQ3BNxLK>U2B`P78BE+989$iV---{Jq>yf-6<>xKyo zbR)poC8ax^4{|nu>bCAbzu9Yp9_!7XH|T8uv&&}(JjcJw!pv-LE|$Cbt91l+4OXS#OaY^)q)JNMT`)-TqUc?iuvAE?xDdat7Ef3@eFNh?O);$I32a@dtkiH_l z^WZ16K%prB&Qejl1sDTHQ#UwgE2y1eI!;7?aGN&&3PqjK>JiQ$0(vGYO6n{1HvZ0C zrMACsFQLH22s=e}F0NsUaIu1EjEi+PMO$Gp7@DFoEJ~phv=J6}Lig!8F5+5=rntDJ zEn=!QwMXPIdq#}HCX_+Gba&Uj+1bIk+_{4BL8sR2=Y-a|_!YkJbf86QOZz1K2lgND ADgXcg diff --git a/res/bootloaders/generic.bin b/res/bootloaders/generic.bin index 1cc4f5bcc293ebe46aa26b773486f812b7f95ca9..cc6796e6ced0c5558c186d04bee357b979f2f834 100755 GIT binary patch delta 2294 zcmcgsYitx%6h8McyR)>kyKTh+1-3gD7q*b4Emd1B?Q}auEY=5@pivt@gC;@){vbfu zsi;|e1vB_ujRer7KD!I3HI&6*eMOVmR!s{ks~87tFn0>*w6AB4 zeL2>&9O9y1Fmqh4gOBGzD2wspE5lJJpJmC`l6mB zul*~xh+@;q(# z^Zl9;(chmW(f3T0J1aCj>GqM=rVd~fww($`J4~2z=6LS#BkUuCK0~AV%QX3euOUIB zsGMpvs>#+jhmEENLGSK+*RXxQ9sS10S_?faEh0Cif+4tLl1hwi>jmzZX?q3^UY|wVAYDx4FLc(ak$r?Qq&|Jcb=(+HSIRidw+0 z(hc7GE3_ZU5yv9_kgj$dc$MZMeAJ^I5h`)Yqy55-?$H)HDlzkDcROnE9*_14Hys}B zM@Jdn<tuDL2_7V@F;^yJuu!HZqS1I^qMjl0n2a~EWTCCN>8)6NS z^+j*Tg^;4&x3zoYJ2FkkDpu9GwZ89+=3mmAGDv$OGs}HQ9`s_WK=ITdpY~ypq_#C} z(k4k=qwZ5rg;jUgpJ3Z16|)X?#ty`2)4_L1X0bshy|6z5{Dj~Zx}q_7?Z!6!(mu)25LArn%b z2w6D+uG067Lmko{j^f1xtr_>~dm{%e$I)HAv{8wI2OOf&kzW9W_zt+fb?w#;CuaB32 zeW9aqR4%nWU@ZXK7ksPgig=A~wqozbBZh;!HX4NMkYV?;wQ&PO5aPeLrLi4bgaGY> z2m}ig$lKazO9pdb#PtK>WBjnQUSBaA=GW+-#)*Pc1!lV9%3fljz>7{RNlF9#pT`@1 z5=wGQxo()&zu$B_m$-=ObvOo`(}?ND@)^2PK7&`f%i^+?q%4=BD@Z9BaOO|#pRM>5 zT1Dn77QJn_&o{@%2&QHEA<76XjeSxaFADKgGhdK@OWH4`Kp{%E@z*gtkji5Ccj0a5 AAOHXW delta 830 zcmb_Y&ubG=5T1G2jjx->Ce<8bZOaCc{uDPxil#e?VkF z54lM_^dd^I1rHUa&`T*Bym(L=yp*ECOQ>Z-Le}TKm&Fdud~^8b`(~y*;f^@K!TQ8Z zj#{v6DgL{FGiP`>fsM})`40^z*wyE2uDqRqF9a3WkLALRd3(-&kh*v1?N^@{pS?{K z(nWm?uHq&V$bJ_$^@3djdE8weozH89^jEutwTVI^2Xe1l$xbyuUh1_iCwc$StCm5I z^t4vO&|9$1lD9n;1-aDY<3o*C`H;KhX;Ult_Lo~qqHPW5uH|-Hum&>JGk$6i_wWkH zCyE_vyw3hn!cG_Oplg@5kMJedj5*4le1nfz!!#1sDC>Rybp*gU{D#ZT**I7LCa(yS z`_n1(eI4GYo;I{TGkx07?;5UYa)^PIi_@vT6Hcn9O>6ZJ;fu&(f(|asFk4WV&oE0+ zM!~G0$2`Migtiobpi_R6H6t`R@PZWueI8h54+RYwkN&|^ @@ -1377,11 +1378,30 @@ bool VescInterface::fwUpload(QByteArray &newFirmware, bool isBootloader, bool fw int nonCompChunks = 0; int skipChunks = 0; + HeatshrinkIf hs; + bool useHeatshrink = false; + if (szTot > 393208) { + useHeatshrink = true; + qDebug() << "Firmware is big, using heatshrink compression library"; + int szOld = szTot; + newFirmware = hs.encode(newFirmware); + szTot = newFirmware.size(); + qDebug() << "New size:" << szTot << "(" << 100.0 * (double)szTot / (double)szOld << "%)"; + supportsLzo = false; + } + if (!isBootloader) { quint16 crc = Packet::crc16((const unsigned char*)newFirmware.constData(), uint32_t(newFirmware.size())); VByteArray sizeCrc; - sizeCrc.vbAppendInt32(szTot); + if (useHeatshrink) { + uint32_t szShift = 0xCC; + szShift <<= 24; + szShift |= szTot; + sizeCrc.vbAppendUint32(szShift); + } else { + sizeCrc.vbAppendUint32(szTot); + } sizeCrc.vbAppendUint16(crc); newFirmware.prepend(sizeCrc); } From 2cbcb853a0811c534f984e7d8991802e2130f81b Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Tue, 18 Jan 2022 20:38:31 +0100 Subject: [PATCH 003/559] Added warning when the firmware is too big. --- vescinterface.cpp | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/vescinterface.cpp b/vescinterface.cpp index 5399b5d89..b31f3e8f1 100755 --- a/vescinterface.cpp +++ b/vescinterface.cpp @@ -1388,6 +1388,13 @@ bool VescInterface::fwUpload(QByteArray &newFirmware, bool isBootloader, bool fw szTot = newFirmware.size(); qDebug() << "New size:" << szTot << "(" << 100.0 * (double)szTot / (double)szOld << "%)"; supportsLzo = false; + + if (szTot > 393208) { + emitMessageDialog(tr("Firmware too big"), + tr("The firmware you are trying to upload is too large for the " + "bootloader even after compression."), false); + return false; + } } if (!isBootloader) { From e874ede66f548daddac3a40d17cf626d9c18f267 Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Tue, 18 Jan 2022 21:06:49 +0100 Subject: [PATCH 004/559] Removed test test code --- heatshrink/heatshrinkif.cpp | 2 -- vescinterface.cpp | 2 +- 2 files changed, 1 insertion(+), 3 deletions(-) diff --git a/heatshrink/heatshrinkif.cpp b/heatshrink/heatshrinkif.cpp index db3eebf32..b704401ba 100644 --- a/heatshrink/heatshrinkif.cpp +++ b/heatshrink/heatshrinkif.cpp @@ -8,8 +8,6 @@ HeatshrinkIf::HeatshrinkIf() { hse = new heatshrink_encoder; hsd = new heatshrink_decoder; - - test("/home/benjamin/Nextcloud/Dokument/ARM/STM_Eclipse/BLDC_4_ChibiOS/build/BLDC_4_ChibiOS.bin"); } HeatshrinkIf::~HeatshrinkIf() diff --git a/vescinterface.cpp b/vescinterface.cpp index b31f3e8f1..8dbfe6810 100755 --- a/vescinterface.cpp +++ b/vescinterface.cpp @@ -1378,12 +1378,12 @@ bool VescInterface::fwUpload(QByteArray &newFirmware, bool isBootloader, bool fw int nonCompChunks = 0; int skipChunks = 0; - HeatshrinkIf hs; bool useHeatshrink = false; if (szTot > 393208) { useHeatshrink = true; qDebug() << "Firmware is big, using heatshrink compression library"; int szOld = szTot; + HeatshrinkIf hs; newFirmware = hs.encode(newFirmware); szTot = newFirmware.size(); qDebug() << "New size:" << szTot << "(" << 100.0 * (double)szTot / (double)szOld << "%)"; From 7eab8cc0d02ed162faa51feb46071bb7471e627c Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Wed, 19 Jan 2022 15:41:37 +0100 Subject: [PATCH 005/559] Support larger firmware files --- build_all | 1 + build_test_versions | 2 ++ mobile/fwhelper.cpp | 2 +- pages/pagefirmware.cpp | 2 +- 4 files changed, 5 insertions(+), 2 deletions(-) diff --git a/build_all b/build_all index 015b6f5a8..f7da1cb7f 100755 --- a/build_all +++ b/build_all @@ -11,4 +11,5 @@ rm /storage/mnt_webserver/web/ubercart_downloads/vesc_tool_* mv build/lin/vesc_tool_* /storage/mnt_webserver/web/ubercart_downloads/ mv build/win/vesc_tool_* /storage/mnt_webserver/web/ubercart_downloads/ mv build/android/vesc_tool_* /storage/mnt_webserver/web/ubercart_downloads/ +cp build/macos/vesc_tool_* /storage/mnt_webserver/web/ubercart_downloads/ diff --git a/build_test_versions b/build_test_versions index 28c011182..9d10cf324 100755 --- a/build_test_versions +++ b/build_test_versions @@ -2,6 +2,8 @@ set -e +touch build/test_all/"Build Date $(date '+%Y-%m-%d')" + # Linux export PATH=/opt/Qt/5.12-static/bin:$PATH rm -rf build/lin/* diff --git a/mobile/fwhelper.cpp b/mobile/fwhelper.cpp index e0cb84a98..75d29f1b0 100644 --- a/mobile/fwhelper.cpp +++ b/mobile/fwhelper.cpp @@ -132,7 +132,7 @@ bool FwHelper::uploadFirmware(QString filename, VescInterface *vesc, return false; } - if (file.size() > 400000) { + if (file.size() > 700000) { vesc->emitMessageDialog(tr("Upload Error"), tr("The selected file is too large to be a firmware."), false); diff --git a/pages/pagefirmware.cpp b/pages/pagefirmware.cpp index 1458cd9b9..f0d182e70 100755 --- a/pages/pagefirmware.cpp +++ b/pages/pagefirmware.cpp @@ -462,7 +462,7 @@ void PageFirmware::uploadFw(bool allOverCan) } } - if (file.size() > 400000 && !(file.fileName().toLower().endsWith(".hex"))) { + if (file.size() > 700000 && !(file.fileName().toLower().endsWith(".hex"))) { QMessageBox::critical(this, tr("Upload Error"), tr("The selected file is too large to be a firmware.")); From 24d5ff47c572963383f637b5a660be77b5f10b07 Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Thu, 20 Jan 2022 02:00:06 +0100 Subject: [PATCH 006/559] Only replot graphs when visible and queue replots until they become visible otherwise --- pages/pageappbalance.cpp | 2 +- pages/pageappimu.cpp | 6 +++--- pages/pageappnunchuk.cpp | 2 +- pages/pageappppm.cpp | 2 +- pages/pagebms.cpp | 4 ++-- pages/pageexperiments.cpp | 4 ++-- pages/pageimu.cpp | 8 ++++---- pages/pageloganalysis.cpp | 4 ++-- pages/pagemotorcomparison.cpp | 6 +++--- pages/pagertdata.cpp | 22 +++++++++++----------- pages/pagesampleddata.cpp | 18 +++++++++--------- res/CHANGELOG | 4 ++++ widgets/qcustomplot.h | 19 +++++++++++++++++++ 13 files changed, 62 insertions(+), 39 deletions(-) diff --git a/pages/pageappbalance.cpp b/pages/pageappbalance.cpp index 4b19868d6..d497b9074 100644 --- a/pages/pageappbalance.cpp +++ b/pages/pageappbalance.cpp @@ -167,7 +167,7 @@ void PageAppBalance::timerSlot() ui->balancePlot->rescaleAxes(); - ui->balancePlot->replot(); + ui->balancePlot->replotWhenVisible(); updateTextOutput(); } diff --git a/pages/pageappimu.cpp b/pages/pageappimu.cpp index 1a2e47dd2..1710ab578 100644 --- a/pages/pageappimu.cpp +++ b/pages/pageappimu.cpp @@ -190,9 +190,9 @@ void PageAppImu::timerSlot() ui->accelPlot->rescaleAxes(); ui->gyroPlot->rescaleAxes(); - ui->rpyPlot->replot(); - ui->accelPlot->replot(); - ui->gyroPlot->replot(); + ui->rpyPlot->replotWhenVisible(); + ui->accelPlot->replotWhenVisible(); + ui->gyroPlot->replotWhenVisible(); } } diff --git a/pages/pageappnunchuk.cpp b/pages/pageappnunchuk.cpp index 4d122ff45..6cf392cb9 100644 --- a/pages/pageappnunchuk.cpp +++ b/pages/pageappnunchuk.cpp @@ -108,7 +108,7 @@ void PageAppNunchuk::paramChangedDouble(QObject *src, QString name, double newPa } ui->throttlePlot->graph()->setData(x, y); ui->throttlePlot->rescaleAxes(); - ui->throttlePlot->replot(); + ui->throttlePlot->replotWhenVisible(); } } diff --git a/pages/pageappppm.cpp b/pages/pageappppm.cpp index 0eb0a9f0f..df85cbdc4 100644 --- a/pages/pageappppm.cpp +++ b/pages/pageappppm.cpp @@ -99,7 +99,7 @@ void PageAppPpm::paramChangedDouble(QObject *src, QString name, double newParam) } ui->throttlePlot->graph()->setData(x, y); ui->throttlePlot->rescaleAxes(); - ui->throttlePlot->replot(); + ui->throttlePlot->replotWhenVisible(); } } diff --git a/pages/pagebms.cpp b/pages/pagebms.cpp index 0ae0b68ff..0594481bb 100644 --- a/pages/pagebms.cpp +++ b/pages/pagebms.cpp @@ -83,7 +83,7 @@ void PageBms::bmsValuesRx(BMS_VALUES val) } ui->plotCells->xAxis->setTicker(textTicker); - ui->plotCells->replot(); + ui->plotCells->replotWhenVisible(); // Temps @@ -113,7 +113,7 @@ void PageBms::bmsValuesRx(BMS_VALUES val) } ui->plotTemp->xAxis->setTicker(textTicker2); - ui->plotTemp->replot(); + ui->plotTemp->replotWhenVisible(); // Value table ui->valTable->item(0, 0)->setText(QString("%1 V").arg(val.v_tot, 0, 'f', 2)); diff --git a/pages/pageexperiments.cpp b/pages/pageexperiments.cpp index 4b163078e..ec325684b 100644 --- a/pages/pageexperiments.cpp +++ b/pages/pageexperiments.cpp @@ -597,7 +597,7 @@ void PageExperiments::plotSamples(bool exportFormat) ui->plot->rescaleAxes(); } - ui->plot->replot(); + ui->plot->replotWhenVisible(); } void PageExperiments::victronGetCurrent() @@ -625,7 +625,7 @@ void PageExperiments::victronGetVoltage() void PageExperiments::on_rescaleButton_clicked() { ui->plot->rescaleAxes(); - ui->plot->replot(); + ui->plot->replotWhenVisible(); } void PageExperiments::on_zoomHButton_toggled(bool checked) diff --git a/pages/pageimu.cpp b/pages/pageimu.cpp index 7e163e711..c4b76c763 100644 --- a/pages/pageimu.cpp +++ b/pages/pageimu.cpp @@ -206,10 +206,10 @@ void PageImu::timerSlot() ui->gyroPlot->rescaleAxes(); ui->magPlot->rescaleAxes(); - ui->rpyPlot->replot(); - ui->accelPlot->replot(); - ui->gyroPlot->replot(); - ui->magPlot->replot(); + ui->rpyPlot->replotWhenVisible(); + ui->accelPlot->replotWhenVisible(); + ui->gyroPlot->replotWhenVisible(); + ui->magPlot->replotWhenVisible(); } } diff --git a/pages/pageloganalysis.cpp b/pages/pageloganalysis.cpp index 58278f76b..a6a61a88a 100644 --- a/pages/pageloganalysis.cpp +++ b/pages/pageloganalysis.cpp @@ -773,7 +773,7 @@ void PageLogAnalysis::updateGraphs() mVerticalLine->setVisible(true); } - ui->plot->replot(); + ui->plot->replotWhenVisible(); } void PageLogAnalysis::updateStats() @@ -910,7 +910,7 @@ void PageLogAnalysis::updateDataAndPlot(double time) x[1] = time; y[1] = ui->plot->yAxis->range().upper; mVerticalLine->setData(x, y); mVerticalLine->setVisible(true); - ui->plot->replot(); + ui->plot->replotWhenVisible(); LOG_DATA d = getLogSample(int(time * 1000)); mVerticalLineMsLast = d.valTime; diff --git a/pages/pagemotorcomparison.cpp b/pages/pagemotorcomparison.cpp index 5d66b4683..1175b028b 100644 --- a/pages/pagemotorcomparison.cpp +++ b/pages/pagemotorcomparison.cpp @@ -75,7 +75,7 @@ PageMotorComparison::PageMotorComparison(QWidget *parent) : connect(ui->rescaleButton, &QPushButton::clicked, [this]() { on_testRunButton_clicked(); ui->plot->rescaleAxes(); - ui->plot->replot(); + ui->plot->replotWhenVisible(); }); connect(ui->m1ConfLocalButton, &QRadioButton::toggled, [this]() { @@ -399,7 +399,7 @@ void PageMotorComparison::updateDataAndPlot(double posx, double yMin, double yMa x[1] = posx; y[1] = yMax; mVerticalLine->setData(x, y); mVerticalLine->setVisible(true); - ui->plot->replot(); + ui->plot->replotWhenVisible(); mVerticalLinePosLast = posx; mVerticalLineYLast.first = yMin; mVerticalLineYLast.second = yMax; @@ -672,7 +672,7 @@ void PageMotorComparison::on_testRunButton_clicked() ui->plot->rescaleAxes(); } - ui->plot->replot(); + ui->plot->replotWhenVisible(); }; auto plotTorqueSweep = [this, updateData, updateGraphs](QTableWidget *table, diff --git a/pages/pagertdata.cpp b/pages/pagertdata.cpp index 310f6a15c..ca3c10252 100644 --- a/pages/pagertdata.cpp +++ b/pages/pagertdata.cpp @@ -338,10 +338,10 @@ void PageRtData::timerSlot() ui->focPlot->rescaleAxes(); } - ui->currentPlot->replot(); - ui->tempPlot->replot(); - ui->rpmPlot->replot(); - ui->focPlot->replot(); + ui->currentPlot->replotWhenVisible(); + ui->tempPlot->replotWhenVisible(); + ui->rpmPlot->replotWhenVisible(); + ui->focPlot->replotWhenVisible(); mUpdateValPlot = false; } @@ -359,7 +359,7 @@ void PageRtData::timerSlot() ui->posPlot->rescaleAxes(); } - ui->posPlot->replot(); + ui->posPlot->replotWhenVisible(); mUpdatePosPlot = false; } @@ -399,7 +399,7 @@ void PageRtData::timerSlot() ui->experimentPlot->rescaleAxes(); } - ui->experimentPlot->replot(); + ui->experimentPlot->replotWhenVisible(); mExperimentReplot = false; } } @@ -546,11 +546,11 @@ void PageRtData::on_rescaleButton_clicked() ui->focPlot->rescaleAxes(); ui->posPlot->rescaleAxes(); - ui->currentPlot->replot(); - ui->tempPlot->replot(); - ui->rpmPlot->replot(); - ui->focPlot->replot(); - ui->posPlot->replot(); + ui->currentPlot->replotWhenVisible(); + ui->tempPlot->replotWhenVisible(); + ui->rpmPlot->replotWhenVisible(); + ui->focPlot->replotWhenVisible(); + ui->posPlot->replotWhenVisible(); } void PageRtData::on_posInductanceButton_clicked() diff --git a/pages/pagesampleddata.cpp b/pages/pagesampleddata.cpp index 3e4717037..374fd22dc 100644 --- a/pages/pagesampleddata.cpp +++ b/pages/pagesampleddata.cpp @@ -197,8 +197,8 @@ void PageSampledData::timerSlot() ui->filterResponsePlot->rescaleAxes(); } - ui->filterPlot->replot(); - ui->filterResponsePlot->replot(); + ui->filterPlot->replotWhenVisible(); + ui->filterResponsePlot->replotWhenVisible(); mDoFilterReplot = false; } @@ -480,8 +480,8 @@ void PageSampledData::timerSlot() ui->voltagePlot->rescaleAxes(); } - ui->currentPlot->replot(); - ui->voltagePlot->replot(); + ui->currentPlot->replotWhenVisible(); + ui->voltagePlot->replotWhenVisible(); } @@ -625,16 +625,16 @@ void PageSampledData::on_zoomVButton_toggled(bool checked) void PageSampledData::on_rescaleButton_clicked() { ui->currentPlot->rescaleAxes(); - ui->currentPlot->replot(); + ui->currentPlot->replotWhenVisible(); ui->voltagePlot->rescaleAxes(); - ui->voltagePlot->replot(); + ui->voltagePlot->replotWhenVisible(); ui->filterPlot->rescaleAxes(); - ui->filterPlot->replot(); + ui->filterPlot->replotWhenVisible(); ui->filterResponsePlot->rescaleAxes(); - ui->filterResponsePlot->replot(); + ui->filterResponsePlot->replotWhenVisible(); } void PageSampledData::clearBuffers() @@ -673,7 +673,7 @@ void PageSampledData::on_filterLogScaleBox_toggled(bool checked) } ui->filterResponsePlot->rescaleAxes(); - ui->filterResponsePlot->replot(); + ui->filterResponsePlot->replotWhenVisible(); } diff --git a/res/CHANGELOG b/res/CHANGELOG index c4057c8d9..8b15ca138 100644 --- a/res/CHANGELOG +++ b/res/CHANGELOG @@ -1,3 +1,7 @@ +== 4.00 == +* Added support for compressed firmware upload. +* Reduce CPU usage by only plotting RT data when the plot is visible. + == 3.01 == * Fixed simultaneous CAN FW upload when other devices (such as BMS) are on the CAN-bus. * Fixed configuration backup and restore over CAN-bus. diff --git a/widgets/qcustomplot.h b/widgets/qcustomplot.h index 100b30d09..53b225144 100644 --- a/widgets/qcustomplot.h +++ b/widgets/qcustomplot.h @@ -3909,6 +3909,14 @@ class QCP_LIB_DECL QCustomPlot : public QWidget QCPAxis *xAxis, *yAxis, *xAxis2, *yAxis2; QCPLegend *legend; + + void replotWhenVisible() { + if (isVisible()) { + replot(rpQueuedReplot); + } else { + doReplotOnShow = true; + } + } signals: void mouseDoubleClick(QMouseEvent *event); @@ -3932,6 +3940,17 @@ class QCP_LIB_DECL QCustomPlot : public QWidget void afterReplot(); protected: + bool doReplotOnShow; + + virtual void showEvent(QShowEvent *event) override + { + (void)event; + if (doReplotOnShow) { + replot(rpQueuedReplot); + doReplotOnShow = false; + } + } + // property members: QRect mViewport; double mBufferDevicePixelRatio; From f3cf310baf23038c31b40cf3db17380f013242e0 Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Mon, 24 Jan 2022 00:37:31 +0100 Subject: [PATCH 007/559] Added custom motor temperature sensors --- res/config/6.00/parameters_mcconf.xml | 50 +++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) diff --git a/res/config/6.00/parameters_mcconf.xml b/res/config/6.00/parameters_mcconf.xml index 51c010e63..1fa5940a3 100644 --- a/res/config/6.00/parameters_mcconf.xml +++ b/res/config/6.00/parameters_mcconf.xml @@ -3450,6 +3450,8 @@ p, li { white-space: pre-wrap; } KTY83/122 NTC 100K at 25°C KTY84/130 + NTC Custom + PTC Custom Coefficient for PTC Motor Thermistor @@ -3473,6 +3475,50 @@ p, li { white-space: pre-wrap; } %/K 9 + + Custom NTC/PTC Resistance + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Resistance of custom NTC/PTC resistor.</p></body></html> + MCCONF_M_NTCX_PTCX_RES + 2 + 0.001 + 0 + 200000 + 100 + 0 + 0.1 + 10000 + 0.1 + + 7 + + + Custom NTC/PTC Base Temperature + 1 + 1 + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'Roboto'; ; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Base temperature of custom NTC/PTC resistor.</p></body></html> + MCCONF_M_NTCX_PTCX_BASE_TEMP + 2 + 1 + 0 + 500 + -274 + 0 + 0.1 + 25 + 10 + °C + 7 + Hall Sensor Extra Samples 2 @@ -4106,6 +4152,8 @@ p, li { white-space: pre-wrap; } m_out_aux_mode m_motor_temp_sens_type m_ptc_motor_coeff + m_ntcx_ptcx_res + m_ntcx_ptcx_temp_base m_hall_extra_samples si_motor_poles si_gear_ratio @@ -4210,6 +4258,8 @@ p, li { white-space: pre-wrap; } m_motor_temp_sens_type m_ntc_motor_beta m_ptc_motor_coeff + m_ntcx_ptcx_res + m_ntcx_ptcx_temp_base l_duty_start m_hall_extra_samples From f563f27da11f0df344f9240f8e1ab9818947fc49 Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Sat, 29 Jan 2022 03:30:51 +0100 Subject: [PATCH 008/559] Stared integrating lisp scripting support --- QCodeEditor/include/LispHighlighter | 3 + QCodeEditor/include/QLispCompleter | 3 + .../include/internal/LispHighlighter.hpp | 36 + QCodeEditor/include/internal/QCodeEditor.hpp | 9 + .../include/internal/QLispCompleter.hpp | 18 + QCodeEditor/qcodeeditor.pri | 4 + QCodeEditor/resources/languages/lisp.xml | 23 + .../resources/qcodeeditor_resources.qrc | 1 + QCodeEditor/src/internal/LispHighlighter.cpp | 94 +++ QCodeEditor/src/internal/QCodeEditor.cpp | 33 +- QCodeEditor/src/internal/QLispCompleter.cpp | 101 +++ commands.cpp | 78 ++ commands.h | 12 + datatypes.h | 33 + mainwindow.cpp | 8 +- mainwindow.h | 2 + pages/pagelisp.cpp | 665 ++++++++++++++++++ pages/pagelisp.h | 75 ++ pages/pagelisp.ui | 472 +++++++++++++ pages/pages.pri | 3 + pages/pagescripting.cpp | 47 +- pages/pagescripting.h | 10 +- pages/pagescripting.ui | 6 +- res/CHANGELOG | 6 + res/Lisp/Examples/aux.lisp | 17 + res/Lisp/Examples/can_pos_follow.lisp | 16 + .../Examples/control_servo_from_duty.lisp | 24 + .../Examples/control_servo_from_encoder.lisp | 10 + res/Lisp/Examples/duty.lisp | 22 + res/Lisp/Examples/ppm_read.lisp | 9 + res/Lisp/Examples/print_bms_data.lisp | 35 + res/Lisp/Examples/speed_test.lisp | 53 ++ res/qml/Examples/RpmSlider.qml | 117 +++ res_lisp.qrc | 12 + res_qml.qrc | 1 + vesc_tool.pro | 3 +- widgets/qmleditor.h | 50 -- widgets/{qmleditor.cpp => scripteditor.cpp} | 85 ++- widgets/scripteditor.h | 72 ++ widgets/{qmleditor.ui => scripteditor.ui} | 16 +- widgets/widgets.pri | 6 +- 41 files changed, 2165 insertions(+), 125 deletions(-) create mode 100644 QCodeEditor/include/LispHighlighter create mode 100644 QCodeEditor/include/QLispCompleter create mode 100644 QCodeEditor/include/internal/LispHighlighter.hpp create mode 100644 QCodeEditor/include/internal/QLispCompleter.hpp create mode 100644 QCodeEditor/resources/languages/lisp.xml create mode 100644 QCodeEditor/src/internal/LispHighlighter.cpp create mode 100644 QCodeEditor/src/internal/QLispCompleter.cpp create mode 100644 pages/pagelisp.cpp create mode 100644 pages/pagelisp.h create mode 100644 pages/pagelisp.ui create mode 100644 res/Lisp/Examples/aux.lisp create mode 100644 res/Lisp/Examples/can_pos_follow.lisp create mode 100644 res/Lisp/Examples/control_servo_from_duty.lisp create mode 100644 res/Lisp/Examples/control_servo_from_encoder.lisp create mode 100644 res/Lisp/Examples/duty.lisp create mode 100644 res/Lisp/Examples/ppm_read.lisp create mode 100644 res/Lisp/Examples/print_bms_data.lisp create mode 100644 res/Lisp/Examples/speed_test.lisp create mode 100644 res/qml/Examples/RpmSlider.qml create mode 100644 res_lisp.qrc delete mode 100644 widgets/qmleditor.h rename widgets/{qmleditor.cpp => scripteditor.cpp} (64%) create mode 100644 widgets/scripteditor.h rename widgets/{qmleditor.ui => scripteditor.ui} (94%) diff --git a/QCodeEditor/include/LispHighlighter b/QCodeEditor/include/LispHighlighter new file mode 100644 index 000000000..36699bb44 --- /dev/null +++ b/QCodeEditor/include/LispHighlighter @@ -0,0 +1,3 @@ +#pragma once + +#include diff --git a/QCodeEditor/include/QLispCompleter b/QCodeEditor/include/QLispCompleter new file mode 100644 index 000000000..665c21ba2 --- /dev/null +++ b/QCodeEditor/include/QLispCompleter @@ -0,0 +1,3 @@ +#pragma once + +#include diff --git a/QCodeEditor/include/internal/LispHighlighter.hpp b/QCodeEditor/include/internal/LispHighlighter.hpp new file mode 100644 index 000000000..0bd59b7a9 --- /dev/null +++ b/QCodeEditor/include/internal/LispHighlighter.hpp @@ -0,0 +1,36 @@ +#pragma once + +// QCodeEditor +#include // Required for inheritance +#include + +// Qt +#include +#include + +class QSyntaxStyle; + +/** + * @brief Class, that describes C++ code + * highlighter. + */ +class LispHighlighter : public QStyleSyntaxHighlighter +{ + Q_OBJECT +public: + + /** + * @brief Constructor. + * @param document Pointer to document. + */ + explicit LispHighlighter(QTextDocument* document=nullptr); + +protected: + void highlightBlock(const QString& text) override; + +private: + QVector m_highlightRules; + QRegularExpression m_keyRegex; + +}; + diff --git a/QCodeEditor/include/internal/QCodeEditor.hpp b/QCodeEditor/include/internal/QCodeEditor.hpp index 4e6e790ed..8db737878 100755 --- a/QCodeEditor/include/internal/QCodeEditor.hpp +++ b/QCodeEditor/include/internal/QCodeEditor.hpp @@ -51,6 +51,11 @@ class QCodeEditor : public QTextEdit void searchPreviousResult(); void searchSetCaseSensitive(bool isCaseSensitive); + QString getCommentStr() const; + void setCommentStr(const QString &commentStr); + + void setIndentStrs(const QString &start, const QString &end); + signals: void saveTriggered(); void runEmbeddedTriggered(); @@ -210,5 +215,9 @@ public Q_SLOTS: bool m_autoParentheses; bool m_replaceTab; QString m_tabReplace; + QString m_commentStr; + QString m_indentStartStr; + QString m_indentEndStr; + }; diff --git a/QCodeEditor/include/internal/QLispCompleter.hpp b/QCodeEditor/include/internal/QLispCompleter.hpp new file mode 100644 index 000000000..327e615ce --- /dev/null +++ b/QCodeEditor/include/internal/QLispCompleter.hpp @@ -0,0 +1,18 @@ +#pragma once + +#include + +class QLispCompleter : public QCompleter +{ + Q_OBJECT + +public: + explicit QLispCompleter(QObject* parent=nullptr); + +protected: + QStringList splitPath(const QString &path) const override; + QString pathFromIndex(const QModelIndex &index) const override; + +}; + + diff --git a/QCodeEditor/qcodeeditor.pri b/QCodeEditor/qcodeeditor.pri index 1907f5ca2..1575c8ced 100644 --- a/QCodeEditor/qcodeeditor.pri +++ b/QCodeEditor/qcodeeditor.pri @@ -1,4 +1,5 @@ HEADERS += \ + $$PWD/include/internal/LispHighlighter.hpp \ $$PWD/include/internal/QCodeEditor.hpp \ $$PWD/include/internal/QCXXHighlighter.hpp \ $$PWD/include/internal/QFramedTextAttribute.hpp \ @@ -9,6 +10,7 @@ HEADERS += \ $$PWD/include/internal/QJSONHighlighter.hpp \ $$PWD/include/internal/QLanguage.hpp \ $$PWD/include/internal/QLineNumberArea.hpp \ + $$PWD/include/internal/QLispCompleter.hpp \ $$PWD/include/internal/QLuaCompleter.hpp \ $$PWD/include/internal/QLuaHighlighter.hpp \ $$PWD/include/internal/QPythonCompleter.hpp \ @@ -20,6 +22,7 @@ HEADERS += \ $$PWD/include/internal/QVescCompleter.hpp SOURCES += \ + $$PWD/src/internal/LispHighlighter.cpp \ $$PWD/src/internal/QCodeEditor.cpp \ $$PWD/src/internal/QCXXHighlighter.cpp \ $$PWD/src/internal/QFramedTextAttribute.cpp \ @@ -28,6 +31,7 @@ SOURCES += \ $$PWD/src/internal/QJSONHighlighter.cpp \ $$PWD/src/internal/QLanguage.cpp \ $$PWD/src/internal/QLineNumberArea.cpp \ + $$PWD/src/internal/QLispCompleter.cpp \ $$PWD/src/internal/QLuaCompleter.cpp \ $$PWD/src/internal/QLuaHighlighter.cpp \ $$PWD/src/internal/QPythonCompleter.cpp \ diff --git a/QCodeEditor/resources/languages/lisp.xml b/QCodeEditor/resources/languages/lisp.xml new file mode 100644 index 000000000..9219513e1 --- /dev/null +++ b/QCodeEditor/resources/languages/lisp.xml @@ -0,0 +1,23 @@ + + +

+ define + lambda + car + cons + cdr + let + progn + if + match + _ +
+
+ nil + list +
+
+ print + yield +
+ diff --git a/QCodeEditor/resources/qcodeeditor_resources.qrc b/QCodeEditor/resources/qcodeeditor_resources.qrc index be40d7353..68740c9a2 100644 --- a/QCodeEditor/resources/qcodeeditor_resources.qrc +++ b/QCodeEditor/resources/qcodeeditor_resources.qrc @@ -7,5 +7,6 @@ languages/python.xml languages/qml.xml default_style.xml + languages/lisp.xml diff --git a/QCodeEditor/src/internal/LispHighlighter.cpp b/QCodeEditor/src/internal/LispHighlighter.cpp new file mode 100644 index 000000000..e687986d8 --- /dev/null +++ b/QCodeEditor/src/internal/LispHighlighter.cpp @@ -0,0 +1,94 @@ +// QCodeEditor +#include +#include +#include + +// Qt +#include + + +LispHighlighter::LispHighlighter(QTextDocument* document) : + QStyleSyntaxHighlighter(document), + m_highlightRules(), + m_keyRegex(R"(("[^\r\n:]+?")\s*:)") +{ + Q_INIT_RESOURCE(qcodeeditor_resources); + QFile fl(":/languages/lisp.xml"); + + if (!fl.open(QIODevice::ReadOnly)) + { + return; + } + + QLanguage language(&fl); + + if (!language.isLoaded()) + { + return; + } + + auto keys = language.keys(); + for (auto&& key : keys) + { + auto names = language.names(key); + for (auto&& name : names) + { + m_highlightRules.append({ + QRegularExpression(QString(R"(\b%1\b)").arg(name)), + key + }); + } + } + + // Numbers + m_highlightRules.append({ + QRegularExpression(R"((?<=\b|\s|^)(?i)(?:(?:(?:(?:(?:\d+(?:'\d+)*)?\.(?:\d+(?:'\d+)*)(?:e[+-]?(?:\d+(?:'\d+)*))?)|(?:(?:\d+(?:'\d+)*)\.(?:e[+-]?(?:\d+(?:'\d+)*))?)|(?:(?:\d+(?:'\d+)*)(?:e[+-]?(?:\d+(?:'\d+)*)))|(?:0x(?:[0-9a-f]+(?:'[0-9a-f]+)*)?\.(?:[0-9a-f]+(?:'[0-9a-f]+)*)(?:p[+-]?(?:\d+(?:'\d+)*)))|(?:0x(?:[0-9a-f]+(?:'[0-9a-f]+)*)\.?(?:p[+-]?(?:\d+(?:'\d+)*))))[lf]?)|(?:(?:(?:[1-9]\d*(?:'\d+)*)|(?:0[0-7]*(?:'[0-7]+)*)|(?:0x[0-9a-f]+(?:'[0-9a-f]+)*)|(?:0b[01]+(?:'[01]+)*))(?:u?l{0,2}|l{0,2}u?)))(?=\b|\s|$))"), + "Number" + }); + + // Strings + m_highlightRules.append({ + QRegularExpression(R"("[^\n"]*")"), + "String" + }); + + // Single line + m_highlightRules.append({ + QRegularExpression(R"(;[^\n]*)"), + "Comment" + }); +} + + +void LispHighlighter::highlightBlock(const QString& text) +{ + for (auto&& rule : m_highlightRules) + { + auto matchIterator = rule.pattern.globalMatch(text); + + while (matchIterator.hasNext()) + { + auto match = matchIterator.next(); + + setFormat( + match.capturedStart(), + match.capturedLength(), + syntaxStyle()->getFormat(rule.formatName) + ); + } + } + + // Special treatment for key regex + auto matchIterator = m_keyRegex.globalMatch(text); + + while (matchIterator.hasNext()) + { + auto match = matchIterator.next(); + + setFormat( + match.capturedStart(1), + match.capturedLength(1), + syntaxStyle()->getFormat("Keyword") + ); + } +} diff --git a/QCodeEditor/src/internal/QCodeEditor.cpp b/QCodeEditor/src/internal/QCodeEditor.cpp index f82f7cd35..d2c756a4a 100755 --- a/QCodeEditor/src/internal/QCodeEditor.cpp +++ b/QCodeEditor/src/internal/QCodeEditor.cpp @@ -39,7 +39,10 @@ QCodeEditor::QCodeEditor(QWidget* widget) : m_autoIndentation(true), m_autoParentheses(true), m_replaceTab(true), - m_tabReplace(QString(4, ' ')) + m_tabReplace(QString(4, ' ')), + m_commentStr("//"), + m_indentStartStr("{"), + m_indentEndStr("}") { initFont(); @@ -515,10 +518,10 @@ void QCodeEditor::keyPressEvent(QKeyEvent* e) { auto line2 = line; line2.replace(" ", ""); line2.replace("\t", ""); - if (line2.startsWith("//")) { - line.replace(line.indexOf("/"), 2, ""); + if (line2.startsWith(m_commentStr)) { + line.replace(line.indexOf(m_commentStr.at(0)), m_commentStr.size(), ""); } else { - line.prepend("//"); + line.prepend(m_commentStr); } tc.insertText(line); @@ -573,7 +576,7 @@ void QCodeEditor::keyPressEvent(QKeyEvent* e) { } // Auto-indent selected line or block - if (e->key() == Qt::Key_I && e->modifiers() == Qt::ControlModifier) { + if (!m_indentStartStr.isEmpty() && e->key() == Qt::Key_I && e->modifiers() == Qt::ControlModifier) { auto txtOld = toPlainText(); int indentNow = 0; bool isComment = false; @@ -615,7 +618,7 @@ void QCodeEditor::keyPressEvent(QKeyEvent* e) { } for (auto c: line) { - if (c == '}') { + if (c == m_indentEndStr) { indentNow--; } @@ -647,7 +650,7 @@ void QCodeEditor::keyPressEvent(QKeyEvent* e) { } for (auto c: line) { - if (c == '{') { + if (c == m_indentStartStr) { indentNow++; } } @@ -1015,3 +1018,19 @@ QString QCodeEditor::getCompletionWordNow(int *linePosStart, int *linePosEnd) return res; } + +void QCodeEditor::setIndentStrs(const QString &start, const QString &end) +{ + m_indentStartStr = start; + m_indentEndStr = end; +} + +QString QCodeEditor::getCommentStr() const +{ + return m_commentStr; +} + +void QCodeEditor::setCommentStr(const QString &commentStr) +{ + m_commentStr = commentStr; +} diff --git a/QCodeEditor/src/internal/QLispCompleter.cpp b/QCodeEditor/src/internal/QLispCompleter.cpp new file mode 100644 index 000000000..9c1fa4cd6 --- /dev/null +++ b/QCodeEditor/src/internal/QLispCompleter.cpp @@ -0,0 +1,101 @@ +/* + Copyright 2021 Benjamin Vedder benjamin@vedder.se + + This file is part of VESC Tool. + + VESC Tool is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + VESC Tool is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . + */ + +#include +#include +#include +#include +#include + +QLispCompleter::QLispCompleter(QObject *parent) : + QCompleter(parent) +{ + QStandardItemModel *model = new QStandardItemModel(this); + QVector parents(10); + parents[0] = model->invisibleRootItem(); + int level = 0; + QStringList level0Names; + + auto addItem = [&](QString text) { + if (level == 0) { + if (level0Names.contains(text)) { + return; + } + + level0Names.append(text); + } + + QStandardItem *item = new QStandardItem; + item->setText(text); + parents[level]->appendRow(item); + parents[level + 1] = item; + + if (parents.size() <= (level + 1)) { + parents.resize(parents.size() * 2); + } + }; + + addItem("set"); + { + level++; + addItem("duty(dty)"); + addItem("current(i)"); + level--; + } + + Q_INIT_RESOURCE(qcodeeditor_resources); + QFile fl(":/languages/lisp.xml"); + + if (fl.open(QIODevice::ReadOnly)) { + QLanguage language(&fl); + + if (language.isLoaded()) { + auto keys = language.keys(); + for (auto&& key : keys) { + for (auto name: language.names(key)) { + addItem(name); + } + } + } + + fl.close(); + } + + setCompletionMode(QCompleter::PopupCompletion); + + setModel(model); + setModelSorting(QCompleter::UnsortedModel); + setCaseSensitivity(Qt::CaseInsensitive); + setWrapAround(true); +} + +QStringList QLispCompleter::splitPath(const QString &path) const +{ + return path.split("-"); +} + +QString QLispCompleter::pathFromIndex(const QModelIndex &index) const +{ + QStringList dataList; + for (QModelIndex i = index; i.isValid(); i = i.parent()) { + dataList.prepend(model()->data(i, completionRole()).toString()); + } + + return dataList.join("-"); +} diff --git a/commands.cpp b/commands.cpp index d2e734c91..11cd154fa 100755 --- a/commands.cpp +++ b/commands.cpp @@ -952,6 +952,44 @@ void Commands::processPacket(QByteArray data) emit statsRx(values, mask); } break; + case COMM_LISP_READ_CODE: { + int qmlSize = vb.vbPopFrontInt32(); + int offset = vb.vbPopFrontInt32(); + emit lispReadCodeRx(qmlSize, offset, vb); + } break; + + case COMM_LISP_ERASE_CODE: + emit lispEraseCodeRx(vb.at(0)); + break; + + case COMM_LISP_WRITE_CODE: { + bool ok = vb.vbPopFrontInt8(); + quint32 offset = vb.vbPopFrontUint32(); + emit lispWriteCodeRx(ok, offset); + } break; + + case COMM_LISP_PRINT: + emit lispPrintReceived(QString::fromLatin1(vb)); + break; + + case COMM_LISP_GET_STATS: { + LISP_STATS stats; + stats.cpu_use = vb.vbPopFrontDouble16(1e2); + stats.heap_use = vb.vbPopFrontDouble16(1e2); + stats.mem_use = vb.vbPopFrontDouble16(1e2); + stats.stack_use = vb.vbPopFrontDouble16(1e2); + while (vb.size() > 0) { + auto name = vb.vbPopFrontString(); + auto num = vb.vbPopFrontDouble32Auto(); + stats.number_bindings.append(qMakePair(name, num)); + } + emit lispStatsRx(stats); + } break; + + case COMM_LISP_SET_RUNNING: + emit lispRunningResRx(vb.at(0)); + break; + default: break; } @@ -1963,6 +2001,46 @@ void Commands::resetStats(bool sendAck) emitData(vb); } +void Commands::lispReadCode(int len, int offset) +{ + VByteArray vb; + vb.vbAppendUint8(COMM_LISP_READ_CODE); + vb.vbAppendInt32(len); + vb.vbAppendInt32(offset); + emitData(vb); +} + +void Commands::lispWriteCode(QByteArray data, quint32 offset) +{ + VByteArray vb; + vb.vbAppendUint8(COMM_LISP_WRITE_CODE); + vb.vbAppendUint32(offset); + vb.append(data); + emitData(vb); +} + +void Commands::lispEraseCode() +{ + VByteArray vb; + vb.vbAppendUint8(COMM_LISP_ERASE_CODE); + emitData(vb); +} + +void Commands::lispSetRunning(bool running) +{ + VByteArray vb; + vb.vbAppendUint8(COMM_LISP_SET_RUNNING); + vb.vbAppendInt8(running); + emitData(vb); +} + +void Commands::lispGetStats() +{ + VByteArray vb; + vb.vbAppendUint8(COMM_LISP_GET_STATS); + emitData(vb); +} + void Commands::timerSlot() { if (mTimeoutFwVer > 0) mTimeoutFwVer--; diff --git a/commands.h b/commands.h index d40af1b2e..54725222e 100644 --- a/commands.h +++ b/commands.h @@ -131,6 +131,12 @@ class Commands : public QObject void writeQmluiResReceived(bool ok, quint32 offset); void ioBoardValRx(IO_BOARD_VALUES val); void statsRx(STAT_VALUES val, unsigned int mask); + void lispReadCodeRx(int lenQml, int ofsQml, QByteArray data); + void lispEraseCodeRx(bool ok); + void lispWriteCodeRx(bool ok, quint32 offset); + void lispPrintReceived(QString str); + void lispStatsRx(LISP_STATS stats); + void lispRunningResRx(bool ok); public slots: void processPacket(QByteArray data); @@ -235,6 +241,12 @@ public slots: void getStats(unsigned int mask); void resetStats(bool sendAck); + void lispReadCode(int len, int offset); + void lispWriteCode(QByteArray data, quint32 offset); + void lispEraseCode(); + void lispSetRunning(bool running); + void lispGetStats(); + private slots: void timerSlot(); diff --git a/datatypes.h b/datatypes.h index 59554a8fb..ddfb925ea 100644 --- a/datatypes.h +++ b/datatypes.h @@ -937,6 +937,14 @@ typedef enum { COMM_GET_EXT_HUM_TMP, COMM_GET_STATS, COMM_RESET_STATS, + + // Lisp + COMM_LISP_READ_CODE, + COMM_LISP_WRITE_CODE, + COMM_LISP_ERASE_CODE, + COMM_LISP_SET_RUNNING, + COMM_LISP_GET_STATS, + COMM_LISP_PRINT } COMM_PACKET_ID; // CAN commands @@ -1076,4 +1084,29 @@ struct BALANCE_VALUES { Q_DECLARE_METATYPE(BALANCE_VALUES) +struct LISP_STATS { + Q_GADGET + +public: + Q_PROPERTY(double cpu_use MEMBER cpu_use) + Q_PROPERTY(double heap_use MEMBER heap_use) + Q_PROPERTY(double mem_use MEMBER mem_use) + Q_PROPERTY(double stack_use MEMBER stack_use) + + LISP_STATS() { + cpu_use = 0.0; + heap_use = 0.0; + mem_use = 0.0; + stack_use = 0.0; + } + + double cpu_use; + double heap_use; + double mem_use; + double stack_use; + QVector> number_bindings; +}; + +Q_DECLARE_METATYPE(LISP_STATS) + #endif // DATATYPES_H diff --git a/mainwindow.cpp b/mainwindow.cpp index df4ef2b50..ee3678acd 100755 --- a/mainwindow.cpp +++ b/mainwindow.cpp @@ -422,6 +422,7 @@ MainWindow::MainWindow(QWidget *parent) : mPageFirmware->reloadParams(); mPageCanAnalyzer->reloadParams(); mPageScripting->reloadParams(); + mPageLisp->reloadParams(); updateMotortype(); updateAppToUse(); @@ -1506,7 +1507,12 @@ void MainWindow::reloadPages() mPageScripting = new PageScripting(this); mPageScripting->setVesc(mVesc); ui->pageWidget->addWidget(mPageScripting); - mPageVESCDev->addTab(mPageScripting, QIcon(theme + "icons_textedit/Outdent-96.png"), tr("Scripting")); + mPageVESCDev->addTab(mPageScripting, QIcon(theme + "icons_textedit/Outdent-96.png"), tr("QML")); + + mPageLisp = new PageLisp(this); + mPageLisp->setVesc(mVesc); + ui->pageWidget->addWidget(mPageLisp); + mPageVESCDev->addTab(mPageLisp, QIcon(theme + "icons_textedit/Outdent-96.png"), tr("Lisp")); mPageCanAnalyzer = new PageCanAnalyzer(this); mPageCanAnalyzer->setVesc(mVesc); diff --git a/mainwindow.h b/mainwindow.h index aa37b256f..1106afe6e 100644 --- a/mainwindow.h +++ b/mainwindow.h @@ -67,6 +67,7 @@ #include "pages/pagecustomconfig.h" #include "pages/pagescripting.h" #include "pages/pagemotorcomparison.h" +#include "pages/pagelisp.h" namespace Ui { class MainWindow; @@ -209,6 +210,7 @@ private slots: PageCustomConfig *mPageCustomConfig1; PageCustomConfig *mPageCustomConfig2; PageScripting *mPageScripting; + PageLisp *mPageLisp; QTabWidget *mPageVESCDev; Preferences *mPreferences; diff --git a/pages/pagelisp.cpp b/pages/pagelisp.cpp new file mode 100644 index 000000000..9cf933949 --- /dev/null +++ b/pages/pagelisp.cpp @@ -0,0 +1,665 @@ +/* + Copyright 2022 Benjamin Vedder benjamin@vedder.se + + This file is part of VESC Tool. + + VESC Tool is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + VESC Tool is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . + */ + +#include "pagelisp.h" +#include "ui_pagelisp.h" +#include "utility.h" + +PageLisp::PageLisp(QWidget *parent) : + QWidget(parent), + ui(new Ui::PageLisp) +{ + ui->setupUi(this); + mVesc = nullptr; + + Utility::setPlotColors(ui->bindingPlot); + + ui->mainEdit->setModeLisp(); + ui->mainEdit->codeEditor()->setCommentStr(";"); + ui->mainEdit->codeEditor()->setIndentStrs("", ""); + + makeEditorConnections(ui->mainEdit); + + QPushButton *plusButton = new QPushButton(); + QString theme = Utility::getThemePath(); + plusButton->setIcon(QIcon(theme +"icons/Plus Math-96.png")); + ui->runButton->setIcon(QIcon(theme +"icons/Circled Play-96.png")); + ui->stopButton->setIcon(QIcon(theme +"icons/Shutdown-96.png")); + ui->helpButton->setIcon(QIcon(theme +"icons/Help-96.png")); + ui->clearConsoleButton->setIcon(QIcon(theme +"icons/Delete-96.png")); + ui->openRecentButton->setIcon(QIcon(theme +"icons/Open Folder-96.png")); + ui->removeSelectedButton->setIcon(QIcon(theme +"icons/Delete-96.png")); + ui->clearRecentButton->setIcon(QIcon(theme +"icons/Delete-96.png")); + ui->openExampleButton->setIcon(QIcon(theme +"icons/Open Folder-96.png")); + ui->uploadButton->setIcon(QIcon(theme +"icons/Download-96.png")); + ui->readExistingButton->setIcon(QIcon(theme +"icons/Upload-96.png")); + ui->eraseButton->setIcon(QIcon(theme +"icons/Delete-96.png")); + + plusButton->setFlat(true); + plusButton->setText("New Tab"); + ui->fileTabs->setCornerWidget(plusButton); + connect(plusButton, &QPushButton::clicked, [this]() { + createEditorTab("", ""); + }); + + connect(ui->mainEdit, &ScriptEditor::fileNameChanged, [this](QString fileName) { + QFileInfo f(fileName); + QString txt = "main"; + + if (f.exists()) { + txt = f.fileName() + " (main)"; + mDirNow = f.path(); + } else { + mDirNow = ""; + } + + ui->fileTabs->setTabText(0, txt); + }); + + QSettings set; + { + int size = set.beginReadArray("pagelisp/recentfiles"); + for (int i = 0; i < size; ++i) { + set.setArrayIndex(i); + QString path = set.value("path").toString(); + QFileInfo f(path); + if (f.exists()) { + mRecentFiles.append(path); + } + } + set.endArray(); + } + { + int size = set.beginReadArray("pagelisp/recentopenfiles"); + for (int i = 0; i < size; ++i) { + set.setArrayIndex(i); + QString path = set.value("path").toString(); + QFileInfo f(path); + if (f.exists()) { + QFile file(path); + if (file.open(QIODevice::ReadOnly)) { + if (ui->mainEdit->codeEditor()->toPlainText().isEmpty()) { + ui->mainEdit->codeEditor()->setPlainText(file.readAll()); + ui->mainEdit->setFileNow(path); + } else { + createEditorTab(path, file.readAll()); + } + } + } + } + set.endArray(); + ui->fileTabs->setCurrentIndex(0); + } + + updateRecentList(); + + // Load examples + for (auto fi: QDir("://res/Lisp/Examples/").entryInfoList(QDir::NoFilter, QDir::Name)) { + QListWidgetItem *item = new QListWidgetItem; + item->setText(fi.fileName()); + item->setData(Qt::UserRole, fi.filePath()); + ui->exampleList->addItem(item); + } + + // Add close button that clears the main editor + QPushButton *closeButton = new QPushButton(); + closeButton->setIcon(QIcon(theme +"icons/Delete-96.png")); + closeButton->setFlat(true); + ui->fileTabs->tabBar()->setTabButton(0, QTabBar::RightSide, closeButton); + + ScriptEditor *mainEditor = qobject_cast(ui->fileTabs->widget(0)); + connect(closeButton, &QPushButton::clicked, [this, mainEditor]() { + // Clear main tab + removeEditor(mainEditor); + }); + + ui->splitter->setSizes(QList({1000, 600})); + ui->splitter_2->setSizes(QList({1000, 600})); + + mPollTimer.start(100); + connect(&mPollTimer, &QTimer::timeout, [this]() { + if (ui->pollBox->isChecked()) { + if (mVesc) { + mVesc->commands()->lispGetStats(); + } + } + }); +} + +PageLisp::~PageLisp() +{ + QSettings set; + { + set.remove("pagelisp/recentfiles"); + set.beginWriteArray("pagelisp/recentfiles"); + int ind = 0; + for (auto f: mRecentFiles) { + set.setArrayIndex(ind); + set.setValue("path", f); + ind++; + } + set.endArray(); + } + { + set.remove("pagelisp/recentopenfiles"); + set.beginWriteArray("pagelisp/recentopenfiles"); + for (int i = 0;i < ui->fileTabs->count();i++) { + auto e = qobject_cast(ui->fileTabs->widget(i)); + set.setArrayIndex(i); + set.setValue("path", e->fileNow()); + } + set.endArray(); + } + + delete ui; +} + +VescInterface *PageLisp::vesc() const +{ + return mVesc; +} + +void PageLisp::setVesc(VescInterface *vesc) +{ + mVesc = vesc; + + connect(mVesc->commands(), &Commands::lispPrintReceived, [this](QString str) { + ui->debugEdit->moveCursor(QTextCursor::End); + ui->debugEdit->insertPlainText(str + "\n"); + ui->debugEdit->moveCursor(QTextCursor::End); + }); + + connect(mVesc->commands(), &Commands::lispRunningResRx, [this](bool ok) { + if (!ok) { + mVesc->emitMessageDialog(tr("Start/Stop Lisp"), + tr("Start/Stop Lisp failed. Did you forget to upload the code?"), false); + } + }); + + connect(mVesc->commands(), &Commands::lispStatsRx, [this](LISP_STATS stats) { + ui->cpuBar->setValue(stats.cpu_use); + ui->heapBar->setValue(stats.heap_use); + ui->memBar->setValue(stats.mem_use); + ui->stackBar->setValue(stats.stack_use); + + ui->bindingTable->setColumnCount(2); + ui->bindingTable->setRowCount(stats.number_bindings.size()); + int ind = 0; + for (auto b: stats.number_bindings) { + ui->bindingTable->setItem(ind, 0, new QTableWidgetItem(b.first)); + ui->bindingTable->setItem(ind, 1, new QTableWidgetItem(QString::number(b.second, 'f'))); + ind++; + } + }); +} + +void PageLisp::reloadParams() +{ + +} + +void PageLisp::updateRecentList() +{ + ui->recentList->clear(); + for (auto f: mRecentFiles) { + ui->recentList->addItem(f); + } +} + +void PageLisp::makeEditorConnections(ScriptEditor *editor) +{ + connect(editor->codeEditor(), &QCodeEditor::textChanged, [editor, this]() { + setEditorDirty(editor); + }); + connect(editor->codeEditor(), &QCodeEditor::clearConsoleTriggered, [this]() { + ui->debugEdit->clear(); + }); + connect(editor, &ScriptEditor::fileOpened, [this](QString fileName) { + if (!mRecentFiles.contains(fileName)) { + mRecentFiles.append(fileName); + updateRecentList(); + } + }); + connect(editor, &ScriptEditor::fileSaved, [editor, this](QString fileName) { + if (mVesc) { + mVesc->emitStatusMessage("Saved " + fileName, true); + } + + if (!mRecentFiles.contains(fileName)) { + mRecentFiles.append(fileName); + updateRecentList(); + } + + setEditorClean(editor); + }); +} + +void PageLisp::createEditorTab(QString fileName, QString content) +{ + ScriptEditor *editor = new ScriptEditor(); + editor->setModeLisp(); + editor->codeEditor()->setCommentStr(";"); + editor->codeEditor()->setIndentStrs("", ""); + int tabIndex = ui->fileTabs->addTab(editor, ""); + ui->fileTabs->setCurrentIndex(tabIndex); + + makeEditorConnections(editor); + + connect(editor, &ScriptEditor::fileNameChanged, [this, editor](QString fileName) { + QFileInfo f(fileName); + QString txt = "Unnamed"; + + if (f.exists()) { + txt = f.fileName(); + } else if (!fileName.isEmpty()) { + txt = fileName; + } + + ui->fileTabs->setTabText(ui->fileTabs->indexOf(editor), txt); + }); + + editor->setFileNow(fileName); + editor->codeEditor()->setPlainText(content); + QString theme = Utility::getThemePath(); + + QPushButton *closeButton = new QPushButton(); + closeButton->setIcon(QIcon(theme +"icons/Cancel-96.png")); + closeButton->setFlat(true); + ui->fileTabs->tabBar()->setTabButton(tabIndex, QTabBar::RightSide, closeButton); + + connect(closeButton, &QPushButton::clicked, [this, editor]() { + removeEditor(editor); + }); + + // Do this at the end to make sure to account for the changes from loading the initial text + setEditorClean(editor); +} + +void PageLisp::removeEditor(ScriptEditor *editor) +{ + bool shouldCloseTab = false; + + // Check if tab is dirty + if (editor->isDirty == true) { + // Ask user for confirmation + QMessageBox::StandardButton answer = QMessageBox::question( + this, + tr("Delete the tab"), + tr("Do you want to delete the tab contents?"), + QMessageBox::Yes | QMessageBox::No + ); + + if (answer == QMessageBox::Yes) { + shouldCloseTab = true; + } else { + shouldCloseTab = false; + } + + } else { + shouldCloseTab = true; + } + + // Only close if appropriate + if (shouldCloseTab) { + // Get index for this tab + int tabIdx = ui->fileTabs->indexOf(editor); + + // Special handling of tabIdx == 0 + if (tabIdx == 0) { + editor->codeEditor()->clear(); + editor->setFileNow(""); + } else { + ui->fileTabs->removeTab(tabIdx); + } + } +} + +void PageLisp::setEditorDirty(ScriptEditor *editor) +{ + // Check if the editor is not already dirty + if (editor->isDirty == false) { + // Set editor as dirty + editor->isDirty = true; + + // Get editor index + int tabIdx = ui->fileTabs->indexOf(editor); + + // Append a `*` to signify a dirty editor + QString tabText = ui->fileTabs->tabText(tabIdx); + ui->fileTabs->setTabText(tabIdx, tabText + "*"); + } +} + +void PageLisp::setEditorClean(ScriptEditor *editor) +{ + // Check if the editor is not already clean + if (editor->isDirty == true) { + // Set editor as clean + editor->isDirty = false; + + // Get editor index + int tabIdx = ui->fileTabs->indexOf(editor); + + // Get the tab's label + QString tabText = ui->fileTabs->tabText(tabIdx); + + // Check if the final character is a `*`, which indicated it was a dirty file + if (tabText.back() == "*") { + // Remove the terminal `*` + tabText.chop(1); + ui->fileTabs->setTabText(tabIdx, tabText); + } + } +} + +void PageLisp::openExample() +{ + QListWidgetItem *item = ui->exampleList->currentItem(); + + if (item) { + QFile file(item->data(Qt::UserRole).toString()); + + if (!file.open(QIODevice::ReadOnly)) { + QMessageBox::critical(this, "Open Lisp File", + "Could not open example for reading"); + return; + } + + if (ui->mainEdit->codeEditor()->toPlainText().isEmpty()) { + ui->mainEdit->codeEditor()->setPlainText(file.readAll()); + ui->mainEdit->setFileNow(""); + + setEditorClean(ui->mainEdit); + } else { + createEditorTab("", file.readAll()); + } + + file.close(); + } else { + QMessageBox::critical(this, "Open Example", + "Please select one example."); + } +} + +void PageLisp::openRecentList() +{ + auto *item = ui->recentList->currentItem(); + + if (item) { + QString fileName = item->text(); + QFile file(fileName); + + if (!file.open(QIODevice::ReadOnly)) { + QMessageBox::critical(this, "Open Lisp File", + "Could not open\n " + fileName + " for reading"); + return; + } + + if (ui->mainEdit->codeEditor()->toPlainText().isEmpty()) { + ui->mainEdit->codeEditor()->setPlainText(file.readAll()); + ui->mainEdit->setFileNow(fileName); + } else { + createEditorTab(fileName, file.readAll()); + } + + file.close(); + } else { + QMessageBox::critical(this, "Open Recent", + "Please select a file."); + } +} + +bool PageLisp::eraseCode() +{ + if (!mVesc) { + return false; + } + + if (!mVesc->isPortConnected()) { + mVesc->emitMessageDialog(tr("Erase old code"), tr("Not Connected"), false); + return false; + } + + QProgressDialog dialog("Erasing old script...", QString(), 0, 0, this); + dialog.setWindowModality(Qt::WindowModal); + dialog.show(); + + auto waitEraseRes = [this]() { + int res = -10; + + QEventLoop loop; + QTimer timeoutTimer; + timeoutTimer.setSingleShot(true); + timeoutTimer.start(6000); + auto conn = connect(mVesc->commands(), &Commands::lispEraseCodeRx, + [&res,&loop](bool erRes) { + res = erRes ? 1 : -1; + loop.quit(); + }); + + connect(&timeoutTimer, SIGNAL(timeout()), &loop, SLOT(quit())); + loop.exec(); + + disconnect(conn); + return res; + }; + + mVesc->commands()->lispEraseCode(); + + int erRes = waitEraseRes(); + if (erRes != 1) { + QString msg = tr("Unknown failure"); + + if (erRes == -10) { + msg = tr("Erase timed out"); + } else if (erRes == -1) { + msg = tr("Erasing Lisp Code failed"); + } + + dialog.close(); + mVesc->emitMessageDialog(tr("Erase Lisp"), msg, false); + return false; + } + + return true; +} + +void PageLisp::on_openRecentButton_clicked() +{ + openRecentList(); +} + +void PageLisp::on_removeSelectedButton_clicked() +{ + auto *item = ui->recentList->currentItem(); + + if (item) { + QString fileName = item->text(); + mRecentFiles.removeOne(fileName); + updateRecentList(); + } +} + +void PageLisp::on_clearRecentButton_clicked() +{ + auto res = QMessageBox::question(this, "Clear Recent Files", + "This will clear the list with recent files. Are you sure?"); + + if (res == QMessageBox::Yes) { + mRecentFiles.clear(); + updateRecentList(); + } +} + +void PageLisp::on_recentList_doubleClicked() +{ + openRecentList(); +} + +void PageLisp::on_openExampleButton_clicked() +{ + openExample(); +} + +void PageLisp::on_exampleList_doubleClicked() +{ + openExample(); +} + +void PageLisp::on_runButton_clicked() +{ + mVesc->commands()->lispSetRunning(1); +} + +void PageLisp::on_stopButton_clicked() +{ + mVesc->commands()->lispSetRunning(0); +} + +void PageLisp::on_uploadButton_clicked() +{ + if (!eraseCode()) { + return; + } + + auto waitWriteRes = [this]() { + int res = -10; + + QEventLoop loop; + QTimer timeoutTimer; + timeoutTimer.setSingleShot(true); + timeoutTimer.start(1000); + auto conn = connect(mVesc->commands(), &Commands::lispWriteCodeRx, + [&res,&loop](bool erRes, quint32 offset) { + (void)offset; + res = erRes ? 1 : -1; + loop.quit(); + }); + + connect(&timeoutTimer, SIGNAL(timeout()), &loop, SLOT(quit())); + loop.exec(); + + disconnect(conn); + return res; + }; + + QProgressDialog dialog(tr("Uploading..."), QString(), 0, 0, this); + dialog.setWindowModality(Qt::WindowModal); + dialog.show(); + + VByteArray vb; + vb.vbAppendUint16(0); + vb.append(ui->mainEdit->codeEditor()->toPlainText()); + + if (vb.at(vb.size() - 1) != '\0') { + vb.append('\0'); + } + + quint16 crc = Packet::crc16((const unsigned char*)vb.constData(), uint32_t(vb.size())); + VByteArray data; + data.vbAppendUint32(vb.size() - 2); + data.vbAppendUint16(crc); + data.append(vb); + + if (data.size() > (1024 * 120)) { + ui->uploadButton->setEnabled(true); + mVesc->emitMessageDialog(tr("Upload Code"), tr("Not enough space"), false); + return; + } + + quint32 offset = 0; + bool ok = true; + while (data.size() > 0) { + const int chunkSize = 384; + int sz = data.size() > chunkSize ? chunkSize : data.size(); + + mVesc->commands()->lispWriteCode(data.mid(0, sz), offset); + if (!waitWriteRes()) { + mVesc->emitMessageDialog(tr("Upload Code"), tr("Write failed"), false); + ok = false; + break; + } + + offset += sz; + data.remove(0, sz); + } +} + +void PageLisp::on_readExistingButton_clicked() +{ + QByteArray lispData; + int lenLispLast = 0; + auto conn = connect(mVesc->commands(), &Commands::lispReadCodeRx, + [&](int lenLisp, int ofsLisp, QByteArray data) { + if (lispData.size() <= ofsLisp) { + lispData.append(data); + } + lenLispLast = lenLisp; + }); + + auto getLispChunk = [&](int size, int offset, int tries, int timeout) { + bool res = false; + + for (int j = 0;j < tries;j++) { + mVesc->commands()->lispReadCode(size, offset); + res = Utility::waitSignal(mVesc->commands(), SIGNAL(lispReadCodeRx(int,int,QByteArray)), timeout); + if (res) { + break; + } + } + return res; + }; + + QProgressDialog dialog(tr("Reading Lisp..."), QString(), 0, 0, this); + dialog.setWindowModality(Qt::WindowModal); + dialog.show(); + + if (getLispChunk(10, 0, 5, 1500)) { + while (lispData.size() < lenLispLast) { + int dataLeft = lenLispLast - lispData.size(); + if (!getLispChunk(dataLeft > 400 ? 400 : dataLeft, lispData.size(), 5, 1500)) { + break; + } + } + + if (lispData.size() == lenLispLast) { + if (ui->mainEdit->codeEditor()->toPlainText().isEmpty()) { + ui->mainEdit->codeEditor()->setPlainText(lispData); + ui->fileTabs->setTabText(ui->fileTabs->indexOf(ui->mainEdit), "From VESC"); + } else { + createEditorTab("From VESC", lispData); + } + } else { + mVesc->emitMessageDialog(tr("Get Lisp"), + tr("Could not read Lisp code"), + false); + } + } else { + mVesc->emitMessageDialog(tr("Get Lisp"), + tr("Could not read Lisp code"), + false); + } + + disconnect(conn); +} + +void PageLisp::on_eraseButton_clicked() +{ + eraseCode(); +} diff --git a/pages/pagelisp.h b/pages/pagelisp.h new file mode 100644 index 000000000..be12fa4a9 --- /dev/null +++ b/pages/pagelisp.h @@ -0,0 +1,75 @@ +/* + Copyright 2022 Benjamin Vedder benjamin@vedder.se + + This file is part of VESC Tool. + + VESC Tool is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + VESC Tool is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . + */ + +#ifndef PAGELISP_H +#define PAGELISP_H + +#include +#include "vescinterface.h" +#include "widgets/scripteditor.h" + +namespace Ui { +class PageLisp; +} + +class PageLisp : public QWidget +{ + Q_OBJECT + +public: + explicit PageLisp(QWidget *parent = nullptr); + ~PageLisp(); + + VescInterface *vesc() const; + void setVesc(VescInterface *vesc); + void reloadParams(); + +private slots: + void on_openRecentButton_clicked(); + void on_removeSelectedButton_clicked(); + void on_clearRecentButton_clicked(); + void on_recentList_doubleClicked(); + void on_openExampleButton_clicked(); + void on_exampleList_doubleClicked(); + void on_runButton_clicked(); + void on_stopButton_clicked(); + void on_uploadButton_clicked(); + void on_readExistingButton_clicked(); + void on_eraseButton_clicked(); + +private: + Ui::PageLisp *ui; + VescInterface *mVesc; + QStringList mRecentFiles; + QString mDirNow; + QTimer mPollTimer; + + void updateRecentList(); + void makeEditorConnections(ScriptEditor *editor); + void createEditorTab(QString fileName, QString content); + void removeEditor(ScriptEditor *editor); + void setEditorDirty(ScriptEditor * editor); + void setEditorClean(ScriptEditor * editor); + void openExample(); + void openRecentList(); + bool eraseCode(); + +}; + +#endif // PAGELISP_H diff --git a/pages/pagelisp.ui b/pages/pagelisp.ui new file mode 100644 index 000000000..73244af2b --- /dev/null +++ b/pages/pagelisp.ui @@ -0,0 +1,472 @@ + + + PageLisp + + + + 0 + 0 + 1569 + 907 + + + + Form + + + + + + Qt::Vertical + + + + Qt::Horizontal + + + + + 2 + + + + + 12 + + + + + Erase + + + + :/res/icons/Delete-96.png:/res/icons/Delete-96.png + + + true + + + + + + + Upload + + + + :/res/icons/Download-96.png:/res/icons/Download-96.png + + + true + + + + + + + Read lisp code from connected VESC + + + Read Existing + + + + :/res/icons/Upload-96.png:/res/icons/Upload-96.png + + + true + + + + + + + Run + + + + :/res/icons/Circled Play-96.png:/res/icons/Circled Play-96.png + + + true + + + + + + + Stop + + + + :/res/icons/Shutdown-96.png:/res/icons/Shutdown-96.png + + + true + + + + + + + Qt::Horizontal + + + + 40 + 20 + + + + + + + + Show help + + + Help + + + + :/res/icons/Help-96.png:/res/icons/Help-96.png + + + true + + + + + + + + + QTabWidget::Triangular + + + 0 + + + + main + + + + + + + + + + + + Poll Status + + + + + + + + + 0 + + + + + + + Stack + + + + + + + CPU + + + + + + + Heap + + + + + + + 0 + + + + + + + 0 + + + + + + + 0 + + + + + + + Mem + + + + + + + + + QAbstractItemView::NoEditTriggers + + + QAbstractItemView::SelectRows + + + true + + + + Binding + + + + + Value + + + + + + + + + + QTabWidget::West + + + QTabWidget::Triangular + + + 0 + + + + Console + + + + + + + DejaVu Sans Mono + + + + + + + + + + + + + + :/res/icons/Delete-96.png:/res/icons/Delete-96.png + + + + + + + Qt::Vertical + + + + 20 + 40 + + + + + + + + + + + Recent + + + + + + + + + 3 + + + + + Open selected recent file + + + Open + + + + :/res/icons/Open Folder-96.png:/res/icons/Open Folder-96.png + + + + + + + Remove selected recent file from list (file will not be deleted from file system) + + + Remove + + + + :/res/icons/Delete-96.png:/res/icons/Delete-96.png + + + + + + + Clear recent file list (nothing will be deleted from file system) + + + Clear + + + + :/res/icons/Delete-96.png:/res/icons/Delete-96.png + + + + + + + Qt::Vertical + + + + 20 + 40 + + + + + + + + + + + Examples + + + + + + + + + + + Open + + + + :/res/icons/Open Folder-96.png:/res/icons/Open Folder-96.png + + + + + + + Qt::Vertical + + + + 20 + 40 + + + + + + + + + + + Plot + + + + + + + + + + + + + + + VTextBrowser + QTextEdit +
widgets/vtextbrowser.h
+
+ + ScriptEditor + QWidget +
widgets/scripteditor.h
+ 1 +
+ + QCustomPlot + QWidget +
widgets/qcustomplot.h
+ 1 +
+
+ + + + + + clearConsoleButton + clicked() + debugEdit + clear() + + + 1524 + 374 + + + 1456 + 379 + + + + +
diff --git a/pages/pages.pri b/pages/pages.pri index 8f3aef042..2d5b5486f 100644 --- a/pages/pages.pri +++ b/pages/pages.pri @@ -5,6 +5,7 @@ FORMS += \ $$PWD/pagecananalyzer.ui \ $$PWD/pageconnection.ui \ $$PWD/pagecustomconfig.ui \ + $$PWD/pagelisp.ui \ $$PWD/pagemotor.ui \ $$PWD/pagedebugprint.ui \ $$PWD/pagebldc.ui \ @@ -43,6 +44,7 @@ HEADERS += \ $$PWD/pagecananalyzer.h \ $$PWD/pageconnection.h \ $$PWD/pagecustomconfig.h \ + $$PWD/pagelisp.h \ $$PWD/pagemotor.h \ $$PWD/pagedebugprint.h \ $$PWD/pagebldc.h \ @@ -81,6 +83,7 @@ SOURCES += \ $$PWD/pagecananalyzer.cpp \ $$PWD/pageconnection.cpp \ $$PWD/pagecustomconfig.cpp \ + $$PWD/pagelisp.cpp \ $$PWD/pagemotor.cpp \ $$PWD/pagedebugprint.cpp \ $$PWD/pagebldc.cpp \ diff --git a/pages/pagescripting.cpp b/pages/pagescripting.cpp index 302a973a2..b5ce43702 100755 --- a/pages/pagescripting.cpp +++ b/pages/pagescripting.cpp @@ -41,6 +41,7 @@ PageScripting::PageScripting(QWidget *parent) : ui->qmlWidget->setResizeMode(QQuickWidget::SizeRootObjectToView); ui->qmlWidget->setClearColor(Utility::getAppQColor("normalBackground")); + ui->mainEdit->setModeQml(); makeEditorConnections(ui->mainEdit); QPushButton *plusButton = new QPushButton(); @@ -72,7 +73,7 @@ PageScripting::PageScripting(QWidget *parent) : createEditorTab("", ""); }); - connect(ui->mainEdit, &QmlEditor::fileNameChanged, [this](QString fileName) { + connect(ui->mainEdit, &ScriptEditor::fileNameChanged, [this](QString fileName) { QFileInfo f(fileName); QString txt = "main"; @@ -137,7 +138,7 @@ PageScripting::PageScripting(QWidget *parent) : closeButton->setFlat(true); ui->fileTabs->tabBar()->setTabButton(0, QTabBar::RightSide, closeButton); - QmlEditor *mainQmlEditor = qobject_cast(ui->fileTabs->widget(0)); + ScriptEditor *mainQmlEditor = qobject_cast(ui->fileTabs->widget(0)); connect(closeButton, &QPushButton::clicked, [this, mainQmlEditor]() { // Clear main tab removeEditor(mainQmlEditor); @@ -164,7 +165,7 @@ PageScripting::~PageScripting() set.remove("pagescripting/recentopenfiles"); set.beginWriteArray("pagescripting/recentopenfiles"); for (int i = 0;i < ui->fileTabs->count();i++) { - auto e = qobject_cast(ui->fileTabs->widget(i)); + auto e = qobject_cast(ui->fileTabs->widget(i)); set.setArrayIndex(i); set.setValue("path", e->fileNow()); } @@ -357,7 +358,7 @@ void PageScripting::updateRecentList() } } -void PageScripting::makeEditorConnections(QmlEditor *editor) +void PageScripting::makeEditorConnections(ScriptEditor *editor) { connect(editor->codeEditor(), &QCodeEditor::textChanged, [editor, this]() { setEditorDirty(editor); @@ -374,13 +375,13 @@ void PageScripting::makeEditorConnections(QmlEditor *editor) connect(editor->codeEditor(), &QCodeEditor::clearConsoleTriggered, [this]() { ui->debugEdit->clear(); }); - connect(editor, &QmlEditor::fileOpened, [this](QString fileName) { + connect(editor, &ScriptEditor::fileOpened, [this](QString fileName) { if (!mRecentFiles.contains(fileName)) { mRecentFiles.append(fileName); updateRecentList(); } }); - connect(editor, &QmlEditor::fileSaved, [editor, this](QString fileName) { + connect(editor, &ScriptEditor::fileSaved, [editor, this](QString fileName) { if (mVesc) { mVesc->emitStatusMessage("Saved " + fileName, true); } @@ -396,13 +397,14 @@ void PageScripting::makeEditorConnections(QmlEditor *editor) void PageScripting::createEditorTab(QString fileName, QString content) { - QmlEditor *editor = new QmlEditor(); + ScriptEditor *editor = new ScriptEditor(); + editor->setModeQml(); int tabIndex = ui->fileTabs->addTab(editor, ""); ui->fileTabs->setCurrentIndex(tabIndex); makeEditorConnections(editor); - connect(editor, &QmlEditor::fileNameChanged, [this, editor](QString fileName) { + connect(editor, &ScriptEditor::fileNameChanged, [this, editor](QString fileName) { QFileInfo f(fileName); QString txt = "Unnamed"; @@ -437,12 +439,12 @@ void PageScripting::createEditorTab(QString fileName, QString content) * @brief PageScripting::removeEditor Removes the editor (unless it is the 0th, in which case it simply clears it) * @param qmlEditor */ -void PageScripting::removeEditor(QmlEditor *qmlEditor) +void PageScripting::removeEditor(ScriptEditor *editor) { bool shouldCloseTab = false; // Check if tab is dirty - if (qmlEditor->isDirty == true) { + if (editor->isDirty == true) { // Ask user for confirmation QMessageBox::StandardButton answer = QMessageBox::question( this, @@ -464,17 +466,16 @@ void PageScripting::removeEditor(QmlEditor *qmlEditor) // Only close if appropriate if (shouldCloseTab) { // Get index for this tab - int tabIdx = ui->fileTabs->indexOf(qmlEditor); + int tabIdx = ui->fileTabs->indexOf(editor); // Special handling of tabIdx == 0 if (tabIdx == 0) { - qmlEditor->codeEditor()->clear(); - qmlEditor->setFileNow(""); + editor->codeEditor()->clear(); + editor->setFileNow(""); } else { ui->fileTabs->removeTab(tabIdx); } } - } @@ -482,15 +483,15 @@ void PageScripting::removeEditor(QmlEditor *qmlEditor) * @brief PageScripting::setEditorDirtySet the editor as dirty, i.e. having text modifications * @param qmlEditor */ -void PageScripting::setEditorDirty(QmlEditor *qmlEditor) +void PageScripting::setEditorDirty(ScriptEditor *editor) { // Check if the editor is not already dirty - if (qmlEditor->isDirty == false) { + if (editor->isDirty == false) { // Set editor as dirty - qmlEditor->isDirty = true; + editor->isDirty = true; // Get editor index - int tabIdx = ui->fileTabs->indexOf(qmlEditor); + int tabIdx = ui->fileTabs->indexOf(editor); // Append a `*` to signify a dirty editor QString tabText = ui->fileTabs->tabText(tabIdx); @@ -503,15 +504,15 @@ void PageScripting::setEditorDirty(QmlEditor *qmlEditor) * @brief PageScripting::setEditorClean Set the editor as clean, i.e. having no text modifications * @param qmlEditor */ -void PageScripting::setEditorClean(QmlEditor *qmlEditor) +void PageScripting::setEditorClean(ScriptEditor *editor) { // Check if the editor is not already clean - if (qmlEditor->isDirty == true) { + if (editor->isDirty == true) { // Set editor as clean - qmlEditor->isDirty = false; + editor->isDirty = false; // Get editor index - int tabIdx = ui->fileTabs->indexOf(qmlEditor); + int tabIdx = ui->fileTabs->indexOf(editor); // Get the tab's label QString tabText = ui->fileTabs->tabText(tabIdx); @@ -547,7 +548,7 @@ bool PageScripting::exportCArray(QString name) QString filename; QString dir = "."; - auto editor = qobject_cast(ui->fileTabs->widget(0)); + auto editor = qobject_cast(ui->fileTabs->widget(0)); QFileInfo fileNow = QFileInfo(editor->fileNow()); if (fileNow.exists()) { dir = fileNow.path(); diff --git a/pages/pagescripting.h b/pages/pagescripting.h index eb60e49c2..9c72c9e00 100644 --- a/pages/pagescripting.h +++ b/pages/pagescripting.h @@ -25,7 +25,7 @@ #include "vescinterface.h" #include "mobile/qmlui.h" -#include "widgets/qmleditor.h" +#include "widgets/scripteditor.h" #include "utility.h" namespace Ui { @@ -79,11 +79,11 @@ private slots: Utility mUtil; void updateRecentList(); - void makeEditorConnections(QmlEditor *editor); + void makeEditorConnections(ScriptEditor *editor); void createEditorTab(QString fileName, QString content); - void removeEditor(QmlEditor *qmlEditor); - void setEditorDirty(QmlEditor * qmlEditor); - void setEditorClean(QmlEditor * qmlEditor); + void removeEditor(ScriptEditor *editor); + void setEditorDirty(ScriptEditor *editor); + void setEditorClean(ScriptEditor *editor); QString qmlToRun(bool importDir = true); bool exportCArray(QString name); bool eraseQml(); diff --git a/pages/pagescripting.ui b/pages/pagescripting.ui index 7829c5c28..c4ffebb5f 100644 --- a/pages/pagescripting.ui +++ b/pages/pagescripting.ui @@ -135,7 +135,7 @@ 0 - + main @@ -541,9 +541,9 @@
widgets/vtextbrowser.h
- QmlEditor + ScriptEditor QWidget -
widgets/qmleditor.h
+
widgets/scripteditor.h
1
diff --git a/res/CHANGELOG b/res/CHANGELOG index 8b15ca138..e7ef1782a 100644 --- a/res/CHANGELOG +++ b/res/CHANGELOG @@ -1,6 +1,12 @@ == 4.00 == * Added support for compressed firmware upload. * Reduce CPU usage by only plotting RT data when the plot is visible. +* Lisp scripting editor and integration. + - Autocompletion. + - Syntax highlighting. + - Real-time binding, CPU and memory monitors. + - Console for printing + - Examples == 3.01 == * Fixed simultaneous CAN FW upload when other devices (such as BMS) are on the CAN-bus. diff --git a/res/Lisp/Examples/aux.lisp b/res/Lisp/Examples/aux.lisp new file mode 100644 index 000000000..ec52e69dc --- /dev/null +++ b/res/Lisp/Examples/aux.lisp @@ -0,0 +1,17 @@ +(define set-auxtime (lambda (port state time) + (progn + (set-aux port state) + (define aux-now (list port state time)) + (yield (* 1000 time)) +))) + +(let ((f (lambda () + (progn + (set-auxtime 1 1 1500) + (set-auxtime 1 0 500) + (set-auxtime 2 1 1500) + (set-auxtime 2 0 500) + (yield 1000000) + (f) +)))) (f)) + diff --git a/res/Lisp/Examples/can_pos_follow.lisp b/res/Lisp/Examples/can_pos_follow.lisp new file mode 100644 index 000000000..4726c55bb --- /dev/null +++ b/res/Lisp/Examples/can_pos_follow.lisp @@ -0,0 +1,16 @@ +(define itcnt 0) + +(define f (lambda () + (progn + (define itcnt (+ itcnt 1)) + (canset-pos 124 (get-encoder)) + (define canc (canget-current-dir 124)) + (set-servo (- 0.5 (* 0.02 canc))) + (set-brake (* 0.5 canc)) + (timeout-reset) + (yield 2000) + (f) +))) + +(f) + diff --git a/res/Lisp/Examples/control_servo_from_duty.lisp b/res/Lisp/Examples/control_servo_from_duty.lisp new file mode 100644 index 000000000..0e1f83e26 --- /dev/null +++ b/res/Lisp/Examples/control_servo_from_duty.lisp @@ -0,0 +1,24 @@ +(define servo-out 0.5) + +(define abs (lambda (x) (if (> x 0) x (- x)))) + +(define update-servo (lambda () + (progn + (define servo-out (+ servo-out (* (get-duty) 0.2))) + (if (> servo-out 1.0) (define servo-out 1.0) nil) + (if (< servo-out 0) (define servo-out 0) nil) + (set-servo servo-out) +))) + +(define itcnt 0) + +(define f (lambda () + (progn + (define itcnt (+ itcnt 1)) + (if (> (abs (get-duty)) 0.005) (update-servo) nil) + (yield 10000) + (f) +))) + +(f) + diff --git a/res/Lisp/Examples/control_servo_from_encoder.lisp b/res/Lisp/Examples/control_servo_from_encoder.lisp new file mode 100644 index 000000000..232693510 --- /dev/null +++ b/res/Lisp/Examples/control_servo_from_encoder.lisp @@ -0,0 +1,10 @@ +(define f (lambda () + (progn + (define encval (get-encoder)) ; So that lisp_stats shows the value + (set-servo (/ (- 360.0 encval) 360.0)) + (yield 20000) + (f) +))) + +(f) + diff --git a/res/Lisp/Examples/duty.lisp b/res/Lisp/Examples/duty.lisp new file mode 100644 index 000000000..b0108ad20 --- /dev/null +++ b/res/Lisp/Examples/duty.lisp @@ -0,0 +1,22 @@ +;;; This program will ramp the duty cycle up and down according +;;; to the parameters below. + +(define rate 50) ; Update rate in hz +(define ramptime 3.0) ; Motor ramp time + +(define rampstep (/ 1.0 (* rate ramptime))) +(define upcnt rampstep) + +(let ((f (lambda (x) + (progn + (set-duty x) + (timeout-reset) + + (yield (/ 1000000 rate)) + + (if (> x 1.0) (define upcnt (- rampstep) nil)) + (if (< x -1.0) (define upcnt rampstep) nil) + + (f (+ x upcnt)) +)))) (f 0)) + diff --git a/res/Lisp/Examples/ppm_read.lisp b/res/Lisp/Examples/ppm_read.lisp new file mode 100644 index 000000000..6256441c9 --- /dev/null +++ b/res/Lisp/Examples/ppm_read.lisp @@ -0,0 +1,9 @@ +(let ((f (lambda () + (progn + (define ppm (get-ppm)) ; So that lisp_stats shows the value + (set-duty ppm) + (timeout-reset) + (yield 20000) + (f))))) +(f)) + diff --git a/res/Lisp/Examples/print_bms_data.lisp b/res/Lisp/Examples/print_bms_data.lisp new file mode 100644 index 000000000..7e9a5c90f --- /dev/null +++ b/res/Lisp/Examples/print_bms_data.lisp @@ -0,0 +1,35 @@ +(define rate 2) ; Update rate in hz + +(define map (lambda (f xs) + (if (= xs nil) + nil + (cons (f (car xs)) (map f (cdr xs)))))) + +(define iota (lambda (n) + (let ((iacc (lambda (acc i) + (if (< i 0) + acc + (iacc (cons i acc) (- i 1)))))) + (iacc nil n)))) + +(define range (lambda (start end) + (map (lambda (x) (+ x start)) (iota (- end start)) +))) + +(define foldl (lambda (f i xs) + (if (= xs nil) + i + (foldl f (f i (car xs)) (cdr xs))))) + +(let ((f (lambda () + (progn + (define v-cells (map (lambda (c)(get-bms-val "v_cell" c)) (range 0 (- (get-bms-val "cell_num") 1)))) + (print (list "V Tot : " (get-bms-val "v_tot"))) + (print (list "V Cells: " v-cells)) + (print (list "foldl : " (foldl + 0 v-cells))) + (print (list "ADCs : " (map (lambda (c)(get-adc c)) (iota 1)))) + (print " ") + (yield (/ 1000000.0 rate)) + (f) +)))) (f)) + diff --git a/res/Lisp/Examples/speed_test.lisp b/res/Lisp/Examples/speed_test.lisp new file mode 100644 index 000000000..ad68a77b4 --- /dev/null +++ b/res/Lisp/Examples/speed_test.lisp @@ -0,0 +1,53 @@ +; Note: dec-cnt2 in C using a recursive function that takes +; a volatile int as argument takes 0.2 seconds to finish. +; That is about 500x faster, which seems to be consistent +; with a few other tests. + +; 12 seconds +(define dec-cnt (lambda (x) + (if (= x 0) 0 (dec-cnt (- x 1))) +)) + +; 10 seconds +(define dec-cnt2 (lambda (x) + (match x (0 0) (_ (dec-cnt2 (- x 1)))) +)) + +; 4 seconds +(define dec-cnt3 (lambda (x) + (if (> x 0) (dec-cnt3 (- (- (- (- (- (- (- x 1) 1) 1) 1) 1) 1) 1)) 0) +)) + +(define tak (lambda (x y z) + (if (not (< y x)) + z + (tak + (tak (- x 1) y z) + (tak (- y 1) z x) + (tak (- z 1) x y))))) + +(define fib (lambda (n) + (if (< n 3) 1 + (+ (fib (- n 1)) (fib (- n 2)))))) + +(define q2 (lambda (x y) + (if (or (< x 1) (< y 1)) 1 + (+ (q2 (- x (q2 (- x 1) y)) y) + (q2 x (- y (q2 x (- y 1)))))))) + +(define f (lambda () + (progn + + (define start (systime)) + ;(dec-cnt3 100000) + (define takres (tak 18 12 6)) + ;(define fibres (fib 23)) + ;(define q2res (q2 7 8)) + (print (list "Seconds elapsed: " (secs-since start))) + + (yield 2000000) + (f) +))) + +(f) + diff --git a/res/qml/Examples/RpmSlider.qml b/res/qml/Examples/RpmSlider.qml new file mode 100644 index 000000000..1e512816c --- /dev/null +++ b/res/qml/Examples/RpmSlider.qml @@ -0,0 +1,117 @@ +/* + Copyright 2020 Benjamin Vedder benjamin@vedder.se + + This file is part of VESC Tool. + + VESC Tool is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + VESC Tool is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . + */ + +import QtQuick 2.7 +import QtQuick.Controls 2.0 +import QtQuick.Layouts 1.3 +import QtQuick.Controls.Material 2.2 +import Vedder.vesc.utility 1.0 + +import Vedder.vesc.commands 1.0 +import Vedder.vesc.configparams 1.0 +import "qrc:/mobile" + +Item { + id: mainItem + anchors.fill: parent + + property Commands mCommands: VescIf.commands() + property ConfigParams mMcConf: VescIf.mcConfig() + + ColumnLayout { + id: gaugeColumn + anchors.fill: parent + RowLayout { + Layout.fillHeight: true + Layout.fillWidth: true + CustomGauge { + id: rpmGauge + Layout.fillWidth: true + Layout.preferredWidth: gaugeColumn.width * 0.45 + Layout.preferredHeight: gaugeColumn.height * 0.45 + maximumValue: 12000 + minimumValue: 0 + tickmarkScale: 0.001 + tickmarkSuffix: "k" + labelStep: 1000 + value: 0 + unitText: "RPM" + typeText: "Speed" + } + + CustomGauge { + id: voltageGauge + Layout.fillWidth: true + Layout.preferredWidth: gaugeColumn.width * 0.45 + Layout.preferredHeight: gaugeColumn.height * 0.45 + maximumValue: 100 + minimumValue: 0 + tickmarkScale: 1 + tickmarkSuffix: "" + labelStep: 20 + value: 0 + unitText: "V" + typeText: "Motor\nVoltage" + } + } + + RowLayout { + Slider { + from: 0 + to: 100 + Layout.fillWidth: true + + onValueChanged: { + if (activeBox.checked) { + mCommands.setDutyCycle(value / 100) + } else { + value = 0 + } + } + } + + CheckBox { + id: activeBox + text: "Active" + } + } + + Timer { + running: true + repeat: true + interval: 50 + + onTriggered: { + mCommands.getValues() + if (activeBox.checked) { + mCommands.sendAlive() + } + } + } + + Connections { + target: mCommands + + onValuesReceived: { + rpmGauge.value = Math.abs(values.rpm) / 5 + voltageGauge.value = Math.abs(values.v_in * values.duty_now) + } + } + } +} diff --git a/res_lisp.qrc b/res_lisp.qrc new file mode 100644 index 000000000..f27cd1754 --- /dev/null +++ b/res_lisp.qrc @@ -0,0 +1,12 @@ + + + res/Lisp/Examples/aux.lisp + res/Lisp/Examples/can_pos_follow.lisp + res/Lisp/Examples/control_servo_from_duty.lisp + res/Lisp/Examples/control_servo_from_encoder.lisp + res/Lisp/Examples/duty.lisp + res/Lisp/Examples/ppm_read.lisp + res/Lisp/Examples/print_bms_data.lisp + res/Lisp/Examples/speed_test.lisp + + diff --git a/res_qml.qrc b/res_qml.qrc index 0cf511f27..cc8ed3297 100644 --- a/res_qml.qrc +++ b/res_qml.qrc @@ -22,5 +22,6 @@ res/qml/Examples/BrakeBench.qml res/qml/Examples/PositionControl.qml res/qml/Examples/GaugeTest.qml + res/qml/Examples/RpmSlider.qml diff --git a/vesc_tool.pro b/vesc_tool.pro index 4a2b7aa5e..54635a370 100644 --- a/vesc_tool.pro +++ b/vesc_tool.pro @@ -10,7 +10,7 @@ VT_INTRO_VERSION = 1 VT_CONFIG_VERSION = 2 # Set to 0 for stable versions and to test version number for development versions. -VT_IS_TEST_VERSION = 1 +VT_IS_TEST_VERSION = 2 VT_ANDROID_VERSION_ARMV7 = 98 VT_ANDROID_VERSION_ARM64 = 99 @@ -251,6 +251,7 @@ include(QCodeEditor/qcodeeditor.pri) RESOURCES += res.qrc \ res_fw_bms.qrc \ res_fw.qrc \ + res_lisp.qrc \ res_qml.qrc RESOURCES += res_config.qrc diff --git a/widgets/qmleditor.h b/widgets/qmleditor.h deleted file mode 100644 index d6f5e015d..000000000 --- a/widgets/qmleditor.h +++ /dev/null @@ -1,50 +0,0 @@ -#ifndef QMLEDITOR_H -#define QMLEDITOR_H - -#include -#include - -namespace Ui { -class QmlEditor; -} - -class QmlEditor : public QWidget -{ - Q_OBJECT - -public: - explicit QmlEditor(QWidget *parent = nullptr); - ~QmlEditor(); - - QCodeEditor *codeEditor(); - QString fileNow(); - void setFileNow(QString fileName); - - bool isDirty = false; - -protected: - void keyPressEvent(QKeyEvent *event); - -signals: - void fileOpened(QString fileName); - void fileSaved(QString fileName); - void fileNameChanged(QString newName); - -private slots: - void on_openFileButton_clicked(); - void on_saveButton_clicked(); - void on_saveAsButton_clicked(); - void on_searchEdit_textChanged(const QString &arg1); - void on_searchPrevButton_clicked(); - void on_searchNextButton_clicked(); - void on_replaceThisButton_clicked(); - void on_replaceAllButton_clicked(); - void on_searchHideButton_clicked(); - void on_searchCaseSensitiveBox_toggled(bool checked); - -private: - Ui::QmlEditor *ui; - -}; - -#endif // QMLEDITOR_H diff --git a/widgets/qmleditor.cpp b/widgets/scripteditor.cpp similarity index 64% rename from widgets/qmleditor.cpp rename to widgets/scripteditor.cpp index e5041623a..c7e1cc79a 100644 --- a/widgets/qmleditor.cpp +++ b/widgets/scripteditor.cpp @@ -1,17 +1,39 @@ -#include "qmleditor.h" +/* + Copyright 2021 - 2022 Benjamin Vedder benjamin@vedder.se + + This file is part of VESC Tool. + + VESC Tool is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + VESC Tool is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . + */ + +#include "scripteditor.h" #include "ui_qmleditor.h" #include +#include #include +#include #include #include #include "utility.h" -QmlEditor::QmlEditor(QWidget *parent) : +ScriptEditor::ScriptEditor(QWidget *parent) : QWidget(parent), - ui(new Ui::QmlEditor) + ui(new Ui::ScriptEditor) { ui->setupUi(this); + mIsModeLisp = false; QString theme = Utility::getThemePath(); ui->searchHideButton->setIcon(QPixmap(theme + "icons/Cancel-96.png")); @@ -19,9 +41,6 @@ QmlEditor::QmlEditor(QWidget *parent) : ui->saveButton->setIcon(QPixmap(theme + "icons/Save-96.png")); ui->saveAsButton->setIcon(QPixmap(theme + "icons/Save as-96.png")); ui->searchWidget->setVisible(false); - - ui->qmlEdit->setHighlighter(new QmlHighlighter); - ui->qmlEdit->setCompleter(new QVescCompleter); ui->qmlEdit->setTabReplaceSize(4); connect(ui->qmlEdit, &QCodeEditor::saveTriggered, [this]() { @@ -38,28 +57,42 @@ QmlEditor::QmlEditor(QWidget *parent) : }); } -QmlEditor::~QmlEditor() +ScriptEditor::~ScriptEditor() { delete ui; } -QCodeEditor *QmlEditor::codeEditor() +QCodeEditor *ScriptEditor::codeEditor() { return ui->qmlEdit; } -QString QmlEditor::fileNow() +QString ScriptEditor::fileNow() { return ui->fileNowLabel->text(); } -void QmlEditor::setFileNow(QString fileName) +void ScriptEditor::setFileNow(QString fileName) { ui->fileNowLabel->setText(fileName); emit fileNameChanged(fileName); } -void QmlEditor::keyPressEvent(QKeyEvent *event) +void ScriptEditor::setModeQml() +{ + ui->qmlEdit->setHighlighter(new QmlHighlighter); + ui->qmlEdit->setCompleter(new QVescCompleter); + mIsModeLisp = false; +} + +void ScriptEditor::setModeLisp() +{ + ui->qmlEdit->setHighlighter(new LispHighlighter); + ui->qmlEdit->setCompleter(new QLispCompleter); + mIsModeLisp = true; +} + +void ScriptEditor::keyPressEvent(QKeyEvent *event) { if (event->key() == Qt::Key_Escape) { if (ui->searchEdit->hasFocus() || ui->replaceEdit->hasFocus()) { @@ -68,11 +101,11 @@ void QmlEditor::keyPressEvent(QKeyEvent *event) } } -void QmlEditor::on_openFileButton_clicked() +void ScriptEditor::on_openFileButton_clicked() { QString fileName = QFileDialog::getOpenFileName(this, tr("Open QML File"), "", - tr("QML files (*.qml)")); + mIsModeLisp ? tr("Lisp files (*.lisp)") : tr("QML files (*.qml)")); if (!fileName.isEmpty()) { QFile file(fileName); @@ -92,7 +125,7 @@ void QmlEditor::on_openFileButton_clicked() } } -void QmlEditor::on_saveButton_clicked() +void ScriptEditor::on_saveButton_clicked() { QString fileName = ui->fileNowLabel->text(); @@ -116,15 +149,17 @@ void QmlEditor::on_saveButton_clicked() emit fileSaved(fileName); } -void QmlEditor::on_saveAsButton_clicked() +void ScriptEditor::on_saveAsButton_clicked() { QString fileName = QFileDialog::getSaveFileName(this, tr("Save QML"), "", - tr("QML Files (*.qml)")); + mIsModeLisp ? tr("Lisp files (*.lisp)") : tr("QML files (*.qml)")); + + QString ending = mIsModeLisp ? ".lisp" : ".qml"; if (!fileName.isEmpty()) { - if (!fileName.toLower().endsWith(".qml")) { - fileName.append(".qml"); + if (!fileName.toLower().endsWith(ending)) { + fileName.append(ending); } QFile file(fileName); @@ -144,24 +179,24 @@ void QmlEditor::on_saveAsButton_clicked() } } -void QmlEditor::on_searchEdit_textChanged(const QString &arg1) +void ScriptEditor::on_searchEdit_textChanged(const QString &arg1) { ui->qmlEdit->searchForString(arg1); } -void QmlEditor::on_searchPrevButton_clicked() +void ScriptEditor::on_searchPrevButton_clicked() { ui->qmlEdit->searchPreviousResult(); ui->qmlEdit->setFocus(); } -void QmlEditor::on_searchNextButton_clicked() +void ScriptEditor::on_searchNextButton_clicked() { ui->qmlEdit->searchNextResult(); ui->qmlEdit->setFocus(); } -void QmlEditor::on_replaceThisButton_clicked() +void ScriptEditor::on_replaceThisButton_clicked() { if (ui->qmlEdit->textCursor().selectedText() == ui->searchEdit->text()) { ui->qmlEdit->textCursor().insertText(ui->replaceEdit->text()); @@ -169,7 +204,7 @@ void QmlEditor::on_replaceThisButton_clicked() } } -void QmlEditor::on_replaceAllButton_clicked() +void ScriptEditor::on_replaceAllButton_clicked() { ui->qmlEdit->searchNextResult(); while (!ui->qmlEdit->textCursor().selectedText().isEmpty()) { @@ -178,14 +213,14 @@ void QmlEditor::on_replaceAllButton_clicked() } } -void QmlEditor::on_searchHideButton_clicked() +void ScriptEditor::on_searchHideButton_clicked() { ui->searchWidget->setVisible(false); ui->qmlEdit->searchForString(""); ui->qmlEdit->setFocus(); } -void QmlEditor::on_searchCaseSensitiveBox_toggled(bool checked) +void ScriptEditor::on_searchCaseSensitiveBox_toggled(bool checked) { ui->qmlEdit->searchSetCaseSensitive(checked); } diff --git a/widgets/scripteditor.h b/widgets/scripteditor.h new file mode 100644 index 000000000..4e57cf0e4 --- /dev/null +++ b/widgets/scripteditor.h @@ -0,0 +1,72 @@ +/* + Copyright 2021 - 2022 Benjamin Vedder benjamin@vedder.se + + This file is part of VESC Tool. + + VESC Tool is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + VESC Tool is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . + */ + +#ifndef QMLEDITOR_H +#define QMLEDITOR_H + +#include +#include + +namespace Ui { +class ScriptEditor; +} + +class ScriptEditor : public QWidget +{ + Q_OBJECT + +public: + explicit ScriptEditor(QWidget *parent = nullptr); + ~ScriptEditor(); + + QCodeEditor *codeEditor(); + QString fileNow(); + void setFileNow(QString fileName); + void setModeQml(); + void setModeLisp(); + + bool isDirty = false; + +protected: + void keyPressEvent(QKeyEvent *event); + +signals: + void fileOpened(QString fileName); + void fileSaved(QString fileName); + void fileNameChanged(QString newName); + +private slots: + void on_openFileButton_clicked(); + void on_saveButton_clicked(); + void on_saveAsButton_clicked(); + void on_searchEdit_textChanged(const QString &arg1); + void on_searchPrevButton_clicked(); + void on_searchNextButton_clicked(); + void on_replaceThisButton_clicked(); + void on_replaceAllButton_clicked(); + void on_searchHideButton_clicked(); + void on_searchCaseSensitiveBox_toggled(bool checked); + +private: + Ui::ScriptEditor *ui; + bool mIsModeLisp; + +}; + +#endif // QMLEDITOR_H diff --git a/widgets/qmleditor.ui b/widgets/scripteditor.ui similarity index 94% rename from widgets/qmleditor.ui rename to widgets/scripteditor.ui index f1292280f..31a1abc7f 100644 --- a/widgets/qmleditor.ui +++ b/widgets/scripteditor.ui @@ -1,7 +1,7 @@ - QmlEditor - + ScriptEditor + 0 @@ -107,7 +107,7 @@ - + :/res/icons/Cancel-96.png:/res/icons/Cancel-96.png @@ -142,7 +142,7 @@ Open - + :/res/icons/Open Folder-96.png:/res/icons/Open Folder-96.png @@ -156,7 +156,7 @@ Save - + :/res/icons/Save-96.png:/res/icons/Save-96.png @@ -170,7 +170,7 @@ Save As - + :/res/icons/Save as-96.png:/res/icons/Save as-96.png @@ -189,6 +189,8 @@
QCodeEditor
- + + +
diff --git a/widgets/widgets.pri b/widgets/widgets.pri index 2dfe8fcda..bcf8827ee 100644 --- a/widgets/widgets.pri +++ b/widgets/widgets.pri @@ -18,7 +18,7 @@ FORMS += \ $$PWD/paramdialog.ui \ $$PWD/detectallfocdialog.ui \ $$PWD/dirsetup.ui \ - $$PWD/qmleditor.ui + $$PWD/scripteditor.ui HEADERS += \ $$PWD/batttempplot.h \ @@ -43,9 +43,9 @@ HEADERS += \ $$PWD/detectimu.h \ $$PWD/ppmmap.h \ $$PWD/adcmap.h \ - $$PWD/qmleditor.h \ $$PWD/rtdatatext.h \ $$PWD/nrfpair.h \ + $$PWD/scripteditor.h \ $$PWD/vtextbrowser.h \ $$PWD/imagewidget.h \ $$PWD/parameditstring.h \ @@ -80,9 +80,9 @@ SOURCES += \ $$PWD/detectimu.cpp \ $$PWD/ppmmap.cpp \ $$PWD/adcmap.cpp \ - $$PWD/qmleditor.cpp \ $$PWD/rtdatatext.cpp \ $$PWD/nrfpair.cpp \ + $$PWD/scripteditor.cpp \ $$PWD/vtextbrowser.cpp \ $$PWD/imagewidget.cpp \ $$PWD/parameditstring.cpp \ From 83e23c849ee4d4aba778a15db45c9f7bdc2f779e Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Sat, 29 Jan 2022 03:55:03 +0100 Subject: [PATCH 009/559] Fixed include after renaming --- widgets/scripteditor.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/widgets/scripteditor.cpp b/widgets/scripteditor.cpp index c7e1cc79a..c71074e77 100644 --- a/widgets/scripteditor.cpp +++ b/widgets/scripteditor.cpp @@ -18,7 +18,7 @@ */ #include "scripteditor.h" -#include "ui_qmleditor.h" +#include "ui_scripteditor.h" #include #include From a41cbae761aa2b36051f046d14e0b84797645770 Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Sat, 29 Jan 2022 11:27:05 +0100 Subject: [PATCH 010/559] Some lisp editor fixes --- pages/pagelisp.cpp | 5 ---- widgets/scripteditor.cpp | 60 +++++++++++++++++++++------------------- widgets/scripteditor.ui | 2 +- 3 files changed, 33 insertions(+), 34 deletions(-) diff --git a/pages/pagelisp.cpp b/pages/pagelisp.cpp index 9cf933949..38b11e3fb 100644 --- a/pages/pagelisp.cpp +++ b/pages/pagelisp.cpp @@ -31,9 +31,6 @@ PageLisp::PageLisp(QWidget *parent) : Utility::setPlotColors(ui->bindingPlot); ui->mainEdit->setModeLisp(); - ui->mainEdit->codeEditor()->setCommentStr(";"); - ui->mainEdit->codeEditor()->setIndentStrs("", ""); - makeEditorConnections(ui->mainEdit); QPushButton *plusButton = new QPushButton(); @@ -254,8 +251,6 @@ void PageLisp::createEditorTab(QString fileName, QString content) { ScriptEditor *editor = new ScriptEditor(); editor->setModeLisp(); - editor->codeEditor()->setCommentStr(";"); - editor->codeEditor()->setIndentStrs("", ""); int tabIndex = ui->fileTabs->addTab(editor, ""); ui->fileTabs->setCurrentIndex(tabIndex); diff --git a/widgets/scripteditor.cpp b/widgets/scripteditor.cpp index c71074e77..2c1124c7d 100644 --- a/widgets/scripteditor.cpp +++ b/widgets/scripteditor.cpp @@ -41,18 +41,18 @@ ScriptEditor::ScriptEditor(QWidget *parent) : ui->saveButton->setIcon(QPixmap(theme + "icons/Save-96.png")); ui->saveAsButton->setIcon(QPixmap(theme + "icons/Save as-96.png")); ui->searchWidget->setVisible(false); - ui->qmlEdit->setTabReplaceSize(4); + ui->codeEdit->setTabReplaceSize(4); - connect(ui->qmlEdit, &QCodeEditor::saveTriggered, [this]() { + connect(ui->codeEdit, &QCodeEditor::saveTriggered, [this]() { on_saveButton_clicked(); }); - connect(ui->qmlEdit, &QCodeEditor::searchTriggered, [this]() { + connect(ui->codeEdit, &QCodeEditor::searchTriggered, [this]() { ui->searchWidget->setVisible(true); - auto selected = ui->qmlEdit->textCursor().selectedText(); + auto selected = ui->codeEdit->textCursor().selectedText(); if (!selected.isEmpty()) { ui->searchEdit->setText(selected); } - ui->qmlEdit->searchForString(ui->searchEdit->text()); + ui->codeEdit->searchForString(ui->searchEdit->text()); ui->searchEdit->setFocus(); }); } @@ -64,7 +64,7 @@ ScriptEditor::~ScriptEditor() QCodeEditor *ScriptEditor::codeEditor() { - return ui->qmlEdit; + return ui->codeEdit; } QString ScriptEditor::fileNow() @@ -80,15 +80,19 @@ void ScriptEditor::setFileNow(QString fileName) void ScriptEditor::setModeQml() { - ui->qmlEdit->setHighlighter(new QmlHighlighter); - ui->qmlEdit->setCompleter(new QVescCompleter); + ui->codeEdit->setHighlighter(new QmlHighlighter); + ui->codeEdit->setCompleter(new QVescCompleter); mIsModeLisp = false; } void ScriptEditor::setModeLisp() { - ui->qmlEdit->setHighlighter(new LispHighlighter); - ui->qmlEdit->setCompleter(new QLispCompleter); + ui->codeEdit->setHighlighter(new LispHighlighter); + ui->codeEdit->setCompleter(new QLispCompleter); + ui->codeEdit->setCommentStr(";"); + ui->codeEdit->setIndentStrs("", ""); + ui->codeEdit->setAutoParentheses(false); + ui->codeEdit->setAutoIndentation(false); mIsModeLisp = true; } @@ -115,7 +119,7 @@ void ScriptEditor::on_openFileButton_clicked() return; } - ui->qmlEdit->setPlainText(file.readAll()); + ui->codeEdit->setPlainText(file.readAll()); ui->fileNowLabel->setText(fileName); emit fileNameChanged(fileName); @@ -143,7 +147,7 @@ void ScriptEditor::on_saveButton_clicked() return; } - file.write(ui->qmlEdit->toPlainText().toUtf8()); + file.write(ui->codeEdit->toPlainText().toUtf8()); file.close(); emit fileSaved(fileName); @@ -169,7 +173,7 @@ void ScriptEditor::on_saveAsButton_clicked() return; } - file.write(ui->qmlEdit->toPlainText().toUtf8()); + file.write(ui->codeEdit->toPlainText().toUtf8()); file.close(); ui->fileNowLabel->setText(fileName); @@ -181,46 +185,46 @@ void ScriptEditor::on_saveAsButton_clicked() void ScriptEditor::on_searchEdit_textChanged(const QString &arg1) { - ui->qmlEdit->searchForString(arg1); + ui->codeEdit->searchForString(arg1); } void ScriptEditor::on_searchPrevButton_clicked() { - ui->qmlEdit->searchPreviousResult(); - ui->qmlEdit->setFocus(); + ui->codeEdit->searchPreviousResult(); + ui->codeEdit->setFocus(); } void ScriptEditor::on_searchNextButton_clicked() { - ui->qmlEdit->searchNextResult(); - ui->qmlEdit->setFocus(); + ui->codeEdit->searchNextResult(); + ui->codeEdit->setFocus(); } void ScriptEditor::on_replaceThisButton_clicked() { - if (ui->qmlEdit->textCursor().selectedText() == ui->searchEdit->text()) { - ui->qmlEdit->textCursor().insertText(ui->replaceEdit->text()); - ui->qmlEdit->searchNextResult(); + if (ui->codeEdit->textCursor().selectedText() == ui->searchEdit->text()) { + ui->codeEdit->textCursor().insertText(ui->replaceEdit->text()); + ui->codeEdit->searchNextResult(); } } void ScriptEditor::on_replaceAllButton_clicked() { - ui->qmlEdit->searchNextResult(); - while (!ui->qmlEdit->textCursor().selectedText().isEmpty()) { - ui->qmlEdit->textCursor().insertText(ui->replaceEdit->text()); - ui->qmlEdit->searchNextResult(); + ui->codeEdit->searchNextResult(); + while (!ui->codeEdit->textCursor().selectedText().isEmpty()) { + ui->codeEdit->textCursor().insertText(ui->replaceEdit->text()); + ui->codeEdit->searchNextResult(); } } void ScriptEditor::on_searchHideButton_clicked() { ui->searchWidget->setVisible(false); - ui->qmlEdit->searchForString(""); - ui->qmlEdit->setFocus(); + ui->codeEdit->searchForString(""); + ui->codeEdit->setFocus(); } void ScriptEditor::on_searchCaseSensitiveBox_toggled(bool checked) { - ui->qmlEdit->searchSetCaseSensitive(checked); + ui->codeEdit->searchSetCaseSensitive(checked); } diff --git a/widgets/scripteditor.ui b/widgets/scripteditor.ui index 31a1abc7f..20beecf47 100644 --- a/widgets/scripteditor.ui +++ b/widgets/scripteditor.ui @@ -30,7 +30,7 @@ 6 - + false From 06e6249eb2b08494a56366e76dac549aadb859dc Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Sat, 29 Jan 2022 14:37:02 +0100 Subject: [PATCH 011/559] Added binding plot support --- pages/pagelisp.cpp | 117 +++++++++++++++++++- pages/pagelisp.h | 2 + pages/pagelisp.ui | 270 ++++++++++++++++++++++++++++++++++++++++----- 3 files changed, 357 insertions(+), 32 deletions(-) diff --git a/pages/pagelisp.cpp b/pages/pagelisp.cpp index 38b11e3fb..07d1bd046 100644 --- a/pages/pagelisp.cpp +++ b/pages/pagelisp.cpp @@ -17,6 +17,7 @@ along with this program. If not, see . */ +#include #include "pagelisp.h" #include "ui_pagelisp.h" #include "utility.h" @@ -47,6 +48,22 @@ PageLisp::PageLisp(QWidget *parent) : ui->uploadButton->setIcon(QIcon(theme +"icons/Download-96.png")); ui->readExistingButton->setIcon(QIcon(theme +"icons/Upload-96.png")); ui->eraseButton->setIcon(QIcon(theme +"icons/Delete-96.png")); + ui->rescaleButton->setIcon(QPixmap(theme + "icons/expand_off.png")); + + QIcon mycon = QIcon(theme + "icons/expand_off.png"); + mycon.addPixmap(QPixmap(theme + "icons/expand_on.png"), QIcon::Normal, QIcon::On); + mycon.addPixmap(QPixmap(theme + "icons/expand_off.png"), QIcon::Normal, QIcon::Off); + ui->zoomHButton->setIcon(mycon); + + mycon = QIcon(theme + "icons/expand_v_off.png"); + mycon.addPixmap(QPixmap(theme + "icons/expand_v_on.png"), QIcon::Normal, QIcon::On); + mycon.addPixmap(QPixmap(theme + "icons/expand_v_off.png"), QIcon::Normal, QIcon::Off); + ui->zoomVButton->setIcon(mycon); + + mycon = QIcon(theme + "icons/size_off.png"); + mycon.addPixmap(QPixmap(theme + "icons/size_on.png"), QIcon::Normal, QIcon::On); + mycon.addPixmap(QPixmap(theme + "icons/size_off.png"), QIcon::Normal, QIcon::Off); + ui->autoscaleButton->setIcon(mycon); plusButton->setFlat(true); plusButton->setText("New Tab"); @@ -129,7 +146,7 @@ PageLisp::PageLisp(QWidget *parent) : ui->splitter->setSizes(QList({1000, 600})); ui->splitter_2->setSizes(QList({1000, 600})); - mPollTimer.start(100); + mPollTimer.start(1000 / ui->pollRateBox->value()); connect(&mPollTimer, &QTimer::timeout, [this]() { if (ui->pollBox->isChecked()) { if (mVesc) { @@ -137,6 +154,32 @@ PageLisp::PageLisp(QWidget *parent) : } } }); + + connect(ui->pollRateBox, QOverload::of(&QSpinBox::valueChanged), [this](int val) { + mPollTimer.setInterval(1000 / val); + }); + + auto updateZoom = [this]() { + Qt::Orientations plotOrientations = Qt::Orientations( + ((ui->zoomHButton->isChecked() ? Qt::Horizontal : 0) | + (ui->zoomVButton->isChecked() ? Qt::Vertical : 0))); + + ui->bindingPlot->axisRect()->setRangeZoom(plotOrientations); + }; + + connect(ui->zoomHButton, &QPushButton::clicked, updateZoom); + connect(ui->zoomVButton, &QPushButton::clicked, updateZoom); + updateZoom(); + + QFont legendFont = font(); + legendFont.setPointSize(9); + ui->bindingPlot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom); + ui->bindingPlot->legend->setVisible(true); + ui->bindingPlot->legend->setFont(legendFont); + ui->bindingPlot->axisRect()->insetLayout()->setInsetAlignment(0, Qt::AlignRight|Qt::AlignBottom); + ui->bindingPlot->xAxis->setLabel("Age (s)"); + ui->bindingPlot->yAxis->setLabel("Value"); + ui->bindingPlot->xAxis->setRangeReversed(true); } PageLisp::~PageLisp() @@ -197,12 +240,67 @@ void PageLisp::setVesc(VescInterface *vesc) ui->bindingTable->setColumnCount(2); ui->bindingTable->setRowCount(stats.number_bindings.size()); + + QStringList selectedBindings; + qint64 maxAgeMs = 5000; + auto timeNow = QDateTime::currentMSecsSinceEpoch(); + int ind = 0; for (auto b: stats.number_bindings) { ui->bindingTable->setItem(ind, 0, new QTableWidgetItem(b.first)); - ui->bindingTable->setItem(ind, 1, new QTableWidgetItem(QString::number(b.second, 'f'))); + auto data = new QTableWidgetItem(QString::number(b.second, 'f')); + data->setData(Qt::UserRole, b.second); + ui->bindingTable->setItem(ind, 1, data); + + if (ui->bindingTable->item(ind, 1)->isSelected()) { + selectedBindings.append(b.first); + if (!mBindingData.contains(b.first)) { + mBindingData.insert(b.first, QVector>()); + } + + mBindingData[b.first].append(qMakePair(timeNow, b.second)); + + // Remove old data points + while (!mBindingData[b.first].isEmpty() && mBindingData[b.first].at(0).first < (timeNow - maxAgeMs)) { + mBindingData[b.first].removeFirst(); + } + } + ind++; } + + // Remove bindings not selected + for (auto it = mBindingData.begin(); it != mBindingData.end();) { + if (!selectedBindings.contains(it.key())) { + it = mBindingData.erase(it); + } else { + ++it; + } + } + + // Add graphs + ui->bindingPlot->clearGraphs(); + int graphInd = 0; + for (auto it = mBindingData.begin(); it != mBindingData.end();++it) { + auto name = it.key(); + QVector xAxis, yAxis; + for (auto p: it.value()) { + xAxis.append(double(timeNow - p.first) / 1000.0); + yAxis.append(p.second); + } + + ui->bindingPlot->addGraph(); + ui->bindingPlot->graph()->setPen(QPen(Utility::getAppQColor(QString("plot_graph%1").arg(graphInd + 1)))); + ui->bindingPlot->graph()->setName(name); + ui->bindingPlot->graph()->setData(xAxis, yAxis); + graphInd++; + } + + if (ui->autoscaleButton->isChecked()) { + ui->bindingPlot->rescaleAxes(); + } + + ui->bindingPlot->replotWhenVisible(); }); } @@ -594,10 +692,19 @@ void PageLisp::on_uploadButton_clicked() offset += sz; data.remove(0, sz); } + + if (ok && ui->autoRunBox->isChecked()) { + on_runButton_clicked(); + } } void PageLisp::on_readExistingButton_clicked() { + if (!mVesc->isPortConnected()) { + mVesc->emitMessageDialog(tr("Read code"), tr("Not Connected"), false); + return; + } + QByteArray lispData; int lenLispLast = 0; auto conn = connect(mVesc->commands(), &Commands::lispReadCodeRx, @@ -658,3 +765,9 @@ void PageLisp::on_eraseButton_clicked() { eraseCode(); } + +void PageLisp::on_rescaleButton_clicked() +{ + ui->bindingPlot->rescaleAxes(); + ui->bindingPlot->replotWhenVisible(); +} diff --git a/pages/pagelisp.h b/pages/pagelisp.h index be12fa4a9..03aad9b39 100644 --- a/pages/pagelisp.h +++ b/pages/pagelisp.h @@ -52,6 +52,7 @@ private slots: void on_uploadButton_clicked(); void on_readExistingButton_clicked(); void on_eraseButton_clicked(); + void on_rescaleButton_clicked(); private: Ui::PageLisp *ui; @@ -59,6 +60,7 @@ private slots: QStringList mRecentFiles; QString mDirNow; QTimer mPollTimer; + QMap > > mBindingData; void updateRecentList(); void makeEditorConnections(ScriptEditor *editor); diff --git a/pages/pagelisp.ui b/pages/pagelisp.ui index 73244af2b..156d9130c 100644 --- a/pages/pagelisp.ui +++ b/pages/pagelisp.ui @@ -6,14 +6,14 @@ 0 0 - 1569 - 907 + 1487 + 870 Form - + @@ -31,7 +31,7 @@ - 12 + 0 @@ -79,29 +79,14 @@ - - - Run - - - - :/res/icons/Circled Play-96.png:/res/icons/Circled Play-96.png - - - true + + + Automatically run program on upload - - - - - Stop - - - - :/res/icons/Shutdown-96.png:/res/icons/Shutdown-96.png + AutoRun - + true @@ -158,11 +143,56 @@ - - - Poll Status - - + + + + + Run + + + + :/res/icons/Circled Play-96.png:/res/icons/Circled Play-96.png + + + true + + + + + + + Stop + + + + :/res/icons/Shutdown-96.png:/res/icons/Shutdown-96.png + + + true + + + + + + + Poll Status + + + + + + + Hz + + + 1 + + + 10 + + + + @@ -418,10 +448,190 @@ Plot - + + + + + + 0 + 0 + + + + QFrame::StyledPanel + + + QFrame::Plain + + + + 3 + + + 2 + + + 2 + + + 2 + + + 2 + + + + + + 0 + 0 + + + + + 3 + + + + Autoscale plots with incoming samples + + + + + + + :/res/icons/size_off.png + :/res/icons/size_on.png:/res/icons/size_off.png + + + + 20 + 20 + + + + true + + + true + + + + + + + + 0 + 0 + + + + + 3 + + + + Enable horizontal zoom + + + + + + + :/res/icons/expand_off.png + :/res/icons/expand_on.png:/res/icons/expand_off.png + + + + 20 + 20 + + + + true + + + true + + + + + + + + 0 + 0 + + + + + 3 + + + + Enable vertical zoom + + + + + + + :/res/icons/expand_v_off.png + :/res/icons/expand_v_on.png:/res/icons/expand_v_off.png + + + + 20 + 20 + + + + true + + + true + + + + + + + Rescale plots to fit + + + + + + + :/res/icons/size_off.png:/res/icons/size_off.png + + + + 20 + 20 + + + + + + + + Qt::Vertical + + + + 20 + 40 + + + + + + + From 94457244116c7e25c6aec1a19d2f164e797e493a Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Sat, 29 Jan 2022 21:27:31 +0100 Subject: [PATCH 012/559] Lisp status update --- commands.cpp | 1 + datatypes.h | 2 ++ pages/pagelisp.cpp | 4 +++- pages/pagelisp.ui | 56 +++++++++++++++++++++++++++++++--------------- 4 files changed, 44 insertions(+), 19 deletions(-) diff --git a/commands.cpp b/commands.cpp index 11cd154fa..69d218008 100755 --- a/commands.cpp +++ b/commands.cpp @@ -978,6 +978,7 @@ void Commands::processPacket(QByteArray data) stats.heap_use = vb.vbPopFrontDouble16(1e2); stats.mem_use = vb.vbPopFrontDouble16(1e2); stats.stack_use = vb.vbPopFrontDouble16(1e2); + stats.done_ctx_r = vb.vbPopFrontString(); while (vb.size() > 0) { auto name = vb.vbPopFrontString(); auto num = vb.vbPopFrontDouble32Auto(); diff --git a/datatypes.h b/datatypes.h index ddfb925ea..f9d07b843 100644 --- a/datatypes.h +++ b/datatypes.h @@ -1092,6 +1092,7 @@ struct LISP_STATS { Q_PROPERTY(double heap_use MEMBER heap_use) Q_PROPERTY(double mem_use MEMBER mem_use) Q_PROPERTY(double stack_use MEMBER stack_use) + Q_PROPERTY(QString done_ctx_r MEMBER done_ctx_r) LISP_STATS() { cpu_use = 0.0; @@ -1104,6 +1105,7 @@ struct LISP_STATS { double heap_use; double mem_use; double stack_use; + QString done_ctx_r; QVector> number_bindings; }; diff --git a/pages/pagelisp.cpp b/pages/pagelisp.cpp index 07d1bd046..2fb235b6a 100644 --- a/pages/pagelisp.cpp +++ b/pages/pagelisp.cpp @@ -233,10 +233,12 @@ void PageLisp::setVesc(VescInterface *vesc) }); connect(mVesc->commands(), &Commands::lispStatsRx, [this](LISP_STATS stats) { - ui->cpuBar->setValue(stats.cpu_use); + ui->cpuBar->setValue(stats.cpu_use * 10); + ui->cpuBar->setFormat(QString("%1%").arg(stats.cpu_use, 0, 'f', 1)); ui->heapBar->setValue(stats.heap_use); ui->memBar->setValue(stats.mem_use); ui->stackBar->setValue(stats.stack_use); + ui->doneCtxRLabel->setText(stats.done_ctx_r); ui->bindingTable->setColumnCount(2); ui->bindingTable->setRowCount(stats.number_bindings.size()); diff --git a/pages/pagelisp.ui b/pages/pagelisp.ui index 156d9130c..309099d28 100644 --- a/pages/pagelisp.ui +++ b/pages/pagelisp.ui @@ -196,46 +196,66 @@ - - + + 0 - - + + - Stack + CPU - - + + - CPU + Mem - - + + - Heap + - - + + 0 - - + + + + 1000 + 0 + + + + + + + + + Stack + + + + + + + Result + @@ -245,10 +265,10 @@ - - + + - Mem + Heap From b253b422cfc8561b7e6b9dd5e7c005bcdb0db5d8 Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Sat, 29 Jan 2022 21:32:12 +0100 Subject: [PATCH 013/559] Added empty loop lisp example --- res/Lisp/Examples/loop.lisp | 11 +++++++++++ res_lisp.qrc | 1 + 2 files changed, 12 insertions(+) create mode 100644 res/Lisp/Examples/loop.lisp diff --git a/res/Lisp/Examples/loop.lisp b/res/Lisp/Examples/loop.lisp new file mode 100644 index 000000000..870a8c8fa --- /dev/null +++ b/res/Lisp/Examples/loop.lisp @@ -0,0 +1,11 @@ +(define rate 50) ; Update rate in hz + +(define f (lambda () + (progn + ; Put your code here + + (yield (/ 1000000 rate)) + (f) +))) + +(f) diff --git a/res_lisp.qrc b/res_lisp.qrc index f27cd1754..970ace1ce 100644 --- a/res_lisp.qrc +++ b/res_lisp.qrc @@ -8,5 +8,6 @@ res/Lisp/Examples/ppm_read.lisp res/Lisp/Examples/print_bms_data.lisp res/Lisp/Examples/speed_test.lisp + res/Lisp/Examples/loop.lisp From ecd42756e63f7fecdff5d2a0b29a70830d8b77f6 Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Sat, 29 Jan 2022 23:25:23 +0100 Subject: [PATCH 014/559] re-enabled auto indentation for lisp --- widgets/scripteditor.cpp | 1 - 1 file changed, 1 deletion(-) diff --git a/widgets/scripteditor.cpp b/widgets/scripteditor.cpp index 2c1124c7d..3375ec9a0 100644 --- a/widgets/scripteditor.cpp +++ b/widgets/scripteditor.cpp @@ -92,7 +92,6 @@ void ScriptEditor::setModeLisp() ui->codeEdit->setCommentStr(";"); ui->codeEdit->setIndentStrs("", ""); ui->codeEdit->setAutoParentheses(false); - ui->codeEdit->setAutoIndentation(false); mIsModeLisp = true; } From c3d7b78a033074a2951ed0919af4c0c6fa4c4cde Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Sun, 30 Jan 2022 10:56:28 +0100 Subject: [PATCH 015/559] Renamed swdprog connect button --- pages/pageswdprog.ui | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/pageswdprog.ui b/pages/pageswdprog.ui index b4dae2a52..a5f289274 100644 --- a/pages/pageswdprog.ui +++ b/pages/pageswdprog.ui @@ -349,7 +349,7 @@ Connect to internal NRF5x MCU - Connect NRF5X + Connect Internal From e15f1749d9beaa35b9d46027340ec6040ab134d9 Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Mon, 31 Jan 2022 20:04:59 +0100 Subject: [PATCH 016/559] Added start RPM (offset) to torque+exp mode in motor comparison tool --- pages/pagemotorcomparison.cpp | 14 +++++++------- pages/pagemotorcomparison.ui | 2 +- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/pages/pagemotorcomparison.cpp b/pages/pagemotorcomparison.cpp index 1175b028b..c66686cc8 100644 --- a/pages/pagemotorcomparison.cpp +++ b/pages/pagemotorcomparison.cpp @@ -301,8 +301,6 @@ PageMotorComparison::PageMotorComparison(QWidget *parent) : addDataItemBoth("wh/mi", false); addDataItemBoth("KV (BLDC)", false); addDataItemBoth("KV Noload (BLDC)", false); - - } PageMotorComparison::~PageMotorComparison() @@ -344,7 +342,7 @@ void PageMotorComparison::settingChanged() { ui->testTorqueBox->setEnabled(ui->testModeTorqueButton->isChecked() || ui->testModeRpmButton->isChecked()); ui->testPowerBox->setEnabled(ui->testModeRpmPowerButton->isChecked() || ui->testModeExpButton->isChecked()); - ui->testRpmStartBox->setEnabled(ui->testModeRpmPowerButton->isChecked()); + ui->testRpmStartBox->setEnabled(ui->testModeRpmPowerButton->isChecked() || ui->testModeExpButton->isChecked()); ui->testExpBox->setEnabled(ui->testModeExpButton->isChecked()); ui->testExpBaseTorqueBox->setEnabled(ui->testModeExpButton->isChecked()); @@ -459,13 +457,14 @@ void PageMotorComparison::updateDataAndPlot(double posx, double yMin, double yMa md.update(mM2Config, posx, torque, getParamsUi(2)); updateTable(md, ui->m2PlotTable); } else { + double rpm_start = ui->testRpmStartBox->value(); double rps = posx * 2.0 * M_PI / 60.0; double prop_exp = ui->testExpBox->value(); double baseTorque = ui->testExpBaseTorqueBox->value(); double topRpm = ui->testRpmBox->value(); double power = ui->testPowerBox->value(); - double p_max_const = power / pow(topRpm, prop_exp); - double torque = (p_max_const * pow(posx, prop_exp)) / rps; + double p_max_const = power / pow(topRpm - rpm_start, prop_exp); + double torque = (p_max_const * pow(posx > rpm_start ? (posx - rpm_start) : 0.0, prop_exp)) / rps; torque += baseTorque; MotorData md; @@ -768,7 +767,8 @@ void PageMotorComparison::on_testRunButton_clicked() double power = ui->testPowerBox->value(); double prop_exp = ui->testExpBox->value(); double baseTorque = ui->testExpBaseTorqueBox->value(); - double p_max_const = power / pow(rpm, prop_exp); + double rpm_start = ui->testRpmStartBox->value(); + double p_max_const = power / pow(rpm - rpm_start, prop_exp); QVector xAxis; QVector > yAxes; @@ -776,7 +776,7 @@ void PageMotorComparison::on_testRunButton_clicked() for (double r = rpm / 1000.0;r < rpm;r += (rpm / 1000.0)) { double rps = r * 2.0 * M_PI / 60.0; - double power = p_max_const * pow(r, prop_exp); + double power = p_max_const * pow(r > rpm_start ? (r - rpm_start) : 0.0, prop_exp); double torque = power / rps; torque += baseTorque; diff --git a/pages/pagemotorcomparison.ui b/pages/pagemotorcomparison.ui index 79651206a..30ca5d422 100644 --- a/pages/pagemotorcomparison.ui +++ b/pages/pagemotorcomparison.ui @@ -106,7 +106,7 @@ 0 - 10.000000000000000 + 0.000000000000000 999999.000000000000000 From 1966809d92255f363fb85b7ad329447a464b3e56 Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Thu, 3 Feb 2022 17:28:41 +0100 Subject: [PATCH 017/559] Added can js lisp example --- res/Lisp/Examples/can_js.lisp | 97 +++++++++++++++++++++++++++++++++++ res_lisp.qrc | 1 + 2 files changed, 98 insertions(+) create mode 100644 res/Lisp/Examples/can_js.lisp diff --git a/res/Lisp/Examples/can_js.lisp b/res/Lisp/Examples/can_js.lisp new file mode 100644 index 000000000..4c5fbde9c --- /dev/null +++ b/res/Lisp/Examples/can_js.lisp @@ -0,0 +1,97 @@ +; This example comminucates with a Grayhill 3J Gen 2.0 Joystick. It +; uses the J1939 CAN-standard. + +(define js-sa 0xF1) ; Grayhill joystick source address +(define my-id 2) + +; ID to send data to the joysick +(define id-send (bits-enc-int (bits-enc-int 0x18EF0000 8 js-sa 8) 0 my-id 8)) + +; Received X- and Y-axis values from the joystick +(define x-axis 0) +(define y-axis 0) + +; Counter for received CAN-frames +(define can-cnt 0) + +; Handler for EID CAN-frames +(define proc-eid (lambda (id data) + (if (num-eq id 0x18ff03f1) + (progn + (define can-cnt (+ can-cnt 1)) + + ; Note: the axes are 10 bits in the datasheet, but they change in + ; steps of 2 percent, so the lower bits are always 0. Not sure + ; why they don't use just 7 bits for that. + + (define x-axis (* 0.001 + (* (if (= (bits-dec-int (ix 0 data) 2 1) 0) 1.0 -1.0) + (+ (bits-dec-int (ix 0 data) 6 2) (* 4 (ix 1 data)) + )))) + + (define y-axis (* 0.001 + (* (if (= (bits-dec-int (ix 2 data) 2 1) 0) 1.0 -1.0) + (+ (bits-dec-int (ix 2 data) 6 2) (* 4 (ix 3 data)) + )))) + + ; Decode the buttons that are currently pressed + (define btn-lst (list + (bits-dec-int (ix 5 data) 6 2) + (bits-dec-int (ix 5 data) 4 2) + (bits-dec-int (ix 5 data) 2 2) + (bits-dec-int (ix 5 data) 0 2) + (bits-dec-int (ix 6 data) 6 2) + (bits-dec-int (ix 6 data) 4 2) + (bits-dec-int (ix 6 data) 2 2) + )) + +; (set-duty y-axis) +; (timeout-reset) + ) + nil +))) + +; This function waits for events from the C code and calls the +; handlers for them when the events arrive. +(define event-handler (lambda () + (progn + (recv ((signal-can-eid (? id) . (? data)) (proc-eid id data)) + (_ nil)) + (event-handler) ; Call self again to make this a loop +))) + +; Set LEDs in button. +; 0: off, 1: on, 2: slow blink, 3: med blink, 4: fast blink +; btn: Button number +; l: Left LED +; c: Center LED +; r: Right LED +(define set-btn-leds (lambda (btn l c r) + (progn + (define msg (list btn (bits-enc-int l 4 c 4) r)) + (can-send-eid id-send msg) +))) + +(define btn-now 1) + +(define btn-fun (lambda () + (progn + (set-btn-leds btn-now 1 4 1) + (yield 1500000) + (set-btn-leds btn-now 0 0 0) + + (define btn-now (+ btn-now 1)) + (if (= btn-now 6) (define btn-now 7)) ; Index 6 is missing, so skip it + (if (> btn-now 7) (define btn-now 1)) + + (btn-fun) ; Call self again to make this a loop +))) + +; Spawn the event handler thread and pass the ID it returns to C +(event-register-handler (spawn '(event-handler))) + +; Enable the CAN event for extended ID (EID) frames +(event-enable "event-can-eid") + +; Start the button-blink-function from this thread +(btn-fun) diff --git a/res_lisp.qrc b/res_lisp.qrc index 970ace1ce..840e353a3 100644 --- a/res_lisp.qrc +++ b/res_lisp.qrc @@ -9,5 +9,6 @@ res/Lisp/Examples/print_bms_data.lisp res/Lisp/Examples/speed_test.lisp res/Lisp/Examples/loop.lisp + res/Lisp/Examples/can_js.lisp From 7f28555ecd2e243fb0d48e4255abd927d8f5c848 Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Thu, 3 Feb 2022 20:01:38 +0100 Subject: [PATCH 018/559] lisp --- QCodeEditor/src/internal/QLispCompleter.cpp | 4 ++-- mainwindow.ui | 9 +++----- pages/pagelisp.cpp | 25 +++++++++++++++++++++ pages/pagelisp.h | 1 + pages/pagelisp.ui | 5 ++++- vesc_tool.pro | 2 +- 6 files changed, 36 insertions(+), 10 deletions(-) diff --git a/QCodeEditor/src/internal/QLispCompleter.cpp b/QCodeEditor/src/internal/QLispCompleter.cpp index 9c1fa4cd6..92ac5d896 100644 --- a/QCodeEditor/src/internal/QLispCompleter.cpp +++ b/QCodeEditor/src/internal/QLispCompleter.cpp @@ -54,8 +54,8 @@ QLispCompleter::QLispCompleter(QObject *parent) : addItem("set"); { level++; - addItem("duty(dty)"); - addItem("current(i)"); + addItem("duty dty"); + addItem("current i)"); level--; } diff --git a/mainwindow.ui b/mainwindow.ui index 7d7a61d54..275f9dc9f 100644 --- a/mainwindow.ui +++ b/mainwindow.ui @@ -19,7 +19,7 @@ VESC Tool - + :/res/icon.png:/res/icon.png @@ -76,7 +76,7 @@ - :/res/logo.png + :/res/logo.png true @@ -931,9 +931,6 @@ Exit - - Ctrl+Q - @@ -1416,8 +1413,8 @@ p, li { white-space: pre-wrap; } + - diff --git a/pages/pagelisp.cpp b/pages/pagelisp.cpp index 2fb235b6a..808797d0f 100644 --- a/pages/pagelisp.cpp +++ b/pages/pagelisp.cpp @@ -21,6 +21,7 @@ #include "pagelisp.h" #include "ui_pagelisp.h" #include "utility.h" +#include "widgets/helpdialog.h" PageLisp::PageLisp(QWidget *parent) : QWidget(parent), @@ -345,6 +346,12 @@ void PageLisp::makeEditorConnections(ScriptEditor *editor) setEditorClean(editor); }); + connect(editor->codeEditor(), &QCodeEditor::runEmbeddedTriggered, [this]() { + on_uploadButton_clicked(); + }); + connect(editor->codeEditor(), &QCodeEditor::stopTriggered, [this]() { + on_stopButton_clicked(); + }); } void PageLisp::createEditorTab(QString fileName, QString content) @@ -773,3 +780,21 @@ void PageLisp::on_rescaleButton_clicked() ui->bindingPlot->rescaleAxes(); ui->bindingPlot->replotWhenVisible(); } + +void PageLisp::on_helpButton_clicked() +{ + QString html = "VESC Lisp Editor. For documentation, go to
" + "https://github.com/vedderb/bldc/blob/master/lispBM/README.md

" + "Keyboard Commands
" + "Ctrl + '+' : Increase font size
" + "Ctrl + '-' : Decrease font size
" + "Ctrl + space : Show auto-complete suggestions
" + "Ctrl + '/' : Toggle auto-comment on line or block
" + "Ctrl + 'f' : Open search (and replace) bar
" + "Ctrl + 'e' : Upload (and run if set) application
" + "Ctrl + 'q' : Stop application
" + "Ctrl + 'd' : Clear console
" + "Ctrl + 's' : Save file
"; + + HelpDialog::showHelpMonospace(this, "VESC Tool Script Editor", html.replace(" "," ")); +} diff --git a/pages/pagelisp.h b/pages/pagelisp.h index 03aad9b39..abba3ab74 100644 --- a/pages/pagelisp.h +++ b/pages/pagelisp.h @@ -53,6 +53,7 @@ private slots: void on_readExistingButton_clicked(); void on_eraseButton_clicked(); void on_rescaleButton_clicked(); + void on_helpButton_clicked(); private: Ui::PageLisp *ui; diff --git a/pages/pagelisp.ui b/pages/pagelisp.ui index 309099d28..bde607251 100644 --- a/pages/pagelisp.ui +++ b/pages/pagelisp.ui @@ -35,6 +35,9 @@
+ + Erase lisp application from VESC. This will also prevent it from starting on next boot (as expected). + Erase @@ -140,7 +143,7 @@
- + diff --git a/vesc_tool.pro b/vesc_tool.pro index 54635a370..87083ff9a 100644 --- a/vesc_tool.pro +++ b/vesc_tool.pro @@ -10,7 +10,7 @@ VT_INTRO_VERSION = 1 VT_CONFIG_VERSION = 2 # Set to 0 for stable versions and to test version number for development versions. -VT_IS_TEST_VERSION = 2 +VT_IS_TEST_VERSION = 3 VT_ANDROID_VERSION_ARMV7 = 98 VT_ANDROID_VERSION_ARM64 = 99 From 457303c60dd7a8c1e8a23f62df404cb221394930 Mon Sep 17 00:00:00 2001 From: jaykup26 Date: Thu, 3 Feb 2022 21:07:58 -0600 Subject: [PATCH 019/559] Fixed firmware version dropping the zero --- pages/pagefirmware.cpp | 2 +- vescinterface.cpp | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/pages/pagefirmware.cpp b/pages/pagefirmware.cpp index f0d182e70..e5a728060 100755 --- a/pages/pagefirmware.cpp +++ b/pages/pagefirmware.cpp @@ -159,7 +159,7 @@ void PageFirmware::fwRxChanged(bool rx, bool limited) } if (params.major >= 0) { - fwStr = QString("Fw: %1.%2").arg(params.major).arg(params.minor); + fwStr = QString("Fw: %1.%2").arg(params.major).arg(params.minor, 2, 10, QLatin1Char('0')); if (!params.hw.isEmpty()) { fwStr += ", Hw: " + params.hw; } diff --git a/vescinterface.cpp b/vescinterface.cpp index 8dbfe6810..96334f854 100755 --- a/vescinterface.cpp +++ b/vescinterface.cpp @@ -505,7 +505,7 @@ QStringList VescInterface::getSupportedFirmwares() QStringList fws; for (int i = 0;i < fwPairs.size();i++) { - fws.append(QString("%1.%2").arg(fwPairs.at(i).first).arg(fwPairs.at(i).second)); + fws.append(QString("%1.%2").arg(fwPairs.at(i).first).arg(fwPairs.at(i).second, 2, 10, QLatin1Char('0'))); } return fws; } From 190772030c364403e64672b017a802feff73525d Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Fri, 4 Feb 2022 03:42:17 +0000 Subject: [PATCH 020/559] @jaykup26 has signed the CLA from Pull Request #207 --- signatures/version1/cla.json | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/signatures/version1/cla.json b/signatures/version1/cla.json index 3ff6d6e94..58d9d9fed 100644 --- a/signatures/version1/cla.json +++ b/signatures/version1/cla.json @@ -31,6 +31,14 @@ "created_at": "2022-01-05T15:14:58Z", "repoId": 102395117, "pullRequestNo": 200 + }, + { + "name": "jaykup26", + "id": 628881, + "comment_id": 1029608426, + "created_at": "2022-02-04T03:42:03Z", + "repoId": 102395117, + "pullRequestNo": 207 } ] } \ No newline at end of file From cf67527c97fdba850f1490b9233701d41175ac9b Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Sat, 5 Feb 2022 01:08:49 +0100 Subject: [PATCH 021/559] Name and pin set support --- QCodeEditor/resources/languages/qml.xml | 2 + QCodeEditor/src/internal/QVescCompleter.cpp | 2 + commands.cpp | 22 +++ commands.h | 3 + datatypes.h | 6 + mobile/BleSetupDialog.qml | 179 ++++++++++++++++++++ mobile/StartPage.qml | 13 +- mobile/qml.qrc | 1 + pages/pagefirmware.cpp | 5 + pages/pagewelcome.cpp | 6 + pages/pagewelcome.h | 1 + pages/pagewelcome.ui | 79 +++++---- res/qml/WelcomeQmlPanel.qml | 22 +++ 13 files changed, 307 insertions(+), 34 deletions(-) create mode 100644 mobile/BleSetupDialog.qml diff --git a/QCodeEditor/resources/languages/qml.xml b/QCodeEditor/resources/languages/qml.xml index 5e0037ce8..8b6acfb6e 100644 --- a/QCodeEditor/resources/languages/qml.xml +++ b/QCodeEditor/resources/languages/qml.xml @@ -116,5 +116,7 @@ ApplicationWindow ProgressBar Gamepad + TextArea + TextInput diff --git a/QCodeEditor/src/internal/QVescCompleter.cpp b/QCodeEditor/src/internal/QVescCompleter.cpp index 64bc5f273..44fa374c6 100644 --- a/QCodeEditor/src/internal/QVescCompleter.cpp +++ b/QCodeEditor/src/internal/QVescCompleter.cpp @@ -94,6 +94,8 @@ QVescCompleter::QVescCompleter(QObject *parent) : addItem("emitPlotSetGraph(graph)"); addItem("getStats(mask)"); addItem("getImuData(mask)"); + addItem("setBleName(name)"); + addItem("setBlePin(pin)"); level--; }; diff --git a/commands.cpp b/commands.cpp index 69d218008..e3c1e0ff7 100755 --- a/commands.cpp +++ b/commands.cpp @@ -146,6 +146,12 @@ void Commands::processPacket(QByteArray data) params.qmlAppFullscreen = qmlApp == 2; } + if (vb.size() >= 1) { + auto nrfFlags = vb.vbPopFrontUint8(); + params.nrfNameSupported = nrfFlags & 1; + params.nrfPinSupported = nrfFlags & 2; + } + emit fwVersionReceived(params); } break; @@ -2042,6 +2048,22 @@ void Commands::lispGetStats() emitData(vb); } +void Commands::setBleName(QString name) +{ + VByteArray vb; + vb.vbAppendUint8(COMM_SET_BLE_NAME); + vb.vbAppendString(name); + emitData(vb); +} + +void Commands::setBlePin(QString pin) +{ + VByteArray vb; + vb.vbAppendUint8(COMM_SET_BLE_PIN); + vb.vbAppendString(pin); + emitData(vb); +} + void Commands::timerSlot() { if (mTimeoutFwVer > 0) mTimeoutFwVer--; diff --git a/commands.h b/commands.h index 54725222e..e2264f3dd 100644 --- a/commands.h +++ b/commands.h @@ -247,6 +247,9 @@ public slots: void lispSetRunning(bool running); void lispGetStats(); + void setBleName(QString name); + void setBlePin(QString pin); + private slots: void timerSlot(); diff --git a/datatypes.h b/datatypes.h index f9d07b843..ad3166e2c 100644 --- a/datatypes.h +++ b/datatypes.h @@ -574,6 +574,8 @@ struct FW_RX_PARAMS { Q_PROPERTY(bool qmlHwFullscreen MEMBER qmlHwFullscreen) Q_PROPERTY(bool hasQmlApp MEMBER hasQmlApp) Q_PROPERTY(bool qmlAppFullscreen MEMBER qmlAppFullscreen) + Q_PROPERTY(bool nrfNameSupported MEMBER nrfNameSupported) + Q_PROPERTY(bool nrfPinSupported MEMBER nrfPinSupported) public: FW_RX_PARAMS() { @@ -588,6 +590,8 @@ struct FW_RX_PARAMS { qmlHwFullscreen = false; hasQmlApp = false; qmlAppFullscreen = false; + nrfNameSupported = false; + nrfPinSupported = false; } Q_INVOKABLE QString hwTypeStr() { @@ -622,6 +626,8 @@ struct FW_RX_PARAMS { bool qmlHwFullscreen; bool hasQmlApp; bool qmlAppFullscreen; + bool nrfNameSupported; + bool nrfPinSupported; }; diff --git a/mobile/BleSetupDialog.qml b/mobile/BleSetupDialog.qml new file mode 100644 index 000000000..67faf77f0 --- /dev/null +++ b/mobile/BleSetupDialog.qml @@ -0,0 +1,179 @@ +/* + Copyright 2022 Benjamin Vedder benjamin@vedder.se + + This file is part of VESC Tool. + + VESC Tool is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + VESC Tool is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . + */ + +import QtQuick 2.7 +import QtQuick.Controls 2.10 +import QtQuick.Layouts 1.3 + +import Vedder.vesc.vescinterface 1.0 +import Vedder.vesc.commands 1.0 +import Vedder.vesc.configparams 1.0 +import Vedder.vesc.utility 1.0 + +Item { + property var dialogParent: ApplicationWindow.overlay + property Commands mCommands: VescIf.commands() + + function openDialog() { + dialog.open() + } + + Dialog { + title: "BLE Module Setup" + + id: dialog + modal: true + focus: true + width: parent.width - 20 - notchLeft - notchRight + closePolicy: Popup.CloseOnEscape + x: (parent.width - width)/2 + y: parent.height / 2 - height / 2 + notchTop + parent: dialogParent + padding: 10 + + Overlay.modal: Rectangle { + color: "#AA000000" + } + + ColumnLayout { + anchors.fill: parent + + RowLayout { + Layout.fillWidth: true + + Rectangle { + enabled: useNameBox.checked + + Layout.fillWidth: true + height: nameInput.implicitHeight + 14 + border.width: 2 + border.color: enabled ? Utility.getAppHexColor("midAccent") : Utility.getAppHexColor("disabledText") + color: "#33a8a8a8" + radius: 3 + TextInput { + id: nameInput + color: Utility.getAppHexColor("lightText") + anchors.fill: parent + anchors.margins: 7 + font.pointSize: 12 + maximumLength: 25 + focus: true + } + } + + CheckBox { + id: useNameBox + checked: true + text: "Update Name" + } + } + + RowLayout { + Layout.fillWidth: true + Rectangle { + enabled: usePinBox.checked + Layout.fillWidth: true + height: pinInput.implicitHeight + 14 + border.width: 2 + border.color: enabled ? Utility.getAppHexColor("midAccent") : Utility.getAppHexColor("disabledText") + color: "#33a8a8a8" + radius: 3 + TextInput { + id: pinInput + color: Utility.getAppHexColor("lightText") + anchors.fill: parent + anchors.margins: 7 + font.pointSize: 12 + validator: IntValidator {bottom: 0; top: 999999} + maximumLength: 6 + focus: true + } + } + + CheckBox { + id: usePinBox + checked: true + Layout.preferredWidth: useNameBox.width + text: "Update Pin\nUse 6 digits" + } + } + + Button { + Layout.fillWidth: true + text: "Apply && Reset NRF" + visible: useNameBox.checked || usePinBox.checked + onClicked: { + if (!VescIf.isPortConnected()) { + VescIf.emitMessageDialog("BLE Setup", "Not Connected", false, false) + dialog.close() + return; + } + + var msg = "" + + var nameTxt = "" + if (useNameBox.checked) { + nameTxt = nameInput.text + + if (nameTxt.length >= 2) { + msg += "New Name: " + nameTxt + "\n" + } else { + msg += "Name reset to default value.\n" + } + + mCommands.setBleName(nameTxt) + } + + var pinTxt = "" + if (usePinBox.checked) { + pinTxt = pinInput.text + if (pinTxt.length > 0) { + while(pinTxt.length < 6) { + pinTxt = "0" + pinTxt + } + } + + if (pinTxt.length > 0) { + msg += "New Pin : " + pinTxt + "\n" + } else { + msg += "Pin code disabled.\n" + } + + mCommands.setBlePin(pinTxt) + } + + if (msg.length > 0) { + VescIf.emitMessageDialog("BLE Setup", msg, true, false) + } + + dialog.close() + } + } + + Button { + Layout.fillWidth: true + text: "Cancel" + + onClicked: { + dialog.close() + } + } + } + } +} diff --git a/mobile/StartPage.qml b/mobile/StartPage.qml index 767c3e2fb..fbb447f69 100644 --- a/mobile/StartPage.qml +++ b/mobile/StartPage.qml @@ -267,11 +267,16 @@ Item { Layout.preferredWidth: 500 Layout.preferredHeight: 80 - buttonText: "Pair\nBLE" + buttonText: "Setup\nBluetooth\nModule" imageSrc: "qrc" + Utility.getThemePath() + "icons/bluetooth.png" onClicked: { - pairDialog.openDialog() + if (VescIf.getLastFwRxParams().nrfNameSupported && + VescIf.getLastFwRxParams().nrfPinSupported) { + bleSetupDialog.openDialog() + } else { + pairDialog.openDialog() + } } } @@ -325,7 +330,9 @@ Item { id: pairDialog } - + BleSetupDialog { + id: bleSetupDialog + } Connections { target: mCommands diff --git a/mobile/qml.qrc b/mobile/qml.qrc index 398505ca3..05fe7e458 100644 --- a/mobile/qml.qrc +++ b/mobile/qml.qrc @@ -55,5 +55,6 @@ MultiSettings.qml CanScreen.qml StatPage.qml + BleSetupDialog.qml diff --git a/pages/pagefirmware.cpp b/pages/pagefirmware.cpp index e5a728060..7d3bb607c 100755 --- a/pages/pagefirmware.cpp +++ b/pages/pagefirmware.cpp @@ -184,6 +184,11 @@ void PageFirmware::fwRxChanged(bool rx, bool limited) fwStr += params.hasPhaseFilters ? "Yes" : "No"; } + fwStr += "\nNRF Name: "; + fwStr += (params.nrfNameSupported ? "Yes" : "No"); + fwStr += ", Pin: "; + fwStr += (params.nrfPinSupported ? "Yes" : "No"); + ui->currentLabel->setText(fwStr); updateHwList(params); updateBlList(params); diff --git a/pages/pagewelcome.cpp b/pages/pagewelcome.cpp index dc103941b..83e18a563 100755 --- a/pages/pagewelcome.cpp +++ b/pages/pagewelcome.cpp @@ -43,6 +43,7 @@ PageWelcome::PageWelcome(QWidget *parent) : ui->nrfPairButton->setIcon(QIcon(theme + "icons/icons8-fantasy-96.png")); ui->multiSettingButton->setIcon(QIcon(theme + "icons/Settings-96.png")); ui->invertDirButton->setIcon(QIcon(theme + "icons/Process-96.png")); + ui->setupBluetoothButton->setIcon(QIcon(theme + "icons/bluetooth.png")); layout()->setContentsMargins(0, 0, 0, 0); mVesc = nullptr; @@ -124,3 +125,8 @@ void PageWelcome::on_nrfPairButton_clicked() { QMetaObject::invokeMethod(ui->qmlWidget->rootObject(), "nrfQuickPair"); } + +void PageWelcome::on_setupBluetoothButton_clicked() +{ + QMetaObject::invokeMethod(ui->qmlWidget->rootObject(), "openBleSetup"); +} diff --git a/pages/pagewelcome.h b/pages/pagewelcome.h index d6cfaf54a..a58afbfd3 100644 --- a/pages/pagewelcome.h +++ b/pages/pagewelcome.h @@ -49,6 +49,7 @@ public slots: private slots: void on_autoConnectButton_clicked(); void on_nrfPairButton_clicked(); + void on_setupBluetoothButton_clicked(); private: Ui::PageWelcome *ui; diff --git a/pages/pagewelcome.ui b/pages/pagewelcome.ui index eac92c9c5..30720cb41 100644 --- a/pages/pagewelcome.ui +++ b/pages/pagewelcome.ui @@ -6,8 +6,8 @@ 0 0 - 1450 - 499 + 1506 + 785 @@ -54,14 +54,14 @@ Quick Configuration - - + + - NRF Quick Pair + Multi Settings - :/res/icons/icons8-fantasy-96.png:/res/icons/icons8-fantasy-96.png + :/res/icons/Settings-96.png:/res/icons/Settings-96.png @@ -71,17 +71,14 @@ - - - - Automatically connect to the VESC using the USB connection. - + + - AutoConnect + Setup Bluetooth Module - :/res/icons/Connected-96.png:/res/icons/Connected-96.png + :/res/icons/bluetooth.png:/res/icons/bluetooth.png @@ -91,17 +88,14 @@ - - - - Simple FOC setup for all VESCs on CAN-bus - + + - Setup Motors FOC + Invert Motor Directions - :/res/icons/Wizard-96.png:/res/icons/Wizard-96.png + :/res/icons/Process-96.png:/res/icons/Process-96.png @@ -109,12 +103,26 @@ 45 - - false + + + + + + NRF Quick Pair + + + + :/res/icons/icons8-fantasy-96.png:/res/icons/icons8-fantasy-96.png + + + + 45 + 45 + - + Setup Input @@ -134,14 +142,17 @@ - - + + + + Simple FOC setup for all VESCs on CAN-bus + - Multi Settings + Setup Motors FOC - :/res/icons/Settings-96.png:/res/icons/Settings-96.png + :/res/icons/Wizard-96.png:/res/icons/Wizard-96.png @@ -149,16 +160,22 @@ 45 + + false + - - + + + + Automatically connect to the VESC using the USB connection. + - Invert Motor Directions + AutoConnect - :/res/icons/Process-96.png:/res/icons/Process-96.png + :/res/icons/Connected-96.png:/res/icons/Connected-96.png diff --git a/res/qml/WelcomeQmlPanel.qml b/res/qml/WelcomeQmlPanel.qml index b752d8aa6..4e063a626 100644 --- a/res/qml/WelcomeQmlPanel.qml +++ b/res/qml/WelcomeQmlPanel.qml @@ -74,6 +74,23 @@ Item { multiSettings.openDialog() } + function openBleSetup() { + if (!VescIf.isPortConnected()) { + VescIf.emitMessageDialog("BLE Setup", + "You are not connected to the VESC.", false, false) + } else { + if (VescIf.getLastFwRxParams().nrfNameSupported && + VescIf.getLastFwRxParams().nrfPinSupported) { + bleSetupDialog.openDialog() + } else { + VescIf.emitMessageDialog("BLE Setup", + "The BLE module does not support setup. You can try " + + "updating the firmware on it from the SWD programmer page.", + false, false) + } + } + } + SetupWizardFoc { id: focWizard dialogParent: container @@ -84,6 +101,11 @@ Item { dialogParent: container } + BleSetupDialog { + id: bleSetupDialog + dialogParent: container + } + Dialog { id: directionSetupDialog title: "Direction Setup" From 642c735f40c7a1b0854828fc3155e7a5dc0f3eac Mon Sep 17 00:00:00 2001 From: Benjamin Vedder Date: Sat, 5 Feb 2022 19:12:35 +0100 Subject: [PATCH 022/559] Added 60_75 and 75_600 --- pages/pageswdprog.cpp | 4 ++++ res/firmwares/60_75/VESC_default.bin | Bin 0 -> 524280 bytes .../60_75/VESC_default_no_hw_limits.bin | Bin 0 -> 524280 bytes res/firmwares/75_600/VESC_default.bin | Bin 0 -> 524280 bytes .../75_600/VESC_default_no_hw_limits.bin | Bin 0 -> 524280 bytes res_fw.qrc | 4 ++++ 6 files changed, 8 insertions(+) create mode 100755 res/firmwares/60_75/VESC_default.bin create mode 100755 res/firmwares/60_75/VESC_default_no_hw_limits.bin create mode 100755 res/firmwares/75_600/VESC_default.bin create mode 100755 res/firmwares/75_600/VESC_default_no_hw_limits.bin diff --git a/pages/pageswdprog.cpp b/pages/pageswdprog.cpp index a5d9710e7..59a1b6a63 100644 --- a/pages/pageswdprog.cpp +++ b/pages/pageswdprog.cpp @@ -541,12 +541,16 @@ void PageSwdProg::bmConnRes(int res) 0, ":/res/bootloaders/generic.bin"); addSwdFw("VESC 100/500", "://res/firmwares/100_500/VESC_default.bin", 0, "://res/bootloaders/60_o_75_300_o_HD60_o_UAVC_OMEGA_o_75_300_R2_o_60_MK3_o_100_250_o_75_300_R3_o_60_MK4_o_60_MK5_o_HD75.bin"); + addSwdFw("VESC 75/600", "://res/firmwares/75_600/VESC_default.bin", + 0, "://res/bootloaders/60_o_75_300_o_HD60_o_UAVC_OMEGA_o_75_300_R2_o_60_MK3_o_100_250_o_75_300_R3_o_60_MK4_o_60_MK5_o_HD75.bin"); addSwdFw("STORMCORE 60Dxs", ":/res/firmwares/STORMCORE_60Dxs/VESC_default.bin", 0, ":/res/bootloaders/generic.bin"); addSwdFw("STORMCORE 100DX", ":/res/firmwares/STORMCORE_100Dx/VESC_default.bin", 0, ":/res/bootloaders/generic.bin"); addSwdFw("VESC 60v2 Alva", ":/res/firmwares/60v2_alva/VESC_default.bin", 0, ":/res/bootloaders/generic.bin"); + addSwdFw("VESC 60 75V", ":/res/firmwares/60_75/VESC_default.bin", + 0, ":/res/bootloaders/generic.bin"); break; case 2: diff --git a/res/firmwares/60_75/VESC_default.bin b/res/firmwares/60_75/VESC_default.bin new file mode 100755 index 0000000000000000000000000000000000000000..4e322cfc63c61a520766120305c4bff898f57194 GIT binary patch literal 524280 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