Skip to content

dcoon/kbms

Repository files navigation

Welcome to the KBMS project 👋

KBMS is a mobile app to monitor and configure KiloVault HLX+ LiFePO4 batteries. It is a replacement for the now defunct KiloVault app. It is free and open source.

screenshot

KBMS is still in its early stages and hasn't been submitted to app stores yet. But there is an early preview build available for testing (Android only). Expect bugs! Check the discussion group for known issues and workarounds.

Get the app

iOS

KBMS is in TestFlight Internal. If you want to help test, DM me with your contact info. Hopefully, we'll get to TF External within the next week or so.

Android

  1. Install the Android test build

Text Build QR Code https://expo.dev/accounts/davidcoon/projects/kbms/builds/5f55b7f9-63d9-475f-8f14-18316e3afdcd

Click Install on the build page to download; open with apk installer; then say Yes or Allow to all the prompts. Be aware, you'll be side loading an app on your device without review by Google. Make sure you trust this project first.

  1. Run the app

On the Devices tab, press the play icon in the upper right corner to start scanning for nearby batteries. Click on a KiloVault battery. You MAY need to press play again to connect to the battery. Graphs and data should appear within a few seconds.

  1. Troubleshooting

Information and error messages will popup at the bottom of the screen. The two most common are Bluetooth isn't on and Can't connect to device. If you can't connect to a nearby battery or it doesn't show up when scanning on the Devices tab, try turning Bluetooth off and on again.

If all else fails, go to Settings, change the Log Level to Info or Debug, reproduce the error, and Share the logs on the discussion group.

Support & Feature Requests

Feel free to ask questions in the discussion group. Screenshots and logs (LogLevel=INFO) are very helpful. Feature requests are welcome. The development roadmap is viewable in the Project Plan.

Project Plan

Contribute

  1. Artwork

Icons, splash screens, graphs...all are welcome. Submit a pull request or post to the discussion group.

  1. Translations

Internationalization is on the short term roadmap. We'll need help translating text and icons.

  1. Development

This is an Expo project created with create-expo-app and written in Typescript. Pull the repo and build using standard Expo tools. Submit a pull request with new features and fixes. If you need help with architecture, post questions in the discussions.

Join the community

Join our community of developers and battery owners.

About

Mobile app to monitor and control KiloVault HLX+ LiFePO4 batteries. Free and Open Source.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors