https://github.com/bottxrnife/helium-2287-w

https://github.com/bottxrnife/helium-2287-w

Last synced: about 1 month ago
JSON representation

• Host: GitHub
• URL: https://github.com/bottxrnife/helium-2287-w
• Owner: bottxrnife
• Created: 2020-09-25T02:47:03.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2021-06-17T06:06:20.000Z (over 3 years ago)
• Last Synced: 2024-10-22T16:43:42.673Z (2 months ago)
• Language: Rust
• Size: 1.15 MB
• Stars: 15
• Watchers: 4
• Forks: 10
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-helium - bottxrnife/helium-2287 - Above but for RAK2287-based builds, like the RAK Discover Kit 2 (SX1302-based chip) (Software / DIY Hotspots)

README

        
# Helium Hotspot US version SX1302 with WiFi-Connect

[![](https://www.balena.io/deploy.png)](https://dashboard.balena-cloud.com/deploy?repoUrl=https://github.com/bottxrnife/helium-2287-w)

This project deploys a Helium Hotspot with US LoRa configuration. Run the Helium EU LoRa version (SX1301) from [this project](https://github.com/PastaGringo/balenaos-helium-gtw)

## Getting started

It runs on a Raspberry Pi (3/4) on the balenaOS 64bits with a RAK2287 concentrator (SX1302).

You will need a [balenaCloud free account](https://dashboard.balena-cloud.com/) and [balenaEtcher](https://balena.io/etcher) for flashing the SD card.

## Deploy the code

This project deploys a Helium Hotspot with US LoRa configuration.

Login to your BalenaCloud account and click this button to deploy! 

After you deploy this and wrote the image onto the pi, wire the pi to ethernet (so it can download everything first) and power it on, wait around 10 minutes for everything needed to install. After you're able to see the status as "online" and everything is running (this is also a good time to backup your swarm_key), you may now unplug the pi and ethernet. After plugging it back in, wait around 3 minutes.

You should see a new wifi network named "Hotspot-Connect." The password to connect to it is "12345678"

A captive portal should come up prompting you to connect to a wifi network, if not, open a web browser and type in the ip address for the portal: "192.168.12.1"

Note that after 5 minutes, the hotspot-connect wifi network automatically turns off, and the only way to see it again is to reboot the PI

## How to update the miner

To update the Helium miner, click the deploy button and choose "deploy to existing application" (automated miner updates coming soon)

## How to backup the swarm_key

1. Open an SSH session to the "host-os"

2. Type this command and keep note of the (YOUR INSTANCE)_miner-data information: 

      ls /var/lib/docker/volumes

3. Type this command to get a link to download the swarm key (note to replace the YOUR INSTANCE part with the container number that you got from the previous command) 

      curl -F "file=@/var/lib/docker/volumes/(YOUR INSTANCE)_miner-data/_data/miner/swarm_key" https://file.io

4. Use the outputted file.io link to securely download your swarm key. The link only works one time.

## How to restore the swarm_key

1. Open an SSH session to the "host-os"

2. Type this command and keep note of the (YOUR INSTANCE)_miner-data information: 

      ls /var/lib/docker/volumes

3. Navigate to where the swarm_key is stored

      cd /var/lib/docker/volumes/(YOUR INSTANCE)_miner-data/_data/miner/

4. Remove the original swarm_key file

      rm swarm_key

5. Upload your swarm_key that you wish to restore onto file.io and do

      curl -LJO [FILE.IO UPLOAD LINK]

6. Reboot miner and you will see it restored :)