La descripción general, con ejemplos en ejecución, está en la página de la placa y El modelo XIAO SAMD21 (todos los registros).
Qué es
La Seeed Studio XIAO SAMD21, una ATSAMD21G18A funcionando con nuestro propio núcleo Cortex-M en su perfil ARMv6-M, el mismo núcleo que usa la Raspberry Pi Pico, a 48 MHz en vez de 125. El firmware es un ELF Thumb que habla a las direcciones reales del SAM D21.
La placa mide 21 por 17.8 mm y sus dos filas de siete pads están a 0.6 pulgadas de distancia, así que se monta a horcajadas sobre el canal central de una protoboard dejando una fila libre a cada lado.
Los pines
Catorce pads castellados, siete por cada borde, con el conector USB-C en la parte de arriba.
Columna izquierda: D0, D1, D2, D3, D4, D5, D6.
Columna derecha: 5V, GND, 3V3, D10, D9, D8, D7.
Cada uno de los once pads de E/S es una entrada analógica, y A0 a A10 son los mismos pads que D0 a D10; la serigrafía imprime ambos. analogRead(A3) y analogRead(3) son el mismo pin.
Esta es una placa de 3.3 voltios y sus pines no toleran 5 V. 3V3 suministra 3.3 V y 5V suministra 5 V desde el conector USB.
Tres LEDs están en la placa y en ningún pad: el LED del usuario, RX y TX. Los tres son activos en bajo, así que digitalWrite(LED_BUILTIN, LOW) enciende el del usuario. LED_BUILTIN es 13.
Tres cosas que el pinout te hace
Esto es del hardware, no del modelo, y cada una le pasa a alguien:
D0no tiene PWM. Es el pin del DAC y no llega a ningún temporizador, así queanalogWrite(0, x)lo enciende o apaga en el punto medio. Usa cualquier otro pad para un fundido.D4no tiene interrupción externa. Es el pin NMI del chip, así queattachInterrupt(4, ...)no hace nada. YD5yD7comparten una línea de interrupción, así que solo uno de los dos puede llevar un controlador a la vez.- Algunos pads de PWM comparten el ciclo útil.
D1yD4son un canal de comparación, y también lo sonD9yD5,D10yD2, yD8yD3. Escribir en uno mueve ambos.
Serial es el USB, y Serial1 no
Serial es el dispositivo USB propio del chip. Es a lo que está conectado el monitor serie, y no tiene tasa de baudios propia: el número que pasas llegaría al host como una petición que el host puede ignorar.
No hay una pila USB debajo. Mokxi modela el controlador del dispositivo como un conducto de bytes en los registros reales de los endpoints y nada más arriba: sin enumeración, sin descriptores, sin paquetes SETUP. En una XIAO real while (!Serial) {} espera a que el host note la placa; aquí regresa de inmediato. Y Keyboard y Mouse, que son la otra mitad de para lo que sirve una placa con USB nativo, no están disponibles.
Serial1 es otra cosa: un USART real en D6 (TX) y D7 (RX), transmitiendo tramas 8N1 reales bit por bit. Pon un jumper de D6 a D7 y un sketch escucha su propio eco; pon los dos extremos a tasas de baudios distintas y el texto se distorsiona, exactamente como sucede en un escritorio.
What is modeled
El PORT, el SysTick, lo suficiente de GCLK, PM y SYSCTRL para que un inicio estilo Arduino corra hasta el final, los seis SERCOM como USART, TCC0-2 y TC3-7 hasta PWM, el ADC SAR en los veinte canales, el EIC, y el USB como ese conducto de bytes.
Ese es el conjunto que pinMode, digitalWrite, digitalRead, analogRead, analogWrite, millis, micros, delay, attachInterrupt, Serial y Serial1 necesitan, en sus direcciones reales.
Lo que no está
El árbol de reloj (el núcleo simplemente corre a 48 MHz desde la primera instrucción), SPI e I2C en los SERCOM (Wire y SPI son software en pines comunes, abajo), el DAC, los comparadores analógicos, el controlador táctil, I2S, DMA, el sistema de eventos, el controlador NVM, el watchdog, el RTC, y todo el USB por encima de un conducto de bytes.
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 el modelo XIAO SAMD21. La sección 7 es la que hay que leer antes de llevar una compilación de aquí al silicio real.
Bibliotecas estándar de Arduino
Un tutorial que incluya Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h con Adafruit_SSD1306.h y DHT.h se compila aquí tal cual. Cada uno es un header propio de Mokxi con el nombre original, escrito sobre los controladores de los componentes de la caja, y nada de eso es código de la biblioteca original.
Wire.begin()pone el bus I2C enD4(SDA) yD5(SCL).EEPROM.hfunciona, pero el modelo de esta placa no tiene EEPROM ni flash escribible, así que los bytes viven en 4 KB de RAM: se leen dentro de una ejecución y desaparecen al reiniciar.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.
El editor de código y la compilación enumera lo que cubre cada una y en qué difiere de la biblioteca original.
Los ejemplos
Blink, Button, Serial y Analog.
En otras partes
- La página de la placa: /boards/xiao-samd21
- El documento de contrato: el modelo XIAO SAMD21
- La otra placa en el mismo núcleo: la Raspberry Pi Pico
- Proyecto inicial: XIAO SAMD21 serial