README.md

[ SmartController & SmartDisplay ]

⚠️ Warning : this is work in progress. I decline all responsability about using informations from this project ⚠️

To contribute and help this project :

What is SmartController ?

It's a combo of electronic and smartphone application. It extend all features from original Minimotors EYE LCD and Minimotors controller, but it can also interface Zero, Apollo, Vsett, VESC adnd Kelly controllers. The electronic board will interract with most of the e-scooter electronic when you plug it. You simply place the little box inside the deck and connect it to the controller (and other electric parts if you want more features)

What is SmartDisplay ?

It is an extension of the SmartController to completly replace the standard display of the escooter. It mainly uses the same hardware/software. For hardware, you only need to add a small extension board with the correct FPC connector... and of course, the LCD screen.

Requirements

• An e-scooter with any supported controllers (single or dual)
• An power supply between 36V and 100V... (possible with external DC-DC providing 5V if needed)
• If you want to use progressive brake feature, you must ensure no more than 60V pass in the brake handle (issue noted only for Kaabo)
• The electronics (ESP32 Dev KitC V4 + SmartController shield + JST SM/PH connectors + SmartDisplay shield if you want to connect the LCD display)
• Some electronic skills

Features

Features	SmartController	SmartDisplay	Note
Waterproof display with 3.5" screen		✅	Need a custom lcd enclosure with handlebar bracket.
Progressive electric brake	✅	✅
Temporary disable electric brake on high voltage	✅	✅
Bluetooth android application with dashboard and settings	✅	✅
Bluetooth and Wifi security integrated	✅	✅	BLE Encryption, Wifi WPA, HTTPS OTA
Wifi web application with dashboard and settings	✅	✅
Intelligent battery autonomy computing with LG MJ1 cell reference	✅	✅
Anti-theft with bluetooth proximity and manual locking	✅	✅	Up to 2 Bluetooth devices can be registered and scanned
Fast mode, acceleration, eco switches with smartphone	✅	✅
Fast mode, acceleration, eco switches with custom hardware remote	✅	✅	Need a custom buttons enclosure with handlebar bracket.
Automatic shutdown after inactivity	✅	✅
Custom acceleration curves	✅	✅
Configurable speed limiter with fast on/off	✅	✅
Multiple monitoring option like temperature, humidity, current/power	✅	✅	With SmartDisplay, it needs external sensors.
Push to start mode (PAS)	✅	✅
Compatibility with Dualtron, Speedway, Futecher, Zero, Vsett, VESCs	✅	✅	VSett needs confirmation but it seems to be the same as Zero. Dual VESC needs work.
Over the air update with wifi connection	✅	✅
Data logging on smartphone	✅	✅

What can be done ?

I suggest you to have a look at all planed/added features in the image below. There is almost no limit in custom features. The controller power cannot exceed the nominal power, but with a shunt, you can increase the acceleration and still have a current control loop to limit the current by software (and avoid burning the controller).

Most settings will be configurable by the smartphone, and additionnal hardware buttons will allow you to control specific features.

Some examples :

• It can lock the escooter with bluetooth proximity (with a beacon, the smartphone or any bluetooth device). When locked, the power is so reduced that nobody can ride it is you aren't close enouth. You can also manually lock the scooter with the Smartphone.

• You find the acceleration trigger to agressive at low speed ? you can change the acceleration curve for smooth trigger at low speed, and still have the beast once you push the trigger harder

• You want a mode for some weather conditions like 'rainy' with less torque ? no problem. Use fast settings access on the application dashboard or configuration hardware buttons.

• You feel the electric brake too strong at full power ? The progressive electric braking adjust the brake power with digital, or better, analog brake lever pressure sensor in real time.

• You can to limit speed to legal limits at startup ? Simply enable the option, and the speed limit can be removed with a brake pressure at startup or the smartphone.

• You want to control all settings for the Smartphone ? Use the Android native application or you can connect any device to the SmartElec in Wifi

• You want to know if there is not issue inside you escooter deck ? Temperature and humidity sensors will tell you is water entered inside the deck or if the ESC/battery is overheating.

>>> Check all detailed features here <<<

Board assembly (v1.4.2)

Wrapping & Size

Current PCB size : 6.5cm (7cm with display connector) x 3.0cm x 1.5cm

Electronic

Compatibility

The software is designed for ESP32 Dev Kit v4 microcontroller.

Schematics

PCB schematic v1.4.2

old - PCB schematic v1.3.2

Protype parts list

Google sheet

Inspiration to understand controller electronic

China BLDC motor controller 36v 250W

3D parts

The display and buttons cases are available here : STL Parts

Applications

Android

SmartElec Application - Google play

iPhone

I have no skills in iPhone apps. If anyone wants to develop, let me know 😉

ToDo / Done

• Escooter controllers ↔️

  • [✅] Serial Minimotors
    • [✅] Read/write serial link LCD_TO_CNTRL
    • [✅] Read/write serial link CNTRL_TO_LCD
    • [✅] Decode speed/mode/brake/regulator from serial link
    • [✅] Frame error detection
    • [IN PROGRESS 🔄] Error codes processing
      • [✅] Controller under voltage error
      • [✅] Throttle voltage
      • [✅] Brake voltage
      • Controller other error
  • [✅] VESC
    • [✅] Read serial link
    • [✅] Decode datas : speed, voltage, current
    • [✅] Set speed 1/2/3 modes
    • [✅] Electric brake max power setting
    • [✅] PAS
    • [✅] Lock (anti-theft or manual)
    • [✅] Speed computing
    • [✅] Temperature feedback
    • [✅] Brake power smartphone feedback
    • [✅] Speed limiter
    • [✅] Power processing / display
    • [✅] Brake forbiden on high voltage
    • [✅] Electric analog brake processing
    • [✅] Electric digital brake processing
    • [IN PROGRESS 🔄] Dual VESC - PRO Version
      • Change speed limits
      • Change current/acceleration limits
      • Get infos
    • Error codes processing
      • Temperature alarm
      • Other errors
  • [✅] Zero/Apollo
    • [✅] Read serial link
    • [✅] Decode datas : speed, mode, power, pas ...
    • [✅] Set speed 1/2/3 modes
    • [✅] Speed computing
    • [✅] Speed limiter
    • [✅] Lock (anti-theft or manual)
    • [✅] PAS
    • [✅] Set accel mode
    • [✅] Electric brake max power setting
    • [✅] Brake power smartphone feedback
    • [✅] Brake forbiden on high voltage
    • [✅] Electric analog brake processing
    • [✅] Electric digital brake processing
    • Error codes processing
  • [✅] Kelly
    • [✅] Read serial link
    • [✅] Decode datas : speed, voltage, controller temperature
    • Error codes processing

• Communications

  • [✅] Bluetooth
    • [✅] Communication with Android
    • [✅] Dashboard
    • [✅] Anti-theth with smartphone
    • [✅] Anti-theth with beacon (scan & rssi detection)
    • [✅] Lock beacon or device settings
    • [✅] SmartController connection security (PIN code)
    • [✅] SmartController connection with multi devices (BT device choice)
    • [✅] Settings
    • [✅] Flash firmware
  • [✅] Wifi
    • [✅] Settings
    • [✅] Flash firmware
    • [IN PROGRESS 🔄] Dashboard

• Other inputs/outputs ↔️

  • [✅] Read current with WCS1700
  • [✅] Read battery voltage
  • [✅] Read tempertature/humidity with DHT11/DHT22
  • [✅] Read break handle position on serial
  • [✅] Read break handle position on standard brake handle
  • [✅] Read break handle position on analog brake handle
  • [✅] Read buttons
  • [✅] Send break handle position to controller
  • [✅] Send LED status
  • [✅] Send optocopler order
  • [✅] Internal temperature sensor
  • [✅] Throttle signal regeneration
  • [IN PROGRESS 🔄] External expansion boards - PRO Version
    • [✅] IO and sensors
    • [IN PROGRESS 🔄] GPS & anti-theft
    • [IN PROGRESS 🔄] Time and date

• Power 🔋

  • [✅] Convert 12V to 5V
  • [✅] Convert 80V to 5V
  • [✅] Convert 100V to 5V

• Features ⚙️

  • [✅] Save settings in non volatile memory
  • [✅] Progressive electric braking (software detection)
  • [✅] Progressive electric braking (hardware analog detection)
  • [✅] OTA update
  • [✅] Current measure auto calibration (at startup)
  • [✅] Current measure manual calibration
  • [✅] Speed limiter at startup
  • [✅] Configurable speed limit
  • [✅] Remote physical button
    • [✅] Speed limiter ON/OFF
    • [✅] Lock ON
    • [✅] Nitro Boost continuous
    • [✅] Nitro Boost ON/OFF
    • [✅] Aux ON/OFF
    • [✅] Switch modes 1/2/3 or 2/3
    • [✅] Settings access
  • [✅] Disable electric brake with full battery
  • [✅] Manual calibration for analog brake
  • [✅] Manual calibration for voltage
  • [✅] Use brake switch as startup for speed limiter
  • [✅] LCD Speed adjustment
  • [✅] Exponential acceleration curve
  • [✅] PAS switch
  • [✅] Custom acceleration curves (linear/expo/custom)
  • [✅] Automatic power off
  • [IN PROGRESS 🔄] Dynamic BLE debug infos

• Android application 📱

  • [✅] Display :
    • [✅] Speed
    • [✅] Mode
    • [✅] Voltage
    • [✅] Current
    • [✅] Power
    • [✅] Brake mode (PA)
    • [✅] Max speed
    • [✅] Max power
    • [✅] Max current
    • [✅] Temperature
    • [✅] Humidity
    • [✅] Time
    • [✅] Moving time
    • [✅] Odometer / distance
    • [✅] Trip distance
    • [✅] Average speed
    • [✅] Autonomy
    • [✅] Brake forbiden
    • [✅] Errors
  • [✅] Auto-launch app with NFC tag
  • [✅] Parameters custom settings
  • [✅] Data logging
  • [✅] History graphics
  • [✅] Integrated settings help
  • [IN PROGRESS 🔄] Wizzard for calibrations

• iPhone application 🍏

  • use wifi dashboard

Let's go ! 🛴

• Escooter wiring diagrams
• Produce your own board
• Wiring
• Run it !
• Settings description

Ressources 🔗

• Serial links data decoding - Excel XLSX

Hardware revisions ⏱️

1.4.2

• fix throttle ADC voltage for external throttle
• add LCD display backlight control
• switch to LM5164 regulator
• add power latch

Donate to support 💰

If you want to support me, click here !

License

The code is under GNU GPL v3 license All code usage must be redistributed in public.