9a0602f9e5
* Products
-> updated with new products
-> added accessories
* Getting started
-> re-structured getting started guide
-> removed some of the advanced stuff
* Tutorials / Examples
-> added categories
-> added new basic tutorials Sleep, GPIO and Pring
-> added WiFi ap / sta tutorial
-> added wifi Scan MAC tutorial
* Firmware API
-> added pysense pytrack pygate categories here
* Datasheets
-> added CE FCC and RoHS documents
-> added pysense2 and pytrack 2 templates
* Update firmware
-> new section, added all methods of updating the firmware
* License
-> put license in its own section
general remarks:
-> updated the layout / theme
no more red code text
codeblocks actually work now
-> general layout updates, removed the old html structures (mostly)
3.4 KiB
title, aliases
| title | aliases | |||
|---|---|---|---|---|
| Pytrack 2.0 X |
|
This chapter describes the various libraries which are designed for the Pytrack board. This includes details about the various methods and classes available for each of the Pytrack's sensors.
3-Axis Accelerometer (LIS2HH12)
Pytrack has a 3-Axis Accelerometer that provides outputs for acceleration as well as roll, pitch and yaw.
Constructors
class LIS2HH12(pytrack = None, sda = 'P22', scl = 'P21')
Creates a LIS2HH12 object, that will return values for acceleration, roll, pitch and yaw. Constructor must be passed a Pytrack or I2C object to successfully construct.
Methods
LIS2HH12.acceleration()
Read the acceleration from the LIS2HH12. Returns a tuple with the 3 values of acceleration (G).
LIS2HH12.roll()
Read the current roll from the LIS2HH12. Returns a float in degrees in the range -180 to 180.
LIS2HH12.pitch()
Read the current pitch from the LIS2HH12. Returns a float in degrees in the range -90 to 90. Once the board tilts beyond this range the values will repeat. This is due to a lack of yaw measurement, making it not possible to know the exact orientation of the board.
GPS with GLONASS (Quectel L76-L GNSS)
Pytrack has a GPS (with GLONASS) that provides outputs longitude/latitude, speed and other information about the Pytrack's location.
Constructors
class L76GNSS(pytrack = None, sda = 'P22', scl = 'P21', timeout = None)
Creates a L76GNSS object, that will return values for longitude and latitude. Constructor must be passed a Pytrack or I2C object to successfully construct. Set the timeout to a time period (in seconds) for the GPS to search for a lock. If a lock is not found by the time the timeout has expired, the coordinates method will return (None, None).
Methods
L76GNSS.coordinates(debug = False)
Read the longitude and latitude from the L76GNSS. Returns a tuple with the longitude and latitude. With debug set to True the output from the GPS is verbose.
L76GNSS.dump_nmea()
Continuously print nmea sentences received from the L76GNSS to the REPL. This is useful if you want to use a graphical tool over UART to visualise GPS reception
L76GNSS.write()
Send commands to the L76GNSS. This function should only be used if advised by Pycom for a specific purpose.
Pytrack class to control supervisor MCU
Constructors
class Pytrack(i2c=None, sda='P22', scl='P21')
Initialise I2C communication with the supervisor MCU
Methods
Pytrack.sd_power(enabled=True)
This command allows switching the power supply for the SD card (VCC + PullUP resistors).
Pytrack.sensor_power(enabled=True)
This command allows switching the power supply for the GPS module and any sensors connected through the external 6-pin connector.
Pytrack.gps_standby(enabled=True)
This command allows switching the GPS module into stand-by mode. The GPS module is no longer accessible via I2C in this case.
{{% hint style="info" %}} Please note that more functionality is being added regularly to these libraries. If a required feature is not available, feel free to contribute with a pull request at the Libraries GitHub repository {{% /hint %}}