Connect to WiFi Using SSH

In most cases, your Lattice1 will connect to your network without any issues, however, you can encounter situations in which connecting manually via SSH is worth trying.

A perfect example where you'd want to try connecting manually via SSH would be living in a large apartment building with lots of different networks and not seeing your WiFi's SSID in the list of available networks on the device - this can sometimes happen, although it's rare.

In this situation, we presume there's nothing wrong with the way your network is set up, and the only action you have to take is actually connect to it - but you can't do that through the device, because you can't tap on the SSID to initiate the process. Before you attempt this, make sure your network meets these conditions:

  • Your network's SSID (name) is less than 32 characters

  • Your network is set to 2.4 GHz (ideally 2.4 GHz only, or autoswitching bands)

  • Your network uses one of these encryption types: WEP, WPA-PSK or WPA2-PSK

Conditions met? Good, let's have a look at how to connect via SSH.

Step-by-Step Guide

  1. First, you have to open a communication channel with your Lattice. And since you cannot connect to WiFi, you have to connect via Ethernet (the cable has to be plugged into the same router as your computer, but your computer can be connected to WiFi provided by that router too).

  2. Once your Lattice is connected to your router via the Ethernet cable, SSH into it:

  1. Once you're in and you see the ASCII art spelling out "Lattice1", all you have to do is send this command to connect: wifisetup add -ssid "networkssid" -encr "encryptiontype" -password "networkpassword" Type everything in without the quotation marks. The -ssid parameter is the name of your network. The -encr is the encryption type - usually, this will be WPA2 (do not type out the full "WPA2-PSK", just "WPA2") - you can confirm what encryption type your router is using for your network by going into your router settings. The Lattice supports WEP, WPA and WPA2. The -password is obviously your network's password. Case sensitive. Here's an example of how this command could look like: wifisetup add -ssid Verizon-135898 -encr wpa2 -password MikesWiFi69

And there you go, all done. Your Lattice should now be connected!

If you can't connect even though all the info you're typing in is correct, please go through all the steps in our WiFi Troubleshooting doc. Feel free to reach out if you get stuck.

Last updated