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
en:controller:setup [2024/03/27 10:13]
dmitry [Throttle control mode setup] 		en:controller:setup [2026/09/03 07:35] (current)
vasilisk [Battery]
Line 25: Line 25:
 ^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)  ||  3 year  | ^Warranty|  2 years (with compound potting — 3 year)  ||  3 year  |
- 
-//In the kit: // 
- 
-   * CAN-cable 1,2-meters length for connection to the On-board Computer. 
-  * Phase wires. 
-  * Battery wires 
-  * Hall sensors wire. 
- 
-Phase, battery, and Hall sensors wires are supplied with connectors, depending on the type and specification of the controller in the order. 
- 
-//Optionally you can order:// 
- 
-  * САN-cables 0,3 and 2 meters length. 
-  * Controller-side inputs for connection throttle, brakes levers directly to the Controller. 
-  * PWM/PAS wire for connection PAS, fans for cooling or brake lights. 
  
 ===== Connection diagram ===== ===== Connection diagram =====
Line 47: Line 32:
 When the power is turned on for the first time, the controller will start automatically. To enable/disable the controller, you must connect an external switch according to the diagram or configure the button located on the back of the On-board computer in the menu **Devices**  > **Controller**  > **Extra parameters**  > **Disable button**. When the power is turned on for the first time, the controller will start automatically. To enable/disable the controller, you must connect an external switch according to the diagram or configure the button located on the back of the On-board computer in the menu **Devices**  > **Controller**  > **Extra parameters**  > **Disable button**.
  
-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:display:start|On-board computer]]** . To access the ports, you need to unscrew five screws and remove the plastic cover. For connection, use PHD 2.0 connectors and crimp pins, which are included in the kit. If you do not have a crimping tool such as Crimper SN-2549, you must order "Crimped wires for display". The On-board computer is connected to the controller with one CAN-wire 1.2 meters long, which is included in the controller kit. Be careful, the CAN-wire from the Controller is connected to the **SYSTEM**  connector on the backside of the On-board computer.+You can find the wiring diagrams for 6F,12F,24F, On-board computer and uLigt on this [[https://drive.google.com/file/d/175f4Cv4QuhjYu4UIwU951rA5HNJUEr5k/view?usp=drive_link|link]], wiring diagram for P24F and Encoder board [[https://docs.nucular.tech/doku.php?id=en:controller:schematic|here]]. By default, all peripherals (throttle, brake, switches, etc.) are connected into ports located on the backside of **[[:en:display:start|On-board computer]]** . To access the ports, you need to unscrew five screws and remove the plastic cover. For connection, use PHD 2.0 connectors and crimp pins, which are included in the kit. If you do not have a crimping tool such as Crimper SN-2549, you must order "Crimped wires for display". The On-board computer is connected to the controller with one CAN-wire 1.2 meters long, which is included in the controller kit. Be careful, the CAN-wire from the Controller is connected to the **SYSTEM**  connector on the backside of the On-board computer.
  
 If you want to connect peripherals directly to the Controller, you need to order "Control-side inputs", in the diagram below this switching option is designated as "Alternative connection". You can also use a mixed connection, for example, connect the throttle lever to the On-board computer, and the brake lever to the Controller. \\ If you want to connect peripherals directly to the Controller, you need to order "Control-side inputs", in the diagram below this switching option is designated as "Alternative connection". You can also use a mixed connection, for example, connect the throttle lever to the On-board computer, and the brake lever to the Controller. \\
Line 125: Line 110:
 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. 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.+**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. This parameter have priority over **Discharge max** in **Battery** menu and can be used to activate boost mode.
  
-**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**. Optional parameter, by default set to 0.0kW to disable power limit (battery current will be used instead). Should be used with **Power** throttle modes for better power regulation by throttle.
  
 **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:controller:setup#speedometer_setup|Speedometer setup]]**). A speed value over 100% activates the field weakening mode, which allows the motor to accelerate above the supply voltage (see section **[[:en:controller:setup#field_weakening_setup|Field weakening setup]]**). **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:controller:setup#speedometer_setup|Speedometer setup]]**). A speed value over 100% activates the field weakening mode, which allows the motor to accelerate above the supply voltage (see section **[[:en:controller:setup#field_weakening_setup|Field weakening setup]]**).
Line 178: Line 163:
 ===== Advanced control modes ===== ===== Advanced control modes =====
  
-In the menu section **Controller**  > **Advanced modes**  enables the control modes and activates the advanced settings for each of these modes.+In the menu section **Controller** > **Advanced modes** enables the control modes and activates the advanced settings for S1/S2/S3 modes which are located in the corresponding menu section.
  
 {{:en:controller:k5_en.png?nolink&  }} {{:en:controller:k5_en.png?nolink&  }}
Line 517: Line 502:
 ===== 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: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. 
 + 
 +<WRAP center round tip 60%> Controller estimates remaining battery charge from Wh consumption (energy drawn by the controller), not from battery voltage. Voltage-based estimation is inaccurate — voltage fluctuates with load, temperature, and chemistry in a non-linear way, making it an unreliable indicator of actual remaining capacity. Because the percentage is calculated from cumulative Wh usage since the last full charge, it does not update upward during a partial charge. The system recalibrates (resets to 100%) only when the battery reaches 100% at the moment of power-on. If you charge from, say, 40% to 70%, the display will continue showing 40% until the next full charge and power cycle. </WRAP> 
 + 
 +**#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).
  
-**#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.
  
-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**.
  
-**#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**.+**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.
  
-**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**.
  
-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. </WRAP>
  
-<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. </WRAP>+**Charge max** — maximum battery charging current, during regeneration or in **Converter** mode, in amperes (**А**). Select values from **1.0A** to **400.0А**, in increments of **0.5А**.
  
-**Charge max**  — maximum battery charging current, during regeneration or in **Converter**  mode, in amperes (**А**). Select values from **1.0A**  to **400.0А**, in increments of **0.5А**.+**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А**, in increments of **0.5А**.
  
-**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А**, in increments of **0.5А**.+**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**.
  
-**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 =====
Line 689: Line 682:
 ===== 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** > **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**. Status flags reset after controller reboot, if issue happens - try to check flags before turning off controller or resetting them.
  
 {{:en:controller:status_en_0504.png?nolink&  }} {{:en:controller:status_en_0504.png?nolink&  }}
  
-**Reset?**  — reset all statuses. Values **On**  and **Off**. \\ **Max acceleration**  — maximum acceleration, in ERPM/s. \\ **Min deceleration**  — maximum deceleration, in ERPM/s. \\ **Overload current**  — the last recorded current on the phases, in Amperes. \\ **Overload**  — exceeding the permissible current values. Values **On**  and **Off**. \\ **High V ripple**  — overcurrent on the P24F controller (plate) which is monitored via voltage ripple. Values **On**  and **Off**. \\ **Over-Field weakening**  — weakening error. Values **On**  and **Off**. \\ **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 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**. \\ **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**. \\ **Throttle error**  — throttle lever connection error. Values **On**  and **Off**. \\ **Throttle lock**  — indicates that the throttle lever is disabled. 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. \\ **PAS protection**  — PAS error. Values **On**  and **Off**. \\ **Controller overheat**  — overheat protection of the controller. Values **On**  and **Off**. \\ **Motor overheat**  — overheating protection of the electric motor. Values **On**  and **Off**. \\ **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**. \\ **ADC sample error**  — software error of the analog-to-digital converter (ADC). Values **On**  and **Off**. \\ **VBUS sample error**  — supply voltage measurement error. Values **On**  and **Off**. \\ **Voltage on phases**  — overvoltage on phases. Values **On**  and **Off**. \\ **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**, **Bit recessive**, **Bit dominant**, **CRC**, **SW**. Tell us the code if this error occurs. \\ **Receive w/error**  — CAN-bus errors on receiving. \\ **Sent w/error**  — CAN-bus errors on transmitting. \\ **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. \\ **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**  — current load of the central processor, in percentage (**%**).+**Reset?** — reset all status flags. Values **On** and **Off**.   \\ 
 + **Max acceleration**  — maximum acceleration, in ERPM/s. \\ 
 + **Min deceleration**  — maximum deceleration, in ERPM/s. \\ 
 + **Overload current**  — the last recorded current on the phases, in Amperes. \\ 
 + **Overload**  — exceeding the permissible current values. Values **On**  and **Off**. \\ 
 + **High V ripple**  — overcurrent on the P24F controller (plate) which is monitored via voltage ripple. Values **On**  and **Off**. \\  
 +**Over-Field weakening**  — weakening error. Values **On**  and **Off**. \\ 
 + **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 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**. \\ **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**. \\ **Throttle error**  — throttle lever connection error. Values **On**  and **Off**. \\ **Throttle lock**  — indicates that the throttle lever is disabled. 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. \\ **PAS protection**  — PAS error. Values **On**  and **Off**. \\ **Controller overheat**  — overheat protection of the controller. Values **On**  and **Off**. \\ **Motor overheat**  — overheating protection of the electric motor. Values **On**  and **Off**. \\ **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**. \\ **ADC sample error**  — software error of the analog-to-digital converter (ADC). Values **On**  and **Off**. \\ **VBUS sample error**  — supply voltage measurement error. Values **On**  and **Off**. \\ **Voltage on phases**  — overvoltage on phases. Values **On**  and **Off**. \\ **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**, **Bit recessive**, **Bit dominant**, **CRC**, **SW**. Tell us the code if this error occurs. \\ **Receive w/error**  — CAN-bus errors on receiving. \\ **Sent w/error**  — CAN-bus errors on transmitting. \\ **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. \\ **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**  — current load of the central processor, in percentage (**%**).
  
 ===== Debug information ===== ===== Debug information =====