29 918
modifications
Modifications
Sauter à la navigation
Sauter à la recherche
Ligne 15 :
Ligne 15 : − + Ligne 114 :
Ligne 114 : − + + + Ligne 211 :
Ligne 213 : − + Ligne 217 :
Ligne 219 : − + − + + + + Ligne 226 :
Ligne 231 : − + + + + + + + + + + + + − + + + + + Ligne 249 :
Ligne 269 : +
→MicroPython How To
Here follows some fundamentals help links about the Python language himself:
Here follows some fundamentals help links about the Python language himself:
* [https://www.w3schools.com/python/ '''W3Schools''' on Python] : one of the best resource for learning online.
* [https://www.w3schools.com/python/ '''W3Schools''' on Python] : one of the best ressource for learning online (should I say "my favorite one).
* [https://www.pythoncheatsheet.org/#Python-Basics '''P'''ython'''C'''heat'''S'''heet.org] : Anyone can forget how to make loop, list, dictionary, tuple, list slice, math operator, generator...
* [https://www.pythoncheatsheet.org/#Python-Basics '''P'''ython'''C'''heat'''S'''heet.org] : Anyone can forget how to make loop, list, dictionary, tuple, list slice, math operator, generator...
* [https://www.pythonsheets.com/ pythonsheets.com] : more advanced cheat sheet.
* [https://www.pythonsheets.com/ pythonsheets.com] : more advanced cheat sheet.
That method returns a 16 bits value, so a number between 0 and 65535.
That method returns a 16 bits value, so a number between 0 and 65535.
{{ambox|text=Even if the {{fname|read_u16()}} returns a 16 bits values, the effective ADC resolution is still 12 bits. The MicroPython internal will just upscale the ADC value from 0..4095 to returned value 0..65535 by applying a multiplier.}}
{{ambox|text=Even if the {{fname|read_u16()}} returns a 16 bits values, the effective ADC resolution is still 12 bits. The MicroPython internal will just upscale the ADC value from 0..4095 to returned value 0..65535 by applying a multiplier.
The effective ADC reading precision is 3.3V/4095 = 0.000805V (0.8mv) }}
[[Fichier:ENG-CANSAT-FEATHER-PICO-HowTo-25.png]]
[[Fichier:ENG-CANSAT-FEATHER-PICO-HowTo-25.png]]
The UART is often compared to a serial port (which is in facts very similar to).
The UART is often compared to a serial port (which is in facts very similar to).
It allows to send and receives data from a device using the same interface like modem, GPS, termina. UART/Serial ports are used to creates point to point communication.
It allows to send and receives data from a device using the same interface like modem, GPS, terminal. UART/Serial ports are used to creates point to point communication.
When wiring an UART, the RX & TX connection must be cross-over like the wiring to GPS here below (see the [https://github.com/mchobby/esp8266-upy/tree/master/gps-ultimate gps-ultimate MicroPython library])
When wiring an UART, the RX & TX connection must be cross-over like the wiring to GPS here below (see the [https://github.com/mchobby/esp8266-upy/tree/master/gps-ultimate gps-ultimate MicroPython library])
[[Fichier:ENG-CANSAT-PICO-HowTo-UART.png|480px]]
[[Fichier:ENG-CANSAT-PICO-HowTo-UART.png|480px]]
{{ambox|text=It is advised to use the UART(1) on GP4 & GP5. Indeed, UART(0) is used to replicates REPL session. See the [[ENG-CANSAT-PICO-USER-GUIDE|Pinout]] for details.}}
{{ambox|text=It is advised to use the UART(0) on GP0 & GP1. Indeed, UART(1) overlaps the SPI(0) used for Radio module. Alternative UART(1) position overlaps the I2C(0) bus. See the [[ENG-CANSAT-PICO-USER-GUIDE|Pinout]] for details.}}
<syntaxhighlight lang="python">
<syntaxhighlight lang="python">
from machine import UART
from machine import UART, Pin
# UART(0) on GP0 & GP1
uart = UART( 0, baudrate=9600)
# UART(1) on GP4 & GP5
# UART(1) on GP4 & GP5
# Alternate position for UART(1) by using Bus Fabric feature
# Alternate position for UART(1) by using Bus Fabric feature
uart = UART( 1, baudrate=9600, timeout=3000)
uart = UART( 1, rx=Pin(9), tx=Pin(8), baudrate=9600 )
</syntaxhighlight>
Outside of connecting device (like GPS) to the UART, you can also use an UART to get the REPL over it (exactly like USB connexion but over an UART. This may be kindly useful to bring a REPL connectivity over mobile network/device.
The following snip of code duplicates the REPL over the {{fname|UART(0)}} .
<syntaxhighlight lang="python">
from machine import UART
from os import dupterm
uart = UART(0, baudrate=19200, bits=8, parity=None, stop=1)
os.dupterm( uart, 1 ) # Pico Firmware must be recompile with dupterm()
</syntaxhighlight>
</syntaxhighlight>
The {{fname|UART}} class is [https://docs.micropython.org/en/latest/library/machine.UART.html fully described into MicroPython documentation].
The {{fname|UART}} class is [https://docs.micropython.org/en/latest/library/machine.UART.html fully described into MicroPython documentation].
{{underline|Tips & Tricks:}}<br />One of the key parameter of UART is the {{fname|timeout}} parameter which indicates the timeout (in ms) to receive the end-of-line on {{fname|UART.readline()}} .
The {{fname|dupterm()}} function is [https://docs.micropython.org/en/latest/library/os.html#terminal-redirection-and-duplication described here into the MicroPython documentation].
{{underline|Tips & Tricks:}}
* One of the key parameter of UART is the {{fname|timeout}} parameter which indicates the timeout (in ms) to receive the end-of-line on {{fname|UART.readline()}} .
* See this [https://forums.raspberrypi.com/viewtopic.php?t=304410 Raspberry-Pi forum thread] to compile a dupterm() enabled firmware for Pico.
=== SPI Bus ===
=== SPI Bus ===
* SS: Slave Select (activated at LOW) used to activate the device on the bus. It is also used to start "transaction" with the device.
* SS: Slave Select (activated at LOW) used to activate the device on the bus. It is also used to start "transaction" with the device.
[[Fichier:ENG-CANSAT-PICO-HowTo-SPI.png]]
The following snip of code creates an instance of the {{fname|SPI(0)}} bus
The following snip of code creates an instance of the {{fname|SPI(0)}} bus