Skip to content

owenthewizard/rpi-wifi-bridge

Repository files navigation

rpi-wifi-bridge

A minimal buildroot image to turn the Raspberry Pi into a Wi-Fi to Ethernet bridge.

Quick Start

  1. Download the latest sdcard.img for your Pi from the releases page and flash it to a micro SD card.
  2. Mount the root filesystem from the micro SD card and modify the config files according to CONFIG.md. This can also be done on the Pi itself if you have a serial console available:
mount / -o remount,rw
vi /etc/wpa_supplicant.conf # add your Wi-Fi
vi /etc/hostname # optional
mount / -o remount,ro
reboot
  1. (Re)boot the Pi and connect your Ethernet client. Observe that it now has network connectivity!

Compatibility

The two prebuilt images are designed to be compatible with the Pi 1/0/0W and 2/3/4/02W. That said, to date only the 0W and 3 have been tested and confirmed working.

Board Working Version Tested Notes Updated
Raspberry Pi 0w v4 Beta
Raspberry Pi 3 v5 Beta @owenthewizard 02/27/2024

Advanced Usage

You can leverage buildroot's extreme flexibility to make all sort of customizations to the image. See BUILDING.md for more info.

How It Works

See BridgeNetworkConnectionsProxyArp on the Debian Wiki.

Contributing

Pull requests are always welcome.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be licensed under the terms of the GNU General Public License, either version 3 of the License, or (at your option) any later version.

Versioning

This project is currently in a pre-release stage. Final versioning scheme is TBD.

Changes are documented in the Changelog.

Authors

See the list of contributors.

License

Subject to the below exceptions, code is released under the GNU General Public License, version 3 or (at your option) any later version. See also the Buildroot license notice for more nuances about the meaning of this license.

Patches are not covered by this license. Instead, they are covered by the license of the software to which the patches are applied.

See LICENSE.md for a copy of the GNU General Public License version 3.0.