Skip to content

Public GPLv2 release of 2nd generation Starlink Wifi Router Code

Notifications You must be signed in to change notification settings

SpaceExplorationTechnologies/starlink-wifi-gen2

Repository files navigation

Starlink WiFi Gen2 platform

Starlink WiFi Gen2 routers are dual-band 3x3 802.11ac wireless routers based on MT7629 SoCs. This platform is derived from MediaTek's SDK, which in turn is based on OpenWrt. We try to remain as close as possible to upstream OpenWrt.

What's in the box:

  • Bootloaders, kernel, drivers, and build system for Starlink WiFi Gen2 routers.
  • Anything that links against GPL2 or similarly licensed libraries.

What's NOT in the box:

  • SpaceX applications which live in the payload repository (we're not ready to open source these yet).
  • Vendor applications which have been omitted by request.

Building

On any Linux box, install Docker and generate the hermetic build container (optional inside SpaceX):

NO_PUSH=1 docker/build.sh

Then build the target image:

NO_CLEAN=1 scripts/build.sh

Outputs

Build outputs are located under bin/YYYY-MM-DD-COMMIT:

  • v2-YYYY-MM-DD-COMMIT-upgrade.bin - Upgrade image for wifi_control --flash.
  • v2-YYYY-MM-DD-COMMIT-single.bin - NAND image for U-Boot or NAND flasher.

For convenience, bin/upgrade.bin is a symlink to the most recent build.

Options

  • NO_CLEAN=1 - Enable caching for faster incremental builds.
  • OVERLAY=all - Enable persistent root filesystem overlay for faster iteration.
  • PAYLOAD=... - Use wifi_control from a local payload repository. Must already be built.
  • VERSION=... - Use a custom version name for this build.

Flashing

Connect to the router over ethernet or wireless, then copy over and flash your image:

scp bin/upgrade.bin root@StarlinkRouter:/tmp
ssh root@StarlinkRouter wifi_control --flash=/tmp/upgrade.bin --reboot

To prevent bricking by power loss or bad updates, each router stores two copies of software and alternates between them on each boot. Flashing always writes the inactive copy. Flash twice to update both copies.

Boot toggling is implemented in BL2 (the first non-ROM bootloader) of which there is only one copy. To update BL2 and both copies of all other software add --update_full. Warning: This is inherently unsafe.

Jobs

We're quietly trying to build some of the best WiFi routers on the planet at ridiculously low cost. We work hard with tiny teams on incredibly tight schedules. If that sounds fun, email wifi@spacex.com with any of the following:

  • The hardest technical problem you've solved.
  • The most innovative electronics product you've designed and manufactured.
  • The best security vulnerability you've found, or check out our bug bounty program.
  • As many ways as you can think of to accurately measure per-frame MAC and PHY properties (MCS, EVM, spectral power distribution, ...) in realtime for under $1000.

Bonus points if you can tell us:

  • What this circuit on the board does.
  • What the device at I2C address 0x20 does.

About

Public GPLv2 release of 2nd generation Starlink Wifi Router Code

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published