Repository navigation
Releases
ground-v1.6.2
Test build: the SDR receiver is now built into the app. Download it, plug in an RTL-SDR, open the T-Beams screen and press Turn on on the SDR's sheet. Nothing else to install, no conf file to edit. Flight software is the same as 1.6.0. Tested on the SSDS lab PC (Windows) with a real dongle; the Linux build is tested with recordings; the macOS build has not been run on a Mac yet. It is marked as a pre-release, so the app won't offer it as an update.
New in 1.6.2
- Built-in SDR: rtl_sdr and the rxx_lora decoders ship inside the app and unpack on first use. It listens on SF10, 11 and 12 at 915.0 MHz with one dongle.
- The SDR sheet says what is wrong in plain words: no dongle plugged in, another program (like SDR#) holding it, or the driver missing. On Windows that is a one-time WinUSB install with Zadig for "Bulk-In, Interface (Interface 0)"; on Linux a udev rule and blacklisting dvb_usb_rtl28xxu.
- No Python needed any more. The SDR's signal processing runs inside the app.
- An
sdr = <command>line in descent-ground.conf still overrides the built-in SDR. - The bundled programs are GPL. Their licences are in the bundle's THIRD_PARTY folder and their sources are attached to this release (descent-sdr-sources.tar.gz).
ground-v1.6.1
Test build: the SDR receiver in the dashboard. Flight software is the same as 1.6.0. The SDR has decoded our SF12 packets from a recording and live on the bench, it has not been out on a drop day yet. It is marked as a pre-release, so the app won't offer it as an update.
New in 1.6.1
- SDR receiver: put
sdr = <command>in descent-ground.conf and the app runs it. The T-Beams screen gets an SDR sheet with on/off, restart and gain (auto or fixed). - The SDR sheet shows its health as it reports it: clipping, noise floor, dropped samples and lines, and "saturated" when the SDR says so. Also per spreading factor counts for this session and its recent error output.
- Live: the SDR shows in the receivers strip as SF10 · SF11 · SF12, with its own counts.
- ground/sdr/sdr_rx.py: the SDR program for an RTL-SDR, listening on SF10, 11 and 12 at 915.0 MHz. It needs rxx_lora with the LDRO patch next to it (ground/sdr/rxx_lora-ldro.patch).
- Programs the app starts now run on their own: Ctrl-C on the app stops them within about 5 s, quitting from the page stops them at once.
- Keep the RTL-SDR on its own USB port. On a shared hub it dropped everything on the hub twice.
ground-v1.6.0
Test build with new flight software. Seen on a board on the bench: boot-air transmitting at the air gap, take-off on movement in about a second, landing after 30 s still, and a 6 ms gap between back-to-back packets. The landed duty cycle and Stop2 have only been tested on a computer, so try it on a spare board first. It is marked as a pre-release, so the app won't offer it as an update.
New in 1.6.0
- Flight software: boot-air transmits at the air gap. A board lands after 30 s still at any height, or 60 s still whatever the altitude says. A missing IMU reading counts as no movement.
- Flight software: once landed with a good fix, the board parks. It wakes once per ground rate, tries the GPS for up to 10 s (60 s every 10th wake), sends one packet and sleeps in Stop2. Tilting it or a climb wakes it fully.
- Flight software: a 2048-byte console buffer, so printing no longer holds up the loop.
- ChipSats page: one ground rate for transmitting and logging. 0 is allowed with a warning.
- ChipSats page: console log level and carrier frequency (902.0-928.0 MHz) per board, checked against the board's start line after a write.
- ChipSats page: a console card for every board, with a filter over the whole session.
- T-Beams: carrier frequency per T-Beam. ChipSat consoles and T-Beams are now told apart without asking.
- Analysis tab: one phase bar over the boots you pick, sensor strips, first IMU and GPS times, a table of everything in a pull, and charts of every field.
- Live and Replay: a 3D view and a map of a flight.
- Receiver programs: the app can run a program as a receiver (receiver = in descent-ground.conf).
ground-v1.5.5
Test build with new flight software. Boot-air ending and the IMU stepping up on the ground have been seen on a real board; take-off, landing, the landed sleep, Stop2 and the IMU pin reset have only been tested on a computer, so try it on a spare board first. It is marked as a pre-release, so the app won't offer it as an update.
New in 1.5.5
- Analysis tab: pick a pull and it lays out what the board logged, boot by boot. Reset causes and how each boot ended, phase changes with the firmware's own reason, sensor and bus events, the sensors' valid flags, lowest and highest readings, gaps, and what the log can't show. Open in Replay charts the values.
- Pulls: choose the baud rate, see valid and invalid records as they come in, and a chip with 0 records or only boot events is a finished pull, not a failure.
- Clear erases with no checks first.
- T-Beam firmware 1.2.2: the receiver reports the spreading factor its radio chip is actually on and whether it is listening, and the app confirms a factor only from that.
Flight software in this build
- Ground and air: the IMU decides and a live barometer or GPS has to agree, a climb to go up and flat to come down. The barometer alone never puts a board in the air. The rules are in fsw/V2_6_X_Code/docs/phases.md.
- On the ground the IMU runs at 1 Hz and steps up to 20 Hz when moved.
- After a flight the board looks for a GPS fix, then puts the GPS in standby and sleeps between packets (Stop2), transmitting and logging at the ground gaps. Movement wakes everything again.
- The radio sleeps between packets in every phase.
- The IMU is reset through its reset pin at every boot and when it stops answering or holds the I2C bus.
- Sensor, bus, phase, radio and flash events are logged on the chip and show in pulls and the Analysis tab.
- A ground log gap of 0 keeps every IMU reading and writes it at once.
ground-v1.5.4
Test build. The flight software here is the same as 1.5.0. Flashing, log pull and clear have worked on a real board, the rest is not confirmed on a board yet, so try it on a spare board first. It is marked as a pre-release, so the app won't offer it as an update.
New in 1.5.4
- A flashed T-Beam gets back the name it last reported, not an old name this computer had kept. The name a T-Beam reports is now the one the app keeps for it.
- After a T-Beam flash the app asks for the spreading factor until the board's own header shows it, up to five times. The card says "Asked for SFn" until then, then "SFn confirmed" with the time. If the board refuses it or never says so, the card says that in red.
- Not yet tried on a real T-Beam. Check the SF on the receiver row before trusting it.
Everything else is in the 1.5.0, 1.5.1, 1.5.2 and 1.5.3 notes.
ground-v1.5.3
Test build. The flight software here is the same as 1.5.0. Flashing, log pull and clear have worked on a real board, the rest is not confirmed on a board yet, so try it on a spare board first. It is marked as a pre-release, so the app won't offer it as an update.
New in 1.5.3
- A receiver's spreading factor counts only when the T-Beam itself says so. After you pick a new one, its row says "asked for SF9" until the board's own header line carries the new value, then "SF9 confirmed" with a toast "Mast is listening on SF9". If the board refuses (#DG,ERR,sf) or no header comes within 4 s, the row says that instead. The select always shows what the board last reported, never what was asked. The T-Beams Radio card says the same under its select, with the time.
- Flashing receiver firmware on the T-Beams screen goes on the first press of Flash, no Overwrite it step, the same as the ChipSat flight write. The card says the board is erased first; the save box is beside it.
Everything else is in the 1.5.0 notes, 1.5.1 notes and 1.5.2 notes.
ground-v1.5.2
Test build. The flight software here is the same as 1.5.0. Flashing, log pull and clear have worked on a real board, the rest is not confirmed on a board yet, so try it on a spare board first. It is marked as a pre-release, so the app won't offer it as an update.
New in 1.5.2
- The sound when a run starts is now one plain beep, in place of the chirp from 1.5.1. It plays at the same times as before.
Everything else is in the 1.5.0 notes and 1.5.1 notes.
ground-v1.5.1
Test build. The flight software here is the same as 1.5.0: it has only passed computer tests and has never run on a real board, so try it on a spare board first. It is marked as a pre-release, so the app won't offer it as an update.
New in 1.5.1
- Live gives one short chirp when a run starts: a board heard for the first time, or a board that restarted, even if its first packet was missed. Normal packets, duplicates and Replay stay silent.
- The sound setting now covers lost boards and new runs.
- Click the page once after opening it, as the browser plays no sound until then. A chirp can come late if the tab is in the background.
Everything else is in the 1.5.0 notes.
ground-v1.5.0
Test build. The flight software in this release has only passed computer tests and has never run on a real board, so try it on a spare board first. It is marked as a pre-release, so the app won't offer it as an update.
New
- Log rate and transmit rate for every battery level, in ground and in air. Boards need this flight software written to them for the tables to work.
descent-ground check <folder>prints what happened in a pull or a log, worst first.- Live shows the SF each ChipSat was last heard on.
- One status panel for flash, pull and clear, and a box when each one ends.
- After a write, the app checks the settings on the board and shows what is really there.
Changed
- Build and flash is one press with no confirmation. It refuses blank values and board id 255.
- A board with no settings to read starts from what this browser last wrote to it, otherwise empty.
- Images on older settings layouts are refused for patching. Reading older boards still works.
To test
Flash a spare board, then check that it boots, logs and transmits at the rates you set. Then pull its log and run check on it.
ground-v1.4.0
Ground app 1.4.0