Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Your Sparrow Developer Kit contains the items shown below. Let’s quickly define what each of these items are before discussing how to hook everything up.

...

1. Notecarrier-AL A with a pre-installed Wi-Fi Notecard

The Wi-Fi Notecard is a System-on-Module that makes it easy to send data over a Wi-Fi network. The Notecarrier-ALA is a companion board that houses the Notecard.

...

A Qwiic JST connector you’ll use to attach the Essentials Board to the Notecarrier-ALA.

5. STLINK-V3MINI

A stand-alone debugging probe for STM32 microcontrollers. You can use this to debug and update firmware on both the Essentials Board and Reference Nodes.

...

  • 2) Connect your Essentials Board to your Notecarrier-AL A using the included Qwiic cable.

...

  • 3) Ensure the DIP switch on the Notecarrier-AL A is set to 3V3, as 3V3 is a requirement when using a Wi-Fi Notecard.

    • TIP: The end of a safety pin works well for flipping DIP switches.

...

  • 4) Use the included Micro USB to USB-A data cable to connect the Notecarrier-AL A to your computer. After a few seconds you should see green LED lights on both the Notecarrier-AL A and Essentials Board.

...

  • 5) [OPTIONAL] Connect a LiPo battery to the JST connector labeled LIPO on the Notecarrier-AL. The LiPo battery can power the gateway if you want to run everything without a USB connection after you complete this setup. The LiPo battery will charge when the Notecarrier-AL is connected to power through USBA. Because the gateway requires continuous power, the lipo battery can act as an uninterruptible power supply—ensuring your gateway continues to operate if your regular power source fails, or if you need to plug your gateway in at a different location.

...

Set up Notehub

Notehub is a cloud service that receives data from the Notecard, and can route that data to your own cloud apps and services. You’ll need to set up a Notehub account and project to receive sensor data from your reference nodes.

...

  • NOTE: Not seeing your Notecard? Make sure you’ve connected your Notecarrier-AL A to your laptop with a micro-USB-to-USB-A cable.

  • 7) Issue the following command to connect associate your Notecard with your newly created Notehub project, making sure to substitute <productUID> with your own value.

    Code Block
    {"req":"hub.set","product":"<productUID>","mode":"continuous"} 

...

  • 8) Finally, issue the following command to connect your Wi-Fi Notecard to your home Wi-Fi network, making sure to substitute <ssid name> and <password> with your own values.

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

...

And with that, you have now completed the setup of your Sparrow Development Kit! For next steps we recommend that you:Let’s look at one more tip before you re-attach the backs of your Reference Node enclosures.

Distinguishing Between Multiple Reference Nodes

Each reference node in your Sparrow Development Kit has a unique identifier. You can view this identifier in the Filefield of each of the node’s air.qo and motion.qo events. For example, the screenshot below shows how to find a node’s identifier on a motion.qo event. (You can double click the event to view the full identifier, and to copy the value to your clipboard.)

...

Having the identifier can be useful whenever you need to differentiate between multiple nodes, aka whenever you need to tell which node is which.

As another option, you can also determine a node’s identifier by pressing and releasing the node’s PAIR button. Doing so creates and syncs a _health.qo event that contains the pressed node’s identifier in its body.

...

If you’d like, make note of any of your nodes’ identifiers using the steps above, and when you’re ready, go ahead and re-attach the backs of your Reference Node enclosures.

Next Steps

Now that you have everything connected and communicating, this is what we recommend as next steps.

  • 1) Move your hardware to different locations. Since you have everything connected and communicating, now is a great time to Go ahead and reposition your Essentials Board and Reference Nodes to get readings from different locations. (And if you haven’t already, feel free to re-attach the backs of your Reference Node enclosures.)

    • NOTE: There are no hard-and-fast rules that dictate how far apart you can place LoRa devices because the optimal distance depends on whether your devices have a clear line-of-sight, or the signal needs to penetrate walls, concrete, and the like. In a home or building, devices will need to be placed closer together, ideally less than a hundred meters apart. Out in the open, devices can reach one another across 1 KM or more. As with anything, we strongly suggest you test your application under real-world circumstances prior to deployment.

  • 2) Read more about what you can do with Sparrow. This quickstart helped you get your Sparrow Development Kit up and running, but there’s a lot more you can do with Sparrow. As a next step, we recommend checking out our Sparrow Setup and Run Guide, which provides a more detailed look at everything you can do with your Sparrow hardware.

...