Placas

A Seeed XIAO SAMD21

Uma placa do tamanho de uma unha: onze pads, todos eles entradas analógicas, com Serial no próprio USB do chip.

A visão geral, com exemplos rodando, está na página da placa e O modelo da XIAO SAMD21 (todos os registradores).

O que é

A Seeed Studio XIAO SAMD21, uma ATSAMD21G18A rodando no nosso próprio núcleo Cortex-M no perfil ARMv6-M, o mesmo núcleo que o Raspberry Pi Pico usa, a 48 MHz em vez de 125. O firmware é um ELF Thumb que conversa com os endereços reais do SAM D21.

A placa tem 21 por 17,8 mm e suas duas fileiras de sete pads ficam a 0,6 polegada de distância, então ela fica atravessada sobre o canal central da protoboard com uma fileira livre de cada lado.

Os pinos

Quatorze pads castelados, sete em cada borda, com o soquete USB-C no topo.

Coluna esquerda: D0, D1, D2, D3, D4, D5, D6.

Coluna direita: 5V, GND, 3V3, D10, D9, D8, D7.

Todos os onze pads de E/S são entradas analógicas, e A0 a A10 são os mesmos pads de D0 a D10; a serigrafia imprime os dois. analogRead(A3) e analogRead(3) são o mesmo pino.

Esta é uma placa de 3,3 volts e seus pinos não toleram 5 V. 3V3 fornece 3,3 V e 5V fornece 5 V do soquete USB.

Três LEDs estão na placa e em nenhum pad: o LED do usuário, RX e TX. Os três são ativos em nível baixo, então digitalWrite(LED_BUILTIN, LOW) acende o do usuário. LED_BUILTIN é 13.

Três coisas que o pinout faz com você

Isto é o hardware, não o modelo, e cada uma pega alguém:

  • D0 não tem PWM. É o pino do DAC e não chega a nenhum timer, então analogWrite(0, x) o liga ou desliga na metade do curso. Use qualquer outro pad para um fade.
  • D4 não tem interrupção externa. É o pino de NMI do chip, então attachInterrupt(4, ...) não faz nada. E D5 e D7 compartilham uma linha de interrupção, então só um dos dois pode ter um manipulador por vez.
  • Alguns pads de PWM compartilham o duty. D1 e D4 são um canal de comparação, e o mesmo vale para D9 e D5, D10 e D2, e D8 e D3. Escrever em um move os dois.

Serial é o USB, e Serial1 não é

Serial é o próprio dispositivo USB do chip. É nele que o monitor serial está conectado, e ele não tem taxa de transmissão própria: o número que você passa chega ao host como um pedido que o host pode ignorar.

Não há uma pilha USB por baixo. O Mokxi modela o controlador do dispositivo como um duto de bytes nos registradores reais dos endpoints e nada acima disso: sem enumeração, sem descritores, sem pacotes SETUP. Num XIAO de verdade, while (!Serial) {} espera o host notar a placa; aqui ele retorna de imediato. E Keyboard e Mouse, que são a outra metade do propósito de uma placa com USB nativo, não estão disponíveis.

Serial1 é outra coisa: uma USART real em D6 (TX) e D7 (RX), transmitindo quadros 8N1 reais um bit por vez. Ligue um jumper de D6 a D7 e um sketch ouve o próprio eco; configure as duas pontas com taxas de transmissão diferentes e o texto embaralha, exatamente como acontece numa mesa.

What is modeled

O PORT, o SysTick, GCLK, PM e SYSCTRL na medida suficiente para uma inicialização estilo Arduino rodar até o fim, os seis SERCOMs como USARTs, TCC0-2 e TC3-7 até o PWM, o ADC SAR nos vinte canais, o EIC e o USB como aquele duto de bytes.

Esse é o conjunto de que pinMode, digitalWrite, digitalRead, analogRead, analogWrite, millis, micros, delay, attachInterrupt, Serial e Serial1 precisam, nos seus endereços reais.

O que não é

A árvore de clock (o núcleo simplesmente roda a 48 MHz desde a primeira instrução), SPI e I2C nos SERCOMs (Wire e SPI são software em pinos comuns, abaixo), o DAC, os comparadores analógicos, o controlador de toque, I2S, DMA, o sistema de eventos, o controlador NVM, o watchdog, o RTC e todo o USB acima de um duto 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 o modelo da XIAO SAMD21. A seção 7 é a que se deve ler antes de levar uma compilação daqui para o silício real.

Bibliotecas do Arduino

Um tutorial que inclua Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h com Adafruit_SSD1306.h e DHT.h compila aqui como está. Cada uma é um cabeçalho próprio do Mokxi sob o nome upstream, escrito sobre os drivers dos componentes da caixa de componentes, e nada disso é o código da biblioteca upstream.

  • Wire.begin() coloca o barramento I2C em D4 (SDA) e D5 (SCL).
  • EEPROM.h funciona, mas o modelo desta placa não tem EEPROM nem flash gravável, então os bytes vivem em 4 KB de RAM: eles são lidos de volta dentro de uma execução e somem num reset.
  • Adafruit_NeoPixel.h stops 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.

O editor de código e a compilação lista o que cada uma cobre e como difere da biblioteca upstream.

Os exemplos

Blink, Button, Serial e Analog.

Em outros lugares