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 [2026/04/20 10:42]
vasilisk [Status flags] 		en:controller:setup [2026/09/03 07:35] (current)
vasilisk [Battery]
Line 502: 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.
  
-**#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).+<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>
  
-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.+**#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).
  
-**#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**.+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.
  
-**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.+**#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**.
  
-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**.+**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.
  
-<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>+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**.
  
-**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А**.+<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>
  
-**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А**.+**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А**.
  
-**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**.+**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**. 
 + 
 +**# 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 674: 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**. Status flags reset after controller reboot, if issue happens - try to check flags before turning off controller.+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 =====