Skip to content

Latest commit

 

History

History
68 lines (47 loc) · 4.58 KB

README.md

File metadata and controls

68 lines (47 loc) · 4.58 KB
Raw

Hotspotβnβ Disk Image (Raspberry Pi)

Get Hotspotβnβ running on any Raspberry Pi.

Fastest Method (Non-Linux Machines e.g. Windows, Mac etc)

  1. Visit Latest Releases
  2. Download the latest pre-comiled image (attached in the 'assets' segment at the bottom of the release notes)

Compiling a fresh Disk Image (from Source)

  1. Grab a local copy of this directory:
    • Git Checkout '/hbnb/arm/' from this 'Net-Installer' Branch is the best and recommended method
    • Or Git Fetch/Clone the whole 'Net-Installer' Branch will get files you don't need, but it's easier
    • Or Git Fetch/Clone or Zip download the entire monorepo is not recommend, since it's tens of gigabytes in size
  2. Run the following Command: sudo bash ./compile.sh
    • this script will produce an upto-date image entitled 'hbnb-latest.img.xz'

Burn the image to your Raspberry Pi's MicroSD Card

Insert your Pi's MicroSD Card into your laptop/desktop computer Using your prefered Disk Burning Program, write the image to the Card.

  • We recommend RaspberryPi Imager since it supports Windows, Mac & Linux Most other softwares do the same job if you prefer not to use RPI Imager e.g. Etcher, Win32 Disk Imager, Gnome Disk Utility etc

The disk image is now ready to go into your Raspberry Pi (providing the Pi has internet access via Ethernet)

Wireless (Wi-Fi) Support

If you prefer to power up your Pi and have it connect wirelessly to a Wi-Fi Access point (to establish internet access) then follow these steps:

  1. Eject and re-insert the MicroSD Card into your machine
  2. Navigate to /boot/raspberrypi-ua-netinst/config/ in your favorate text editor
    • Open the installer-config.txt file in Notepad
    • Enter Wi-Fi SSID and Password where instructed
    • Save the file
  3. Eject your MicroSD Card - You're ready to proceed

Power On and Bootup

  • eject your MicroSD card from your computer, insert it into the Pi and apply power.
  • hotspotβnβ autonomously installs
  • connect to a TV via HDMI to see the progress
  • it may reboot a few times, this is normal!

Access the Dashboard

Once the autonomous build has completed, identify the devices ip address (shown on your TV Screen, if connected - otherwise scan your network for the IP of the new device)

  • Enter the Pi's IP address into the web browser of any device connected to your local network.
  • Displayed in your web-browser should be the HotspotBnB dashboard.
  • The remainder of the setup can be completed via the dashboard.

Support

In the event of an issue, please check back for latest releases with bug fixes and/or submit an issue on here.

Tips

  • If you're accessing the dashboard from a mobile device (preferably using Chrome web browser) it's recommended you save the page to your devices homescreen, so that you can launch your HotspotBnB Dashboard in the same way you do other apps on your mobile devices. Locally this will work, but to access the Raspberry Pi remotely you will need to install an application such as Dataplicity (currently being loaded to HotspotBnB's App Store).

Notes

  • This release is only a proof of concept of the autonomous self-build capabilities and a preview of the final solution (so no apps can actually be installed yet). For a disk image with apps pre-installed, please download Hotspotβnβ v0.0.1-rc.8
  • download each new release and repeat this initial installation process to experience the latest developments in near 'real-time' until we introduce our Software/ Firmware Over the Air (OTA) updates/ upgrades.
  • tested and working on all models of the raspberry pi.
  • Users will normally be prompted to accept the terms of the cryptocurrency mining when accessing the dashboard for the first time - an optional and opt-in feature. However this 'JSECoin' feature is still being integrated into HotspotBnB. (If users don't agree and accept the cryptocurrency mining, the banner just remains on the dashboard. We owe no obligation not to inhibit the user experience in this way if they aren't willing to participate in a fair exchange e.g. our software solution for access to your network devices redundant processing power)