From 05e4aa32657d1d214dd61acc0f78154d3024feb4 Mon Sep 17 00:00:00 2001 From: gijsio <67470426+gijsio@users.noreply.github.com> Date: Wed, 12 Aug 2020 16:07:33 +0200 Subject: [PATCH] clarified pysense and pytrack information --- content/datasheets/expansionboards/pysense.md | 14 ++++++++++++-- content/datasheets/expansionboards/pytrack2.md | 8 ++++++-- content/gettingstarted/_index.md | 15 +++++++++++---- content/tutorials/expansionboards/pysense.md | 12 +++++++++--- content/tutorials/expansionboards/sleep.md | 3 +-- 5 files changed, 39 insertions(+), 13 deletions(-) diff --git a/content/datasheets/expansionboards/pysense.md b/content/datasheets/expansionboards/pysense.md index 14487f1..30b63b2 100644 --- a/content/datasheets/expansionboards/pysense.md +++ b/content/datasheets/expansionboards/pysense.md @@ -7,6 +7,8 @@ aliases: - chapter/datasheets/boards/pysense --- **Store**: [Buy Here](https://pycom.io/product/pysense/) + + ![](/gitbook/assets/pysense.png) ## Datasheet @@ -18,10 +20,18 @@ The datasheet of the Pysense is available as a [PDF File](/gitbook/assets/pysens ## Pinout The pinout of the Pysense is available as a [PDF File](/gitbook/assets/pysense-pinout.pdf) - - +* The user button is connected to `P14` or `G4`. This button can also be used to put the Pysense board in `dfu-bootloader` mode to update the firmware. ![](/gitbook/assets/pysense-pinout-1.png) + +## Sensors +The Pysense includes 4 additional sensors: +1. Altitude/Pressure sensor [MPL3115A2 datasheet]() +2. Light sensor [datasheet]() +3. Accelerometer [LIS2HH12 datasheet]() +4. Temperature/Humidity sensor [SI7006A20 datasheet]() + + ## Notes ### Battery Charger diff --git a/content/datasheets/expansionboards/pytrack2.md b/content/datasheets/expansionboards/pytrack2.md index d14c782..f097606 100644 --- a/content/datasheets/expansionboards/pytrack2.md +++ b/content/datasheets/expansionboards/pytrack2.md @@ -15,11 +15,15 @@ The datasheet of the Pytrack is available as a [PDF File](/gitbook/assets/PyTrac ## Pinout -The pinout of the Pytrack is available as a [PDF File]( -/gitbook/assets/pytrack2-pinout.pdf) +The pinout of the Pytrack is available as a [PDF File](/gitbook/assets/pytrack2-pinout.pdf) ![](/gitbook/assets/pytrack2-pinout.png) ## Notes + +### Antenna + +The Pytrack 2.0 X board has an internal GPS antenna built in. You can find it on the front side near the bottom, labelled `RFI1`. When you are not using the external antenna, remove the jumper labeled `AON`. If you want better reception and faster fix times, you can use the external GPS antenna with the Pytrack 2.0 X. The SMA connector on the side does **NOT** work with the LoRa or WiFi whip antennas you might already have! You can purchase the appropiate GPS antenna from our webshop [here](https://pycom.io/product/external-gps-antenna/). + ### Battery Charger The board features a single cell Li-Ion/Li-Po charger. When the board is being powered via the micro USB connector, it will charge the battery (if connected). diff --git a/content/gettingstarted/_index.md b/content/gettingstarted/_index.md index 914cf81..b846570 100644 --- a/content/gettingstarted/_index.md +++ b/content/gettingstarted/_index.md @@ -16,7 +16,7 @@ In the following guide, we will explain the basic process to get started using y 1. [Setting up the hardware](#step-1-setting-up-the-hardware) 2. [Setting up your computer](#step-2-setting-up-your-computer) 3. [Programming the module](#step-3-programming-your-module) - +4. [Using your Expansionboard](#step-4-using-your-expansionboard) @@ -127,15 +127,22 @@ If you need to remove files from your device you can use the following commands: >>> os.fsformat('/flash') ``` -## Getting started with +## Step 4: Using your expansionboard From here on, you can continue to use the additional features of your expansionboard: +>Note The Expansionboard does not need any additional libraries and provides no additional features -|[ Pygate](/tutorials/expansionboards/pysense/)| [Pysense](/tutorials/expansionboards/pysense/) | [Pysense 2.0 X](/tutorials/expansionboards/pysense/)| [Pytrack](/tutorials/expansionboards/pysense/)| [Pytrack 2.0 X](/tutorials/expansionboards/pysense/)| [PyScan ](/tutorials/expansionboards/pysense/)| +|[ Pygate](/tutorials/expansionboards/pygate/)| [Pysense](/tutorials/expansionboards/pysense/) | [Pysense 2.0 X](/tutorials/expansionboards/pysense2/)| [Pytrack](/tutorials/expansionboards/pytrack/)| [Pytrack 2.0 X](/tutorials/expansionboards/pytrack2/)| [PyScan ](/tutorials/expansionboards/pyscan/)| |:---|:---|:---|:---|:---|:---| | ![](/gitbook/assets/expansion_board_3_lopy4.png)|![](/gitbook/assets/pysense_icon.png) | ![](/gitbook/assets/pytrack_icon.png)| ![](/gitbook/assets/pytrack_icon.png)| ![](/gitbook/assets/pytrack_icon.png)| ![](/gitbook/assets/pytrack_icon.png) | +## Step 5: Connecting antennas +Click on the Icon of your board to get redirect to the datasheet and antenna connection diagrams -# Step 4: Further reading +|[Wipy 3](/tutorials/expansionboards/pysense/)| [Lopy 4](/tutorials/expansionboards/pysense/) | [Sipy](/tutorials/expansionboards/pysense/)| [Gpy](/tutorials/expansionboards/pysense/)| [Fipy](/tutorials/expansionboards/pysense/)| +|:---|:---|:---|:---|:---| +| ![](/gitbook/assets/wipy.png)|![](/gitbook/assets/lopy4.png) | ![](/gitbook/assets/sipy.png)| ![](/gitbook/assets/gpy.png)| ![](/gitbook/assets/fipy.png)| + +## Further references Now that we got the basic example running, you can continue with the links below. diff --git a/content/tutorials/expansionboards/pysense.md b/content/tutorials/expansionboards/pysense.md index 577ee81..530b546 100644 --- a/content/tutorials/expansionboards/pysense.md +++ b/content/tutorials/expansionboards/pysense.md @@ -5,9 +5,15 @@ aliases: - tutorials/pysense.md - chapter/tutorials/pysense --- +The Pysense board includes 4 additional sensors to be used with your pycom device! You can find an example on how to use the sensors below, but first we need to install the libraries. You can find more information about the Pysense and its sensors in the [datasheet section](/datasheets/expansionboards/pysense/) -## All sensors ->Note: You can find this example in the [GitHub repository](https://github.com/pycom/pycom-libraries/tree/master/pysense). Over there, you can also find the relevant libraries. +## Install libraries +To use the Pysense board, you will first need to add some libraries to your project: +1. Go the the [GitHub repository](https://github.com/pycom/pycom-libraries/) and download the archive. +2. Extract the archive and copy the files from the pysense folder into your project folder +3. Upload the project to your device. This will enable the functionality. + +## Use sensors ```python #!/usr/bin/env python # @@ -64,7 +70,7 @@ time.sleep(3) py.setup_sleep(10) py.go_to_sleep() ``` -## Accelerometer +## Accelerometer example This basic example shows how to read pitch and roll from the on-board accelerometer and output it in comma separated value (CSV) format over serial. diff --git a/content/tutorials/expansionboards/sleep.md b/content/tutorials/expansionboards/sleep.md index e5b4dda..300877b 100644 --- a/content/tutorials/expansionboards/sleep.md +++ b/content/tutorials/expansionboards/sleep.md @@ -46,6 +46,5 @@ py.setup_int_wake_up(True, True) acc.enable_activity_interrupt(2000, 200) # go to sleep for 5 minutes maximum if no accelerometer interrupt happens -py.setup_sleep(300) -py.go_to_sleep() +machine.deepsleep(5*60*1000) ``` \ No newline at end of file