Luna BBSHD User manual

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
LUNA BBSHD Ludicrous V2
Controller
USER MANUAL
Date: 2021-06-30
Revision: 2
www.lunacycle.com 1/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
Table of contents
Safety Notice 3
Required tools and hardware 4
Installation 4
Using the BBSHD Ludicrous V2 5
Power Levels 6
Connecting to VESC Tool 7
Tuning Your Controller 10
Firmware update 14
Data logging 17
Fault Codes 19
Troubleshooting 21
www.lunacycle.com 2/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
Safety Notice
This motor controller is powerful enough to melt a motor, wires, destroy a battery and break bones. With
great power comes great responsibility! Don’t try to break stuff, because you will!
The controller comes with a default configuration that should work for even the wildest users. As you can
tell from the extreme power density achieved, these motors, wires and power electronics are already
being pushed to the limit.
We are offering it for people who know what they are doing and will be responsible with this kind of
power (know what gear to ride in, understand battery limits, etc).
We prefer to sell this kit to our existing bike customers only. If you are a new customer you may need to
convince us that this is the controller you want. This is for people who have owned the stock or ludicrous
V1 BBSHD and want more.
Luna is supporting a fully Open Source platform named VESC®, which means users could potentially
change any parameter of this motor drive, and have full access to the source code to change or improve
fundamental features. Luna builds come in read-only mode to deter people from changing safety-critical
parameters, but we know its only a mild entry barrier.
Modifying the default motor configuration is NOT advised as it greatly increases the likelihood of
property damage and severe injury -and source code changes are far more dangerous-.
It is NOT legal to ride this on public streets or trails. We sell this bike for private property use and
race/track riders.
www.lunacycle.com 3/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
Required tools and hardware
● BBSHD drive unit
● Torx screwdriver
●Dielectric grease
● A display (Luna/Bafang/Eggrider). For 72V systems, an eggrider display is required, with the
beta eggrider firmware downloaded from HERE version > 2.5.58_beta
● Android device
● VESC Tool - Luna Edition Android app:
https://public.3.basecamp.com/p/3vQFDVjrG7emSnoEdNCAhiPi
Installation
You can follow the BBSHD controller replacement video:
Replacing the controller is easier if the chainring is removed, so if you plan on changing your
chainring size, this is a good time to do it.
It’s worth mentioning that the Ludicrous V2 can extend the top speed by about 25% for the same
battery voltage, so you could get more torque from a smaller chainring while keeping the same end
speed.
Typical BBSxx recommendation for improved water resistance is sealing with silicone or dielectric
grease, particularly around the grommet but also possibly around gasket, with some dielectric on
connectors as described here:
Waterproofing your motor kit - Electricbike.com Ebike Forum
Note that there is no shift sensor cable installed. If you really want it you can use one of the brake
cables.
www.lunacycle.com 4/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
Using the BBSHD Ludicrous V2
The controller works out of the box, its plug and play with no tuning needed.
It is designed to work in the same way as the stock controller: throttle accelerates, it has pedal
assist, you can choose your power level and the display shows the same variables.
Because it's the same principle with a lot more power, here are few suggestions:
● Check the maximum current you can draw from your battery.
If for example your battery can only provide 80A, set the corresponding battery current limit
with Android App (see below)
● If your display is set at the maximum power level, be careful the first time you use it. In a low
gear it can kick you off the bike.
● Be mindful about the amount of power dumped into your motor. If you drive high currents for
too long the winding temperature rise will engage the motor over temperature protection.
Motor temp is easy to see in the app gauges and in the logs.
Changing controller parameters has been disabled in our firmware builds, for safety you won’t be
able to increase any motor related setting like max currents, temps, control loop parameters, etc.
The complete set of motor parameters is hardcoded at build time so it works out of the box and
stays that way. We do acknowledge that a motivated user could build the open source firmware, but
it’s not recommended as it’s easy to damage a mis-tuned controller.
www.lunacycle.com 5/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
Power Levels
The BBSHD platform allows the user to set assist levels, typically 5, but most displays can be
configured to use 9 levels.
When set to 9 levels, it modifies the torque (or phase current) produced by the bbshd in the
following way:
PAS LEVEL
Available torque
LEVEL 9
100%
LEVEL 8
88.8%
LEVEL 7
77.7%
LEVEL 6
66.6%
LEVEL 5
55.5%
LEVEL 4
44.4%
LEVEL 3
33;3%
LEVEL 2
22.2%
LEVEL 1
11.1%
LEVEL 0
Throttle and PAS disabled
www.lunacycle.com 6/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
Connecting to VESC Tool
Get the VESC Tool Luna Edition Android app from here: Download the app installer
DON’T USE THE GOOGLE PLAY APP!!:
Here is a video tutorial to cover the basics of the connection:
WIRELESS CONNECTION - VESC-Tool Mobile Tutorial
(Again, DON’T USE THE GOOGLE PLAY APP!)
1. Open the VESC Tool App and tap SCAN
2. When your VESC shows up, click
www.lunacycle.com 7/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
CONNECT. Note there may be more than one
Bluetooth Low Energy (BLE) device in the air.
3. Your BBSHD is now connected! After a
couple of seconds the controller will transfer
the custom Luna UI to the phone.
4. In the RIDE tab you can see live data
coming from the controller. We added a Motor
Temperature gauge, as the Ludi V2 can easily
drive the motor to its temperature limits.
www.lunacycle.com 8/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
VESC Tool is also available for Linux and Windows PCs here:
VESC Tool Downloads
The app will NOT run on IOS smartphones because Apple doesn’t allow open source licences in
their App Store.
Vesc Tool on Mac laptops is not officially supported, but someone provides unofficial Mac
releases here:
https://github.com/rpasichnyk/vesc_tool/releases
We didn’t test these so use them at your own risk.
www.lunacycle.com 9/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
Tuning Your Controller
In the TUNE page you can store 3 different tuning profiles:
● STREET LEGAL
● TRAIL
● LUDICROUS
The profile names are fixed, but the actual tuning is fully configurable.
By tapping the WRITE button, the selected profile will be stored in the controller.
www.lunacycle.com 10/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
Each profile has these parameters to tune:
● Throttle Amps
The throttle controls the phase Amps, and this slider sets the max available phase current at
the throttle. Torque output is directly proportional to phase current, so the slider is ultimately
setting the amount of torque your motor produces.
● PAS Amps
The Cadence-based Pedal Assist algorithm generates torque based on pedaling speed. This
slider sets the max phase Amps produced by PAS.
● Power
Maximum power limit. Decreasing power will mostly affect mid-high speed performance.
● RPM
Set motor RPM limit
● Throttle Response
The sharpest throttle response is achieved by reducing the ramp-up time to only 0.3
seconds. For a more smoother response, the slider can increase the ramp-up time to up to 3
seconds.
● Torque Linearity
With the slider maxed out, the Throttle angle vs Torque will be fully linear. Reducing linearity
will reduce the Torque in the initial part of the throttle, making it smoother on the low end.
● Fixed Throttle Amps
When checked, the throttle current limit will be fixed at its maximum setting, equivalent to
level 9. When not checked, throttle torque follows the display levels (1 to 9). Setting level 0
always disables both throttle and PAS.
www.lunacycle.com 11/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
On the BIKE CFG tab you can set your battery and wheel size parameters. Luna provides 3
different battery presets as a reference.
www.lunacycle.com 12/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
● Battery current max
Limits your battery current to avoid exceeding its cell ratings. For example, each Q30 cell can
supply 25A in short bursts.
● Overvoltage
When the battery exceeds this voltage, a fault will be asserted.
● Undervoltage Cutoff Start
At this voltage the torque available is 100%.
● Undervoltage Cutoff End
At this voltage the torque available is 0%. Torque is linearly decreased between UV cutoff
start and end to prevent the battery from sagging too low.
● Wheel diameter
Used to calculate the speed from the wheel sensor. Wheel speed is shown in the display, in
the apps, and in the logs.
● Logging Directory
In order to store datalogs, this path needs to be defined.
www.lunacycle.com 13/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
Firmware update
This is generic a video tutorial that is worth watching BUT DON’T USE THE GOOGLE PLAY
APP!!:
FIRMWARE UPDATE - VESC-Tool Mobile Tutorial
1. Make sure your display won’t
auto-shutdown the controller during the
update process. The controller can get
bricked if that happens.
2. If your Ludi V2 had special settings,
write them down as the firmware
update will wipe out the controller
memory
3. Get the latest LUNA EDITION VESC
Tool that includes the Luna firmware.
If for some reason you need the firmware
image, here it is:
BBSHD_default.bin
Luna will let you know when new
firmwares are available
4. From the app, go to FIRMWARE tab
and select the firmware according to
your battery
www.lunacycle.com 14/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
5. Select your firmware file
6. Start UPLOAD
7. Read and accept the warning
8. Wait some minutes until upload finishes
Make sure the phone is close to the controller and don’t shut down the bbshd while firmware is
being updated.
The controller will boot up ready to run and fully configured.
Some reasons for updating the firmware may include:
www.lunacycle.com 15/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
● Bug fixes
● New features
● Tuning optimization
● Power increases
www.lunacycle.com 16/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
Data logging
With a VESC controller you can save realtime data logs on your Android phone, and study the
logs on your computer.
First, configure the logging directory in the
app (the default directory won’t work), the
setting is found in the BIKE CONFIG tab:
Once configured, you can enable data
logging at any time from the start page:
When datalogging is enabled, a .csv file will
be created in the directory you configured.
Each time logging is enabled, a new .csv
will be created.
www.lunacycle.com 17/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
After logging, send the CSV files to your PC.
3. From VESC Tool, Go to Data Analysis -> Log Analysis.
4. Open CSV
5. Browse the csv
6. Configure your variables to display.
Here you can find a video with a walk through this Log Analysis feature:
https://www.youtube.com/watch?v=1dm12zB78Ic
www.lunacycle.com 18/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
Fault Codes
When the controller detects a problem, the fault source will be shown on the bottom of the
dashboard (RIDE tab):
Fault codes are also stored in the csv when logging is enabled, which is useful when fault is
cleared before you can read it.
www.lunacycle.com 19/23

Luna
BBSHD
Ludicrous V2
USER MANUAL
2021-06-30
Here are some of the faults the controller could report:
FAULT_CODE_OVER_VOLTAGE: Battery overvoltage. Check if your battery limits are ok
FAULT_CODE_UNDER_VOLTAGE: Battery undervoltage. Check if your battery limits are ok
FAULT_CODE_DRV: Powerstage failure
FAULT_CODE_ABS_OVER_CURRENT: Phase current exceeded 230A for an instant
FAULT_CODE_OVER_TEMP_FET: Mosfets reached 95°C
FAULT_CODE_OVER_TEMP_MOTOR: Motor reached 110°C
FAULT_CODE_GATE_DRIVER_OVER_VOLTAGE: Internal 12V supply failure
FAULT_CODE_GATE_DRIVER_UNDER_VOLTAGE: Internal 12V supply failure
FAULT_CODE_MCU_UNDER_VOLTAGE: 3.3V regulation failure
FAULT_CODE_FLASH_CORRUPTION: Background memory integrity check failed
FAULT_CODE_HIGH_OFFSET_CURRENT_SENSOR_1: Phase A current sense off-spec
FAULT_CODE_HIGH_OFFSET_CURRENT_SENSOR_2: Phase B current sense off-spec
FAULT_CODE_HIGH_OFFSET_CURRENT_SENSOR_3: Phase C current sense off-spec
FAULT_CODE_UNBALANCED_CURRENTS: Phase current sensor damaged
FAULT_CODE_BRK: Hardware overcurrent protection tripped
FAULT_CODE_FLASH_CORRUPTION_APP_CFG: Application config integrity check failed
FAULT_CODE_FLASH_CORRUPTION_MC_CFG: Motor config integrity check failed
More fault sources could be added over time.
www.lunacycle.com 20/23