Tổng quan, kèm các ví dụ đang chạy, nằm ở trang bo mạch và Mô hình XIAO SAMD21 (mọi thanh ghi).
Đây là gì
Seeed Studio XIAO SAMD21, một ATSAMD21G18A chạy trên nhân Cortex-M do chính chúng tôi viết với hồ sơ ARMv6-M, cùng nhân mà Raspberry Pi Pico dùng, ở 48 MHz thay vì 125. Firmware là một ELF Thumb giao tiếp với các địa chỉ SAM D21 thật.
Bo mạch có kích thước 21 x 17.8 mm và hai hàng pad, mỗi hàng bảy cái, cách nhau 0.6 inch, nên nó nằm vắt qua rãnh giữa của breadboard, mỗi bên còn lại một hàng trống.
Các chân
Mười bốn pads dạng răng cưa, bảy mỗi cạnh, với ổ cắm USB-C ở phía trên.
Cột trái: D0, D1, D2, D3, D4, D5, D6.
Cột phải: 5V, GND, 3V3, D10, D9, D8, D7.
Cả mười một pads I/O đều là đầu vào analog, và A0 đến A10 là chính các pads D0 đến D10; lớp in mạch in cả hai tên. analogRead(A3) và analogRead(3) là cùng một chân.
Đây là bo mạch 3.3 volt và các chân của nó không chịu được 5 V. 3V3 cấp 3.3 V và 5V cấp 5 V từ ổ cắm USB.
Ba LED nằm trên bo mạch và không thuộc pad nào: LED của người dùng, RX và TX. Cả ba đều active thấp, nên digitalWrite(LED_BUILTIN, LOW) sẽ sáng LED người dùng. LED_BUILTIN là 13.
Ba điều sơ đồ chân tác động đến bạn
Đây là phần cứng, không phải mô hình, và mỗi cái đều khiến ai đó vấp phải:
D0không có PWM. Nó là chân của DAC và không nối với timer nào cả, nênanalogWrite(0, x)chỉ đẩy nó bật hoặc tắt tại điểm giữa. Hãy dùng pad khác để làm hiệu ứng mờ dần.D4không có ngắt ngoài. Nó là chân NMI của chip, nênattachInterrupt(4, ...)không làm gì cả. VàD5vàD7dùng chung một đường ngắt, nên chỉ một trong hai chân có thể gắn bộ xử lý tại một thời điểm.- Một số pads PWM dùng chung duty.
D1vàD4là một kênh so sánh, và tương tựD9vớiD5,D10vớiD2,D8vớiD3. Ghi vào một chân sẽ kéo cả hai.
Serial chính là USB, còn Serial1 thì không
Serial là thiết bị USB ngay trên chip. Nó là nơi Serial Monitor nối vào, và nó không có tốc độ baud riêng: số bạn truyền đi sẽ đến máy chủ như một yêu cầu mà máy chủ có thể bỏ qua.
Bên dưới nó không có giao thức USB nào. Mokxi mô hình hóa bộ điều khiển thiết bị như một đường ống byte tại các thanh ghi endpoint thật và không có gì cao hơn thế: không có enumeration, không có descriptor, không có gói SETUP. Trên XIAO thật, while (!Serial) {} chờ máy chủ nhận ra bo mạch; ở đây nó trả về ngay lập tức. Còn Keyboard và Mouse, là nửa kia của lý do tồn tại của một bo mạch có USB gốc, thì không có sẵn.
Serial1 là chuyện khác: một USART thật trên D6 (TX) và D7 (RX), truyền các khung 8N1 thật từng bit một. Cắm dây từ D6 sang D7 thì sketch sẽ nghe thấy tiếng vọng của chính nó; đặt hai đầu với tốc độ baud khác nhau thì chữ sẽ nhòa loạn, đúng như trên bàn thật.
What is modeled
PORT, SysTick, đủ phần GCLK, PM và SYSCTRL để một đoạn khởi động kiểu Arduino chạy đến hết, sáu SERCOM làm USART, TCC0-2 và TC3-7 ở mức PWM, ADC SAR trên cả hai mươi kênh, EIC, và USB như đường ống byte đó.
Đó là bộ hàm mà pinMode, digitalWrite, digitalRead, analogRead, analogWrite, millis, micros, delay, attachInterrupt, Serial và Serial1 cần, tại địa chỉ thật của chúng.
Những gì không có
Cây clock (nhân chỉ đơn giản chạy ở 48 MHz ngay từ lệnh đầu tiên), SPI và I2C trên các SERCOM (Wire và SPI thay vào đó là phần mềm trên các chân thường, xem dưới đây), DAC, các bộ so sánh analog, bộ điều khiển cảm ứng, I2S, DMA, hệ thống sự kiện, bộ điều khiển NVM, watchdog, RTC, và toàn bộ phần USB cao hơn đường ống byte.
Blocks the chip has and the model does not are mapped and read zero rather than faulting, so a startup that pokes one does not crash the board.
The full list, and a plain account of which register offsets this model can state from the datasheet and which are its own reading, is in mô hình XIAO SAMD21. Mục 7 là phần đáng đọc trước khi đưa một bản build từ đây sang chip thật.
Thư viện Arduino có sẵn
Một bài hướng dẫn có dùng Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h cùng Adafruit_SSD1306.h và DHT.h sẽ biên dịch được nguyên vẹn ở đây. Mỗi cái là header riêng của Mokxi dưới tên thượng nguồn, viết trên các driver cho linh kiện trong hộp, và không dùng mã của thư viện thượng nguồn.
Wire.begin()đặt bus I2C trênD4(SDA) vàD5(SCL).EEPROM.hhoạt động, nhưng mô hình của bo mạch này không có EEPROM hay flash ghi được, nên các byte nằm trong 4 KB RAM: chúng đọc lại được trong một lần Chạy và biến mất khi reset.Adafruit_NeoPixel.hstops with a message: a WS2812 bit is too short to make by hand on this board. The AVR boards, the ESP32s, the Pico and the Uno R4 drive the strip.
Trình soạn code và biên dịch liệt kê mỗi thư viện hỗ trợ những gì và khác gì so với thư viện thượng nguồn.
Các ví dụ
Blink, Button, Serial và Analog.
Ở nơi khác
- Trang bo mạch: /boards/xiao-samd21
- Tài liệu đặc tả: mô hình XIAO SAMD21
- Bo mạch khác cùng nhân: Raspberry Pi Pico
- Dự án khởi đầu: XIAO SAMD21 serial