USER MANUAL Luna BBSHD 2021-06-30 Ludicrous V2 Table of contents Safety Notice Required tools and hardware Installation Using the BBSHD Ludicrous V2 Power Levels Connecting to VESC Tool Tuning Your Controller Firmware update Data logging Fault Codes Troubleshooting www.lunacycle.com 2/23...
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.
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 ●...
2021-06-30 Ludicrous V2 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.
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:...
BBSHD 2021-06-30 Ludicrous V2 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!)
Page 8
Ludicrous V2 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.
Page 9
USER MANUAL Luna BBSHD 2021-06-30 Ludicrous V2 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.
USER MANUAL Luna BBSHD 2021-06-30 Ludicrous V2 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.
Page 11
USER MANUAL Luna BBSHD 2021-06-30 Ludicrous V2 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.
Page 12
USER MANUAL Luna BBSHD 2021-06-30 Ludicrous V2 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...
Page 13
USER MANUAL Luna BBSHD 2021-06-30 Ludicrous V2 ● 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.
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...
Page 15
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.
Page 16
USER MANUAL Luna BBSHD 2021-06-30 Ludicrous V2 ● Bug fixes ● New features ● Tuning optimization ● Power increases www.lunacycle.com 16/23...
USER MANUAL Luna BBSHD 2021-06-30 Ludicrous V2 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 Once configured, you can enable data app (the default directory won’t work), the...
Page 18
USER MANUAL Luna BBSHD 2021-06-30 Ludicrous V2 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.
USER MANUAL Luna BBSHD 2021-06-30 Ludicrous V2 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.
Page 20
USER MANUAL Luna BBSHD 2021-06-30 Ludicrous V2 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...
Page 21
I just got it and want more power? Please note that the levels usually used for pedal assist control throttle response by default, unlike stock BBSHD. If you want more power, select a higher level or set “Fixed throttle” in the TUNE page www.lunacycle.com...
Luna BBSHD 2021-06-30 Ludicrous V2 Troubleshooting Problem Possible cause Solution Non-luna firmware flashed Flash the Luna BBSHD firmware Error 30 shown Wiring damage Check with another display in display Damaged internal supply (BLE wouldn’t Contact Luna work) Non-luna firmware flashed...
Page 23
USER MANUAL Luna BBSHD 2021-06-30 Ludicrous V2 version of VESC Tool over USB Install the driver from here: USB does not Windows CDC driver not installed in https://www.st.com/en/development-to show up windows older than win10 ols/stsw-stm32102.html In any case, if something stops working its useful to check in the app if there is any FAULT_CODE www.lunacycle.com...
Need help?
Do you have a question about the BBSHD and is the answer not in the manual?
Questions and answers