Tham khảo

Hợp đồng bo mạch Raspberry Pi Pico W (Giai đoạn 9)

Pico có CYW43439 trên bo: chip không được mô phỏng, WiFi được giả lập, còn LED phía sau nó hoạt động.

Đây là tài liệu tham khảo kỹ thuật cho mô hình: nó mô tả những gì được triển khai, thanh ghi này đến thanh ghi khác, dành cho những người viết firmware chạy trên đó. Để dùng bo mạch trong trình soạn thảo, hãy bắt đầu với Raspberry Pi Pico W và trang bo mạch.

Pico W là Raspberry Pi Pico có thêm con CYW43439. Đối với một sketch Arduino, CYW43439 không được mô phỏng; còn với các firmware MicroPython và CircuitPython chính thức, vốn tự điều khiển nó qua các chân của nó, thì có, và docs/cyw43.md là hợp đồng đó (mục 9 bên dưới). Mọi thứ khác về bo mạch này giống Pico, và docs/pico.md là hợp đồng cho tất cả: cùng RP2040, cùng header bốn mươi chân theo cùng thứ tự, cùng bản đồ bộ nhớ, cùng các thanh ghi ngoại vi, cùng mô hình thời gian và cùng runtime. Một thành phần kernel phục vụ cả hai (pico trong crates/parts, với một cờ biến thể), vì bên dưới con chip không dây thì không có gì để phân biệt.

Kiểu trong danh mục là picow. Tài liệu này chỉ nêu những gì khác biệt: ba GPIO và vị trí thật của LED, cùng một khối là của riêng Mokxi.

Hãy đọc mục 6 trước khi bạn định kế hoạch gì quanh bo mạch này (và mục 9 cho dự án Python). Không có sóng radio ở đây. Những gì có, kể từ docs/wifi.md, là một mạng được mô phỏng sau một hộp thư tại một địa chỉ mà RP2040 để trống, và chữ "mô phỏng" nói lên tất cả: không có 802.11, không có firmware CYW43, không có internet thật. LED trên bo vẫn hoạt động, vì nó được truy cập qua chính hộp thư đó, cũng chính là cách nó được truy cập trên phần cứng.

1. Điều gì khác biệt: ba GPIO và LED

Ba GPIO của RP2040 không bao giờ ra tới header trên cả hai bo, và chúng được nối vào những thứ khác nhau:

GPIO trên Pico trên Pico W
GP23 SMPS_MODE, chân chế độ của bộ ổn áp WL_ON, nguồn của CYW43439
GP24 VBUS_SENSE WL_D, đường dữ liệu bán song công của CYW43439
GP25 LED xanh lá WL_CS, chân chip select của CYW43439
GP29 ADC3, mạch chia VSYS WL_CLK, và mạch chia VSYS

LED trên Pico W nối vào chính GPIO 0 của CYW43439, được truy cập qua đường link mà sóng radio dùng. Vì vậy:

  • LED_BUILTIN không phải là một số GPIO trên bo mạch này. Nó là MOKXI_WL_LED, một số chân cao hơn mọi chân thật, và pinMode, digitalWrite và digitalRead gửi nó tới linh kiện không dây qua hộp thư ở mục 3.8 thay vì tới một pad. Đó chính là đường đi mà core Arduino dùng trên phần cứng thật, nơi LED_BUILTIN đi qua driver CYW43. digitalWrite(LED_BUILTIN, HIGH) do đó bật đèn của bo ở đây, hệt như trên bàn làm việc, và probe báo cáo nó là bit 2, quay về qua hộp thư chứ không phải từ một pad.
  • GP25 không phải là LED. Kéo nó lên mức cao ở đây sẽ kéo WL_CS, which is connected to a chip that is not modeled, and on a desk it would do the same. A sketch that writes GP25 expecting a light gets nothing, in Mokxi and on the bench. The Pico's own blink ELF, which writes GP25, lights nothing on this board, and crates/parts' gp25_is_wl_cs_here_and_lights_nothing giữ nó như vậy.
  • Không có PWM nào sau bóng đèn đó. Đường link truyền bật và tắt, không truyền chu kỳ nhiệm vụ, nên analogWrite(LED_BUILTIN, …) không làm gì trên Pico W. fade nói rõ điều đó và fade GP14 thay thế.
  • GP24 không phải là chân cảm biến VBUS. Trên mô hình Pico, chân này được giữ ở mức cao vì bo mạch đó luôn được cấp nguồn qua USB; còn ở đây không có gì điều khiển nó nên nó đọc mức thấp.

Phương án thay thế (coi GP25 là LED và hy vọng) đã được cân nhắc và bác bỏ. Nó sẽ khiến một sketch sáng đèn trong trình mô phỏng nhưng không làm gì trên bàn làm việc thực, đúng là kiểu sai mà dự án này sẽ không bao giờ phát hành. Không có đèn nào cả là câu trả lời đầu tiên và cũng không đúng: đèn có đó trên bo mạch, và đường dẫn tới nó là một giao diện lệnh mà mô hình này hiện đã có. Nên nó được mô phỏng đúng nơi nó thực sự nằm. DECISIONS.md, 17-09-2026.

Mọi thứ khác trong mục 1 của docs/pico.md vẫn giữ nguyên: cùng bốn mươi chân theo cùng thứ tự danh mục, cùng tên gọi, cùng hành vi RUN và 3V3_EN, cùng các đường nguồn ở cùng điện áp, cùng điện trở kéo pad 55 k và cùng ngưỡng đầu vào 1,65 V.

2. Bản đồ bộ nhớ, 3. Thanh ghi ngoại vi, 4. Kênh kết nối máy chủ

Giống các mục 2, 3 và 4 của docs/pico.md, với một khối được thêm vào không thuộc về chip và không bỏ đi điều gì. Đây vẫn là RP2040: cửa sổ XIP flash như cũ, 264 KB SRAM như cũ, RESETS, IO_BANK0, PADS_BANK0, TIMER, UART0, PWM và SIO như cũ ở cùng địa chỉ với cùng các bit, và UART0 là kênh kết nối máy chủ.

The CYW43439 is on SPI-like signals that never leave the module, so nothing in the peripheral map changes to make room for it. What is added instead is Mokxi's own simulated network mailbox, which is not the CYW43 and does not pretend to be:

3.8 Hộp thư mạng Mokxi (0x4FFF_E000)

Khối này không thuộc RP2040, và không có trên Pico thường. Mọi địa chỉ khác trong docs/pico.md đều của chip, lấy từ tài liệu kỹ thuật, và một image dựng theo đó chạy được trên Pico thật. Còn khối này là của riêng Mokxi: mạng mô phỏng của crates/net, nằm trên mọi ngoại vi APB (chúng dừng dưới 0x4008_0000) và dưới cửa sổ AHB-Lite tại 0x5000_0000, sao cho một image dùng nó sẽ fault trên silicon thay vì đọc nhầm thanh ghi của ngoại vi khác. Cái fault đó là câu trả lời trung thực, vì thứ đứng sau khối này không tồn tại trên chip.

Vì sao hộp thư cũng là hình dạng trung thực ở đây. Phần không dây trên Pico W thật là CYW43439 ở bên kia đường kết nối ba chân kiểu SPI, được điều khiển bởi một blob firmware nhị phân đóng. Nó không phải là một tập thanh ghi được tài liệu hóa trên RP2040, cũng như radio của ESP32 không phải là một tập thanh ghi được tài liệu hóa trên chính die của nó, và WiFi.h của Arduino trên Pico W thực sự kết thúc ở bên kia một giao diện lệnh. Nên đây là một giao diện lệnh: cùng một giao diện, từng byte một, mà bốn bo mạch ESP dùng, tại địa chỉ riêng của bo mạch này.

Nó chỉ được ánh xạ duy nhất trên Pico W. firmware/pico/build.sh định nghĩa MOKXI_BOARD_PICO_W cho bo mạch đó và không cho Pico, nên WiFi.h biên dịch được cho bo này và từ chối với bo kia, và Soc::new của crates/rp2040 để địa chỉ này là một lỗ trống còn Soc::new_with_network ánh xạ nó. Trên Pico thường, lượt truy cập sẽ fault, điều mà một bo mạch không có phần không dây lẽ ra phải như vậy.

Khối này không kích hoạt bất kỳ ngắt NVIC nào. Số hiệu IRQ là của chip, mà khối này không thuộc chip, nên nó không được cấp số nào. Firmware dùng polling, và một core đang đậu trong WFI vẫn được đánh thức khi mạng có điều gì đó để nói, giống như nó được đánh thức cho một cạnh PWM.

Ở đây không có sóng vô tuyến, không có 802.11 và không có internet thật. Không có gì trong mô hình truyền tín hiệu, quét, kết nối với mạng, mã hóa hay mở socket: mật khẩu được so sánh như một chuỗi, một tên không nằm dưới .mokxi sẽ không phân giải được, và ba origin mà mạng phục vụ là các hàm trong crates/net/src/http.rs. Hộp thư mang hình dạng của đường nối thật chứ không hư cấu về một MAC: trên ESP32 thật, phần cứng WiFi là một blob nhị phân đóng với một giao diện lệnh, và WiFi.h của Arduino nằm ở phía bên kia của một giao diện như vậy. docs/wifi.md là hợp đồng cho thứ nằm đằng sau; mục này chỉ nói về các thanh ghi.

Một thanh ghi lệnh, một thanh ghi trạng thái, một vòng đệm 4096 byte cho mỗi chiều và một bit ngắt. Ghi vào NET_CMD_REG sẽ chạy lệnh; một lệnh mất thời gian mô phỏng sẽ bật BUSY và xóa nó, kèm DONE trong NET_INT_RAW_REG, khi hoàn tất.

offset tên bit
0x00 NET_ID_REG đọc ra 0x494B4F4D, và không thanh ghi nào khác đọc ra giá trị đó. Một sketch muốn biết mình có đang chạy trên Mokxi hay không sẽ đọc giá trị này; trên silicon thì lần truy cập này sẽ gây fault
0x04 NET_CMD_REG ghi một mã lệnh (bảng dưới đây); khi ghi, mã lệnh sẽ được chạy
0x08 NET_ARG_REG một từ đối số, đọc lại được: cổng cho LISTEN, trạng thái cho REPLY
0x0C NET_STATUS_REG bit 0 BUSY, bit 1 ERR, bit 2 RX_READY, bit 3 LINK, bit 4 SERVE, bits 8..11 STATE
0x10 NET_RESULT_REG câu trả lời của lệnh cuối cùng
0x14 NET_INT_RAW_REG bit 0 DONE, bit 1 EVENT
0x18 NET_INT_ENA_REG cùng hai bit đó
0x1C NET_INT_CLR_REG ghi 1 để xóa, cùng hai bit đó
0x20 NET_TX_LEN_REG số byte đã xếp vào vòng đệm gửi đi
0x24 NET_TX_DATA_REG ghi: đẩy một byte (bit 0..7) vào bộ đệm vòng đi ra
0x28 NET_RX_LEN_REG số byte đang chờ trong bộ đệm vòng vào
0x2C NET_RX_DATA_REG đọc: lấy một byte từ vòng đệm vào, giá trị 0 khi rỗng
0x30 NET_RING_LEN_REG dung lượng mỗi ring tính bằng byte, để firmware khỏi phải ghi cứng 4096
0x40 NET_BT_CMD_REG Bluetooth: ghi một mã lệnh Bluetooth (docs/bluetooth.md); lệnh ghi sẽ chạy nó
0x44 NET_BT_ARG_REG Bluetooth: một từ đối số, đọc lại được; một sự kiện để lại số của nó ở đây
0x48 NET_BT_RESULT_REG Bluetooth: câu trả lời của lệnh Bluetooth cuối
0x4C NET_BT_STATUS_REG bit 0 CLASSIC_ON, bit 1 CLASSIC_LINK, bit 2 EVENT, bit 3 BLE_ADV, bit 4 BLE_LINK, bit 5 BT_ERR, bit 8 HAS_CLASSIC, bit 9 HAS_BLE
0x50 NET_BT_TX_LEN_REG Bluetooth: các byte đã được xếp vào hàng đợi vòng gửi ra riêng của nó
0x54 NET_BT_TX_DATA_REG Bluetooth: ghi: đẩy một byte vào bộ đệm vòng đó
0x58 NET_BT_RX_LEN_REG Bluetooth: số byte đang chờ trong bộ đệm vòng vào riêng của nó
0x5C NET_BT_RX_DATA_REG Bluetooth: đọc: lấy một byte ra, giá trị 0 khi rỗng

Tám thanh ghi NET_BT_ đọc được giá trị 0 và bỏ qua mọi lệnh ghi trên bo mạch này: CYW43439 lo phần Bluetooth trên Pico W thật, còn Mokxi không mô phỏng nó (docs/bluetooth.md).

STATE là nơi trạm đang ở: 0 rảnh, 1 đang khởi động, 2 đang kết nối, 3 đã kết nối, 4 thất bại, 5 không có mạng đó. NET_CMD_STATUS chuyển cùng thông tin đó thành mã wl_status_t của Arduino mà một sketch đọc từ WiFi.status().

NET_CMD_REG tên tác dụng
0 NOP không có gì
1 RESET ngắt kết nối, bỏ cả hai ring, bỏ mọi request
2 CONNECT vòng đệm gửi đi giữ ssid\0password; báo BUSY trong một đến ba giây
3 DISCONNECT bỏ liên kết và địa chỉ
4 STATUS NET_RESULT_REG = mã wl_status_t
5 IP NET_RESULT_REG = địa chỉ được cấp, octet đầu ở byte thấp
6 RSSI NET_RESULT_REG = cường độ tín hiệu theo dBm, giãn dấu
7 SSID vòng vào nhận tên của điểm truy cập
8 MAC ring vào nhận sáu byte MAC của bo mạch
9 REQUEST ring đi ra giữ method\0url\0headers\0body; kích hoạt BUSY
10 POLL NET_RESULT_REG = 0 khi đang thực hiện, sau đó là trạng thái HTTP, hoặc một mã lỗi âm khi ERR lên mức cao; phần thân được ghi vào vòng đệm nhận
11 LISTEN lắng nghe trên cổng ghi trong NET_ARG_REG
12 ACCEPT NET_RESULT_REG = 1 và vòng đệm vào chứa method\0path\0query\0body, hoặc 0 khi không có gì đang chờ
13 REPLY trả lời request đã được chấp nhận với trạng thái ghi trong NET_ARG_REG; ring đi ra giữ content-type\0body
14 STOP ngừng lắng nghe
15 WL_GPIO_SET điều khiển GPIO riêng của phần không dây từ NET_ARG_REG, bit 0 trước tiên. Bit 0 là LED của bo mạch này
16 WL_GPIO_GET đọc chúng lại vào NET_RESULT_REG
17 BLYNK một thao tác trên máy chủ Blynk được mô phỏng, thao tác nằm trong NET_ARG_REG cùng các trường của nó trong ring đi ra; được trả lời ngay trong NET_RESULT_REG, với ERR bật mà không qua mạng (docs/wifi.md, "Blynk")
20 SOFTAP soft AP (crates/net/src/softap.rs, docs/wifi.md), thao tác trong NET_ARG_REG: 1 kích hoạt nó (ring đi ra chứa ssid\0password\0 và byte kênh; NET_RESULT_REG bằng 1, hoặc 0 với ERR nếu tên rỗng hoặc mật khẩu dài một đến bảy ký tự), 2 tắt nó, 3 cấu hình nó (địa chỉ, gateway và netmask, mỗi thứ bốn byte), 4 địa chỉ của nó (bằng 0 khi tắt), 5 các trạm đã tham gia, 6 các lượt tham gia, lượt rời đi và bit báo bật mà runtime biến thành sự kiện, 7 và 8 khởi động (tên, một byte rỗng, địa chỉ) và dừng máy chủ DNS của captive portal, 9 tên của nó vào ring vào, 10 địa chỉ của điện thoại, 11 phần Host của yêu cầu đang được phục vụ vào ring vào. Trạm duy nhất chính là điện thoại của bảng Web

Lệnh 15 và 16 chỉ riêng bo mạch này có. Bốn bo mạch ESP ánh xạ cùng hộp thư nhưng radio của chúng không có chân như vậy, nên trên đó cả hai lệnh đều đặt ERR và không điều khiển gì: bịa ra một chân chính là bịa ra phần cứng. Ở đây chúng là đường đi của LED_BUILTIN (mục 1).

Các mã POLL âm: -1 tên không phân giải được, -2 trạm chưa được kết hợp, -3 https:// và TLS không được mô phỏng, -4 phần thân dài hơn ring, -5 một URL mà mạng này không phân tích được, -6 đã có một yêu cầu đang thực thi. firmware/include/HTTPClient.h biến chúng thành các mã theo kiểu Arduino để sketch so sánh, và docs/wifi.md liệt kê ánh xạ đó.

Thời gian, tất cả thuộc về chính mô hình này và đều được nêu trong docs/wifi.md: một lượt kết hợp mất từ một đến ba giây, được quyết định từ SSID để một bài học mất đúng thời gian đó ở lần thứ hai; mật khẩu sai trở thành WL_CONNECT_FAILED sau năm giây; một yêu cầu đến một nguồn mô phỏng quay lại sau 60 ms; một yêu cầu vào chính máy chủ của sketch mà sketch không bao giờ trả lời sẽ bị mạng đóng với mã 504 sau mười giây.

5. Mô hình thời gian và linh kiện

Như mục 5 của docs/pico.md, với một khác biệt ở probe.

probe là một bitmask: 1 đang chạy, 2 đậu trong WFI, 4 LED trên bo, 8 phát serial trong 20 ms cuối, 16 nhận serial, 32 giữ BOOTSEL; 0 khi không có chương trình. Bit 2 mang cùng ý nghĩa như trên Pico nhưng đến từ nơi khác: trên Pico nó là pad GP25, còn ở đây là GPIO 0 của CYW43439, đọc lại qua hộp thư. Mô tả probe trong chính mục danh mục đã nói rõ điều đó, nên một công cụ đọc danh mục sẽ biết được mà không cần đọc tài liệu này.

poke giống của Pico: 1 nhấn BOOTSEL, 0 nhả nó, 2 giữ RUN ở mức thấp, 3 nhả nó.

6. Không dây

Radio được mô phỏng. Không có 802.11 ở bất kỳ đâu trong Mokxi, không có CYW43439, không có internet thật và không có yêu cầu nào từng rời khỏi tab trình duyệt. docs/wifi.md là bản hợp đồng và nó thắng thế hơn mục này; phần dưới đây là bản rút gọn và những gì riêng của bo mạch này.

Một sketch có thể dùng WiFi.h, WiFiClient.h, WiFiClientSecure.h, HTTPClient.h và WebServer.h (cùng dạng API kiểu Arduino mà người dùng Pico W copy từ tutorial), và nó sẽ kết nối vào mạng, tải một trang web và phục vụ một trang. Đằng sau các lời gọi đó là mailbox của mục 3.8 và crates/net: một máy trạng thái station giới hạn trong khoảng một đến ba giây, một DHCP lease tại 192.168.4.2, và bốn origin giả dưới .mokxi. Access point là ba thuộc tính của bo mạch (wifiSsid, wifiPassword, wifiRssi), vì không có radio thì chẳng có gì để quét cả.

Cách viết riêng của arduino-pico. Các header là của core ESP32, vì runtime là của ESP32-C3, còn WiFi API của arduino-pico chính là cái đó với vài tên gọi riêng của nó. Các ví dụ của nó (HelloServer, BasicHttpsClient, các ví dụ WiFiServer) dùng những tên đó, nên trên bo mạch này, và chỉ trên bo mạch này, các header cũng mang theo chúng (#if defined(ARDUINO_RASPBERRY_PI_PICO_W)):

arduino-pico ở đây
WiFi.h khai báo WiFiMulti, WiFiClientSecure và NTP giống nhau, không có include riêng của chúng
WiFi.connected(), beginNoBlock(), end() status() == WL_CONNECTED, begin(), disconnect(true)
WiFi.lowPowerMode(), noLowPowerMode(), setTimeout() được chấp nhận, không thay đổi gì
WiFi.beginAP() softAP(): soft AP tại 192.168.42.1, hoặc 192.168.4.1 ở chế độ WIFI_AP_STA, như cách beginAP của arduino-pico chọn (libraries/WiFi/src/WiFiClass.cpp), trừ khi softAPConfig() đã đặt một địa chỉ khác, đây là mạng mà điện thoại trong bảng Web kết nối tới (docs/wifi.md)
WiFi.ping() -1, và nói một lần rằng ICMP không được truyền
WiFi.getHostname() PicoW cho đến khi setHostname()
LEAmDNS.h (MDNS.begin(), MDNS.update()) ESPmDNS.h: biên dịch được, và nói rằng tên sẽ không phân giải
HTTPClient::setInsecure(), setFingerprint(), setCACert(), setX509Time(), setBufferSizes() được chấp nhận; một GET https:// vẫn thất bại với HTTPC_ERROR_NO_TLS
rp2040.getFreeHeap(), getUsedHeap(), getTotalHeap() heap của runtime (trên Pico cũng vậy)

Các bo mạch ESP không nhận được các tên này, vì core của chúng không có, và một Pico thường vẫn từ chối WiFi.h; lời khuyên trong bản biên dịch ở đó nói là đổi bo mạch sang Pico W. web/src/compile/picow-wifi.test.ts chạy các ví dụ.

Những gì không có ở đây, và sẽ không có:

  • Không có 802.11 dưới bất kỳ hình thức nào. Không có kênh, không có quét, không có WiFi.scanNetworks(), không có beacon, không có khung association, không có WPA2, không có PMK, không có mã hóa. Mật khẩu được so sánh như một chuỗi ký tự. RSSI() là một thuộc tính, không phải độ suy giảm đường truyền.
  • Không có CYW43439 như một con chip, đối với sketch. Không có giao thức SPI tới nó, không có firmware blob, không có driver, không có thanh ghi. (MicroPython và CircuitPython là chuyện khác: mục 9.) Chân GPIO 0 của nó được mô phỏng, vì đó là LED trên bo mạch và là một chân mà sketch thực sự điều khiển; hai lệnh chạm tới nó nằm trong bảng ở mục 3.8 và không tác động gì trên bất kỳ bo mạch nào khác. Không GPIO nào khác của nó được mô phỏng, và chân được mô phỏng đó cũng không có PWM.
  • No sequencing. On real hardware the CYW43 has to be powered and its firmware blob loaded before its GPIO 0 will do anything, which the Arduino core does at start-up. Here the command works from the first instruction, whether or not the sketch has called WiFi.begin(). That is a simplification and this is where it is written down.
  • Không có Bluetooth. Không có LE, không có GATT, không có ghép nối, không có stub. CYW43439 làm Bluetooth trên phần cứng thật; Mokxi không mô phỏng nó, và không có header nào để sketch gặp lỗi.
  • Không có internet thật. Không có TCP, không có ngăn xếp IP, không có socket, không có giao thức DNS. Một tên không nằm dưới .mokxi sẽ lỗi với một câu mà sketch đọc được và bảng Cloud in ra.
  • Không có TLS. WiFiClientSecure biên dịch được rồi mới lỗi, vì một TLS tin tưởng mọi thứ sẽ dạy học sinh rằng https là miễn phí.

Nếu mạng không dây thật là mục đích của dự án bạn, bo mạch này trong Mokxi không phải công cụ cho việc đó, và bo mạch nào khác cũng không phải: sản phẩm này không có radio. Mục đích của nó là học hình dạng của code (vòng lặp kết nối, các mã trạng thái, HTTPClient, một handler WebServer) và mọi thứ mà Pico vốn dành cho bên dưới đó.

7. Runtime của firmware

firmware/pico/, với một cờ: firmware/picow/build.sh chạy nó với BOARD=picow, cờ này thêm -DMOKXI_BOARD_PICO_W. Cờ đó định nghĩa MOKXI_NET_BASE trong include/rp2040.h và kéo vào firmware/include/mokxi_net.h, thứ làm cho các header mạng biên dịch được; nó cũng đưa wifi.cpp của ESP32-C3 vào liên kết, vì runtime mạng không biết gì về bo mạch ngoài đúng một địa chỉ đó. Mọi thứ khác (crt0.S, link.ld, src/, arduino.h) là của Pico, không đổi và không sao chép.

Chuỗi catalog program là elf32 arm rp2040 picow, chứ không phải của Pico. Hai bo mạch chạy cùng bộ lệnh trên cùng bản đồ bộ nhớ, nhưng một image biên dịch cho W ghi vào một địa chỉ mà Pico thường để không ánh xạ, nên nó lỗi ở đó. Hai chuỗi nghĩa là trình soạn code đưa cho mỗi bo mạch danh sách riêng của nó, y như chuỗi của Nano được tách khỏi của Uno (docs/nano.md mục 6), và web/public/firmware/picow/index.json là danh sách đó.

Tám ví dụ: blink, button, serial, fade và chaser được đọc trực tiếp từ firmware/pico/examples/ chứ không được sao chép; wificonnect, wifiweather và wifilamp nằm trong firmware/picow/examples/, vì chỉ bo mạch này mới biên dịch được chúng. blink điều khiển LED_BUILTIN và GP15, và trên bo mạch này, cái đầu tiên đi qua mailbox đến GPIO 0 của CYW43, nên cả hai đèn đều nhấp nháy. fade chỉ làm mờ dần GP14, vì phía bên kia của liên kết đó không có PWM. wifilamp điều khiển cả hai, nên trang sẽ bật một đèn trên bo mạch và một đèn trên breadboard.

Có thật sự một họ biên dịch riêng và một bundle runtime riêng (picow), vì bundle được khóa theo chuỗi program. Một sketch viết trong trình soạn code cho Pico W được biên dịch trong trình duyệt, như của Pico.

8. Những gì không được mô phỏng

Mọi thứ trong docs/pico.md mục 6 (core thứ hai, PIO, DMA, SPI, I2C, USB, RTC, cây clock, boot ROM và bootloader tầng hai; ADC thì được mô phỏng, docs/pico.md mục 5a), cộng thêm:

  • CYW43439, đối với sketch, ở mọi chi tiết trừ một: giao thức SPI của nó, firmware blob, thanh ghi của nó, cảm biến VBUS trên GPIO 2, 802.11 ở mọi băng tần, Bluetooth, và ăng-ten. Ngoại lệ là GPIO 0, LED của bo mạch, được mô phỏng vì sketch thực sự điều khiển nó: qua mailbox, bật hoặc tắt, không có PWM. Mạng mô phỏng ở mục 6 không phải là mô hình của con chip này và không nằm ở địa chỉ của nó; nó là một khối riêng của Mokxi, và mục 3.8 nói rõ ngay dòng đầu tiên.
  • GP23, GP24, GP25 và GP29 như các tín hiệu không dây, đối với sketch. Chúng tồn tại trong mô hình RP2040 như các GPIO thường, vì đó là những gì con chip có, và không có gì lắng nghe ở đầu bên kia.

9. MicroPython và CircuitPython: CYW43439 trên các chân của nó

Một Pico W khởi động qua ROM của nó (một bundle MicroPython hoặc CircuitPython, hoặc một UF2 pico-sdk dựng sẵn) có CYW43439 trên GP23, GP24, GP25 và GP29, được mô phỏng từ các chân của nó hướng vào sâu bằng mức mà cyw43-driver của các firmware chính thức chạm tới: bus PIO gSPI, backplane và việc nạp firmware (được nhận rồi bỏ đi), và một bản thay thế SDPCM cho firmware WiFi, vốn trả lời các ioctl của nó và tham gia điểm phát sóng của crates/net. docs/cyw43.md là bản đặc tả. Trên đường đi đó:

  • LED là GPIO 0 của con chip, được điều khiển bởi gpioout qua bus: Pin("LED") trên MicroPython, board.LED trên CircuitPython, bit 4 của que đo như với sketch.
  • WiFi là lwIP của chính firmware qua các khung Ethernet tới điểm phát sóng ở 192.168.4.1 (crates/net/src/lan.rs), cùng cái mà các bo mạch MicroPython ESP32 dùng: DHCP, DNS cho .mokxi, TCP tới cổng 80, và một máy chủ trên bo mạch mà bảng Web truy cập được. wifiSsid, wifiPassword và wifiRssi của bo mạch chính là điểm phát sóng đó.
  • Hộp thư ở 0x4FFF_E000 không được ánh xạ: các firmware này không bao giờ chạm tới nó, và trên silicon đó là một lỗ hổng.
  • Ổ đĩa của CircuitPython bắt đầu từ 1540 KB, sau 1536 KB firmware của bản build W và 4 KB NVM.
  • Nơi nó chạy. Cách khởi động đó cần CYW43439 và phần IP của mạng phía sau nó (net/lan), tức tính năng cyw43 của crate rp2040. Trình mô phỏng của trình soạn code được dựng không kèm nó, nên một Pico W khởi động qua ROM chạy trên mô hình toàn chip rp2040::whole (loại KIND_PICO_W của esp_common::whole_chip) trong module wasm của các mô hình chip, được tải về ở lần Chạy đầu tiên kiểu đó, như các bo mạch ESP32 MicroPython vẫn làm (docs/micropython-esp32.md mục 7). Linh kiện giữ rp2040::chip::Chip: RP2040 cho sketch, mô hình cho khởi động ROM. Ở bản native, mô hình được liên kết sẵn. docs/cyw43.md mục 6 có chi tiết.

Bluetooth, trạm thứ hai trên điểm truy cập mềm (điện thoại của bảng Web tham gia AP_IF, docs/cyw43.md), chế độ tiết kiệm điện và TLS cũng không được mô phỏng ở đó.

Đó là toàn bộ sự khác biệt. Mọi thứ không được đề cập trong tài liệu này là của Pico, và docs/pico.md là nơi nó được ghi lại.