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/09/25 13:01]
dmitry [PAS and Torque sensor setup] 		en:controller:setup [2023/10/02 06:26]
vasilisk
Line 1: Line 1:
 ~~Title: Controller setup~~ ~~Title: Controller setup~~
  
-====== Controller (v.0.8.12) ======+====== 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 247: Line 247:
 In the **Controller**  > **Control**  menu section you can setup setting the engine controls, throttle levers, torque and PAS sensors, cruise control. In the **Controller**  > **Control**  menu section you can setup setting the engine controls, throttle levers, torque and PAS sensors, cruise control.
  
-===== Statistics =====+==== PAS and Torque sensor setup ====
  
-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**  > **Control**  > **Pedal Assist System**  you can set up the Pedal Assist System (PAS), which connects the electric motor when pedaling.
  
-{{:en:controller:statistics_0808.png?nolink&  }}+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.
  
-**Wh used total** — total energy consumption (used plus regen), in Watt-hours (**Wh**).\\ +You can look at the connecting methods of various PAS systems at **[[:en:controller:setup#connection_diagram|Connection diagram]]**.
-**Wh used** — energy consumption, in Watt-hours (**Wh**).\\ +
-**Wh regen.** — energy gained during the recuperation process, in Watt-hours (**Wh**).\\ +
-**Regen. %** — the percentage of energy recovered during recuperation (**%**).\\ +
-**Ah used total** — total energy consumption (used plus regen), in Ampere hours (**Ah**).\\ +
-**Ah used** — energy consumption, in Ampere hours (**Ah**).\\ +
-**Ah regen.** — energy gained during the recuperation process, in Ampere hours (**Ah**).\\ +
-**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, in degrees Celsius (**°C**).\\ +
-**Max controller temp.** — the maximum temperature of the Controller, in degrees Celsius (**°C**).+
  
-The values below are approximate!\\ +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:
-**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 =====+
  
-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.+{{:en:controller:pas_010623.png?nolink& |}}
  
-{{:en:controller:device_info.png?nolink&  }}+**PAS** — selection of pedaling assistant type **PAS sensor**  or **Torque sensor**. If there is no PAS system, select **Disabled**.
  
-**Nucular Controller** — device name depending on the type of Controller.\\ +**PAS connection** — 1-wire or 2-wire connection option, two wires are used for the angle sensor (encoder). \\  
-**Max supply** — 95V. The warranty covers supply voltages up to **90V** inclusive.\\ +**Invert PAS** — change of direction in case of 2-wire connection. Select of values **On**  or **Off**. \\  
-**Max current** — the value of the maximum phase current, depending on the type of Controller, in amperes (A).\\ +**PAS poles** — number of impulses per pedal revolution. Select of values from **1**  to **200**, in increments of **1**. \\  
-**Encoder speed** — 26kHz or 580kHz (new Controller version with orange phase wires).\\ +**PAS min. freq.** — the minimum pedal speed (cadence) at which the motor starts, RPM. Select of values from **1 RPM**  to **500 RPM**, in increments of **1 RPM**. \\  
-**Firmware date** — firmware compilation date.\\ +**PAS max freq.** — the maximum pedal speed (cadence) at which the motor starts, RPM. Select of values from **10 RPM**  to **1000 RPM**, in increments of **5 RPM**. 
-**Firmware ver.** — version of the installed firmware, you can check for updates in the section **[[:en:firmware|Firmware]]** .\\ + 
-**Loader date** — the data loader compilation date.\\ +**# PAS freq.** — the value of the signal coming from the PAS in real-time. \\  
-**Loader version** — data loader version.\\ +**PAS timeout** — the time after which the motor turns off after stopping pedaling, in seconds (s). Select of values from **0.02s**  to **5.00s**, in increments of **0.02s**. \\  
-**Production date** — date of manufacture of the controller.\\ +**PAS filter** — smoothing the control signal for smoother operation, in hertz (Hz). Select of values from **1 Hz**  to **100 Hz**, in increments of **1 Hz**. \\  
-**Worked** — operating time of the Controller in kilowatt-hours (kW*h).\\ +**PAS min out** — minimum control level when PAS is running, in percent (%). Select value from **0%**  to **100%**, in increments of **1%**. \\  
-**t° middle 100 h** — the average temperature of the Сontroller over the last 100 hours.\\ +**PAS max out** — maximum control level, in percent (%). Select of values from **0%**  to **100%**, in increments of **1%**. By analogy with the “pressed” throttle, PAS sends a signal within the specified limits. 
-**t° middle** — the average temperature of the Сontroller over all time.\\ + 
-**Current protections** — the number of triggered overcurrent protections over all time of operation of the controller.\\ +Further in the menu are the settings related to the pressure sensor (Torque sensor). 
-**Temperature protections** — the number of triggered temperature protections over all time of operation of the controller.\\ + 
-**Voltage protections** — the number of triggered voltage protections over all time of operation of the controller.\\ +**Pressure scale** — in Newton-meters/volts (Nm/V). You can calibrate by placing a load on the pedal and calculating the torque on the shaft through the lever. Select value from **0.0 Nm/V**  to **100.0 Nm/V**, in increments of **0.5 Nm/V**. \\  
-**Power cycle** — number of controller switching on.\\ +**Zero pressure** — zero pressure, in millivolts (mV). Select of values from **0mV**  to **10000mV**, in increments of **10mV**. \\  
-**Power-on time** — total operating time of the Controller, minutes, hours, days.\\ +**Protection pressure** — switching off the pressure sensor when the threshold of the specified value is exceeded, in millivolts (mV). Select of values from **0mV**  to **10000mV**, in increments of **100mV**. \\  
-**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. date.+**Torque averaging** — period for which is torque value updated. Measured in half turns (turn/2). If the torque sensor measures only one pedal, then the period must be a multiple of two. Select of values from **1 turn/2**  to **20 turn/2**, in increments of **1 turn/2**. 
 + 
 +**# Torque** — shows the current torque at the sensor, in Newton meters (Nm). 
 + 
 +**# Human watt** — shows the average power you develop when pedaling, in watts (W). \\ **Human watt min**  — the minimum power you develop to activate the motor, in watts (W). Select of values from **0 W**  to **500 W**, in increments of **10 W**. \\  
 +**Human watt max** — the maximum power for 100% activation, in watts (W). Select of values from **0 W**  to **1000 W**, in increments of **10 W**. 
 + 
 +**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** — allows torque sensor activation without rotation. Select of values **On**  or **Off**. The pressure sensor also includes frequency configuration and output level configuration as well as the usual PAS. \\ 
 +**Start torque** — minimum torque to trigger "Instant Torque", in newton meters (Nm). Select of values from **0 Nm** to **120 Nm**, in increments of **2 Nm**. \\ 
 +**Default scale** — starting power level of PAS control (for changing PAS level with buttons), in percentages (%). Select of values from **1%** to **100%**, in increments of **1%**. \\ 
 +**Button step** — power step change with button, in percentages (%). Select of values from **1%** to **100%**, in increments of **1%**.\\ 
 +**# Set scale** — current PAS power level, in percentages (%).
  
  
Line 407: 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 575: 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 757: 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 785: 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**. \\