Home

Install dependencies with a package manager:

• envoy
• protoc-gen-grpc-web
• npm
• protoc

For MacOS, brew install envoy protoc-gen-grpc-web npm protoc

Clone the repo:

• git clone https://github.com/ShaneTWilliams/capstone.git
• git submodule init
• git submodule update software/firmware/lib/nanopb

Install the webapp:

• cd software/frontend
• npm install

Install the Python package:

• cd ..
• python -m venv .csvenv
• source .csvenv/bin/activate
• pip install -e .

Run the build steps:

• capstone values
• capstone proto
• capstone drivers
• capstone convert

Venv needs to be active for capstone ... commands to work

Every step above is mandatory for the below commands to work

Power up the drone:

• Connect battery (taps and main connector)
  • Ensure metal clips on battery straps are not touching either PCB
• Move the switch on the left side of the drone to the forward positions (towards the camera)
  • This switch can be in any position during startup, but having it on just helps you know when the charger has effectively “started” the BMS. The switch can then be turned on and off as you wish and the drone won’t require the charger to “jump start” until you disconnect and reconnect the battery. The switch must be on to receive telemetry over USB-C
• Place the drone on a wireless charger until the drone beeps and the LED illuminates

Do not store the drone long-term with the battery connected; even with the switch off or the system not “jump-started” there is significant quiescent current that will drain (and eventually damage) the battery

Run the software

• To run the server: capstone ground
• Plug the drone in over USB. The ground station software should show that the drone is connected in a terminal

To view telemetry in the terminal:

• capstone watch <value>
  • Here <value> can be all to watch all values
  • This is a lazily written curses script, so if your terminal window is not tall enough it will crash! Sorry

To view telemetry in the browser:

• capstone ui then navigate to localhost:3000
  • Most of this UI is non-functional, but light/dark mode work! (lol)