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 dedocs/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.mdsección 1). SCL/SDAjunto aAREFson las mismas dos piezas de metal que los pines21y20. 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 deR_STRAP, exactamente como el par delA4/SDAdel Uno.5V,5VbyIOREFentregan 5 V conR_SUPPLY;3V3entrega 3.3 V;GND,GNDb,GNDcyGNDdentregan 0 V.VINes una entrada que la placa ignora: siempre se alimenta por USB.RESETtiene 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 reportaMCUSR.AREFsolo se lee, nunca se maneja. Con una referencia interna seleccionada, el pin se deja en paz.- El pin
13tiene el LEDLde la placa a través de 1 k a tierra. A0aA15son pines digitales comunes además de entradas analógicas, a diferencia deA6yA7del 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) extiendeZparaELPMySPM.ELPM Rd, Z+acarrea el desbordamiento deZhaciaRAMPZ, así que un solo puntero recorre todo el flash.EIND(0x5C) extiende el destino deEIJMPyEICALL.CALL,RCALL,ICALL,EICALL,RETyRETIhacen 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.
Serialllega al monitor serie a través del canal del host, y los pines0y1siguen 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.mdsection 3.8, vector 12, except that the stk500v2 bootloader, since its Dec 2011 issue #181 fix, clearsMCUSRand turns the watchdog off after a watchdog reset, and the model does the same: the sketch starts withWDRFclear 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.