The Pycom boards offer an easy way to build Internet of Things applications using Wi-Fi, Bluetooth, Lte, LoRa, and Sigfox. If you desire to know a little bit more about Pycom and their development boards, check out their website at www.pycom.io
With a board in hand and project in mind, this article is designed to help assist in connecting your Pycom board using Wi-Fi to Ubidots' cloud.
Requirements
1. Setting up Hardware
Before beginning, it is important check the points below to make sure your board is programmed correctly:
If this is your first time working with a Pycom board, we recommend you reference to their getting started materials and then return back to this guide for further instruction once you've become more familiar.
2. Setting up Firmware
Setting up the Project
1. Open the Atom editor and then, go to the plugins tab and select "Pymakr" to activate the plugin.
2. Connect the board to your PC and the Atom editor will automatically detect the connection. Once the board is connected you will see the message "connected" in the status:
3. To begin, create a new directory called "ubidots" to manage the codes and libraries. Once the directory is created, in the Atom editor select Open a Project, and search for the directory "ubidots," which was previously created and open it.
4. In the file "ubidots" we are going to manage the libraries and main/boot codes. Please reference and follow the structure below to build your project properly:
> ubidots
- boot.py
- main.py
> lib
-urequests.py
First, we are going to add the folder for the libraries. Right click on the folder "ubidots" and select "New folder", assign "lib" as name.
Now, we're going to add the main and boot files:
Right click the folder "ubidots" and select "New File", assign "boot.py" as the name
Repeat the above steps to create the main called "main.py":
Once both files are created, the structure of your project will look like this:
To finish, we have to add the library file into the "lib" folder:
Right click on the folder "lib" and select "New File", assign as name "urequests.py"
Once the library file is created, the final structure of the project should be like this:
NOTE: If your are importing a library and after compiling receive a message like this one below, it's because you are using an external library and the file needs to be present alongside the boot.py and main.py. For this reason, we previously added the library file.
5.- Now synchronize the project. Press the "Sync" icon from the console, or select Packages –> Pymakr –> Synchronize project.
Coding time
Now that we have the project built and synchronized, it's time to code!
1.- Copy and paste the library from this link into the "urequests.py" file. Once you've pasted the code save it.
2.- Next, copy and paste the code below into the "boot.py" file:
from machine import UART
import machine
import os
uart = UART(0, baudrate=115200)
os.dupterm(uart)
machine.main('main.py')
Save your code once you've uploaded to the "boot.py" file.
3.- Next, copy and paste the code below into the "main.py" file:
from network import WLAN
import urequests as requests
import machine
import time
TOKEN = "Assign_your_Ubidots_token_here" #Put here your TOKEN
DELAY = 1 # Delay in seconds
wlan = WLAN(mode=WLAN.STA)
wlan.antenna(WLAN.INT_ANT)
# Assign your Wi-Fi credentials
wlan.connect("wifi-SSID-here", auth=(WLAN.WPA2, "wifi-password-here"), timeout=5000)
while not wlan.isconnected ():
machine.idle()
print("Connected to Wifi\n")
# Builds the json to send the request
def build_json(variable1, value1, variable2, value2, variable3, value3):
try:
lat = 6.217
lng = -75.567
data = {variable1: {"value": value1},
variable2: {"value": value2, "context": {"lat": lat, "lng": lng}},
variable3: {"value": value3}}
return data
except:
return None
# Sends the request. Please reference the REST API reference https://ubidots.com/docs/api/
def post_var(device, value1, value2, value3):
try:
url = "https://industrial.api.ubidots.com/"
url = url + "api/v1.6/devices/" + device
headers = {"X-Auth-Token": TOKEN, "Content-Type": "application/json"}
data = build_json("fuel", value1, "position", value2, "speed", value3)
if data is not None:
print(data)
req = requests.post(url=url, headers=headers, json=data)
return req.json()
else:
pass
except:
pass
while True:
fuel = 123 # Data values
speed = 234 # Data values
post_var("pycom", fuel, 1, speed)
time.sleep(DELAY)
Once you've pasted, assign your Ubidots Token and the Wi-Fi credentials where is indicated in the code, and save the code when finished. If you don't how find your Ubidots TOKEN, please reference this article below.
Save your code once you've uploaded to the "main.py" with with your Wi-Fi credentials, save your work.
4. Now the project is ready to be run! But first verify if the project is synchronized and that all codes are saved properly.
To run the project just press the "Run" icon from the console:
When running correctly, you will receive something like that below:
NOTE: If you received a error message referring to ImportError: no module named 'urequests' , synchronize the project again and then rerun the project.
3. Data visualization
Go to the Device section of your Ubidots Account and see a new device named "pycom" containing the variables assigned in the sample code provided above:
4. Summary
In a couple of minutes you are posting data to the Ubidots cloud using any Pycom board via Wi-Fi.
Now it is time to create a dashboard to control and manage the variables of your Pycom devices. To learn more about Ubidots widgets and events, check out these video tutorials.
Other readers have also found useful...