Сonfigure Raspberry Pi Zero to work with HelpWire Bridge

Writing the HelpWire Bridge image to an SD card

You will need:

1. An application for flashing images to SD cards. For example, Etcher (available for download at https://www.balena.io/etcher/).

2. A 2GB (or larger) SD card.

How to create a Pi SD card with Etcher:

  1. Insert your SD card into the card reader on your PC.
  2. Install Etcher on your computer, launch the app and perform the following steps:

Step 1 – click “Select image” and choose the HelpWire Bridge image file you received from Electronic Team, Inc.
Step 2 – click “Select drive” and choose the SD card you connected earlier.
Step 3 – click “Flash!” to write the image file to the SD card.

When done, your SD card can be used for further HelpWire Bridge configurations.

For more information on how to install images on an SD card, please see:
https://www.raspberrypi.org/documentation/installation/installing-images/README.md

Configuring WiFi

1. Mount the SD card, containing the HelpWire Bridge image, to your computer.

2. Find the wpa_supplicant.conf file at the root of the SD card and change the settings of the WiFi network to your SSID, password, and country code.

Here is an example of the wpa_supplicant.conf file:

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=US
 
network={
	ssid="ssid name"
	scan_ssid=1
	psk="ssid password"
	key_mgmt=WPA-PSK
}
Note: After the first start of Raspberry Pi Zero, the file wpa_supplicant.conf will be located under the following path: /etc/wpa_supplicant/wpa_supplicant.conf.

Connecting Raspberry Pi Zero to a computer via SSH

For Windows users:

1. Connect your Raspberry Pi to a USB port of your computer.

The device should automatically appear in the Device Manager under Network adapters as an RNDIS device. If it doesn’t, you’ll need to install the RNDIS driver manually. To do this:

  • In the Device Manager, find your Pi Zero (it can be shown as a COM port);
  • Right-click on it and select Update Driver Software;
  • In the popup window, choose Browse my computer for driver software>Let me pick from a list of device drivers on my computer;
  • You’ll see a window asking to select the device type. Choose Network Adapters, click Next;
  • In the Select Network Adapter window, choose Microsoft from the Manufacturer list. Under the list of Network Adapter, select Remote NDIS compatible device.
Note: If you are using Windows 10, you should download the RNDIS Driver and install it manually.

2. Once the driver software is successfully updated, connect to your Raspberry Pi via SSH by entering the hostname “raspberrypi.local”.

To establish an SSH connection to the Raspberry Pi Zero, you can use putty.exe, a client program for the SSH protocol.

For MacOS users:

1. Connect the Raspberry Pi Zero to a USB port of your computer.

2. Enable SSH on your Mac from the command line. To do this, enter the command below into Terminal.app, and press Enter to execute it.

ssh pi@raspberrypi.local

Working with Raspberry Pi Zero via SSH

The default hostname for a connection via SSH is “raspberrypi.local”.

The default credentials are: user login: “pi”, password: “raspberry”.

Once you connected to your Raspberry Pi Zero using SSH, you can:

1. Find the IP address assigned to the device by the router:

ifconfig
Note: Before running this command, be sure to configure your WiFi network.

2. Change your WiFi settings:

In the SSH session, run:

sudo raspi-config
  • select Network Options;
  • select N2 Wi-Fi;
  • enter the parameters of your WiFi network: your country code, SSID, and password.

Configuring HelpWire Operator GUI for connecting to Raspberry Pi Zero

For Windows users:

1. Open the Registry Editor:

Windows menu> regedit

2. Find the key:

HKEY_LOCAL_MACHINE\SOFTWARE\Electronic Team\HelpWire

3. Add the string variable “gui_host” and assign it the value “raspberrypi.local” or the IP address of the WiFi adapter of your Pi Zero.

4. Launch HelpWire Operator GUI.

5. Log in to your operator account.

6. Find the required device in the list and click “Connect”.

For macOS users:

1. Add the following fields to the defaults:

sudo defaults write /Library/Preferences/us.electronic.flexihub.plist gui_host "IP address or the hostname of Raspberry Pi on the WiFi network"

For example, if “gui_host” = “raspberrypi.local”, run:

sudo defaults write /Library/Preferences/us.electronic.flexihub.plist gui_host raspberrypi.local
Note: The control over the daemon will be available only if no device is connected.

2. Launch HelpWire Operator GUI;

3. Log in to your operator account;

4. Find the required device in the list and click “Connect”.