micropython winbond

Micropython Winbond Flash

Micropython Library para interagir com chips flash w25q winbond

A documentação mais recente está disponível no Micropython Winbond ReadThedocs

---

• Instalação
  • Instale as ferramentas necessárias
• Stetup
  • Instale o pacote
    • Em geral
    • Versão específica
    • Versão de teste
  • Manualmente
    • Carregar arquivos para a placa
• Uso
• Créditos

Instalação

Instale as ferramentas necessárias

O Python3 deve ser instalado no seu sistema. Verifique a versão python atual com o seguinte comando

python --version
python3 --version

Dependendo de qual comando Python 3.xy (com xy como alguns números) é retornado, use esse comando para prosseguir.

python3 -m venv .venv
source .venv/bin/activate

pip install -r requirements.txt

Para interação com o sistema de arquivos do dispositivo, o Micropython Shell remoto pode ser usado.

Teste a ferramenta mostrando sua descrição do Homem/Ajuda.

rshell --help

Stetup

Instale o pacote

Conecte o dispositivo Micropython a uma rede (se possível)

 import network
station = network . WLAN ( network . STA_IF )
station . active ( True )
station . connect ( 'SSID' , 'PASSWORD' )
station . isconnected ()

Em geral

Instale a versão mais recente do pacote desta lib no dispositivo Micropython

 import mip
mip . install ( "github:brainelectronics/micropython-winbond" )

Para versões Micropython abaixo de 1.19.1, use o pacote upip em vez de mip

 import upip
upip . install ( 'micropython-winbond' )

Versão específica

Instale uma versão específica e fixa deste Lib no dispositivo Micropython

 import mip
# install a verions of a specific branch
mip . install ( "github:brainelectronics/micropython-winbond" , version = "feature/add-docs-and-detailed-examples" )
# install a tag version
mip . install ( "github:brainelectronics/micropython-winbond" , version = "0.4.0" )

Para versões Micropython abaixo de 1.19.1, use o pacote upip em vez de mip . Com upip , sempre a versão mais recente disponível será instalada.

 import upip
upip . install ( 'micropython-winbond' )

Versão de teste

Instale uma versão do candidato de liberação específica enviada para testar o índice de pacote Python em todos os PR no dispositivo Micropython. Se nenhuma versão específica estiver definida, a versão estável mais recente será usada.

 import mip
mip . install ( "github:brainelectronics/micropython-winbond" , version = "0.4.0-rc2.dev4" )

Para versões Micropython abaixo de 1.19.1, use o pacote upip em vez de mip . Com upip , sempre a versão mais recente disponível será instalada.

 import upip
# overwrite index_urls to only take artifacts from test.pypi.org
upip . index_urls = [ 'https://test.pypi.org/pypi' ]
upip . install ( 'micropython-winbond' )

Consulte também o BainSelectronics Test Pyver Server no Docker para um servidor Pypi de teste em execução no Docker.

Manualmente

Carregar arquivos para a placa

Copie o módulo para a placa Micropython e importe -os como mostrado abaixo usando o Micropython Shell remoto

Abra o shell remoto com o seguinte comando. Além disso, use -b 115200 , caso nenhum CP210x seja usado, mas um CH34X.

rshell -p /dev/tty.SLAB_USBtoUART --editor nano

Execute o seguinte comando dentro do rshell para copiar todos os arquivos e pastas para o dispositivo

mkdir /pyboard/lib
mkdir /pyboard/lib/winbond

cp winbond/ * /pyboard/lib/winbond
cp main.py /pyboard/lib/winbond
cp boot.py /pyboard/lib/winbond

Uso

 from machine import SPI , Pin
import os
from winbond import W25QFlash

# the used SPI and CS pin is setup specific, change accordingly
# check the boot.py file of this repo for further boards
flash = W25QFlash ( spi = SPI ( 2 ), cs = Pin ( 5 ), baud = 2000000 , software_reset = True )

flash_mount_point = '/external'

try :
    os . mount ( flash , flash_mount_point )
except Exception as e :
    if e . errno == 19 :
        # [Errno 19] ENODEV aka "No such device"
        # create the filesystem, this takes some seconds (approx. 10 sec)
        print ( 'Creating filesystem for external flash ...' )
        print ( 'This might take up to 10 seconds' )
        os . VfsFat . mkfs ( flash )
    else :
        # takes some seconds/minutes (approx. 40 sec for 128MBit/16MB)
        print ( 'Formatting external flash ...' )
        print ( 'This might take up to 60 seconds' )
        # !!! only required on the very first start (will remove everything)
        flash . format ()

        # create the filesystem, this takes some seconds (approx. 10 sec)
        print ( 'Creating filesystem for external flash ...' )
        print ( 'This might take up to 10 seconds' )
        # !!! only required on first setup and after formatting
        os . VfsFat . mkfs ( flash )

    print ( 'Filesystem for external flash created' )

    # finally mount the external flash
    os . mount ( flash , flash_mount_point )

Créditos

Parabéns e muito obrigado ao Crizeo do Micropython Fórum e seu post para usar chips de flash winbond