🌡️  Monitor legacy analog systems with TinyML, Edge Impulse, and Blues Wireless. Learn more in our webinar on May 26th!

Search
Documentation Results
End of results
Community Results
End of results
Support
Blues.io
Notehub.io
Shop
Sign In
Search
Documentation Results
End of results
Community Results
End of results
Support
Blues.io
Notehub.io
Shop
×
HomeGuides & Tutorials
Welcome
Collecting Sensor Data
Routing Data to Cloud
Fleet Admin Guide
Notecard Guides
Guide Listing
Asset Tracking
Attention Pin Guide
Connecting to a Wi-Fi Access PointUsing a Notecard API CommandUsing Your Smartphone
Debugging with the FTDI Debug Cable
Encrypting Data With the Notecard
Minimizing Latency
Serial-Over-I2C Protocol
Understanding Environment Variables
Understanding Notecard Penalty Boxes
Updating ESP32 Host Firmware
Using External SIM Cards
Using JSONata to Transform JSON
Routing References
Twilio Route
MQTT Route
Azure Function Route
ThingWorx Route
Rate this page  
  • ★
    ★
  • ★
    ★
  • ★
    ★
  • ★
    ★
  • ★
    ★

Connecting to a Wi-Fi Access Point

Wi-Fi Notecards have the ability to connect to Wi-Fi access points and transmit data over Wi-Fi networks. In this guide you’ll learn two different ways to set up a connection.

note

To connect a Wi-Fi Notecard to a Wi-Fi access point, you must first connect the Notecard to a companion Notecarrier board . If you're not sure how to do so, refer to our guide on connecting a Notecard to a Notecarrier.

Once you have your Wi-Fi Notecard seated on a Notecarrier, you're ready to connect it to a local Wi-Fi access point. There are two ways to accomplish this:

  1. Using a Notecard API command
  2. Using your smartphone
warning

Before you continue, please note that Wi-Fi Notecard is only compatible with 2.4 GHz Wi-Fi access points. Access points that combine 5gHz and 2.4gHz with the same SSID may cause issues using the Notecard. Also, your ensure your Notecard firmware version is at least v3.2.1.

Using a Notecard API Command

Connect your Notecarrier to your computer via USB. You should see a red LED flash repeatedly, letting you know it's booting up. Using your terminal program (or the in-browser REPL), send this request to the Note Wi-Fi:

{"req":"card.wifi","ssid":"<ssid name>","password":"<password>"}

In return, you'll get a confirmation that your Wi-Fi Notecard is set to connect to the specified SSID using a specific security protocol. For example:

{
  "ssid": "<ssid name>",
  "security": "WPA2"
}
note

This does not mean your Wi-Fi Notecard is successfully connected to your access point, it just means that it is ready to connect once there is data to be sent. You'll know your Wi-Fi Notecard is actively connected to an access point when the blue LED is on (which it will be after you send a request).

Using Your Smartphone

Alternatively, you can set up your Note Wi-Fi using your smartphone.

With your Wi-Fi Notecard and Notecarrier plugged into a power supply, press and release the black button on the face of the Note Wi-Fi:

The location of the black button

Next, open up your smartphone and browse for available Wi-Fi access points. Within a minute or so, you should see "Notecard" as an option:

A list of available access points on a smartphone

Connect to "Notecard" on your phone and you'll be redirected to a window where you can enter the SSID and password. You can also use the "Scan List" feature to look for available access points, then tap on an access point to pre-fill everything except for the password.

note

If the browser window doesn't automatically appear after connecting to the Notecard SSID, visit 10.10.0.1 in your phone's browser.

The Wi-Fi Notecard’s connection screen

Finally, tap "Connect" to complete your Wi-Fi configuration. Your Wi-Fi Notecard should reboot (note the flashing red LEDs), at which point you’ll have successfully connected.

note

You'll know that your Wi-Fi Notecard is actively connected to a Wi-Fi access point when the blue LED is on. Don't worry if it's not on right now, as it should only be on after you make your first hub.set command. If you’re unsure how to run a hub.set command, refer to the Notecard quickstart.

The light remains on when the connection to the Wi-Fi network is active. If you set the Notecard’s mode to "continuous" the Notecard will maintain a connection to your access point. If you set the Notecard’s mode to "periodic" the Notecard will only connect when it needs to transfer data.

If you change your Wi-Fi configuration and the hub.sync.status command returns "status": "connect delayed...”, power cycle the Notecard to have it immediately use the new Wi-Fi configuration.

The blue LED on a Wi-Fi Notecard

Can we improve this page? Send us feedbackRate this page
  • ★
    ★
  • ★
    ★
  • ★
    ★
  • ★
    ★
  • ★
    ★
© 2022 Blues Inc.Terms & ConditionsPrivacy
blues.ioTwitterLinkedInGitHubHackster.io
Disconnected
Disconnected
Having trouble connecting?

Try changing your Micro USB cable as some cables do not support transferring data. If that does not solve your problem, contact us at support@blues.com and we will get you set up with another tool to communicate with the Notecard.

Connect a NotecardClick 'Connect' and select a USB-connected Notecard to start issuing requests from the browser.