- Laptop (with internet access)
- Raspberry Pi or Raspberry Pi Zero W (w/ configured microSD card, instructions for which are here)
- SparkFun Pi Wedge
- SparkFun FTDI Basic Breakout - 3.3V
- Mini USB to USB-C Cable or USB 2.0 Cable - A-Male to Mini-B
Note: if you are on macOS 10.13 (High Sierra) the following procedure should work out of the box. Previous macOS versions required the installation of an additional driver.
- With with your RPi off, connect the PiWedge to the RPi and then the FTDI Basic Breakout to its spot on the wedge (with the microchip facing up, plug the breakout in to the male header pins on the corner of the PiWedge): PHOTO HERE
- Plug the RPi power adapter into its port and connect the other end to an outlet
- On your laptop, open a new terminal window and type the following command:
screen /dev/tty.usbserial
and then press the key. You should see the terminal autocomplete with a string of letters and numbers identifying theFTDI Device
. For example, the command should look something like this (at this point):screen /dev/tty.usbserial-AH02LSSH
- Add the
BAUD
rate (115200
) to the command above (the command should now look something like this:screen /dev/tty.usbserial-AH02LSSH 115200
). Press to issue the command - Once a connection is made the terminal label will update to
screen
. Press enter to bring up the login screen (sometimes I have to power cycle the RPi to get the login stuff to show up) - Enter login credentials
- Type
exit
and then hit enter to return to the login prompt - Open a new terminal tab
- We need to get the number of the screen session so we can
quit
it. Enterscreen -ls
in the terminal and copy the number before.tty001
for use in the next step - Issue the following command in the terminal (replace with the number form the previous step):
screen -X -S <SESSION NUMBER> quit
There is one file that needs to be configured to setup WiFI on the Raspberry Pi: /etc/wpa_supplicant/wpa_supplicant.conf
.
- Connect to the RPi via
screen
- Navigate to
/etc/wpa_supplicant/wpa_supplicant.conf
:cd /etc/wpa_supplicant/
- Open
wpa_supplicant.conf
withnano
:sudo nano wpa_supplicant.conf
and move on to the next sequence (Configuring wpa_supplicant)
Here is what wpa_supplicant
should look like with only one network (with nonsense credentials):
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
network={
ssid="WIFINETWORKNAME"
psk="WIFINETWORKPASSWORD"
}
To configure for your WIFI network insert the network name in ssid
and the password in psk
. Note that you have to use quotes for both of these fields. Save changes, exit, and reboot
to confirm that you can connect to the network after logging back in. You should see the IP Address show up before the login prompt if all was successful. Write it down and move on to the next section.
- Use
ssh
(Secure Shell) to connect to your RPi via Wifi:ssh pi@IP_address
- Enter login credentials
Note that this method requires us to already know what the IP Address for the RPi is
- While connected to your RPi, run
sudo raspi-config
- Select
Network Options
, hit - Select
Hostname
, hit - The next screen describes what is legal in Hostnames (no symbols!), hit
- Type a new Hostname. It needs to be easy to remember and unique, hit
- Hit the right arrow key twice to select
Finish
, then hit
ssh pi@<HOSTNAME>.local
, for example:ssh [email protected]
- Enter login credentials