Dependencies¶
This driver depends on:
Please ensure all dependencies are available on the CircuitPython filesystem. This is easily achieved by downloading the Adafruit library and driver bundle.
Usage Example¶
This module implements a child class build upon Adafruit’s PyPortal class. The class implements just one method, overriding a base method, allowing the PyPortal device to connect to more than one SSID. To use, invoke this class where you would have used the PyPortal class. For example:
from pyportal_multissid import PyPortal_MultiSSID
pyportal = PyPortal_MultiSSID(status_neopixel=board.NEOPIXEL)
Configure your “home” network as ‘ssid’ and ‘password’ as usual in your secrets.py file, then add any additional networks (such as phone hotspot, MiFi devices, and networks at places the PyPortal will visit) as described below. The PyPortal then becomes portable.
The alteration of secrets.py is to include one extra key/value pair. The key is ‘hotspots’ and the value is a list of pairs of ssid and password strings:
secrets = {
# Whatever is already in your secrets dict remains.
# Be sure to add a now-needed comma if there isn't one.
'hotspots': [
['myphonessid', 'thepassword'],
['mymifissid', 'itspassword'],
['myvacationhomessid', 'dontyouwish'],
],
}
See examples/pyportal_multissid_simpletest.py
Contributing¶
Contributions are welcome! Please read our Code of Conduct before contributing to help this project stay welcoming.
Documentation¶
For information on building library documentation, please check out this guide.