La descripción general, con ejemplos en ejecución, está en la página de la placa y El modelo de la Raspberry Pi Pico W (todos los registros).
Para un sketch Arduino, el WiFi está simulado detrás de un buzón, y el LED funciona de cualquier manera.
Qué es
The same RP2040 on the same board outline with the same forty pins as the Raspberry Pi Pico, corriendo en el mismo modelo. El núcleo, el GPIO del SIO, el TIMER, el UART0 y el PWM son los de la Pico, en las mismas direcciones, y un programa compilado para una Pico aquí es el mismo ELF que una Pico W ejecuta.
Lo que la placa real agrega es un CYW43439: WiFi de 2.4 GHz (802.11n) y Bluetooth, en un chip junto al RP2040 con su propia antena grabada en la punta de la placa.
El CYW43439 y un sketch Arduino
Esta sección y la siguiente tratan de sketches Arduino. MicroPython y CircuitPython llegan a la interfaz del chip real, que está modelada para ellos: consulta MicroPython y CircuitPython más abajo.
Para un sketch, casi nada de ese chip está modelado. Sin protocolo SPI hacia él, sin blob de firmware, sin controlador, sin registros y sin Bluetooth: sin LE, sin GATT, sin vinculación, ni siquiera un stub. Un sketch que llame a Bluetooth no compila aquí, porque el entorno de ejecución no lo declara.
La única excepción es su GPIO 0, que es el LED de la placa, porque es un pin que un sketch de verdad controla; consulta más abajo. En hardware real el chip debe estar alimentado y con su firmware cargado antes de que ese pin haga algo, lo cual el núcleo Arduino prepara al iniciar; aquí funciona desde la primera instrucción, y eso es una simplificación y no un modelo de la secuencia.
Es deliberado. Un stub que devolviera "no conectado" sería una mentira con forma plausible, y uno que devolviera "conectado" sería peor.
Lo que la placa sí tiene es una red simulada, descrita más abajo, y de qué sirve además de eso: para todo lo que sirve la Pico (el núcleo, los temporizadores, el PWM, el UART, los pines) en la placa que la gente realmente compró. Si un radio real es el objetivo de tu proyecto, esta placa en Mokxi no es la herramienta para eso, y ninguna otra lo es: no hay radio en este producto.
WiFi, simulated
No hay radio. Nunca lo habrá: una MAC 802.11 no es algo que este modelo pudiera reproducir con honestidad.
Lo que hay en su lugar es una red simulada. Un bloque que es propio de Mokxi y no del chip (un buzón en 0x4FFF_E000, donde un RP2040 real no tiene nada mapeado) lleva WiFi.h, HTTPClient.h y WebServer.h, así que el código de Arduino que trae un tutorial funciona aquí: la placa se conecta a un punto de acceso cuyo nombre y contraseña son propiedades de la placa, WiFi.status() recorre los mismos estados en el mismo lapso de uno a tres segundos, el DHCP le asigna 192.168.4.2, y un sketch puede descargar una página o servir una.
Lo que hay detrás es software, y no se oculta nada de eso. No hay 802.11, ni canal, ni escaneo, ni WPA2, ni TCP, ni TLS y no hay internet real: cuatro nombres inventados bajo .mokxi se resuelven y ningún otro, y nada de lo que haga un sketch puede llegar a la red donde está tu navegador. WiFiClientSecure compila y luego falla, diciendo que TLS no está simulado. Los paneles Web y Cloud en la parte de abajo del editor se abren con esa frase y no la hacen desaparecer al hacer scroll.
La única excepción es Internet real, un interruptor en el panel Cloud para cualquiera con sesión iniciada (más con Pro) que está apagado cada vez que se carga una página. Con él encendido, una petición por un nombre fuera de .mokxi,
https:// incluido, sale por la pasarela de Mokxi y la respuesta vuelve al sketch. Ver Internet real.
Un buzón también es la forma honesta aquí. La parte inalámbrica de una Pico W real es una CYW43439 al otro lado de un enlace tipo SPI de tres pines, manejada por un blob binario cerrado, no un conjunto de registros documentados en el RP2040, igual que la radio de un ESP32 no es un conjunto de registros documentados en su propio chip. Así que esto es una interfaz de comandos, que es donde está la costura real. Para un sketch, la CYW43439 en sí no está modelada, y el Bluetooth no se simula para nada.
El bloque está mapeado en una Pico W y no en una Pico común, así que WiFi.h compila para una placa y no compila para la otra, y los programas de ejemplo de las dos placas no son intercambiables.
Para esta placa vienen cuatro ejemplos: WiFi: conectarse a la red, WiFi: descargar el clima, Laboratorio de API: descargar JSON y WiFi: una lámpara en una página web.
Sketches escritos para arduino-pico
The Pico W's Arduino core is arduino-pico, and its WiFi examples build here as
they are written: HelloServer with WebServer and LEAmDNS.h, BasicHttpsClient
with a WiFiMulti and HTTPClient, and the WiFiServer ones with
server.accept(). Its own calls are here too: WiFi.connected(),
WiFi.noLowPowerMode(), WiFi.end(), http.setInsecure() and
rp2040.getFreeHeap(). A few compile and do nothing, because what they reach
is not simulated, and the serial monitor says so once: WiFi.ping() answers -1,
MDNS.begin("picow") names
nothing that resolves, and an https:// address still fails after
setInsecure().
Dos cosas que cambiar en un sketch copiado: el nombre de la red y la contraseña, que deben coincidir con las de la placa (Mokxi-Lab y breadboard a menos que las cambies en la placa), y cualquier dirección fuera de .mokxi, donde nada responde. Un sketch en una Raspberry Pi Pico común no compila con WiFi.h en absoluto, porque esa placa no tiene chip inalámbrico; cambia la placa por una Pico W.
WiFi, simulado explica cómo usarlo; WiFi simulado es el contrato, límite por límite.
El LED no está en GP25
Esta es la parte que confunde a la gente, y también los confunde en una mesa real.
El LED verde de una Pico está en GP25. El de una Pico W no. En una Pico W, GP23, GP24 y GP25 van todos al CYW43439 en su lugar (WL_ON, WL_D y WL_CS), y el LED cuelga del GPIO 0 del propio CYW43, al que se llega por el mismo enlace que usa la radio.
Así que digitalWrite(25, HIGH) no enciende nada aquí, y tampoco enciende nada en hardware real.
digitalWrite(LED_BUILTIN, HIGH) sí lo enciende, en ambas. LED_BUILTIN en esta placa no es un número de GPIO en absoluto: el entorno de ejecución lo envía a la parte inalámbrica por el mismo buzón que usa la red, que es la ruta que toma el núcleo de Arduino en la placa real. La lámpara de la placa en el editor se enciende con él.
Una cosa que ese enlace no puede llevar es un ciclo útil, así que analogWrite(LED_BUILTIN, …) no hace nada en una Pico W. Un LED que respire necesita un pin del header, que es lo que hace el ejemplo Fade.
Conecta un LED y una resistencia de 220 ohms de un pin del header a un pin de tierra y haz parpadear ese en su lugar. El ejemplo blink de la propia placa hace exactamente eso.
Los pines
Exactamente las cuarenta de la Pico, en el mismo orden y con los mismos nombres: mira la Raspberry Pi Pico. Esta es una placa de 3.3 voltios y sus pines no toleran 5 V.
GP29 es WL_CLK en una Pico W además del divisor de VSYS, y GP24 no es el sensor de VBUS. Aquí nada lo maneja, así que lee bajo. Ninguno de los dos está en el header en ninguna de las dos placas.
Qué se modela, y qué no
Lo mismo que la Pico, cada línea, más un bloque que no es del chip en absoluto: el SIO GPIO, el TIMER de 64 bits, UART0, UART1 (Serial2, en sus pines), PWM, el ADC, el buzón de la red simulada y el único pin de la CYW43 detrás de él están; PIO, DMA, SPI, I2C, USB, el RTC, el árbol de relojes, el segundo núcleo y la ROM de arranque no lo están, y tampoco lo está el resto de la CYW43439. Eso es la placa de un sketch: con MicroPython y CircuitPython la placa arranca a través de su ROM con el modelo completo del chip de la Pico, y la CYW43439 está en sus pines (abajo). analogRead() lee GP26 a GP28 (A0 a A2) como en la Pico.
The full list is in el modelo de la Raspberry Pi Pico W, que solo dice lo que cambia, y el modelo de la Raspberry Pi Pico, que dice todo lo demás.
Bibliotecas estándar de Arduino
Igual que en la Pico: Servo.h,
Wire.h (en GP4 y GP5), SPI.h, EEPROM.h (en RAM), LiquidCrystal_I2C.h,
Adafruit_SSD1306.h, Adafruit_NeoPixel.h y DHT.h compilan tal cual.
Los ejemplos
Blink, Button, Serial, Fade y Chaser son los propios de la Pico, compilados de nuevo para esta placa. Blink maneja LED_BUILTIN y GP15, así que la lámpara de la propia placa y una en la protoboard parpadean juntas; Fade solo atenúa GP14, porque no hay PWM en el enlace hacia la lámpara de la placa. Los ejemplos de control de juego de la Pico (los cuatro pasos de Fight stick, Fight stick, Leverless controller, Mixbox-style controller y Stop the light) también están aquí.
Cuatro más son solo de esta placa, porque solo esta placa tiene red: WiFi: conectarse a la red, WiFi: descargar el clima, Laboratorio de API: descargar JSON, y WiFi: una lámpara en una página web, que enciende ambas lámparas desde la pestaña Web.
Una compilación para Pico W usa un bloque que una Pico común deja sin mapear, así que las dos placas llevan cadenas de programa distintas y el editor ofrece a cada una su propia lista.
MicroPython y CircuitPython
Elige MicroPython (main.py) o CircuitPython (code.py) en el panel Firmware de la placa y Ejecutar arranca el firmware oficial de la Pico W: la compilación de Pico W de MicroPython v1.29.0, o la de CircuitPython 10.3.1. Cualquiera de las dos maneja la CYW43439 como lo hace en una mesa real, por los pines propios del chip (GP23, GP24, GP25 y GP29), y el chip está modelado hasta la profundidad a la que llega su controlador: el bus, la carga del firmware (aceptada y descartada) y los comandos de WiFi.
- El LED es el GPIO 0 del chip:
Pin("LED")en MicroPython,board.LEDen CircuitPython. - WiFi joins Mokxi's simulated access point, whose name and password are
the board's WiFi properties (Mokxi-Lab and breadboard unless you
change them). In MicroPython,
network.WLAN(network.STA_IF)connects andsocket,requestsandurequestsreach the.mokxisites; a socket server on the board opens in the Web panel. In CircuitPython,wifi.radio.connect()connects andsocketpoolwithadafruit_requestsfetches the same sites. - El punto de acceso propio de la placa:
WiFi.beginAP()(en 192.168.42.1, o 192.168.4.1 enWIFI_AP_STA, como en arduino-pico) ynetwork.WLAN(network.AP_IF)de MicroPython (en 192.168.4.1) lo inician, y el panel Web se conecta a él como un celular y abre ahí la página de la placa. - No simulado: Bluetooth, una segunda estación en el punto de acceso, el punto de acceso de CircuitPython, el ahorro de energía, TLS, y cualquier red que no sea la de Mokxi. En CircuitPython,
wifi.radio.ap_infolanzaNotImplementedError, porque su port para la Pico W no lo implementa.
Consulta la Pico para MicroPython y CircuitPython en la Pico para CircuitPython; el modelo Raspberry Pi Pico W tiene el detalle.
En otras partes
- La página de la placa: /boards/pico-w
- El documento de contrato: el modelo Raspberry Pi Pico W
- La placa de la que es una versión: la Raspberry Pi Pico
- Python en ella: CircuitPython en la Pico