Referencia

Contrato de la placa Arduino Mega 2560 (Fase 9)

La ATmega2560: once puertos, seis temporizadores, cuatro USART y un ADC de dieciséis canales.

Esta es la referencia de ingeniería del modelo: qué implementa, registro por registro, para quienes escriben firmware sobre él. Para usar la placa en el editor, empieza por El Arduino Mega 2560 y la página de la placa.

El Mega 2560 es el Arduino para un proyecto que se quedó sin pines. Un componente del kernel (mega2560 en crates/parts) envuelve un modelo del SoC ATmega2560 (crates/atmega2560) sobre el mismo núcleo AVR que el Uno (crates/avr-core). El núcleo se comparte; el chip que lo rodea, no. Este documento es el contrato, y prevalece sobre cualquier comentario en el código.

El tipo de catálogo es mega2560 (Arduino Mega 2560 R3). Donde una sección dice "como docs/uno.md", ese documento es el contrato para esa parte.

1. Pines de la placa (orden del catálogo)

Vista superior, con el conector USB-B y el conector de barril en el borde izquierdo. Los headers del shield a lo largo de los bordes largos son los de un Uno, agujero por agujero, incluido el hueco de 0.16 pulgadas del Uno entre los dos bloques del header digital. El bloque 2x18 de pines digitales extra está en el borde corto derecho.

Fila superior, de izquierda a derecha (26 agujeros): SCL, SDA, AREF, GND, 13, 12, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0, 14, 15, 16, 17, 18, 19, 20, 21.

Fila inferior, de izquierda a derecha (23 agujeros): IOREF, RESET, 3V3, 5V, GNDb, GNDc, VIN, A0 a A15.

El bloque 2x18, fila por fila desde el borde largo de la placa hacia adentro (34 agujeros): 22/23, 24/25, ... 52/53, luego 5Vb/GNDd.

83 pines. Los dos headers ICSP no son pines.

El mapeo de puertos, que es la razón de ser de la tabla de pines de esta placa. No está ordenado, y es el de la placa real:

pines puerto
0, 1 PE0, PE1
2, 3 PE4, PE5
4 PG5
5 PE3
6 a 9 PH3 a PH6
10 a 13 PB4 a PB7
14, 15 PJ1, PJ0
16, 17 PH1, PH0
18, 19 PD3, PD2
20, 21 PD1, PD0
22 a 29 PA0 a PA7
30 a 37 PC7 hasta PC0
38 PD7
39 a 41 PG2, PG1, PG0
42 a 49 PL7 a PL0
50 a 53 PB3 a PB0
A0 a A7 PF0 a PF7
A8 a A15 PK0 a PK7

No existe el puerto I. Los puertos A a F y H a L son de ocho bits; el puerto G es de seis (PG0 a PG5), y los dos bits superiores leen 0 e ignoran las escrituras.

Eléctrica:

  • Cada GPIO maneja push-pull a 5 V a través de R_STRONG, queda en alta impedancia, o hace pull-up a través de 35 k, exactamente como establece la sección 1 de docs/uno.md. Una entrada lee alto a 2.5 V; una red en disputa (Desconocido) lee 0, y una flotante lee ruido, como en el Uno (docs/uno.md sección 1).
  • SCL/SDA junto a AREF son las mismas dos piezas de metal que los pines 21 y 20. Ese es el cambio R3 en el header del shield. Ambos orificios de cada par llevan lo que el pin está manejando más lo que haga la red del otro lado, a través de R_STRAP, exactamente como el par del A4/SDA del Uno.
  • 5V, 5Vb y IOREF entregan 5 V con R_SUPPLY; 3V3 entrega 3.3 V; GND, GNDb, GNDc y GNDd entregan 0 V. VIN es una entrada que la placa ignora: siempre se alimenta por USB.
  • RESET tiene un pull-up de 10 k a 5 V. Llevarlo por debajo de 2.5 V mantiene la CPU en reset; soltarlo produce un reset externo, que es lo que reporta MCUSR.
  • AREF solo se lee, nunca se maneja. Con una referencia interna seleccionada, el pin se deja en paz.
  • El pin 13 tiene el LED L de la placa a través de 1 k a tierra.
  • A0 a A15 son pines digitales comunes además de entradas analógicas, a diferencia de A6 y A7 del Nano.

2. Mapa de memoria

flash 256 KB, 128 K palabras de instrucción, PC de 17 bits
SRAM 8 KB en 0x0200 a 0x21FF, RAMEND = 0x21FF
EEPROM 4 KB
registros 32 en 0x0000 a 0x001F
I/O 0x0020 a 0x005F, accesibles con IN/OUT
E/S extendida 0x0060 a 0x01FF, accesibles solo con LD/ST

De un flash de un cuarto de megabyte y un PC de 17 bits se siguen tres cosas, y el núcleo maneja las tres:

  • RAMPZ (0x5B) extiende Z para ELPM y SPM. ELPM Rd, Z+ acarrea el desbordamiento de Z hacia RAMPZ, así que un solo puntero recorre todo el flash.
  • EIND (0x5C) extiende el destino de EIJMP y EICALL.
  • CALL, RCALL, ICALL, EICALL, RET y RETI hacen push y pop de una dirección de retorno de tres bytes, y una interrupción hace lo mismo, así que un marco de pila aquí es un byte más profundo que el de un Uno.

SP es 0x21FF al salir del reset.

3. Periféricos

Las direcciones son direcciones de datos. Toda esta sección es el mapa de la hoja de datos del ATmega2560, no una conveniencia.

3.1 Puertos

PINx, DDRx, PORTx consecutivos, un grupo por puerto: A 0x20, B 0x23, C 0x26, D 0x29, E 0x2C, F 0x2F, G 0x32, H 0x100, J 0x103, K 0x106, L 0x109. El bit 4 de MCUCR (0x55) es PUD, que desactiva todos los pull-up a la vez.

Escribir 1 en un bit de PINx alterna el bit correspondiente de PORTx, como en el Uno.

3.2 Temporizadores

Seis. Los temporizadores 0 y 2 son de ocho bits con dos canales de comparación; los temporizadores 1, 3, 4 y 5 son de dieciséis bits con tres canales de comparación cada uno: A, B y C.

temporizador base tipo
0 TCCR0A 0x44 8-bit, 2 channels
1 0x80 16 bits, 3 canales
2 TCCR2A 0xB0 8-bit, 2 channels, async
3 0x90 16 bits, 3 canales
4 0xA0 16 bits, 3 canales
5 0x120 16 bits, 3 canales

A sixteen-bit timer's registers run TCCRnA, TCCRnB, TCCRnC, gap, TCNTnL, TCNTnH, ICRnL, ICRnH, OCRnAL, OCRnAH, OCRnBL, OCRnBH, OCRnCL, OCRnCH from the base. The high-byte temporary register is shared across all of them, as the data sheet says.

Las máscaras de interrupción son TIMSK0 0x6E, TIMSK1 0x6F, TIMSK2 0x70, TIMSK3 0x71, TIMSK4 0x72, TIMSK5 0x73; las banderas son TIFR0 0x35 hasta TIFR5 0x3A.

Cada modo de onda de la sección 3.2 de docs/uno.md está aquí, en los seis temporizadores, y las salidas de comparación llegan a sus pads. OC0A y OC1C son ambos PB7, que es el pin 13: el que se habilite primero es dueño del pad, y solo el dueño puede liberarlo.

3.3 ADC

Dieciséis canales externos. ADMUX 0x7C, ADCSRA 0x7A, ADCSRB 0x7B, ADCL/ADCH 0x78/0x79, DIDR0 0x7E, DIDR1 0x7F, DIDR2 0x7D.

The channel number is five bits, and the fifth is not in ADMUX: it is MUX5, bit 3 of ADCSRB. So channel = (ADCSRB.MUX5 << 4) | (ADMUX & 0x1F). Channels 0 to 7 are A0 to A7; with MUX5 set, 0 to 7 are A8 to A15.

REFS1:0 selecciona la referencia: 0 = AREF, 1 = AVcc (5 V), 2 = la banda interna de 1.1 V, 3 = la interna de 2.56 V. El Uno no tiene referencia de 2.56 V; este componente sí.

Ten-bit result, right adjusted unless ADLAR is set. Conversion timing is the Uno's: 13 ADC clocks for a normal conversion, 25 for the first after ADEN, at the prescaled clock ADPS2:0 selects.

3.4 USART

Cuatro. Bases 0xC0, 0xC8, 0xD0 y 0x130, cada una con UCSRnA, UCSRnB, UCSRnC, un hueco, UBRRnL, UBRRnH, UDRn. Los nombres de los bits son los del Uno.

USART0 es el canal hacia el equipo: lo que un programa escribe en UDR0 llega al monitor serie, y lo que el monitor envía llega a UDR0. No controla PE0 y PE1.

USART1, USART2 y USART3 controlan sus pines. Activar TXEN se apodera del pin TX sin importar su bit DDRx y envía una trama 8N1 real: bit de inicio en bajo, ocho bits de datos empezando por el menos significativo, bit de parada en alto, un tiempo de bit cada uno a la velocidad que UBRRn establece. Activar RXEN toma el pin RX como entrada y lo muestrea en medio de cada bit. Un cable entre dos de estos pines transporta bytes a la velocidad que pidió el sketch, y un par con velocidades distintas produce caracteres ilegibles, como pasaría en el banco de trabajo.

Pines TX y RX: USART1 PD3/PD2, USART2 PH1/PH0, USART3 PJ1/PJ0.

3.5 Interrupciones externas y por cambio de pin

Ocho interrupciones externas, de INT0 a INT7, en PD0 a PD3 y PE4 a PE7. Los bits de detección están divididos: INT0 a INT3 en EICRA (0x69), INT4 a INT7 en EICRB (0x6A), dos bits cada una. Máscara EIMSK 0x3D, banderas EIFR 0x3C.

La numeración de Arduino no es la del hardware: la interrupción 0 es el pin 2, que es INT4; las interrupciones 2 a 5 son los pines del 21 al 18, que son INT0 a INT3. INT6 y INT7 están en PE6 y PE7, que la placa no expone, así que no se puede adjuntar nada a ellas.

Cambio de pin: tres grupos en lugar de los tres puertos del Uno. PCINT0 es el puerto B, PCINT1 es PE0 más PJ0 a PJ6, PCINT2 es el puerto K. PCICR 0x68, PCIFR 0x3B, máscaras PCMSK0 0x6B, PCMSK1 0x6C, PCMSK2 0x6D.

3.6 Suspensión y EEPROM

SMCR 0x53 holds SE and the sleep mode bits. SLEEP with SE set parks the core until an interrupt, and a parked core costs the simulator nothing.

La EEPROM es de 4 KB a través de EEARH/EEARL, EEDR y EECR, como en la sección 3.6 de docs/uno.md.

3.7 Vectores

57 vectores, de dos palabras cada uno, porque solo JMP alcanza toda la flash de 256 KB. El vector n está en la dirección de palabra 2n. La numeración es la de la hoja de datos: 0 reset, 1 a 8 INT0 a INT7, 9 a 11 PCINT0 a PCINT2, 12 watchdog, 13 a 15 timer 2, 16 a 20 timer 1, 21 a 23 timer 0, 24 SPI, 25 a 27 USART0, 28 comparador analógico, 29 ADC, 30 EEPROM lista, 31 a 35 timer 3, 36 a 38 USART1, 39 TWI, 40 SPM listo, 41 a 45 timer 4, 46 a 50 timer 5, 51 a 53 USART2, 54 a 56 USART3.

4. Canal del host

host = "bytes utf-8 en USART0", como el Uno.

5. Modelo de tiempo y el componente

16 MHz, porciones de 10 us, 160 ciclos por porción, cambios de pin reportados en su desplazamiento de ciclo exacto dentro de la porción y convertidos en llamadas a drive_after con los mismos desplazamientos. SLEEP detiene el núcleo y el componente entonces programa el siguiente despertar según lo que el chip esté esperando, en lugar de cada 10 us. Todo esto es la sección 5 de docs/uno.md sin cambios.

Sonda: bit 0 en ejecución, bit 1 dormido, bit 2 el LED integrado en el pin 13, bit 3 actividad TX en los últimos 20 ms, bit 4 actividad RX; 0 sin programa. Poke: 2 = presionar RESET, 3 = soltar.

Un fallo (un código de operación ilegal, un salto más allá del final de la flash, una pila desbordada) detiene el núcleo, deja los pines como estaban y escribe una línea en el canal del host nombrando la falla y el PC, en cinco dígitos hexadecimales porque el PC de este componente los necesita.

6. Firmware (firmware/mega/)

Su propio runtime, porque el componente realmente es distinto. Cinco archivos son los del Uno, compilados de nuevo para este destino en lugar de copiados, porque nada en ellos depende de cuántos puertos o temporizadores tenga el chip: support.S, src/support.c, src/format.c, src/math.c, src/print.cpp y src/main.cpp. Todo lo demás es de esta placa: crt0.S (57 vectores, una pila en 0x21FF, ELPM con RAMPZ para la copia de .data), link.ld, la tabla de pines de 70 entradas, el tick del temporizador, el ADC de dieciséis canales, los cuatro USART y las interrupciones externas.

NUM_DIGITAL_PINS es 70, NUM_ANALOG_INPUTS es 16, A0 a A15 son los pines 54 a 69, LED_BUILTIN es 13, MOKXI_BOARD es "mega2560".

Ejemplos en firmware/mega/examples/<name>/sketch.ino, compilados a web/public/firmware/mega/<name>.elf con web/public/firmware/mega/index.json: blink (pin 13), serial, ports (los cuatro USART, cada uno de los tres de los headers con puente de vuelta a su propio RX), chaser (doce LEDs en los pines 22 a 33, un pin cada uno, sin registro de desplazamiento).

El campo program del índice es "elf32 avr atmega2560", y la entrada del catálogo dice lo mismo. A diferencia del Nano, esta cadena difiere de la del Uno porque el ELF realmente lo hace: distinto chip, distinto mapa de registros, distinta tabla de vectores.

7. Qué no está modelado

  • El puente USB a serie, el 16U2. Serial llega al monitor serie a través del canal del host, y los pines 0 y 1 siguen siendo GPIO normales.
  • SPI, TWI/I2C, the analog comparator and the JTAG interface. Their registers read back what was written; nothing happens. (The watchdog is modeled, as the Uno's: docs/uno.md section 3.8, vector 12, except that the stk500v2 bootloader, since its Dec 2011 issue #181 fix, clears MCUSR and turns the watchdog off after a watchdog reset, and the model does the same: the sketch starts with WDRF clear and the watchdog stopped.)
  • Los escudos como componentes físicos. Arma el mismo circuito en la protoboard en su lugar.
  • The Arduino IDE library ecosystem. The runtime here is ours and Arduino-shaped, not the Arduino core.
  • The Mega ADK and the older Mega 1280. This is the Mega 2560 R3.

8. De qué está seguro este modelo, y de qué no

Tomado de la hoja de datos. Cada dirección, posición de bit y valor de reset de la sección 3 proviene del ATmega640/1280/1281/2560/2561 Data Sheet, con la numeración del espacio de datos. Los once puertos, los seis temporizadores, los cuatro USART, los dieciséis canales del ADC y su división ADCSRB/MUX5, las ocho interrupciones externas y los grupos de cambio de pin son los de la hoja de datos, y también lo son los 256 KB de flash con su contador de programa de tres bytes y EIND. Los números propios de la placa (el orden de los headers de la sección 1, el LED en el pin 13 (PB7) y qué pin del chip es cada uno de los 54 pines digitales y los 16 analógicos) son del esquemático de la Mega 2560 R3.

Modelado, pero sin apegarse a los números de la hoja de datos. Todo lo del grupo intermedio de la sección 7 de docs/uno.md se aplica aquí sin cambios, porque es el mismo núcleo y las mismas formas de periféricos: un ADC que es round(1023 × Vin / Vref) sin muestreo y retención, sin no linealidad, sin ruido y sin desplazamiento; un reloj exacto de 16 MHz sin tolerancia, deriva ni fluctuación; tres estados de pad y un umbral, con una resistencia pull-up de 35 kΩ, sin histéresis, sin tiempo de subida y sin límite de corriente; una alimentación ideal que no puede caer; un arranque de un microsegundo donde una placa real pasa 65 ms en su bootloader; y una porción de 10 us con el núcleo avanzando una instrucción a la vez dentro de ella.

Deliberadamente ausente, como enumera la sección 7: el puente USB a serie 16U2, SPI, TWI/I2C, el comparador analógico, la interfaz JTAG, los shields como componentes físicos y el ecosistema de bibliotecas del núcleo de Arduino. Sus registros devuelven lo que se escribió y no ocurre nada. Esta es la Mega 2560 R3, no la ADK ni la 1280 anterior.