meta data for this page
Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
en:controller:setup [2021/10/28 13:34] dmitry |
en:controller:setup [2023/06/01 12:34] dmitry [Motor temperature sensor] |
||
---|---|---|---|
Line 1: | Line 1: | ||
~~Title: Controller setup~~ | ~~Title: Controller setup~~ | ||
- | ====== Controller (v.0.8) ====== | + | ====== Controller (v.0.8.9) ====== |
The controller allows you to control BLDC (Brushless Direct Current Motor) and PMSM (Permanent Magnet Synchronous Motor) electric motors. At the moment we are producing three types of controllers for different motors power. | The controller allows you to control BLDC (Brushless Direct Current Motor) and PMSM (Permanent Magnet Synchronous Motor) electric motors. At the moment we are producing three types of controllers for different motors power. | ||
Line 8: | Line 8: | ||
^ Parameters | ^ Parameters | ||
- | ^Maximum power| | + | ^Maximum power| |
^Nominal power| | ^Nominal power| | ||
- | ^Voltage range| | + | ^Voltage range| |
^Phase current, max| 120A | 250А | 500А | | ^Phase current, max| 120A | 250А | 500А | | ||
- | ^Battery current, max| | + | ^Battery current, max| 90A | 150A | |
^Supply out| 12В 3A ||| | ^Supply out| 12В 3A ||| | ||
^Operating temperature range| | ^Operating temperature range| | ||
Line 23: | Line 23: | ||
^Sleep current less| < | ^Sleep current less| < | ||
^Protection class| | ^Protection class| | ||
- | ^Size, without wires| | + | ^Size, without wires| |
^Weight| | ^Weight| | ||
^Warranty| | ^Warranty| | ||
Line 29: | Line 29: | ||
//In the kit: // | //In the kit: // | ||
- | | + | * CAN-cable 1,2-meters length for connection to the On-board Computer. |
- | * Phase wires.\\ | + | * Phase wires. |
- | * Battery wires\\ | + | * Battery wires |
* Hall sensors wire. | * Hall sensors wire. | ||
Line 38: | Line 38: | ||
// | // | ||
- | * САN-cables 0,3 and 2 meters length.\\ | + | * САN-cables 0,3 and 2 meters length. |
- | * Controller-side inputs for connection throttle, brakes levers directly to the Controller.\\ | + | * Controller-side inputs for connection throttle, brakes levers directly to the Controller. |
- | * PWM/PAS wire for connection PAS, fans for cooling or brake lights.\\ | + | * PWM/PAS wire for connection PAS, fans for cooling or brake lights. |
===== Connection diagram ===== | ===== Connection diagram ===== | ||
Line 48: | Line 49: | ||
When the power is turned on for the first time, the controller will start automatically. To enable/ | When the power is turned on for the first time, the controller will start automatically. To enable/ | ||
- | You can find the wiring diagrams of the other devices on this [[https://drive.google.com/ | + | You can find the wiring diagrams of the other devices on this [[https://bit.ly/3zPIYvn|link]]. By default, all peripherals (throttle, brake, switches, etc.) are connected into ports located on the backside of **[[en: |
If you want to connect peripherals directly to the Controller, you need to order " | If you want to connect peripherals directly to the Controller, you need to order " | ||
Line 88: | Line 89: | ||
===== Auto-setup ===== | ===== Auto-setup ===== | ||
- | The auto-setup function in the **Controller** > **Auto-setup** menu section allows you to automatically set up the electric motor, throttle, and brake levers. | + | The auto-setup function in the **Controller** > **Auto-setup** menu section allows you to automatically set up the electric motor, throttle, and brake levers. If the throttle and brake levers are connected to the On-board computer, then they must be configured in [[en: |
{{: | {{: | ||
Line 104: | Line 105: | ||
If you have a throttle lever and an analog brake connected, then you need to enable Full Setup, and follow the instructions on the On-Board computer screen. The corresponding menu items will indicate when to press and release the throttle or brake lever. | If you have a throttle lever and an analog brake connected, then you need to enable Full Setup, and follow the instructions on the On-Board computer screen. The corresponding menu items will indicate when to press and release the throttle or brake lever. | ||
- | If only one throttle lever is connected, you must independently turn on the items step-by-step: | + | If only one throttle lever is connected, you must independently turn on the items step-by-step: |
If the motor is heavy and autodetect does not happen, you can gently push it with your hand or increase the tuning current in the **Controller** > **Auto-setup** > **Setup current** section, for example, twice. The setup current can be selected in the range from **2A** to **50A**, in increments of **1A**. | If the motor is heavy and autodetect does not happen, you can gently push it with your hand or increase the tuning current in the **Controller** > **Auto-setup** > **Setup current** section, for example, twice. The setup current can be selected in the range from **2A** to **50A**, in increments of **1A**. | ||
Line 114: | Line 115: | ||
===== Firmware update ===== | ===== Firmware update ===== | ||
- | In the menu section **Controller** > **Settings and Update**, you can update the Controller' | + | In the menu section **Controller** > **Update |
{{: | {{: | ||
Line 151: | Line 152: | ||
**Power** — maximum power (discharge) of the battery, in kilowatts (**kW**). Select of values from **0.00kW** to **30.0kW**, in increments of **0.1kW**. Set to 0.0kW to disable the power limiting limit.\\ | **Power** — maximum power (discharge) of the battery, in kilowatts (**kW**). Select of values from **0.00kW** to **30.0kW**, in increments of **0.1kW**. Set to 0.0kW to disable the power limiting limit.\\ | ||
- | **Speed** — maximum speed in percentage (%). Select of values from **4%** to **150%**, in increments of **2%**. The value of this parameter determines the percentage of speed depending on the reference speed (see section **[[en: | + | **Speed** — maximum speed in percentage (%). Select of values from **4%** to **150%**, in increments of **2%**. The value of this parameter determines the percentage of speed depending on the reference speed (see section **[[en: |
==== Electric brake setup ==== | ==== Electric brake setup ==== | ||
- | **Braking phase** — the value of the phase current of braking by the motor, in Amperes (**A**). Select of values from **0A** to **500A**, in increments of **2A**. For braking to zero, it is recommended to enable **Active braking** in the section **Controller** > **Control**. When using the switch brake, lower brake current change speed makes recuperation more smooth. \\ | + | **Braking phase** — the value of the phase current of braking by the motor, in Amperes (**A**). Select of values from **0A** to **500A**, in increments of **2A**. For braking to zero, it is recommended to enable **Active braking** in the section **Controller** > **Control**. When using limit switches on mechanical brakes, lower brake current change speed makes recuperation more smooth. \\ |
==== Braking phase at speed control ==== | ==== Braking phase at speed control ==== | ||
Line 179: | Line 180: | ||
==== Field weakening setup ==== | ==== Field weakening setup ==== | ||
- | **Field weakening** — the magnitude of the field weakening current, in Amperes (**A**). Select of values from **0A** to **500A**, | + | **Field weakening** — the magnitude of the field weakening current, in Amperes (**A**). Select of values from **0A** to **500A**, in increments of **2A**. This setting allows you to increase the maximum motor speed and depends on the supply voltage, in any case, the speed will be no more than the maximum supply voltage (**Vmax**) of the controller (**95V limit**).< |
- | + | The current of weakening creates a field that acts against the field of the permanent magnets. The superposition of these fields creates an equivalent field that is below nominal. The attenuation efficiency depends on the parameters of the motor. The best results can be obtained with IPM motors. </ | |
- | <WRAP center round info 60%>\\ | + | \\ |
- | The current of weakening creates a field that acts against the field of the permanent magnets. The superposition of these fields creates an equivalent field that is below nominal. The attenuation efficiency depends on the parameters of the motor. The best results can be obtained with IPM motors. | + | <WRAP center round warning 60%> |
- | </ | + | |
To set up the weakening, you need: | To set up the weakening, you need: | ||
- | * for one of the control modes in the section **Controller** > **Control modes** specify a speed value greater than 100%, for example, Speed 3 is 120%. | ||
- | * set the weakening current value in the section **Controller** > **Control modes**, you can start from 30A.\\ | ||
- | Field weakening is activated when the maximum speed is reached, the Controller adds weakening current, limiting the phase current and weakening current specified in the control mode. That is if the effective phase current is 70A, and the weakening current is set to 30A, then a minimum of 100A must be specified in the phase current settings. If the phase current increases to 80A, then only 20A will remain for weakening because 80A + 20A = 100A.\\ | + | * for one of the control modes in the section **Controller** |
+ | * set the weakening current value in the section **Controller** | ||
+ | |||
+ | Field weakening is activated when the maximum speed is reached, the Controller adds weakening current, limiting the phase current and weakening current specified in the control mode. That is if the effective phase current is 70A, and the weakening current is set to 30A, then a minimum of 100A must be specified in the phase current settings. If the phase current increases to 80A, then only 20A will remain for weakening because 80A + 20A = 100A. | ||
+ | |||
+ | Also, the Controller will limit the speed of rotation of the motor so that its effective EMF does not exceed the maximum supply voltage of the controller (not the battery). If the motor starts twitching on the suspended wheel, then it is necessary to reduce the weakening current. | ||
- | Also, the Controller will limit the speed of rotation of the motor so that its effective EMF does not exceed the maximum supply voltage of the controller (not the battery). If the motor starts twitching on the suspended wheel, then it is necessary to reduce the weakening current.\\ | ||
==== Current change speed ==== | ==== Current change speed ==== | ||
Line 219: | Line 221: | ||
**Acceleration lim.** and **Deceleration lim.** — are specified in ERPM/s, select of values from **0 ERPM/s** to **500000 ERPM/s**, in increments of **200 ERPM/s **. These settings allow you to limit the speed of acceleration or deceleration of the motor, it is convenient to use on slippery surfaces. For setting go to the **Controller** > **Status flags** section, in this menu there are two parameters that register the maximum acceleration and deceleration — **Max acceleration** and **Max deceleration**. **Reset** the values of these parameters in the same section of the menu, then you need to ride your e-bike in order to register the current dynamics of acceleration and deceleration. You can use these values as a reference and decrease them if you need to limit change speed. If the type of surface changes, for example, it becomes too slippery, then these values can be reduced until it becomes comfortable to catch the moment when the wheel loses traction. \\ | **Acceleration lim.** and **Deceleration lim.** — are specified in ERPM/s, select of values from **0 ERPM/s** to **500000 ERPM/s**, in increments of **200 ERPM/s **. These settings allow you to limit the speed of acceleration or deceleration of the motor, it is convenient to use on slippery surfaces. For setting go to the **Controller** > **Status flags** section, in this menu there are two parameters that register the maximum acceleration and deceleration — **Max acceleration** and **Max deceleration**. **Reset** the values of these parameters in the same section of the menu, then you need to ride your e-bike in order to register the current dynamics of acceleration and deceleration. You can use these values as a reference and decrease them if you need to limit change speed. If the type of surface changes, for example, it becomes too slippery, then these values can be reduced until it becomes comfortable to catch the moment when the wheel loses traction. \\ | ||
+ | |||
+ | **Braking phase** — the value of the phase current of braking by the motor, in Amperes (A). Select of values from **0A** to **500A**, in increments of **2A**. For braking to zero, it is recommended to enable Active braking in the section **Controller** > **Control**. When using limit switches on mechanical brakes, lower brake current change speed makes recuperation more smooth. | ||
**Braking ph. at 0% throttle** — phase braking current with the throttle handle released, in Amperes (A). Select of values from **0A** to **500A**, in increments of **2A**. This function allows regenerative braking to be initiated when the throttle is released. If **0A** is specified or additional modes are disabled in the **Controller** > **Advanced modes** section of the menu, then for the recuperation level will be used value from menu item in the **Controller** > **Control modes** > **Braking ph. at 0% throttle** menu item. | **Braking ph. at 0% throttle** — phase braking current with the throttle handle released, in Amperes (A). Select of values from **0A** to **500A**, in increments of **2A**. This function allows regenerative braking to be initiated when the throttle is released. If **0A** is specified or additional modes are disabled in the **Controller** > **Advanced modes** section of the menu, then for the recuperation level will be used value from menu item in the **Controller** > **Control modes** > **Braking ph. at 0% throttle** menu item. | ||
Line 388: | Line 392: | ||
The menu item **Controller** > **Control** > **Throttle mode** you can set up throttle lever mode. | The menu item **Controller** > **Control** > **Throttle mode** you can set up throttle lever mode. | ||
- | {{: | + | {{: |
Three throttle modes options are available: | Three throttle modes options are available: | ||
**Speed** — a similar mode is used in Infineon controllers and non-programmable low-cost controllers and is characterized by the use of maximum current to reach a given speed. In this mode, the maximum thrust is used until the desired speed is reached, the thrust is not regulated by the throttle grip. \\ | **Speed** — a similar mode is used in Infineon controllers and non-programmable low-cost controllers and is characterized by the use of maximum current to reach a given speed. In this mode, the maximum thrust is used until the desired speed is reached, the thrust is not regulated by the throttle grip. \\ | ||
**Torque** — in this mode, the throttle controls phase current, the thrust is limited by the angle of rotation of the throttle. \\ | **Torque** — in this mode, the throttle controls phase current, the thrust is limited by the angle of rotation of the throttle. \\ | ||
- | **Speed+torque** — combined mode (as Kelly), similar to the operation of the gas pedal in a car with an internal combustion engine. \\ | + | **Speed+torque** — combined mode (as Kelly), similar to the operation of the gas pedal in a car with an internal combustion engine. In the case of selecting the **Speed+torque** mode, pressing the throttle to 50%, when achieved 50% speed, the current consumption will be reduced to hold speed. The acceleration current will also be proportionally lower. \\ |
+ | **Power** — in this mode, you can fine-tune the consumption from the battery using the throttle. \\ | ||
+ | |||
+ | **Adaptive throttle** — this function allows you to more accurately dose throttle at high speed when the battery current in the settings is several times lower than the phase current. \\ | ||
- | In the case of selecting the **Speed+torque** mode, pressing throttle to 50%, when achieved 50% speed, the current consumption will be reduced to hold speed. The acceleration current will also be proportionally lower. \\ | ||
==== Throttle and brake voltage range setup ==== | ==== Throttle and brake voltage range setup ==== | ||
Line 437: | Line 444: | ||
===== Motor setup ===== | ===== Motor setup ===== | ||
- | The **Controller** > **Motor Setup** menu contains all settings related to electric motor operation parameters. | + | The **Controller** |
==== Motor temperature sensor ==== | ==== Motor temperature sensor ==== | ||
- | In the menu section **Controller** > **Motor setup** > **Motor t°-sensor** you can select a temperature range in which a smooth power limit will occur (**Delta °t** parameter) and specify the maximum temperature (**°t max**). | + | In the menu section **Controller** |
- | {{: | + | {{: |
- | **°t max** — maximum electric motor temperature, | + | **°t max** — maximum electric motor temperature, |
- | **Delta °t** — the temperature value that is deducted from the maximum temperature (**°t max**), the resulting temperature value will be the beginning of the power limit, in degrees Celsius (°C). Select of values from **1°C** to **100°C**, in increments of **1 °C**. \\ | + | |
+ | In the menu item **Sensor type** | ||
+ | |||
+ | It is recommended to install a temperature sensor so close as possible on the stator windings, while not in contact with the stator iron. If you don't know what kind of sensor is in the motor, you can check all types of sensors and select the one that displays data the most closely to room temperature. The current measured temperature is displayed at **# Value °t**. | ||
+ | |||
+ | The **# °t resistance** | ||
+ | |||
+ | **Resistance Offset** — temperature sensor offset, in Ohms. Select values from -100 Ohm to 100 Ohm, in increments of 1 Ohm. \\ | ||
+ | **Temperature correction** — temperature sensor correction with wire resistance. Select values On or Off. \\ | ||
+ | **GND wire resistance** — resistance of a ground wire, in Ohms. Select values from 0 Ohm to 1000 Ohm, in increments of 1 Ohm. \\ | ||
+ | **Sensors current** — hall sensor current consumption, | ||
+ | **# Total current:** — calculated current, to check with a tester, in mA. | ||
- | In the menu item **Sensor type** you can select the following types of temperature sensors that support the controller — **KTY81(82)**, | ||
- | It is recommended to install a temperature sensor so close as possible on the stator windings, while not in contact with the stator iron. If you don't know what kind of sensor is in the motor, you can check all types of sensors and select the one that displays data the most closely to room temperature. The current measured temperature is displayed at **# Value °t #**. \\ | ||
- | The **# °t R (+-10%)#** menu item displays the resistance of the motor temperature sensor, with an accuracy of +/-10%. | ||
==== Clutch ==== | ==== Clutch ==== | ||
- | In the menu section **Controller** > **Motor Setup** > **Clutch** you can configure a smooth engine launch for soft engagement clutch or freewheel. Useful for gear motors or mid-drives. At the moment, the setting works well only in the control mode **Torque**, because the clutch there is always engaged. An alternative option is to configure the acceleration limit in the modes **S1**, **S2**, **S3** in the menu section **Controller** > **Advanced modes**. | + | In the menu section **Controller** |
- | {{: | + | {{: |
- | The parameter **Mode** determines the way of operation:: \\ | + | The parameter **Mode** |
- | **Accelerate** — smoothly accelerates the motor until the load appears. \\ | + | |
- | **Accelerate and hold** — in addition to the previous one, it applies weak torque to the motor after the throttle is released, this mode allows you to switch speeds at mid-drive systems without using the pedals. | + | |
- | **# Phase amps** \\ | + | **# Phase amps** \\ **Start time** |
- | **Start time** — maximum time for soft start, in seconds (s). Select values from **1s** to **20s**, in increments of **1s**. \\ | + | |
- | **Start current** — phase motor current at which the load will be detected and the soft start is disabled, in amperes (А). Select values from **0.2А** to **50.0А**, in increments of **0.2А**. This value must be higher than the phase current for specified acceleration of the motor without load. \\ | + | |
- | **Detection time** — the time during which the load must be present, after which the soft start will be switched off, in milliseconds (ms). Select values from **10 ms** to **1000 ms**, in increments of **10 ms**. \\ | + | |
- | **Acceleration** | + | |
- | **Hold (20%)** and **Hold (80%)** — two parameters regulating the phase current supplied to the motor in the mode **Accelerate and hold**, in amperes (А). **20%** — current at low speeds, **80%** — current at about maximum speed. It is possible to determine the approximate values by the no-load current of the motor. Select values from **0.2А** to **50.0А**, in increments of **0.2А**. \\ | + | |
- | **Hold enable time** — time through which after the throttle has been pressed, torque hold will become available, in seconds (s). Select values from **1s** to **120s**, in increments of **4s**. | + | |
- | **Hold time** — the time during which torque will be applied after releasing the throttle, in seconds (s). Select values from **1s** to **120 s**, in increments of **1s**. | + | **Hold time** |
- | <WRAP center round tip 60%>\\ Optimal settings for MAC motor: **Accelerate**, | + | <WRAP center round tip 60%> \\ Optimal settings for MAC motor: **Accelerate**, |
+ | |||
+ | ===== Firmware update ===== | ||
+ | |||
+ | In the menu section **Controller** > **Update and Settings**, you can update the Controller' | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Import config.** — loads the settings from the file ** NCconf.cfg ** - ** NCconf9.cfg ** up to a maximum of 9 different configurations, | ||
+ | \\ | ||
+ | **Export config.** - saves the settings to the ** NCconf.cfg ** - ** NCconf9.cfg ** file up to a maximum of 9 different configurations, | ||
+ | \\ | ||
+ | **Reboot** — restarts the device. If the settings have not been saved, they will be reset.\\ | ||
+ | \\ | ||
+ | **Reset Wh usage** — resets the accumulated number of Watt-Hours in the controller. This indicator is displayed in the statistics of the On-board computer, see section **[[: | ||
+ | \\ | ||
+ | **Reset stats** — resets mileage in kilometers.\\ | ||
+ | \\ | ||
+ | **Load defaults** — after a reset, the default settings are loaded but not saved. If you restart the Controller without saving after a reset, the previous settings will be loaded.\\ | ||
+ | \\ | ||
+ | **Erase data storage** — This function may be needed for the correct firmware update, rollback to default settings, in a situation where user actions lead to incorrect operation of the Controller. If the controller has stopped saving the settings, do a reset, wait 3 seconds, and try to save again.\\ | ||
+ | \\ | ||
+ | **Update firmware** — starting the firmware update process. You can download the current firmware version and read the rules of update in the **[[: | ||
+ | ===== Control modes ===== | ||
+ | |||
+ | In the menu section **Controller** > **Control modes** you can configure and save three presets of the parameters of the electric motor and switch between them using a 3-position switch or buttons on the On-board computer. The currently active mode number is displayed at the top of the main screen. After setting, it is necessary to activate the modes in the menu item **Controller** > **Additional modes** > **Enable additional modes** by setting the value **On**. In the same menu **Controller** > **Additional modes** you can make detailed settings for each mode (see the section Additional modes). | ||
+ | |||
+ | If there is no speed switch, then mode 1 is the default. If the switch is connected to the On-board computer, it is necessary to configure the On-board computer buttons in the **On-board computer** > **Button settings** menu. See section **[[: | ||
+ | |||
+ | ==== Modes setup ==== | ||
+ | |||
+ | {{: | ||
+ | |||
+ | The ** # Current mode ** line displays the currently selected control mode. List of possible options: | ||
+ | **N** — neutral.\\ | ||
+ | **S1** — speed 1.\\ | ||
+ | **S2** — speed 2.\\ | ||
+ | **S3** — speed 3.\\ | ||
+ | **RV** — reverse. | ||
+ | |||
+ | Four parameters are used to configure each mode:\\ | ||
+ | **Phase** — the maximum value of the phase current, in Amperes (**A**). Select of values from **0A** to **500A**, in increments of **2A**. When setting, consider the maximum phase current of your controller type. In most cases, we recommend specifying the value of the phase current 1.5-2 times higher than the battery current. | ||
+ | |||
+ | **Battery** — the maximum value of the battery current, in Amperes (**A**). Select of values from **2A** to **400A**, in increments of **2A**. When setting up, consider the capabilities of the connected battery and the maximum battery current of your controller type. | ||
+ | |||
+ | **Power** — maximum power (discharge) of the battery, in kilowatts (**kW**). Select of values from **0.00kW** to **30.0kW**, in increments of **0.1kW**. Set to 0.0kW to disable the power limiting limit. | ||
+ | |||
+ | **Speed** — maximum speed in percentage (%). Select of values from **4%** to **150%**, in increments of **2%**. The value of this parameter determines the percentage of speed depending on the reference speed (see section **[[: | ||
+ | |||
+ | ==== Electric brake setup ==== | ||
+ | |||
+ | **Braking phase** — the value of the phase current of braking by the motor, in Amperes (**A**). Select of values from **0A** to **500A**, in increments of **2A**. For braking to zero, it is recommended to enable **Active braking** in the section **Controller** > **Control**. When using limit switches on mechanical brakes, lower brake current change speed makes recuperation more smooth. | ||
+ | ==== Braking phase at speed control ==== | ||
+ | |||
+ | **Braking ph. at speed** — phase braking current during speed control, in Amperes (A). Select of values from **0A** to **500A**, in increments of **2A**. This function allows you to slow down when you reset the throttle stick. Works only with Direct Drive motors, without a clutch. | ||
+ | |||
+ | Also to use this mode should be selected: **Speed** or **Speed and Torque** mode in the **Controller** > **Control** > **Throttle Mode** menu item. In the menu item **Controller** > **Control** > **Speed lim. at 0% throttle** enable the speed limit at 0% throttle (optional), enable if you need braking with completely released throttle. | ||
+ | ==== Regenerative braking setting ==== | ||
+ | |||
+ | **Braking ph. at 0% throttle** — phase braking current with the throttle handle released, in Amperes (A). Select of values from **0A** to **500A**, in increments of **2A**. This function allows regenerative braking to be initiated when the throttle is released. | ||
+ | |||
+ | This function will be active if additional modes are disabled in the **Controller** > **Advanced modes** menu section or if, with activated additional modes, in one of the menu sections **Mode S1**, **Mode S2** or **Mode S3** in menu item **Braking ph. at 0% throttle** was setup is **0A**. | ||
+ | ==== Reverse setup ==== | ||
+ | |||
+ | **Speed reverse** — reverse speed, in percentage (%). Select of values from ** 2% ** to ** 150% **, in increments of ** 2% **. The value of this parameter determines the percentage of speed depending on the reference speed (see section **[[: | ||
+ | |||
+ | **Phase reverse** — the value of the reverse phase current, in Amperes (**A**). Select of values from **10A** to **500A**, in increments of **2A**. | ||
+ | ==== Field weakening setup ==== | ||
+ | |||
+ | **Field weakening** — the magnitude of the field weakening current, in Amperes (**A**). Select of values from **0A** to **500A**, in increments of **2A**. This setting allows you to increase the maximum motor speed and depends on the supply voltage, in any case, the speed will be no more than the maximum supply voltage (**Vmax**) of the controller (**95V limit**).< | ||
+ | <WRAP center round warning 60%> | ||
+ | |||
+ | To set up the weakening, you need: | ||
+ | |||
+ | * for one of the control modes in the section **Controller** | ||
+ | * set the weakening current value in the section **Controller** | ||
+ | |||
+ | Field weakening is activated when the maximum speed is reached, the Controller adds weakening current, limiting the phase current and weakening current specified in the control mode. That is if the effective phase current is 70A, and the weakening current is set to 30A, then a minimum of 100A must be specified in the phase current settings. If the phase current increases to 80A, then only 20A will remain for weakening because 80A 20A = 100A. | ||
+ | |||
+ | Also, the Controller will limit the speed of rotation of the motor so that its effective EMF does not exceed the maximum supply voltage of the controller (not the battery). If the motor starts twitching on the suspended wheel, then it is necessary to reduce the weakening current. | ||
+ | |||
+ | ==== Current change speed ==== | ||
+ | |||
+ | **# Current change speed**. | ||
+ | |||
+ | * acceleration, | ||
+ | * braking, select of values from **50A/ | ||
+ | * shutdown, select of values from **50A/ | ||
+ | |||
+ | Three parameters determine the rate of change of the current (smoothness). The higher the value, the faster the current build-up in the motor will occur. For conventional brake levers, it will be useful to reduce the parameter **braking** | ||
+ | |||
+ | ===== Advanced control modes ===== | ||
+ | |||
+ | In the menu section **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | To activate the control modes, select **Controller** | ||
+ | |||
+ | In the menu **Controller** | ||
+ | |||
+ | ~~CL~~ | ||
+ | |||
+ | Each mode has its own section in the **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Acceleration lim.** | ||
+ | |||
+ | **Braking phase** | ||
+ | |||
+ | **Braking ph. at 0% throttle** | ||
+ | |||
+ | **Revers** | ||
+ | |||
+ | **Cruise** | ||
+ | |||
+ | **Disable motor** | ||
+ | |||
+ | **Disable throttle** | ||
+ | |||
+ | **Active braking** | ||
+ | |||
+ | **Reverse on brake** | ||
+ | |||
+ | **Speed lim. at 0% throttle** | ||
+ | |||
+ | **Disable PAS** — disables the Pedal Assist. Select of values **On** | ||
+ | |||
+ | **PAS Scale** | ||
+ | |||
+ | ===== Control ===== | ||
+ | |||
+ | In the **Controller** | ||
+ | |||
+ | ==== PAS and Torque sensor setup ==== | ||
+ | |||
+ | In the menu section **Controller** | ||
+ | |||
+ | ЧTo be able to connect the PAS system, it is necessary to order the PWM IO/PAS cable as an option. The PAS system connects to the Controller via the PWM IO/PAS wire to the **P1/ | ||
+ | |||
+ | You can look at the connecting methods of various PAS systems at **[[: | ||
+ | |||
+ | The PAS, unlike the Torque sensor, controls the throttle by frequency and not by the force of rotation. The PAS setup menu consists of the following items: | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **PAS connection** | ||
+ | |||
+ | **# PAS freq.** | ||
+ | |||
+ | Further in the menu are the settings related to the pressure sensor (Torque sensor). | ||
+ | |||
+ | **Pressure scale** | ||
+ | |||
+ | **# Torque** | ||
+ | |||
+ | **# Human watt** | ||
+ | |||
+ | **Torque min** — the torque at which the throttle signal starts to increase, Newton-meters (Nm). Select of values from **0 Nm** to **100 Nm**, in increments of **2 Nm**. All values less than this level is 0% of throttle. \\ **Torque max** — the torque, which limits the level of 100% throttle, Newton-meters (Nm). Select of values from **0 Nm** to **300 Nm**, in increments of **2 Nm**. \\ **Instant Torque** | ||
+ | |||
+ | ==== Remote control ==== | ||
+ | |||
+ | The **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Input for radio control via PWM (PWM), connects to the **P1** | ||
+ | |||
+ | The **# Input Freq.** | ||
+ | |||
+ | In the menu item **Function** | ||
+ | |||
+ | ~~CL~~ | ||
+ | |||
+ | \\ Adjust the throttle and/or brake range as indicated by the signal. | ||
+ | |||
+ | **# Throttle range** \\ **Throttle min** — minimum throttle value, in milliseconds (ms). Select of values from **0.00 ms** to **10.00 ms**, in increments of **0.01 ms**. \\ **Throttle max** — maximum throttle value, in milliseconds (ms). Select of values from **0.00 ms** to **10.00 ms**, in increments of **0.01 ms**. | ||
+ | |||
+ | **# Brake range** \\ **Brake min** — minimum brake value, in milliseconds (ms). Select of values from **0.00 ms** to **10.00 ms**, in increments of **0.01 ms**. \\ **Brake max** — maximum brake value, in milliseconds (ms). Select of values from **0.00 ms** to **10.00 ms**, in increments of **0.01 ms**. | ||
+ | |||
+ | ==== Cruise control setup ==== | ||
+ | |||
+ | In the menu section **Controller** | ||
+ | |||
+ | **CRe** | ||
+ | |||
+ | For more information about configuring these functions, read the **[[: | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Next are the menu items for setting the cruise: | ||
+ | |||
+ | **Cruise restore** | ||
+ | |||
+ | **Cruise EN time** | ||
+ | |||
+ | **Cruise level** | ||
+ | |||
+ | * **Throttle** | ||
+ | * **Speed** | ||
+ | * **Mixed** | ||
+ | **Cruise smoothness** | ||
+ | |||
+ | **# Used for cruise activation**: | ||
+ | |||
+ | Additionally, | ||
+ | |||
+ | What actions disable cruise control: | ||
+ | |||
+ | * pressing the brake, analog or digital. | ||
+ | * repeated throttle press. | ||
+ | * if a switch is used — when it's disabled. | ||
+ | * reverse enable. | ||
+ | |||
+ | ==== Throttle and brake curves setup ==== | ||
+ | |||
+ | In the menu section **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | You can select the following types of throttle and brake presets: \\ **Linear** | ||
+ | |||
+ | Manual setting of throttle and brake position points is also available, to do this select **None** | ||
+ | |||
+ | You can also manually edit the value of each point in the loaded preset. | ||
+ | |||
+ | ~~CL~~ | ||
+ | |||
+ | ==== Control source ==== | ||
+ | |||
+ | The controller supports the connection of controls (throttle, brake, switches, and buttons) to the Controller, On-board computer, ulight board, or mixed connection when one part of the periphery is connected to the Controller, and the second part to the On-board computer, or to ulight and On-board computer. This is necessary in the case of Tork/PAS sensor configurations in the Controller throttle lever in the On-board computer. In the menu item **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Select of control options: \\ **Auto** | ||
+ | |||
+ | ~~CL~~ | ||
+ | |||
+ | ==== Throttle control mode setup ==== | ||
+ | |||
+ | The menu item **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Three throttle modes options are available: \\ **Speed** | ||
+ | |||
+ | In the case of selecting the **Speed torque** | ||
+ | |||
+ | ==== Throttle and brake voltage range setup ==== | ||
+ | |||
+ | The menu items in the **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Currently, voltage settings for all throttles and brakes are common. \\ **# Throttle** | ||
+ | |||
+ | **# Brake** | ||
+ | |||
+ | **Brake button power** | ||
+ | |||
+ | ==== Setup 100% speed value ==== | ||
+ | |||
+ | The menu items in the **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Speed ref. filter** | ||
+ | |||
+ | **Filter factor** | ||
+ | |||
+ | **Speed mode** | ||
+ | |||
+ | * **OFF** | ||
+ | * **Middle U bat** — the average value between the minimum and maximum voltage of the battery settings used as speed reference, depending on motor kV. | ||
+ | * **U supply** | ||
+ | * **Ref. speed** | ||
+ | * **Ref. ERPM** | ||
+ | **Minimum speed** | ||
+ | |||
+ | **Speed lim. at 0% throttle** | ||
+ | |||
+ | ===== Motor setup ===== | ||
+ | |||
+ | The **Controller** | ||
+ | |||
+ | ==== Motor temperature sensor ==== | ||
+ | |||
+ | In the menu section **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **°t max** — maximum electric motor temperature, | ||
+ | |||
+ | In the menu item **Sensor type** | ||
+ | |||
+ | It is recommended to install a temperature sensor so close as possible on the stator windings, while not in contact with the stator iron. If you don't know what kind of sensor is in the motor, you can check all types of sensors and select the one that displays data the most closely to room temperature. The current measured temperature is displayed at **# Value °t**. | ||
+ | |||
+ | The **# °t resistance** | ||
+ | |||
+ | ==== Clutch ==== | ||
+ | |||
+ | In the menu section **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | The parameter **Mode** | ||
+ | |||
+ | **# Phase amps** \\ **Start time** | ||
+ | |||
+ | **Hold time** | ||
+ | |||
+ | <WRAP center round tip 60%> \\ Optimal settings for MAC motor: **Accelerate**, | ||
+ | |||
+ | ==== Setup the motor position sensors ==== | ||
+ | |||
+ | Under the menu section **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Sensor type** | ||
+ | |||
+ | **Sensor mode** | ||
+ | |||
+ | **Interpolate sensors** | ||
+ | |||
+ | **Interpolation start** | ||
+ | |||
+ | **Frequency control** | ||
==== Hall sensors setup ==== | ==== Hall sensors setup ==== | ||
- | Under the menu section **Controller** > **Motor | + | Further in the menu section **Controller** |
- | === Manual setup the Hall sensors angles === | + | {{: |
- | In general, it is not recommended to change these settings manually!\\ | + | **Hall filter** — enable or disable the filter in the direction of rotation, select the **Direction** |
- | In the menu section | + | |
- | {{: | + | **State filter** |
- | **Offset for square** — additional shift for square wave mode, in degrees (**°**). Select of values from **-30°** to **30°**, in increments of **1°**. \\ | + | **Direction filter** — select |
- | **Offset total fwd** — shift all Halls sensors by the specified value for the direct | + | |
- | **Offset total bkwd** — shift all Halls sensors by the specified value for the reverse rotation of the motor., in degrees | + | |
- | To shift all the halls, you must press the right button of the On-board computer, enter the shift angle, press the right button again. The value will be reset and the angle of all halls will change | + | **Idle filter** — when the motor is not moving, the sensor position is reset to the middle position. Selection |
- | **Reset angles** — reset of all Hall sensors angles. Select of values **On** | + | The next menu sections shows the Hall indices |
- | **Integration threshold** — analogue of Hall angles for sensorless engine control mode, in volts (**V**). \\ | + | |
- | **Hall adjust Ki** — the meaning | + | |
- | === Hall table === | + | ~~CL~~ |
- | The **Controller** > **Motor Setup** > **Hall table** menu section shows the Hall indices and Hall angles | + | ==== Manual setup the Hall sensors |
- | {{: | + | In general, it is not recommended to change these settings manually! |
- | ~~CL~~ | + | |
- | === Advanced Hall sensor settings === | + | {{: |
- | Further | + | **Offset for square** |
- | {{: | + | To shift all the halls, you must press the right button of the On-board computer, enter the shift angle, press the right button again. The value will be reset and the angle of all halls will change to the specified value. You can change the angle of the hall shift in the opposite direction by setting a negative value. |
- | **Sensor type** — currently, by default, only one type of **Hall** sensor | + | **Reset angles** — reset of all Hall sensors angles. Select of values **On** |
- | **Sensor mode** — this parameter is loaded at start-up and can be saved. At the moment, the Controller has the following motor control modes: \\ | + | ==== Encoder setup ==== |
- | **Sensorless** — motor control using BEMF integration, | + | |
- | **Combined** — start the motor on Hall sensors, then switch to sensorless mode, the threshold is determined by the parameter radians per second (**rad/s**) in the **From hall to s-less** menu item. Select of values from **0.00 rad/s** to **2.00 rad/s** in increments of **0.05 rad/s**. To convert values keep in mind that 1 rad/s to RPM = 9.5493 RPM. \\ | + | |
- | **Sensors** — electric motor control only by signals from Hall sensors. \\ | + | |
- | **Freq** — frequency control. Do not use this mode for driving! \\ | + | |
- | **Interpolate halls** — smooth change | + | In the menu **Controller** > **Motor Setup** |
+ | **Note:** on older controllers encoder use **P1** input as PWM for initial position detection, setup ports **P1 (I5)** and **P2 (I6)** to **OFF** and disable PWM output. Settings applied after reboot. | ||
- | **Interpolation start** — the motor is always started from a discrete angle, if digital halls are used. After the specified speed, the angle starts | + | Wiring and connectors Compatibility: |
- | **Frequency control** — a separate mode that can be used to power equipment through a transformer or to dry the varnish on the motor windings. Select of values from **10 HZ** to **200 HZ**, in increments of **1 HZ**. \\ | + | {{: |
- | **Hall filter** — enable or disable the filter | + | **Steps** — number of encoder steps, selectable |
- | **State filter** — select the delay time, in seconds (sec). Selection of values from **0.000s** to **1.000s**, in increments of **0.002s**. This delay is used if the wrong value of the Hall sensors is received. All indicators that are less than the set value will be filtered out. \\ | + | == Debug information == |
- | **Direction filter** — select | + | **Index** — encoder index signal value. \\ **Z-Index** |
==== Motor parameters ==== | ==== Motor parameters ==== | ||
- | Items in the **Controller** > **Motor setup** menu section allow you to configure the parameters of the electric motor. | + | Items in the **Controller** |
- | {{: | + | {{: |
- | **Pole pair** — the number of pole pairs of the stator winding | + | **Pole pair** |
- | **Spin direction** — this setting allows you to change the direction of rotation of the electric motor. Select of values **Forward** and **Invert**. Or you can swap two motor phases to change the direction of rotation.\\ | + | **Spin direction** |
- | **Integration thr.** — the analog of Hall sensors angles for sensorless motor control mode, in volts (**V**). | + | **Integration thr.** |
- | **Control mode** — this parameter is loaded at start-up and can be saved. At the moment, the Controller has the following motor control modes: \\ | + | **Control mode** |
- | **Off** — control mode is disabled.\\ | + | |
- | **Square** — outdated control method used only for motor detection. \\ | + | |
- | **FOC** — field-oriented control of the motor. \\ | + | |
- | **DC-DC** — charging mode when you use the controller in motor charging mode. \\ | + | |
- | The control mode selected in this menu is the priority setting for the controller. If the Hall sensor mode is selected in the **Controller** > **Motor setup** > **Position sensor** menu, which does not correspond to the set operating mode of the electric motor, then this Hall sensor mode will be automatically replaced with a more suitable one. | + | The control mode selected in this menu is the priority setting for the controller. If the Hall sensor mode is selected in the **Controller** |
- | **Max motor U** — limits voltage supplied to the motor, in volts (**V**). In most cases, this parameter is not needed. Select of values from **0V** to **100V**, in increments of **1V**. | + | **Max motor U** — limits voltage supplied to the motor, in volts (**V**). In most cases, this parameter is not needed. Select of values from **0V** |
- | **kV** — motor parameter, electric revolutions per volt (**eRPM/ | + | **kV** |
- | Next are the menu items for configuring the MTPA, this function allows you to introduce a negative id current to increase the torque on the IPM motors. | + | Next are the menu items for configuring the MTPA, this function allows you to introduce a negative id current to increase the torque on the IPM motors. |
- | **Phase resistance** — the result of measuring the phase resistance of the electric motor during auto-setup (menu item **Motor LR**), in Ohms (Ohm). | + | **Phase resistance** |
- | **Inductance d** — the result of measuring the inductance of the electric motor along the d axis during auto-setup (menu item **Motor LR**), in microHenry (µH). The d-axis (" | + | **Inductance d** — the result of measuring the inductance of the electric motor along the d axis during auto-setup (menu item **Motor LR**), in microHenry (µH). The d-axis (" |
- | **Inductance q** — the result of measuring the inductance of the electric motor along the q axis during auto-setup (menu item **Motor LR**), in microHenry (µH). The q-axis (" | + | **Inductance q** — the result of measuring the inductance of the electric motor along the q axis during auto-setup (menu item **Motor LR**), in microHenry (µH). The q-axis (" |
- | **Flux linkage** — is the total magnetic flux permeating the electrical circuit, in Weber (Wb). \\ | + | **Flux linkage** |
- | **# Square wave settings:** \\ | + | **MTPA (IPM Motor)** — enable (**On**) the MTPA function for IPM motor, for all other motors this function must be disabled |
- | **Square offset** — additional shift for square wave mode, in degrees | + | |
- | **Boost square current** — in the sensorless or square mode, applies 100% PWM at the beginning of each winding switch. Starting from specified speed and minimum requested current. Select of values | + | |
- | **Boost current** — setting refers to the control mode **Square**, the minimum current from which the rapid current pumping in the windings is turned on, in amperes (**А**). Select of values from **0A** to **100A**, in increments of **1A**. \\ | + | |
- | **Boost speed** — setting refers to the control mode **Square**, the minimum speed after which the rapid pumping of current in the windings is turned on, in radians per second | + | |
+ | **FOC Vq limit** — improves field weakening on some motors. Select of values **On** and **Off**. | ||
+ | |||
+ | **# Square wave settings:** \\ **Square offset** | ||
===== Battery ===== | ===== Battery ===== | ||
- | In the **Controller** > **Battery** menu section you can set up the parameters of the battery connected to the Controller. The Nucular controllers support supply voltages from **20V** to **90V**, this is **21S** for Lithium-ion (Li-ion) batteries and **25S** for Lithium-iron-phosphate (LiFePO4) batteries. To configure the battery, you must specify the range of supply voltage and current. To correctly display the battery capacity on the On-board computer screen and correctly calculate the remaining charge, you must specify the battery capacity in [[en: | + | In the **Controller** |
- | {{: | + | {{: |
- | **Full charge** — delta voltage relative to the maximum, at which when the controller is turned on, will reset the watt-hour consumption, | + | **Full charge** |
- | **Supply max** and **Supply min** — battery voltage range, in volts (**V**). Select values from **20.00V** to **95.00V**, in increments of **00.1V**. Also, these settings are used for the **Converter** mode. \\ | + | **Supply max** and **Supply min** — battery voltage range, in volts (**V**). Select values from **20.00V** |
- | For lithium-ion (Li-ion) batteries, the minimum can be considered **2.8V*S**, the maximum **4.2V*S**. \\ | + | For lithium-ion (Li-ion) batteries, the minimum can be considered **2.8V*S**, the maximum **4.2V*S**. \\ For lithium-iron-phosphate (LiFePO4)-minimum **2.7V*S**, maximum **3.6V*S**. |
- | For lithium-iron-phosphate (LiFePO4)-minimum **2.7V*S**, maximum **3.6V*S**. | + | |
- | <WRAP center round important 60%> | + | <WRAP center round important 60%> We guarantee stable operation of the Controller at voltages up to **90V** |
- | We guarantee stable operation of the Controller at voltages up to **90V** inclusive. Using a battery over 90V may damage the Controller and void the warranty. | + | |
- | </ | + | |
+ | **Charge max** — maximum battery charging current, during regeneration or in **Converter** | ||
- | **Charge | + | **Discharge |
- | **Discharge | + | **Power max** — maximum continuous discharge |
- | **Power max** — maximum continuous discharge power, in watts (**W**). Set 0W to deactivate power limit. Select values from **0W** to **30000 W**, in increments of **100W**. | + | **# DC voltage** |
+ | |||
+ | ===== Converter ===== | ||
+ | |||
+ | In the menu section **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Enable** | ||
+ | |||
+ | **Auto-enable** | ||
+ | |||
+ | **Detection threshold** | ||
+ | |||
+ | **Battery max I** — maximum battery charge current, if no value is specified then battery settings are used, in amperes (**А**). Select of values from **0.0А** | ||
+ | |||
+ | **Battery min I** — minimum charge current when current is decreased by voltage, in amperes (**А**). Select of values from **0.5А** | ||
+ | |||
+ | **Undercharge** | ||
+ | |||
+ | **Current drop delta** | ||
+ | |||
+ | **Supply max I** — maximum power supply current, in amperes (**А**). Select of values from **2.0 A** to **150.0 A**, in increments of **0.5 A**. | ||
+ | |||
+ | **Supply drop U** — allowable voltage drop on wires or power supply, in volts (**V**). Select of values from **0.50 V** to **10.00 V**, in increments of **0.25 V**. | ||
+ | |||
+ | **Max motor t°** — setting the limitation of the heating temperature of the motor during charging, in degrees Celsius (**°C**). Select of values from **50°C** | ||
+ | |||
+ | Below in the menu section, through the **#** sign, the real-time values of voltages and currents are shown: \\ **# Battery I** \\ **# Battery U** \\ **# Supply I** \\ **# Supply U** | ||
+ | |||
+ | After plugging in the power supply, the On-board Computer will display the battery charging process. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **The indication in the middle** | ||
+ | |||
+ | **Indication to the left:** \\ **59.0V** | ||
+ | |||
+ | ~~CL~~ | ||
+ | |||
+ | ===== I/O port configuration ===== | ||
+ | |||
+ | In the **Controller** | ||
+ | |||
+ | Sixteen CAN ports are additionally available **CAN port 1** - **CAN port 16**, the signal source for which can be configured on the On-board computer or uLight. These are software values, there are fewer physical inputs on the boards, at the moment there are eight CAN ports **IO1** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | In the section **Controller** | ||
+ | |||
+ | If the controls are connected to the On-board computer, then it is necessary to check the activation when contact shorted to GND in the **On-board computer** | ||
+ | |||
+ | ~~CL~~ | ||
+ | |||
+ | In the item ** Controller **> **I/O configuration** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Available functions for the Controller ports **S1**, **S3**, **RV**, **CR**, **P1**, **P2**, **P**, **M** and CAN ports **CAN port 1** - **CAN port 16**: \\ **OFF** | ||
+ | |||
+ | Further in the menu, there are items for configuring the PWM outputs. | ||
+ | |||
+ | ~~CL~~ | ||
+ | |||
+ | ==== PWM output setup ==== | ||
+ | |||
+ | To activate the **PWM P1** or **PWM P2** output, the **Controller** | ||
+ | |||
+ | **PWM freq** | ||
+ | |||
+ | **PWM P1** and **PWM Р2** — selection of operating modes: | ||
+ | |||
+ | * **Disabled** | ||
+ | * **Stop-light** | ||
+ | * **Headlight** | ||
+ | * **t°C motor** | ||
+ | * **t°C controller** | ||
+ | **PWM Pn Min** / **Max** | ||
+ | |||
+ | ===== Extra parameters ===== | ||
+ | |||
+ | In the menu section **Controller** | ||
+ | |||
+ | ==== The power button and auto shutdown ==== | ||
+ | |||
+ | The controller power button is located on the back of the On-Board Computer. In the **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Selecting modes for **Disable button**: \\ **None** | ||
+ | |||
+ | **Auto shutdown** | ||
+ | |||
+ | **Sleep time** | ||
+ | |||
+ | **Lock at turn-on** | ||
+ | |||
+ | ==== Speedometer setup ==== | ||
+ | |||
+ | The next block of settings in the menu section **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Speed calculation** | ||
+ | |||
+ | **Circumference** | ||
+ | |||
+ | **Motor sprocket** | ||
+ | |||
+ | **Wheel sprocket** | ||
+ | |||
+ | If you have a wheel motor, then in the section **Controller** | ||
+ | |||
+ | ==== Master-controller ==== | ||
+ | |||
+ | {{: | ||
+ | |||
+ | ~~CL~~ | ||
+ | |||
+ | ==== Other settings ==== | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Device ID** — setting the Controller number in the CAN network. This number is displayed in the menu section **Settings** | ||
+ | |||
+ | **Prefix 1** and **Prefix 2** — controller name setting for multi-motor configurations. Using the prefixes together or separately, you can specify where the electric motor that the Controller controls is located. The selectable values for each prefix are **None**, **Front**, **Rear**, **Left**, **Right**. To save the setting, go to the **Controller** | ||
+ | |||
+ | For example, you have a 2WD scooter and two 12F controllers, | ||
+ | |||
+ | If you are using a 3WD drive or more, then both prefixes must be used for the controller name. For example, if the controller is driving a rear right motor, the setting will look like this: **Prefix 1** — **Rear**, **Prefix 2** — **Right**. | ||
+ | |||
+ | ===== PID regulators ===== | ||
+ | |||
+ | In the **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Square Ki, Kp** — phase current regulator for a square wave. \\ **FOC Ki, Kp** — phase current regulator for FOC mode. \\ **FW Ki, Kp** — field weakening coefficients. \\ **DCv Ki, Kp** — voltage regulator on the DC bus. \\ **DCi Ki, Kp** — current regulator on the DC bus. \\ **DCw Ki, Kp** — power calculator. \\ **Speed Ki, Kp, Kd** — speed regulator for throttle control modes **Speed** | ||
+ | |||
+ | ~~CL~~ | ||
+ | |||
+ | ===== Status flags ===== | ||
+ | |||
+ | The **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Reset? | ||
+ | **Max acceleration** | ||
+ | **Min deceleration** | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | **12V protection** | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | **PAS protection** | ||
+ | | ||
+ | | ||
+ | **ADC sample error** | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | **CAN state** | ||
+ | **CAN RX** — the number of messages in the CAN bus to receive. \\ | ||
+ | **CAN TX** — the number of messages in the CAN bus to transmission. \\ | ||
+ | **CPU Load** | ||
+ | |||
+ | ===== Debug information ===== | ||
+ | |||
+ | The menu section **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Temp. controller** | ||
+ | |||
+ | Next in the menu are the sections **Debug FOC** and **Remote inputs**, which are described below. | ||
+ | |||
+ | ==== Debug FOC ==== | ||
+ | |||
+ | In the menu section **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **U Q** — Q-axis voltage, in volts (**V**). \\ **U D** — D-axis voltage, in volts (**V**). \\ **I Q** — Q-axis current, in amperes (**А**). \\ **I D** — D-axis current, in amperes (**А**). \\ **Ireqest Q** — Q-axis current request, in amperes (**А**). \\ **Ireqest D** — D-axis current request, in amperes (**А**). | ||
+ | |||
+ | ~~CL~~ | ||
+ | |||
+ | ==== Remote inputs ==== | ||
+ | |||
+ | In the menu section **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | ~~CL~~ | ||
+ | |||
+ | ===== Logger ===== | ||
+ | |||
+ | In the **Controller ** > **Logger** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Start logging** | ||
+ | |||
+ | **Stop logging** | ||
+ | |||
+ | ~~CL~~ | ||
+ | |||
+ | \\ **Start mode** | ||
+ | |||
+ | * **Manual** | ||
+ | * **At start** | ||
+ | **Log time** | ||
+ | |||
+ | * **Time step** | ||
+ | * **Sys time** | ||
+ | **Log rate** | ||
+ | |||
+ | **Mode** | ||
+ | |||
+ | * **Buffered** | ||
+ | * **Max rate** | ||
+ | **Data averaging** | ||
+ | |||
+ | * **None** | ||
+ | * **Fast** | ||
+ | * **Slow** | ||
+ | **Add header to log** — adding the name of the controller when writing the log, so that you can understand which controller the log belongs to in multi-motors configurations. You can set the name of the controller in the menu **Controller** | ||
+ | |||
+ | Next, in the **# Data to log** menu sections, you can select the set of parameters you want to record. Select **On** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | ===== Statistics ===== | ||
+ | |||
+ | In the menu section **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Wh used total** | ||
+ | |||
+ | The values below are approximate! \\ **Motor efficiency** | ||
+ | |||
+ | ===== Device information ===== | ||
+ | |||
+ | In the menu section **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Nucular Controller** | ||
+ | |||
+ | |||
+ | ==== Hall sensors setup ==== | ||
+ | |||
+ | Further in the menu section **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Hall filter** | ||
+ | |||
+ | **State filter** | ||
+ | |||
+ | **Direction filter** | ||
+ | |||
+ | The next menu sections shows the Hall indices and Hall angles for the two directions of rotation of the electric motor. These indices are used for the internal operation of the Controller. | ||
+ | |||
+ | ~~CL~~ | ||
+ | |||
+ | ==== Manual setup the Hall sensors angles ==== | ||
+ | |||
+ | In general, it is not recommended to change these settings manually! \\ In the menu section **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Offset for square** | ||
+ | |||
+ | To shift all the halls, you must press the right button of the On-board computer, enter the shift angle, press the right button again. The value will be reset and the angle of all halls will change to the specified value. You can change the angle of the hall shift in the opposite direction by setting a negative value. | ||
+ | |||
+ | **Reset angles** | ||
+ | |||
+ | |||
+ | ==== Encoder setup ==== | ||
+ | |||
+ | In the menu **Controller** > **Motor Setup** > **Position sensor** > **Encoder settings** there are menu items for configuring the motor encoder. The parameter values in each of the items will appear after passing through the Auto-setup procedure. Controllers with encoder capable have orange phase wires and an encoder speed of 580kHZ under **Controller** > **Device Information**. The wire for connecting the electric motor with the encoder is ordered separately and is installed instead of the wire with connector for the Hall sensors. \\ | ||
+ | |||
+ | Wiring and connectors Compatibility: | ||
+ | **Halls** > **Encoder** — if your controller has a connector for Hall sensors, then you can make an adapter for the encoder yourself. But, in this case, you will not be able to move when you turn it on, you will need to push the electric bike with your feet to start. \\ | ||
+ | **Encoder** > **Halls** — if your controller has an encoder connector, then you can make an adapter for Hall sensors yourself. Everything will work. \\ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Steps** — number of encoder steps, selectable in increments of **1**.\\ | ||
+ | **# Invert counter** — select of values **Off** and **On**.\\ | ||
+ | **# Invert PWM** — select of values **Off** and **On**.\\ | ||
+ | **# Index Z** — the value of the additional output signal of the encoder (zero pointer), the choice of values from **0** to **7**, in increments of **1**.\\ | ||
+ | **# Shift Z FW** — signal shift, select of values from **-60°** to **+60°** in increments of **1°**.\\ | ||
+ | **# Shift Z BW** — signal shift, select of values from **-60°** to **+60°** in increments of **1°**.\\ | ||
+ | |||
+ | == Debug information == | ||
+ | **Index** — encoder index signal value. \\ | ||
+ | **Z-Index** — the value of the zero pointer.\\ | ||
+ | **PWM Period** — PWM signal period, in microseconds (**µs**).\\ | ||
+ | **PWM Width** — PWM signal pulse width, in microseconds (**µs**).\\ | ||
+ | **Rad by index** — position of the electric motor by index, in radians (**rad**).\\ | ||
+ | **Rad by PWM** — position of the electric motor by PWM, in radians (**rad**).\\ | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==== Motor parameters ==== | ||
+ | |||
+ | Items in the **Controller** | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Pole pair** | ||
+ | |||
+ | **Spin direction** | ||
+ | |||
+ | **Integration thr.** | ||
+ | |||
+ | **Control mode** | ||
+ | |||
+ | The control mode selected in this menu is the priority setting for the controller. If the Hall sensor mode is selected in the **Controller** | ||
+ | |||
+ | **Max motor U** — limits voltage supplied to the motor, in volts (**V**). In most cases, this parameter is not needed. Select of values from **0V** | ||
+ | |||
+ | **kV** | ||
+ | |||
+ | Next are the menu items for configuring the MTPA, this function allows you to introduce a negative id current to increase the torque on the IPM motors. | ||
+ | |||
+ | **Phase resistance** | ||
+ | |||
+ | **Inductance d** — the result of measuring the inductance of the electric motor along the d axis during auto-setup (menu item **Motor LR**), in microHenry (µH). The d-axis (" | ||
+ | |||
+ | **Inductance q** — the result of measuring the inductance of the electric motor along the q axis during auto-setup (menu item **Motor LR**), in microHenry (µH). The q-axis (" | ||
+ | |||
+ | **Flux linkage** | ||
+ | |||
+ | **MTPA (IPM Motor)** — enable (**On**) the MTPA function for IPM motor, for all other motors this function must be disabled (**Off**). | ||
+ | |||
+ | **# Square wave settings:** \\ **Square offset** | ||
+ | |||
+ | ===== Battery ===== | ||
+ | |||
+ | In the **Controller** > **Battery** menu section you can set up the parameters of the battery connected to the Controller. The Nucular controllers support supply voltages from **20V** to **90V**, this is **21S** for Lithium-ion (Li-ion) batteries and **25S** for Lithium-iron-phosphate (LiFePO4) batteries. To configure the battery, you must specify the range of supply voltage and current. To correctly display the battery capacity on the On-board computer screen and correctly calculate the remaining charge, you must specify the battery capacity in [[: | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Full charge** — delta voltage relative to the maximum, at which when the controller is turned on, will reset the watt-hour consumption, | ||
+ | |||
+ | **Supply max** and **Supply min** — battery voltage range, in volts (**V**). Select values from **20.00V** to **95.00V**, in increments of **0.1V**. Also, these settings are used for the **Converter** mode. | ||
+ | |||
+ | For lithium-ion (Li-ion) batteries, the minimum can be considered **2.8V*S**, the maximum **4.2V*S**.\\ | ||
+ | For lithium-iron-phosphate (LiFePO4)-minimum **2.7V*S**, maximum **3.6V*S**. \\ | ||
+ | |||
+ | <WRAP center round important 60%> We guarantee stable operation of the Controller at voltages up to **90V** inclusive. Using a battery over 90V may damage the Controller and void the warranty. </ | ||
+ | |||
+ | **Charge max** — maximum battery charging current, during regeneration or in **Converter** mode, in amperes (**А**). Select values from **1.0A** to **400.0А**, | ||
+ | |||
+ | **Discharge max** — maximum continuous discharge current of the battery, but in boost mode, it can be more, check (Throttle control mode setup.), in amperes (**А**). Select values from **1.0A** to **400.0А**, | ||
+ | |||
+ | **Power max** — maximum continuous discharge power, in watts (**W**). Set 0W to deactivate power limit. Select values from **0W** to **30000 W**, in increments of **100W**. | ||
**# DC voltage** — current supply voltage of the Controller, in volts (**V**). | **# DC voltage** — current supply voltage of the Controller, in volts (**V**). | ||
+ | |||
===== Converter ===== | ===== Converter ===== | ||
- | In the menu section **Controller** > **Converter**, | + | In the menu section **Controller** |
- | {{: | + | {{: |
- | **Enable** — turn on the converter mode and start charging. Select of values **On** and **Off**. | + | **Enable** |
- | **Auto-enable** — allows the automatic start of charging when the charging PSU is connected to the controller. Select of values **On** and **Off**. | + | **Auto-enable** |
- | **Detection threshold** — minimum voltage on phases when charger mode activates, also disables motor control, in volts per phase (**Vph**). Select of values from **10Vph** to **80Vph**, in increments of **1Vph**. | + | **Detection threshold** |
- | **Battery max I** — maximum battery charge current, if no value is specified then battery settings are used, in amperes (**А**). Select of values from **0.0А** to **100.0A**, in increments of **0.5А**. | + | **Battery max I** — maximum battery charge current, if no value is specified then battery settings are used, in amperes (**А**). Select of values from **0.0А** |
- | **Battery min I** — minimum charge current when current is decreased by voltage, in amperes (**А**). Select of values from **0.5А** to **10.0A**, in increments of **0.5А**. | + | **Battery min I** — minimum charge current when current is decreased by voltage, in amperes (**А**). Select of values from **0.5А** |
- | **Undercharge** — voltage relative to maximum battery voltage setup, in volts (**V**). Let's decrease the full charge voltage. Select of values from **0.00V** to **10.0V**, in increments of **0.1V**. | + | **Undercharge** |
- | **Current drop delta** — decreases charging current down to **Battery min I** as the battery reaches maximum voltage on specified voltage range, in volts (**dV**). Select of values from **0.0dV** to **20.0 dV** in increments of **0.5 dV**. | + | **Current drop delta** |
- | **Supply max I** — maximum power supply current, in amperes (**А**). Select of values from **2.0 A** to **150.0 A**, in increments of **0.5 A**. | + | **Supply max I** — maximum power supply current, in amperes (**А**). Select of values from **2.0 A** to **150.0 A**, in increments of **0.5 A**. |
- | **Supply drop U** — allowable voltage drop on wires or power supply, in volts (**V**). Select of values from **0.50 V** to **10.00 V**, in increments of **0.25 V**. \\ | + | **Supply drop U** — allowable voltage drop on wires or power supply, in volts (**V**). Select of values from **0.50 V** to **10.00 V**, in increments of **0.25 V**. |
- | **Max motor t°** — setting the limitation of the heating temperature of the motor during charging, in degrees Celsius (**°C**). Select of values from **50°C** to **120°C**, in increments of **5°C**. | + | **Max motor t°** — setting the limitation of the heating temperature of the motor during charging, in degrees Celsius (**°C**). Select of values from **50°C** |
- | Below in the menu section, through the **#** sign, the real-time values of voltages and currents are shown: \\ | + | Below in the menu section, through the **#** sign, the real-time values of voltages and currents are shown: \\ **# Battery I** \\ **# Battery U** \\ **# Supply I** \\ **# Supply U** |
- | **# Battery I** \\ | + | |
- | **# Battery U** \\ | + | |
- | **# Supply I** \\ | + | |
- | **# Supply U** \\ | + | |
After plugging in the power supply, the On-board Computer will display the battery charging process. | After plugging in the power supply, the On-board Computer will display the battery charging process. | ||
- | {{{: | + | {{: |
- | **-22.1A** — information line parameter, depending on the On-Board Computer settings. \\ | + | |
- | **0:0:58** — time elapsed since charging started, hours, minutes, seconds. \\ | + | |
- | **I24.9** — charging current, in Amperes (**A**). \\ | + | |
- | **U53.7** — charging voltage, in Volts (**V**). | + | |
- | **The indication in the middle** is the temperature of the motor and the controller, respectively, | + | **The indication in the middle** |
- | **Indication to the left:** \\ | + | **Indication to the left:** \\ **59.0V** |
- | **59.0V** — information line parameter, depending on the On-Board Computer settings. \\ | + | |
- | **15Wh** — the battery capacity in Watt hours (**Wh**). \\ | + | |
- | **100%** — the battery level, in percent (**%**). \\ | + | |
- | **I24.9** — the battery current, in Amperes (**A**). \\ | + | |
- | **U53.7** — the battery voltage, in Volts (**V**). | + | |
- | + | ~~CL~~ | |
- | ~~CL~~ | + | |
===== I/O port configuration ===== | ===== I/O port configuration ===== | ||
- | In the **Controller** > **I/O configuration** menu section, you can configure the ports functions. The controller has eight digital ports that can be configured for different functions — **S1**, **S3**, **RV**, **CR**, **P1**, **P2**, **P**, **M**. See section **[[en: | + | In the **Controller** |
- | Sixteen CAN ports are additionally available **CAN port 1** - **CAN port 16**, the signal source for which can be configured on the On-board computer or uLight. These are software values, there are fewer physical inputs on the boards, at the moment there are eight CAN ports **IO1** - **IO8** available in the On-board computer plus four Hotkeys (buttons on the On-board computer). In the future, six CAN ports ** I1 ** - ** I6 ** will be added to the uLight board. | + | Sixteen CAN ports are additionally available **CAN port 1** - **CAN port 16**, the signal source for which can be configured on the On-board computer or uLight. These are software values, there are fewer physical inputs on the boards, at the moment there are eight CAN ports **IO1** |
- | {{: | + | {{: |
+ | |||
+ | In the section **Controller** | ||
+ | |||
+ | If the controls are connected to the On-board computer, then it is necessary to check the activation when contact shorted to GND in the **On-board computer** > **Information** [[en: | ||
- | In the section **Controller** > **I/O configuration** > **Port state**, you can check input activation when contact shorted to GND. When a signal is applied, the value will change from **0** to **1**. Below in the menu items **# Throttle** and **# Brake** you can see the voltage on the throttle and brake levers, respectively. | ||
~~CL~~ \\ | ~~CL~~ \\ | ||
- | In the item ** Controller **> **I/O configuration** > **Speeds mode** you can select the method for switching additional modes **S1**, **S2**, **S3** for inputs in the Controller or CAN inputs - **Switch** or **Buttons**. \\ | ||
- | {{: | + | In the item ** Controller **> **I/O configuration** |
- | Available functions for the Controller ports **S1**, **S3**, **RV**, **CR**, **P1**, **P2**, **P**, **M** and CAN ports **CAN port 1** - **CAN port 16**: \\ | + | {{:en: |
- | **OFF** — disable port. \\ | + | |
- | **RV** — reverse. \\ | + | |
- | **CRe** — enable cruise. \\ | + | |
- | **CR+** — increment cruise speed (when cruise is active). \\ | + | |
- | **CR-** — decrement cruise speed (when cruise is active). \\ | + | |
- | **CRr** — restore last saved cruise speed with button, activated only above min cruise speed. \\ | + | |
- | **BK** — brake button. \\ | + | |
- | **DM** — disable motor (disable throttle, brake and PAS). \\ | + | |
- | **DTH** — disable throttle. \\ | + | |
- | **DPAS** — disable PAS. \\ | + | |
- | **SWSNS** — input for Gearsensor to reduce motor torque (WIP). In development. \\ | + | |
- | **N** — activates the neutral mode forcibly, resets speed mode counter if used. If neutral is activated by default, you need to change speed mode again to exit neutral. \\ | + | |
- | **nBK** — inverted brake button input, activates the brake when the contact is opened. \\ | + | |
- | **S1** — speed 1. \\ | + | |
- | **S2** — speed 2. \\ | + | |
- | **S3** — speed 3. \\ | + | |
- | **S1of3** — speed 1 for 3-position switch. \\ | + | |
- | **S3of3** — speed 3 for 3-position switch. \\ | + | |
- | **Scyc** — cycle speed mode, sequential switching with one button. \\ | + | |
- | **S++** — increment speed, switching the speed from low to high with one button. \\ | + | |
- | **S--** — decrement speedи, switching the speed from high to low with one button. \\ | + | |
- | **SPSNS** — input for external speed sensor. \\ | + | |
- | **Spec.** — special port function (like PWM or PAS). \\ | + | |
- | Further in the menu, there are items for configuring the PWM outputs. | + | Available functions for the Controller ports **S1**, **S3**, **RV**, **CR**, **P1**, **P2**, **P**, **M** and CAN ports **CAN port 1** - **CAN port 16**: \\ **OFF** |
- | ~~CL~~ | + | **Spec.** |
- | ==== PWM output setup ==== | + | **CL1**-**CL5** — instant configuration import by pressing the CAN button (up to five different configurations). For correct import, the function number must match the number in the name of your configuration file. For example, a **CL3** function would correspond to a file called **ncconf3.cfg**. |
+ | |||
+ | Further in the menu, there are items for configuring the PWM outputs. | ||
+ | |||
+ | ~~CL~~ | ||
+ | |||
+ | ==== PWM output setup ==== | ||
- | To activate the **PWM P1** or **PWM P2** output, the **Controller** > **Port Setup** menu should be set to **Spec.** mode and **PAS** disabled. | + | To activate the **PWM P1** or **PWM P2** output, the **Controller** |
- | **PWM freq** — selection of frequency of additional PWM output on ports **P1/P2**. Select of values PWM frequency — **100Hz**, **500Hz**, **1kHz**, **5kHz**, **10kHz**, **24kHz (FAN)**. For a conventional light bulb, large values are not needed. Select the frequency **100Hz**, this will be enough to avoid flickering. The high frequency marked ** FAN ** is used to control the fan, this is their standard frequency. | + | **PWM freq** |
- | **PWM P1** and **PWM Р2** — selection of operating modes: | + | **PWM P1** and **PWM Р2** — selection of operating modes: |
- | * **Disabled** — mode not selected. \\ | + | |
- | * **Stop-light** — activated when the brake is pressed. \\ | + | |
- | * **Headlight** — activated when the controller is enabled. \\ | + | |
- | * **t°C motor** — activated beyond the two deltas of the motor temperature, | + | |
- | * **t°C controller** — activated from 40°С, maximum value at 80°С temperature of the Controller. \\ | + | |
- | **PWM Pn Min** / **Max** — indicates the output range of the PWM (duty), select of values from **0%** to **100%**, in increments **1%**. \\ | + | * **Disabled** |
- | **PWM Pn t° Min** / **t° Max** — selection of motor or controller temperature, | + | * **Stop-light** |
+ | * **Headlight** | ||
+ | * **t°C motor** | ||
+ | * **t°C controller** | ||
+ | **PWM Pn Min** / **Max** | ||
===== Extra parameters ===== | ===== Extra parameters ===== | ||
- | In the menu section **Controller** > **Extra parameters** you can set up various additional settings of the Controller. | + | In the menu section **Controller** |
==== The power button and auto shutdown ==== | ==== The power button and auto shutdown ==== | ||
- | The controller power button is located on the back of the On-Board Computer. In the **Controller** > **Extra parameters** > **Disable button** menu item, you can select the way to turn on/off the Controller, which turns on when it is powers-up or the button contacts are closed. In the off mode, the controller consumes about 100 μA, so if you reconnect the power supply without discharging the capacitors, the controller may not start. | + | The controller power button is located on the back of the On-Board Computer. In the **Controller** |
- | {{: | + | {{: |
- | Selecting modes for **Disable button**: \\ | + | Selecting modes for **Disable button**: \\ **None** |
- | **None** — the controller turns on when it is power-up up or when the power button is closed, does not turn off. \\ | + | |
- | **Switch** — the controller turns on when the power button is closed (when EN shorted to GND), turns off when it opens. \\ | + | |
- | **Button** — the controller turns on the button on the On-Board Computer, press it for 2 seconds, and release, to disable it, press and hold the button again. \\ | + | |
- | **CAN** — the controller turns on when it is powers-up or the button contacts shorts, disables only when another device on CAN bus will send a request to disable. This function is used when there are several controllers on a system, where one of them is set to button or switch mode, and the other in CAN mode. \\ | + | |
- | **Auto shutdown** — activation of the controller shutdown function after a while if the motor does not spin. Select of values **On** and **Offл**. The shutdown time is set in item **Sleep time**. | + | **Auto shutdown** |
- | **Sleep time** — selection of the controller shutdown time when the **Auto shutdown** function is activated, in seconds, (**s**). Select of values from **30s** to **1500s**, in increments of **5s**. | + | **Sleep time** |
- | **Lock at turn-on** — the function locks controller inputs when enabled until the password is entered on the On-Board Computer, if there is no On-Board Computer, enabling this setting will permanently lock the controller. | + | **Lock at turn-on** |
==== Speedometer setup ==== | ==== Speedometer setup ==== | ||
- | The next block of settings in the menu section **Controller** > **Extra parameters** refers to the speed calculation setting. If you use an external speed sensor connected to the On-board computer, you need to configure it in menu **[[en: | + | The next block of settings in the menu section **Controller** |
- | {{: | + | {{: |
- | **Speed calculation** — enabling speed calculation in the Controller. Useful for multi-motor configurations, | + | **Speed calculation** |
- | **Circumference** — wheel circumference, | + | **Circumference** |
- | **Motor sprocket** — this setting specifies the number of sprocket teeth on the motor (notional), which allows you to set the gear ratio from motor shaft to the wheel. Also, this setting can be used as a reduction ratio for gear motors. | + | **Motor sprocket** |
- | **Wheel sprocket** — the number of teeth of the wheel sprocket, similar to the setting **Motor sprocket**. | + | **Wheel sprocket** |
- | If you have a wheel motor, then in the section **Controller** > **Motor setup** you need to specify the number of **Pole pair** (divide the number of magnets by two). For gear motors or mid-drives, it is recommended to install an external speed sensor that connects to the Onboard computer or to any of the controller ports. | + | If you have a wheel motor, then in the section **Controller** |
==== Master-controller ==== | ==== Master-controller ==== | ||
- | {{: | + | {{: |
- | In the menu section **Controller** > **Extra parameters** > **Master-controller** you can enable the function of controlling other controllers from the current one. This setting is suitable for multi-motor configurations where control (throttle, brake and etc.) is connected into one of the controllers directly. | + | |
- | ~~CL~~ | + | ~~CL~~ |
==== Other settings ==== | ==== Other settings ==== | ||
- | {{: | + | {{: |
- | **Limit t° CPU** — limiting the temperature of the processor, in degrees Celsius (**°C**). When the specified threshold is reached, the phase current will be limited. Select of values from **60°C** to **105°C**, in increments of **5°C**. | + | |
- | **Device ID** — setting the Controller number in the CAN network. This number is displayed in the menu section **Settings** > **Devices** in front of each device that is connected to the network using the [[en: | + | **Device ID** — setting the Controller number in the CAN network. This number is displayed in the menu section **Settings** |
- | **Prefix 1** and **Prefix 2** — controller name setting for multi-motor configurations. Using the prefixes together or separately, you can specify where the electric motor that the Controller controls is located. The selectable values for each prefix are **None**, **Front**, **Rear**, **Left**, **Right**. To save the setting, go to the **Controller** > **Save settings** menu item and select **On**, then restart the controller. The prefix will now appear in front of the controller name in the **Devices** menu. \\ | + | **Prefix 1** and **Prefix 2** — controller name setting for multi-motor configurations. Using the prefixes together or separately, you can specify where the electric motor that the Controller controls is located. The selectable values for each prefix are **None**, **Front**, **Rear**, **Left**, **Right**. To save the setting, go to the **Controller** |
- | For example, you have a 2WD scooter and two 12F controllers, | + | For example, you have a 2WD scooter and two 12F controllers, |
- | If you are using a 3WD drive or more, then both prefixes must be used for the controller name. For example, if the controller is driving a rear right motor, the setting will look like this: **Prefix 1** — **Rear**, **Prefix 2** — **Right**. | + | If you are using a 3WD drive or more, then both prefixes must be used for the controller name. For example, if the controller is driving a rear right motor, the setting will look like this: **Prefix 1** — **Rear**, **Prefix 2** — **Right**. |
===== PID regulators ===== | ===== PID regulators ===== | ||
- | In the **Controller** > **PID regulators** menu section, various signals of proportional-integral-derivative (PID) regulators are configured - devices in the control loop with feedback used in automatic control systems to generate a control signal in order to obtain the required accuracy and the quality of the transition process. **Settings for advanced users**. | + | In the **Controller** |
- | {{: | + | {{: |
- | Two or three coefficients are used for the settings of each regulator: \\ | + | |
- | **Ki** — integral coefficient. \\ | + | **Square Ki, Kp** — phase current regulator for a square wave. \\ **FOC Ki, Kp** — phase current regulator for FOC mode. \\ **FW Ki, Kp** — field weakening coefficients. \\ **DCv Ki, Kp** — voltage regulator on the DC bus. \\ **DCi Ki, Kp** — current regulator on the DC bus. \\ **DCw Ki, Kp** — power calculator. \\ **Speed Ki, Kp, Kd** — speed regulator for throttle control modes **Speed** |
- | **Кp** — proportional coefficient. \\ | + | |
- | **Kd** — differentiating coefficient. \\ | + | ~~CL~~ |
- | **Square Ki, Kp** — phase current regulator for a square wave. \\ | ||
- | **FOC Ki, Kp** — phase current regulator for FOC mode. \\ | ||
- | **FW Ki, Kp** — field weakening coefficients. \\ | ||
- | **DCv Ki, Kp** — voltage regulator on the DC bus. \\ | ||
- | **DCi Ki, Kp** — current regulator on the DC bus. \\ | ||
- | **DCw Ki, Kp** — power calculator. \\ | ||
- | **Speed Ki, Kp, Kd** — speed regulator for throttle control modes **Speed** and **Speed+torque**. \\ | ||
- | **PLL Ki, Kp** — speed regulator for motor angle interpolation. \\ | ||
- | **Acceleration Kp, Ki** — deceleration and acceleration regulator. | ||
- | ~~CL~~ \\ | ||
===== Status flags ===== | ===== Status flags ===== | ||
- | The **Controller** > **Status Flags** menu section displays errors that may occur during the operation of the Controller. If an error occurs, the parameter value changes to **On**.\\ | + | The **Controller** |
- | {{: | + | {{: |
- | **Reset?** — reset all statuses. Values **On** and **Off**. \\ | + | **Reset? |
- | **Max acceleration** — maximum acceleration, | + | **Max acceleration** |
- | **Min deceleration** — maximum deceleration, | + | **Min deceleration** |
- | **Overload current** — the last recorded current on the phases, in Amperes. \\ | + | **Overload current** |
- | **Overload** — exceeding the permissible current values. Values **On** and **Off**. \\ | + | **Overload** |
- | **Over-Field weakening** — weakening error. Values **On** and **Off**. \\ | + | **Over-Field weakening** |
- | **Supply overvoltage** — too high supply voltage, the error will appear above 95V, but in general depends on the controller model. Values **On** and **Off**. \\ | + | **Supply overvoltage** |
- | **Supply undervoltage** — too low supply voltage, less than the minimum battery supply threshold. Values **On** and **Off**. \\ | + | **Supply undervoltage** |
- | **12V protection** — breaking down or error on the 12V power line. Values **On** and **Off**. \\ | + | **12V protection** |
- | **Brake error** — brake lever connection error. Values **On** and **Off**. \\ | + | **Control fail** — the controller was not able to smoothly turn off the electric motor in time when the brake contacts were closed. Values **On** and **Off**. |
- | **Throttle error** — throttle lever connection error. Values **On** and **Off**. \\ | + | **12V protection** |
- | **Hall error** — Hall sensor connection error. Values **On** and **Off**. \\ | + | **Brake error** |
- | **Code error** — error executing firmware code. Values **On** and **Off**. Let us know if this error occurs. \\ | + | **Throttle error** |
- | **PAS protection** — PAS error. Values **On** and **Off**. \\ | + | **Hall error** |
- | **Controller overheat** — overheat protection of the controller. Values **On** and **Off**. \\ | + | **Code error** |
- | **Motor overheat** — overheating protection of the electric motor. Values **On** and **Off**. \\ | + | **Thread error** — processor overload. Values **On** and **Off**. The error is not critical, let us know if it occurs. \\ |
- | **Protection fail** — hardware error, malfunction of all protection systems during controller self-test. If this error occurs, the operation of the Controller will be impossible. Values **On** and **Off**. \\ | + | **PAS protection** |
- | **Voltage on phases** — overvoltage on phases. Values **On** and **Off**. \\ | + | **Controller overheat** |
- | **CAN: error** — CAN-bus errors. Values **On** and **Off**. | + | **Motor overheat** |
- | **LEC** — types of errors on the CAN bus. If everything is alright you will see the value **Ok**. In case of errors, there will be values - **Stuff**, **Form**, **Acknowledgment**, | + | **Protection fail** |
- | **Receive w/error** — CAN-bus errors on receiving. \\ | + | **ADC sample error** — software error of the analog-to-digital converter (ADC). Values **On** and **Off**. \\ |
- | **Sent w/error** — CAN-bus errors on transmitting. \\ | + | **VBUS sample |
- | **CAN state** — overloading buffers. If everything is alright you will see the value **Ok**. In case of errors, there will be values - **OVR0**, **OVR1**, **OVR01**. Tell us the code if this error occurs. \\ | + | **Voltage on phases** |
- | **CPU Load** — current load of the central processor, in percentage (**%**). | + | **LEC** |
+ | **Receive w/ | ||
+ | **Sent w/ | ||
+ | **CAN state** | ||
+ | **CAN RX** — the number of messages in the CAN bus to receive. \\ | ||
+ | **CAN TX** — the number of messages in the CAN bus to transmission. \\ | ||
+ | **CPU Load** | ||
===== Debug information ===== | ===== Debug information ===== | ||
- | The menu section **Controller** > **Debug information** shows the main parameters of your Controller, electric motor, and the whole system - temperature, | + | The menu section **Controller** |
- | {{: | + | {{: |
- | **Temp | + | **Temp. controller** — temperature of the Controller, in degrees Celsius (**°C**). \\ |
- | **Temp | + | **Temp. motor** — temperature of the electric motor, in degrees Celsius (**°C**). \\ |
- | **DC current** — DC current, in amperes (**А**). \\ | + | **DC current** |
- | **DC voltage** — DC voltage, in volts (**V**). \\ | + | **DC voltage** |
- | **AC current** — AC current, in amperes (**А**). \\ | + | **AC current** |
- | **AC voltage** — AC voltage, in volts (**V**). \\ | + | **AC voltage** |
- | **Motor U0** — DC voltage on phases, in volts (**V**). \\ | + | **Motor U0** — DC voltage on phases, in volts (**V**). \\ |
- | **System 12V** — voltage on the CAN bus 12V, in volts (**V**). \\ | + | **System 12V** — voltage on the CAN bus 12V, in volts (**V**). \\ |
- | **System 5V** — voltage on the CAN bus 5V, in volts (**V**). \\ | + | **System 5V** — voltage on the CAN bus 5V, in volts (**V**). \\ |
- | **RPM** — motor speed, in RPM (**RPM**). \\ | + | **RPM** |
- | **ERPM** — electric revolutions of the motor per minute (**ERPM**). \\ | + | **Hall input** |
- | **Hall input** — this parameter allows you to check the functionality of the Hall sensors. There are three digits in this item, each shows the signal level, if you rotate the motor slowly by hand, all three digits should change. If none of the digits change, check if the Hall connector is connected or the ground may be broken. If one of the digits does not change - there is no contact or the sensor wire is broken. To check the contacts in the controller, disconnect the Hall connector and measure the voltages on the controller connector. There should be about 4V on the signal lines of the Halls, 5V on the power supply, and about 3V on the temperature sensor line. \\ | + | **Hall index** |
- | **Hall index** — virtual position of the motor, digits from 1 to 6 (normal operation). \\ | + | **Throttle %** — the percentage of how much the throttle is pressed. \\ |
- | **Throttle %** — the percentage of how much the throttle is pressed. \\ | + | **Brake %** — the percentage of how much the brake is pressed. \\ |
- | **Brake %** — the percentage of how much the brake is pressed. \\ | + | **Speed request** |
- | **Speed request** — set point for the speed regulator, in eRPM. \\ | + | **Torque request** |
- | **Torque request** — phase current request, either positive throttle or a negative brake. \\ | + | **Torque limit** |
- | **Torque limit** — current limit for this type of controller, taking into account overheating. \\ | + | **Temp CPU** — CPU temperature, |
- | **Temp CPU** — CPU temperature, | + | |
+ | Next in the menu are the sections **Debug FOC** and **Remote inputs**, which are described below. | ||
- | Next in the menu are the sections **Debug FOC** and **Remote inputs**, which are described below. | ||
- | |||
==== Debug FOC ==== | ==== Debug FOC ==== | ||
- | In the menu section **Controller** > **Debug information** > **Debug FOC** \\ | + | In the menu section **Controller** |
- | {{: | + | {{: |
+ | |||
+ | **U Q** — Q-axis voltage, in volts (**V**). \\ **U D** — D-axis voltage, in volts (**V**). \\ **I Q** — Q-axis current, in amperes (**А**). \\ **I D** — D-axis current, in amperes (**А**). \\ **Ireqest Q** — Q-axis current request, in amperes (**А**). \\ **Ireqest D** — D-axis current request, in amperes (**А**). | ||
+ | |||
+ | ~~CL~~ | ||
- | **U Q** — Q-axis voltage, in volts (**V**). \\ | ||
- | **U D** — D-axis voltage, in volts (**V**). \\ | ||
- | **I Q** — Q-axis current, in amperes (**А**). \\ | ||
- | **I D** — D-axis current, in amperes (**А**). \\ | ||
- | **Ireqest Q** — Q-axis current request, in amperes (**А**). \\ | ||
- | **Ireqest D** — D-axis current request, in amperes (**А**). | ||
- | ~~CL~~ \\ | ||
==== Remote inputs ==== | ==== Remote inputs ==== | ||
- | In the menu section **Controller** > **Debug information** > **Remote inputs** you can view the parameters of the throttle and brake levers connected to other devices connected to the CAN-bus (On-board computer or uLight). \\ | + | In the menu section **Controller** |
+ | |||
+ | {{: | ||
+ | |||
+ | ~~CL~~ | ||
- | {{: | ||
- | **Throttle** — voltage on the throttle lever at a remote source (On-board computer or uLight), in volts (**V**). \\ | ||
- | **Brake** — voltage at the brake lever at a remote source (On-board computer or uLight), in volts (**V**). \\ | ||
- | **Throttle % **— the percentage of how much the throttle pressed at a remote source. \\ | ||
- | **Brake %** — the percentage of how much the brake pressed at a remote source. | ||
- | ~~CL~~ \\ | ||
===== Logger ===== | ===== Logger ===== | ||
- | In the **Controller ** > **Logger** menu section, you can enable and configure the data logging during the operation of the Controller. This functionality is experimental, | + | In the **Controller ** > **Logger** |
- | {{: | + | {{: |
- | **Start logging** — to start recording, select **On** and press the right button of the On-board computer. After that, the **#State** menu item will change to **Waiting** status. The recording will start automatically after pressing the throttle grip. If an error occurs during the recording process, you will see its code in the ** # Error code ** menu item. In case of an error, firstly, check that the SD card has the FAT32 file system, and secondly, that there is free space on the SD card for recording. Additionally, | + | **Start logging** |
- | **Stop logging** — stop recording, select **On** to end recording. | + | **Stop logging** |
- | ~~CL~~ \\ | + | |
- | **Start mode** — selection of recording start mode: | + | |
- | * **Manual** — enable manual recording. | + | |
- | * **At start** — recording starts automatically when the Controller is turned on. | + | |
- | **Log time** — two parameters of time for recording to choose from: | + | ~~CL~~ |
- | * **Time step** — delta of time since the previous record. | + | |
- | * **Sys time** — global time, which is incremented after the start of the controller. | + | |
- | **Log rate** — delay between records | + | |
- | **Mode** — recording | + | |
- | * **Buffered** — buffering and recording | + | * **At start** — recording |
- | * **Max rate** — continuous | + | **Log time** — two parameters of time for recording |
- | **Data averaging** — using filters while recording: | + | |
- | * **None** — filter disabled (records real values). | + | * **Sys time** — global time, which is incremented after the start of the controller. |
- | * **Fast** — slight averaging (smoothes | + | **Log rate** — delay between records of values. |
- | | + | |
- | **Add header to log** — adding the name of the controller when writing the log, so that you can understand which controller the log belongs to in multi-motors configurations. You can set the name of the controller in the menu **Controller** > **Extra parameters**, | + | **Mode** — recording mode selection: |
- | Next, in the **# Data to log** menu sections, you can select the set of parameters you want to record. Select | + | |
+ | | ||
+ | **Data averaging** | ||
- | {{: | + | * **None** |
+ | * **Fast** | ||
+ | * **Slow** | ||
+ | **Add header to log** — adding the name of the controller when writing the log, so that you can understand which controller the log belongs to in multi-motors configurations. You can set the name of the controller in the menu **Controller** | ||
+ | |||
+ | Next, in the **# Data to log** menu sections, you can select the set of parameters you want to record. Select **On** | ||
+ | |||
+ | {{: | ||
**# Data to log**: \\ | **# Data to log**: \\ | ||
- | **Battery Voltage** — battery voltage data logging. \\ | + | **Battery Voltage** |
- | **Battery Current** — battery current data logging. \\ | + | **Battery Current** |
- | **Motor Voltage** — motor voltage data logging. \\ | + | **Motor Voltage** |
- | **Motor Current** — motor current data logging. \\ | + | **Motor Current** |
- | **Wheel speed** — wheel speed data logging. \\ | + | **Wheel speed** |
- | **Motor rad/s** — data logging of the angular speed of the electric motor. \\ | + | **Motor rad/ |
- | **Motor RPM** — data logging of revolutions of an electric motor per minute. \\ | + | **Motor RPM** — data logging of revolutions of an electric motor per minute. \\ |
- | **Tmotor °C** — data logging of the electric motor temperature. \\ | + | **Motor angle** — data logging of the angle of the electric motor. \\ |
- | **Tfet °C** — data logging the temperature of field-effect transistors. \\ | + | **Tmotor °C** — data logging of the electric motor temperature. \\ |
- | **Raw hall input** — data logging the input status from Hall sensors without filter. \\ | + | **Tfet °C** — data logging the temperature of field-effect transistors. \\ |
- | **Hall index** — virtual position of motor. \\ | + | **Raw hall input** |
- | **Throttle %** — throttle grip data logging. \\ | + | **Hall index** |
- | **Brake %** — brake lever data logging. \\ | + | **Throttle %** — throttle grip data logging. \\ |
- | **FOC Vq** — Q-axis voltage data logging. \\ | + | **Brake %** — brake lever data logging. \\ |
- | **FOC Vd** — D-axis voltage data logging. \\ | + | **FOC Vq** — Q-axis voltage data logging. \\ |
- | **FOC Iq** — Q-axis current data logging. \\ | + | **FOC Vd** — D-axis voltage data logging. \\ |
- | **FOC Id** — D-axis current data logging. \\ | + | **FOC Iq** — Q-axis current data logging. \\ |
- | **FOC Iq request** — Q-axis current request data logging. \\ | + | **FOC Id** — D-axis current data logging. \\ |
- | **FOC Id request** — D-axis current request data logging. \\ | + | **FOC Iq request** |
- | **Current phA** — data logging the current on the A phase of the electric motor. \\ | + | **FOC Id request** |
- | **Current phB** — data logging the current on the B phase of the electric motor. \\ | + | **Current phA** — data logging the current on the A phase of the electric motor. \\ |
- | **Current phC** — data logging the current on the С phase of the electric motor. \\ | + | **Current phB** — data logging the current on the B phase of the electric motor. \\ |
- | **PAS frequency RPM** — PAS frequency data logging. \\ | + | **Current phC** — data logging the current on the С phase of the electric motor. \\ |
- | **PAS torque Nm** — PAS torque data logging. \\ | + | **PAS frequency RPM** — PAS frequency data logging. \\ |
- | **PAS power W** — PAS power data logging. \\ | + | **PAS torque Nm** — PAS torque data logging. \\ |
- | **Speed request** — speed request data logging. \\ | + | **PAS power W** — PAS power data logging. \\ |
- | **Torque request** — torque request data logging.\\ | + | **Speed request** |
+ | **Torque request** | ||
===== Statistics ===== | ===== Statistics ===== | ||
- | In the menu section **Controller** > **Statistics** you can view the data on the Controller. These are trip statistics that will be automatically reset when the controller is powered off. If you have several Controllers in the system, then you can see the summary data for all controllers in the general statistics in the On-board computer. | + | In the menu section **Controller** |
+ | |||
+ | {{: | ||
- | {{:en:controller:13_0.8.png?nolink |}} | + | **Wh used total** |
+ | **Wh used** | ||
+ | **Wh regen.** | ||
+ | **Regen. %** — the percentage of energy recovered during recuperation (**%**). \\ | ||
+ | **Ah used total** | ||
+ | **Ah used** | ||
+ | **Ah regen.** | ||
+ | **Min bat. voltage** — minimum battery voltage, in Volts (**V**). \\ | ||
+ | **Max phase curr.** — maximum phase current, in Amps (**A**). \\ | ||
+ | **Peak power** — maximum motor power, in Watts (**W**). \\ | ||
+ | **Max motor temp.** — maximum motor temperature, | ||
+ | **Max controller | ||
- | **Wh used total** — total energy consumption (used plus regen), in Watt-hours (**Wh**). | + | The values below are approximate! |
- | **Wh used** — energy consumption, in Watt-hours | + | **Motor efficiency** — efficiency of the electric motor, in percent |
- | **Wh regen.** — energy gained during | + | **Eff. average** — average efficiency of the electric motor, in percent |
- | **Regen. %** — the percentage of energy recovered during recuperation (**%**). \\ | + | **Torque** — current torque of the electric motor, in Newton-meters |
- | **Ah used total** — total energy consumption (used plus regen), in Ampere hours (**Ah**). \\ | + | **Power out** — the power that the electric motor delivers, in Watts (**W**). \\ |
- | **Ah used** — energy consumption, in Ampere hours (**Ah**). \\ | + | **Power in** — power supplied to the electric motor, in Watts (**W**). |
- | **Ah regen.** — energy gained during | + | |
- | The values below are approximate! \\ | ||
- | **Motor efficiency** — efficiency of the electric motor, in percent (**%**). \\ | ||
- | **Eff. average** — average efficiency of the electric motor, in percent (**%**). \\ | ||
- | **Torque** — current torque of the electric motor, in Newton-meters (**Nm**). \\ | ||
- | **Power out** — the power that the electric motor delivers, in Watts (**W**). \\ | ||
- | **Power in** — power supplied to the electric motor, in Watts (**W**). \\ | ||
===== Device information ===== | ===== Device information ===== | ||
- | In the menu section **Controller** > **Device Information** you can view the basic information about the Controller. In this menu, you can check which firmware version is loaded into your Controller, as well as other parameters that differ depending on the Controller model. | + | In the menu section **Controller** |
- | {{: | + | {{: |
- | **Micro Nucular Controller** — device name depending on the type of Controller. \\ | + | **Nucular Controller** |
- | **Max supply** — 95V. The warranty covers supply voltages up to **90V** inclusive. \\ | + | **Max supply** |
- | **Max current** — the value of the maximum phase current, depending on the type of Controller, in amperes (A). \\ | + | **Max current** |
- | **Firmware date** — firmware compilation date. \\ | + | **Encoder speed** — 26kHz or 580kHz (new Controller version with orange phase wires). \\ |
- | **Firmware ver.** — version of the installed firmware, you can check for updates in the section **[[en: | + | **Firmware date** |
- | **Loader date** — the data loader compilation date. \\ | + | **Firmware ver.** |
- | **Loader version** — data loader version. \\ | + | **Loader date** |
- | **Worked** — operating time of the Controller in kilowatt-hours (kW*h). \\ | + | **Loader version** |
- | **t° middle 100 h** — the average temperature of the Сontroller over the last 100 hours. \\ | + | **Production date** — date of manufacture of the controller. \\ |
- | **t° middle** — the average temperature of the Сontroller over all time. \\ | + | **Worked** |
- | **Current protections** — the number of triggered overcurrent protections over all time of operation of the controller. \\ | + | **t° middle 100 h** — the average temperature of the Сontroller over the last 100 hours. \\ |
- | **Temperature protections** — the number of triggered temperature protections over all time of operation of the controller. \\ | + | **t° middle** |
- | **Voltage protections** — the number of triggered voltage protections over all time of operation of the controller. \\ | + | **Current protections** |
- | **Power cycle** — number of controller switching on. \\ | + | **Temperature protections** |
- | **Power-on time** — total operating time of the Controller, minutes, hours, days. | + | **Voltage protections** |
+ | **Power cycle** | ||
+ | **Power-on time** | ||
+ | **Serial number** — serial number of the Controller (for devices manufactured from 01 Jul 2022). Take a photo or write down this number and keep it separate from the Controller. You may need it when requesting repairs or if the Controller is stolen. After updating the firmware to 0.8.7, in some versions of controllers manufactured before 01 Jul 2022, a serial number may also appear. Check after update. |