meta data for this page
  •  

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
Next revision Both sides next revision
en:controller:setup [2023/08/08 12:04]
dmitry [Throttle and brake voltage range setup] 		en:controller:setup [2023/10/02 06:26]
vasilisk
Line 1: Line 1:
 ~~Title: Controller setup~~ ~~Title: Controller setup~~
  
-====== Controller (v.0.8.11) ======+====== Controller (v.0.8.13) ======
  
 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 24: Line 24:
 ^Size, without wires|  53х32х91 mm  |  86х43х125 mm  |  205х98х50 mm  | ^Size, without wires|  53х32х91 mm  |  86х43х125 mm  |  205х98х50 mm  |
 ^Weight|  280g (with compound 430g)  |  640g (with compound 890g)  |  1440g (compound filled)  | ^Weight|  280g (with compound 430g)  |  640g (with compound 890g)  |  1440g (compound filled)  |
-^Warranty|  2 years (with compound potting — 3 year)  |||+^Warranty|  2 years (with compound potting — 3 year)  ||  3 year  |
  
 //In the kit: // //In the kit: //
Line 209: Line 209:
 To activate the control modes, select **Controller**  > **Advanced modes**  > **Enable add. modes**  and to set **On**. To activate the control modes, select **Controller**  > **Advanced modes**  > **Enable add. modes**  and to set **On**.
  
-In the menu **Controller**  > **Advanced modes**  > **Neutral by default**  you can activate the neutral mode (N) when the controller starts up, which will be active until one of the speed modes is activated. In a neutral mode, only the electric brake operates, throttle and PAS are disabled. This mode is recommended for use with speed buttons (not a switch). The function does not work with a 3-position switch (functions of the S1of3 and S3of3 ports in the **Controller**  > **I/O configuration**  menu). ​+In the menu **Controller**  > **Advanced modes**  > **Neutral by default**  you can activate the neutral mode (N) when the controller starts up, which will be active until one of the speed modes is activated. In neutral mode, only the electric brake operates, throttle and PAS are disabled. This mode is recommended for use with speed buttons (not a switch). The function does not work with a 3-position switch (functions of the S1of3 and S3of3 ports in the **Controller**  > **I/O configuration** menu). ​ 
 + 
 +**Neutral timer** — switches neutral on after a certain time in seconds (**s**), which is set in the settings. To turn it off, switch the speed mode. \\
  
 ~~CL~~ ~~CL~~
Line 249: Line 251:
 In the menu section **Controller**  > **Control**  > **Pedal Assist System**  you can set up the Pedal Assist System (PAS), which connects the electric motor when pedaling. In the menu section **Controller**  > **Control**  > **Pedal Assist System**  you can set up the Pedal Assist System (PAS), which connects the electric motor when pedaling.
  
-Ч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/P2** or **IO5/IO6** ports of the **USB/PWM**  connector. When using a SEMPU pressure sensor, an additional signal output from the TH port of the connector **Control**  is required.+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/P2** or **IO5/IO6** ports of the **USB/PWM**  connector. When using a SEMPU pressure sensor, an additional signal output from the TH port of the connector **Control**  is required.
 Note: to use **P1/P2** or **IO5/IO6** ports, setup them to **Spec.** mode in IO Configuration. Note: to use **P1/P2** or **IO5/IO6** ports, setup them to **Spec.** mode in IO Configuration.
  
Line 402: Line 404:
 **Lock throttle at brake** — disables the throttle lever after the brake is applied until the throttle is fully released. Helps with throttle lever glitches, in this case, the **Throttle lock** flag will be set in the menu **Status flags**. \\ **Lock throttle at brake** — disables the throttle lever after the brake is applied until the throttle is fully released. Helps with throttle lever glitches, in this case, the **Throttle lock** flag will be set in the menu **Status flags**. \\
 **Reverse on brake**  — after stopping, pressing the brake lever again activates reverse. Select of values **On**  and **Off**. **Reverse on brake**  — after stopping, pressing the brake lever again activates reverse. Select of values **On**  and **Off**.
 +
 +==== Boost mode ====
 +
 +**Boost duration** (User level) — maximum power operation time, in seconds. Select of values from **0.2**s to **10**s, in increments of **0.2**s. The function works as follows: in the **Controller** > **Control modes** menu, configure the battery current to be greater than the discharge current in the battery settings in the **Controller** > **Battery** > **Discharge max** menu. Next, select the boost operating time in the **Controller** > **Controls** > **Boost duration** menu. Now, while driving, when the battery current increases more than **Discharge Max**, the countdown of the time during which this excess will work begins, i.e. Boost. After this time, the battery current will be reset to the **Discharge max** setting level. In order for the boost mode to be available again, it is necessary to drive for 1 minute at a battery current value of no more than 70% of the Discharge max value. \\
 +
 +For example, on the Sur-Ron Ultra Bee, this mode allows you to squeeze the maximum out of the standard battery and achieve a power of 21 kW instead of 12 kW. \\
 +
  
 ==== Setup 100% speed value ==== ==== Setup 100% speed value ====
Line 534: Line 543:
 **Pole pair**  — the number of magnetic pole pairs of the rotor of the electric motor determines the speed at which the motor shaft will rotate. This parameter is used to calculate RPM and speed. For a more accurate autodetection of the Hall sensors angles, you must specify the correct value for the number of pole pairs for your motor. For the most popular motors, you can see this value in the table **[[:en:motor_information|Motor Information]]**. If your motor is not listed in the table, check with the manufacturer for the number of pole pairs. **Pole pair**  — the number of magnetic pole pairs of the rotor of the electric motor determines the speed at which the motor shaft will rotate. This parameter is used to calculate RPM and speed. For a more accurate autodetection of the Hall sensors angles, you must specify the correct value for the number of pole pairs for your motor. For the most popular motors, you can see this value in the table **[[:en:motor_information|Motor Information]]**. If your motor is not listed in the table, check with the manufacturer for the number of pole pairs.
  
-**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**  — 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. \\ 
 + 
 +**Gear ratio** — additional motor reduction factor for motors with built-in gearbox. Simplifies setting wheel ratios for speed calculation. \\
  
 **Integration thr.**  — the analog of Hall sensors angles for sensorless motor control mode, in volts (**V**). **Integration thr.**  — the analog of Hall sensors angles for sensorless motor control mode, in volts (**V**).
Line 554: Line 565:
 **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 ("quadrature") refers to the component of the stator magnetic field that is 90 ° out of phase with the rotor magnetic field. **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 ("quadrature") refers to the component of the stator magnetic field that is 90 ° out of phase with the rotor magnetic field.
  
-**Flux linkage**  — is the total magnetic flux permeating the electrical circuit, in Weber (Wb).+**Flux linkage**  — is the total magnetic flux permeating the electrical circuit, in Weber (Wb). \\ 
 + 
 +**FOC Optimization** — changes the FOC PWM mode with a choice of **Efficiency** or **Ripple**. In **Efficiency** mode — reduces losses in the controller. In **Ripple mode** — reduces current ripple in the motor and, in some cases, slightly increases motor efficiency and reduces motor noise. \\
  
 **MTPA (IPM Motor)** — enable (**On**) the MTPA function for IPM motor, for all other motors this function must be disabled (**Off**).  **MTPA (IPM Motor)** — enable (**On**) the MTPA function for IPM motor, for all other motors this function must be disabled (**Off**). 
Line 566: Line 579:
 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:display:start#battery_capacity|settings]] of On-board Computer. If you use several batteries with different parameters on the same bike, you can save the configurations for each battery on the SD card and load them after replacing the battery. The SD card can be stored in the On-board computer. 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:display:start#battery_capacity|settings]] of On-board Computer. If you use several batteries with different parameters on the same bike, you can save the configurations for each battery on the SD card and load them after replacing the battery. The SD card can be stored in the On-board computer.
  
-{{:en:controller:k20_en.png?nolink&  }}+**#Quick voltage setup** — feature to help you select the correct parameters for your battery. To automatically configure the items **Full charge**, **Supply max**, **Supply min**, you need to select the type of battery chemistry from the following options:\\ 
 +**LiIon (3.6V)** for li-ion battery.\\ 
 +**LFP (3.2V)** for lithium-iron-phosphate battery (LiFePO4).\\ 
 +**LTO (2.3V)** for lithium-titanate battery (Li4Ti5O12).\\ 
 + 
 +Next, select the **Cell count**, values from **8S** to **28S**, in increments of **1S**. After that, in the **Apply setup** item, select **Yes**. After saving the settings, you will see a window with new battery parameters. It is important to remember that we guarantee the operation of controllers with voltages up to 90V. The device is technically rated for 95V, but operating above 90V will void the warranty and you will be warned about this in a pop-up window. For example, if you try to select 22S for a lithium-ion battery. If the settings exceed 95V, the controller will also warn you that you are trying to set the voltage too high.\\
  
 +**#Limits:** section\\
 **Full charge**  — delta voltage relative to the maximum, at which when the controller is turned on, will reset the watt-hour consumption, in volts (**dV**). This setting resets the **From charge statistics**  when the Controller is turned on. Select values from **0.00 dV**  to **10.00 dV**, in increments of **0.3 dV**. **Full charge**  — delta voltage relative to the maximum, at which when the controller is turned on, will reset the watt-hour consumption, in volts (**dV**). This setting resets the **From charge statistics**  when the Controller is turned on. Select values from **0.00 dV**  to **10.00 dV**, in increments of **0.3 dV**.
  
Line 608: Line 627:
 **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**  to **120°C**, in increments of **5°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**+**MPPT** — enables and disables the maximum power point tracking feature when charging the battery through the controller from a solar panel. \\ 
 + 
 +Below in the menu section, through the **#**  sign, the real-time values of voltages, currents and power are shown: \\  
 +**# Battery I** \\  
 +**# Battery U** \\ 
 +**# Charging power** \\ 
 +**# 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.
Line 741: Line 767:
 For example, you have a 2WD scooter and two 12F controllers, you need to distinguish them somehow in the **Devices**  menu for easy setup. A controller for a front motor can be prefixed with **Front**, in which case the controller will be named **Front Nucular controller**  in the **Devices**  menu. For example, you have a 2WD scooter and two 12F controllers, you need to distinguish them somehow in the **Devices**  menu for easy setup. A controller for a front motor can be prefixed with **Front**, in which case the controller will be named **Front Nucular controller**  in the **Devices**  menu.
  
-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**.  
 + 
 +==== Access level ==== 
 + 
 +Four levels are available:\\ 
 +**Novice**\\ 
 +**User**\\ 
 +**Advanced**\\ 
 +**Engineer**\\ 
 + 
 +Depending on the selected access level, some menu items will be hidden to make it easier to configure the controller. For example, at the **Novice** level, a minimum basic set of settings will be displayed. At the Engineer level, all possible settings will be available. You can choose your level yourself.\\ 
 + 
 +**Important note**: now after updating the firmware to v0.8.13, the default level will be set to **Novice**. Remember this when you don’t find the usual menu items in the controller settings.\\ 
  
 ===== PID regulators ===== ===== PID regulators =====
Line 769: Line 808:
  **Supply undervoltage**  — too low supply voltage, less than the minimum battery supply threshold. Values **On**  and **Off**. \\  **Supply undervoltage**  — too low supply voltage, less than the minimum battery supply threshold. Values **On**  and **Off**. \\
  **12V protection**  — error on the 12V power line. Values **On**  and **Off**. \\  **12V protection**  — error on the 12V power line. 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**. **12V protection**  — breaking down or error on the 12V power line. Values **On**  and **Off**. \\+ **Control fail**  — the controller was not able to smoothly turn off the electric motor in time when throttle released. May happen with certain motors when field weakening used, decrease FW current. Values **On**  and **Off**. \\ 
 +**12V protection**  — breaking down or error on the 12V power line. Values **On**  and **Off**. \\
  **Brake error**  — brake lever connection error. Values **On**  and **Off**. \\  **Brake error**  — brake lever connection error. Values **On**  and **Off**. \\
  **Throttle error**  — throttle lever connection error. Values **On**  and **Off**. \\  **Throttle error**  — throttle lever connection error. Values **On**  and **Off**. \\
- **Hall error**  — Hall sensor connection error. Values **On**  and **Off**. \\ + **Throttle lock** — indicates that the throttle lever is disabled. Values **On**  and **Off**. \\ 
- **Code error**  — hall index error, happens when motor not autodetected. Values **On**  and **Off**. \\+ **Position sensor error**  — motor position sensor connection error. Values **On**  and **Off**. \\ 
 + **Square index error**  — signal error from sensors when trapezoidal control. Values **On**  and **Off**. \\
  **Thread error**  — processor overload. Values **On**  and **Off**. The error is not critical, let us know if it occurs. \\  **Thread error**  — processor overload. Values **On**  and **Off**. The error is not critical, let us know if it occurs. \\
  **PAS protection**  — PAS error. Values **On**  and **Off**. \\  **PAS protection**  — PAS error. Values **On**  and **Off**. \\
Line 825: Line 866:
 **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, you can delete unnecessary files from the card. After that, restart the Controller and start recording again. If the error repeats, contact us through the website or chat technical support and report the error code. **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, you can delete unnecessary files from the card. After that, restart the Controller and start recording again. If the error repeats, contact us through the website or chat technical support and report the error code.
  
-**Stop logging**  — stop recording, select **On**  to end recording.+**Stop logging**  — stop recording, select **On**  to end recording. \\ 
 + 
 +**Continuous logging** — allows you to activate the continuous logging mode, including during stops. In firmware before v0.8.12 the log was written only during driving and electric motor operation. \\
  
 ~~CL~~ ~~CL~~