practical embedded, llc



Kelly controller dashboard User's GUIDE



The Kelly Controller Dashboard Android app provides a configurable dashboard for your Controller Area Network (CAN) enabled Kelly KLS motor controller. The app requires your KLS controller to have the CAN module installed. Not all KLS controllers are shipped with the CAN module installed, so you will need to confirm if your controller supports CAN.


The app is designed to operate ONLY with the CAN broadcast protocol specified here by Kelly Controller for KLS sinusoidal wave controllers. The app can be modified to support any published CAN protocol. If interested please contact us at support@practicalembedded.com.


The app is data monitor only. There is no capability to tune your controller through the CAN interface. You can however configure the dashboard to your vehicle configuration. Note that the app setup menu is disabled while the vehicle is moving to prevent driver distraction.


The app display will not update until the CAN to USB-C serial converter is attached to your Android device and CAN messages are received from the controller. There is a Demo mode with a static display where you can review the app functions and access the setup menu.


The app does not require any wireless network, Bluetooth, or cell coverage to operate. The app does not require the use of GPS, although you can optionally choose to use GPS for position and to aid the speed calculation.


The following sections describe the process to setup and configure the app for your vehicle configuration.



warning



Safe operation is the driver's responsibility. Configure Kelly Controller Dashboard while stationary. Certain app features are disabled once the vehicle is in motion. Mount your device securely. By using this app, you acknowledge that Practical Embedded, LLC bears no liability for accidents, injuries, damages, or losses resulting from use or misuse of the application.


The app is intended to be a fun and inexpensive way to add monitoring to your controller. The app is not a safety device and the data accuracy is not guaranteed. Always default to your vehicle's OEM display (if provided) for the most accurate information. You must agree to the Terms of Service prior to using the app.


Kelly Controller Dashboard does not collect your personnel information or track you. Please review the Privacy Policy.



Installation



Connecting your CAN to USB-C serial converter is easy! Simply connect the three CAN signal wires (H), (L), and (G) from your Kelly controller wire harness to the labeled pins on the converter. Check your Kelly Controller User's Manual for the CAN pinout on your harness. Next, use a standard USB-C cable to connect to your device. The converter is powered over USB-C.



Keep the USB length between the converter and your device as short as possible by running the CAN bus longer. CAN bus is robust against system noise.



Connect the CAN to serial converter to your device then launch the app. The converter will be identified on a selectable list. Click on the item to start the user interface. You will need to grant Permission for the USB converter to connect to your device the first time you run the app. If the converter does not appear on the list, select Refresh from the pull down menu.



overview



1. Motor or controller overheat warning

2. Battery voltage meter

3. Throttle level graph

4. Motor temperature meter

5. Electrical fault

6. Menu

7. Speedometer

8. Boost mode enabled

9. Enable GPS operation

10. Speed calibration

11. Reset the chronograph and lap count

12. Lap counter

13. Drive direction

14. Track

15. Set track position

16. Scrollable message display

17. Chronograph

18. Show lap times

19. Adjust the track view angle

20. Start the time

21.Throttle fault

22. Power level

23. Tachometer

24. Battery low indicator



1. Select track from pull-down

2. Set the track view angle

3. Select the gauge, then set the range and Green, Yellow, Red limits

4. Diameter of tires on the drive axle

5. Teeth on clutch and axle (determines gear ratio)

6. Calibrate the speed

7. Adjust the throttle graph limits

8. Save the settings as you update, click Done when finished



operation



The display will update when the device receives CAN messages from the motor controller. The update rate is driven by the CAN message rate. The display information is driven directly by the controller CAN messages, except for the speed, chronograph, and track position.


The speed is estimated based on the RPM and the drivetrain information provided. There are numerous factors that effect the true speed, so a slider is provided to adjust the speed estimate. You can also adjust the gear teeth (which is used to calculate the gear ratio) and tire diameter settings to get the display closer to true speed. If you enable GPS, the GPS will aid the speed estimate at the expense of increased device battery drain.


The chronograph updates at the CAN message rate. The Lap feature will show your lap times based on the start/finish line identified by clicking the Set button when the red dot is physically at the line, or when GPS is used, the track start/finish line in the track database. The times are estimates because the app can only determine when the start/finish line is crossed between the update cycles.


The track is the app's most unique feature. Your vehicle's position on the track is estimated by speed. By default, GPS is not used. This means you can select any track you want, and the app will simulate your position along that track based on your speed alone. The tracks use real distance, so your movement along the track is as if you were actually there! If you are physically at the track, then you can enable GPS to increase the accuracy of your position at the expense of increased battery drain. You can change the track perspective by using the slider to rotate the track in the display.



Using the built-in track database instead of Google maps allows the app to estimate your track position without GPS, fit the track in the dashboard space, keep the app size small, and improve the performance.



If you would like to see a track added to the database and track coordinates are available on OpenStreetMap, contact us at support@practicalembedded.com.


GPS Mode:


Clicking the GPS button will enable GPS mode. Once GPS mode is enabled, you cannot disable it without refreshing the display. You will need to grant permission for the app to use your precise GPS position. The button will turn yellow and then green once the device has a precise location. The track position will not update accurately until the button turns green. Many factors affect how long it takes before the button turns green, but it usually takes a few minutes. You will notice your battery drains faster when the GPS is being used.



WIth GPS mode enabled, your speed estimate will aided by the GPS velocity provided by your device. This value can sometimes be way off, but since the app knows your RPM and drivetrain information, it can reject the GPS velocity when it is significantly off. This provides a better experience than other generic speedometer apps.



TIPS



* The display is optimized for both landscape and portrait orientation. You must select which before launching the dashboard display. The display is locked after launching to prevent vehicle motion from triggering a sudden rotation.


* You can connect a USB hub to your device and charge simultaneously while using the converter. You must make sure your hub supports data as well as charging.


* In order for the Motor Temperature Display to function, you need to connect a motor temperature sensor to your KLS controller. The KLS controller can read a specific type of thermistor. Check your KLS User's Manual for details.


* Certain fault indicators are triggered by the limits programmed into the controller by the user or OEM.


* Some of the faults indicator icons can have multiple causes. Check the message display for the specific fault.


* The message display is scrollable when the vehicle is not in motion. Since the widget is small it can be a bit tricky and varies with the type of device you are using, but it works!


* When configuring your gauge setup, make sure and hit the Save button before moving on to the next gauge.



Troubleshooting



USB Connection Issues:


* If the CAN to serial converter is not detected by the app, select Refresh devices from the menu pull-down.


* Confirm that the CAN to serial converter board is getting power by checking the LEDs. If the LEDs are not lit, try a different USB cable.


* Make sure your Android device is NOT set to USB Charging Only.


* For Advanced users, you might try placing your device into Developer mode for more options. Some devices controlled by corporate policy will not allow ANY USB communication.


* Try a different Android device. The app will work with older devices, so acquiring an older inexpensive used device is a good option for dedicated use on your vehicle.


Demo Mode:


A Demo mode is accessible from the pull down menu when no serial converter is connected. The dashboard will display with all indicators active, but will not update. The Setup menu is available and functions as normal.


CAN bus disconnected:


If the CAN to USB-C serial converter is connected to the device, but no CAN bus is connected or active, some app functionality will be available at a low update rate as the converter will send a default CAN test message.


For help or questions contact us at support@practicalembedded.com.



acknowlEdgements



The app uses the following Android libraries:

Speedview by Anas

USB Serial by

License info is provided here.





practical embedded, llc



since 2008





Site Last Updated May 30, 2026