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 Nano y la página de la placa.
El Nano es el chip del Arduino Uno en una placa que cabe en una protoboard. Un componente del kernel (nano en crates/parts) envuelve el mismo modelo de SoC ATmega328P (crates/atmega328p) que el Uno, sobre el mismo núcleo AVR (crates/avr-core). Nada del chip cambia: los registros, los timers, la USART, el ADC, los vectores de interrupción y los conteos de ciclos son los que fija docs/uno.md, y ese documento es el contrato para todos ellos. Este solo dice lo que es distinto, que es el paquete y los agujeros.
El tipo del catálogo es nano (Arduino Nano v3). Todo lo de docs/uno.md aplica salvo que una sección aquí diga lo contrario.
1. Pines de la placa (orden del catálogo)
Top view, the mini-USB socket at the top. Two fifteen-pin headers 0.6 inch apart, so the board pushes into a breadboard and straddles the center channel with three spare holes on each side.
Columna izquierda, de arriba abajo (pines de placa 1 a 15): 1, 0, RESET, GND, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12.
Columna derecha, de arriba abajo (pines de placa 30 a 16): VIN, GNDb, RESETb, 5V, A7, A6, A5, A4, A3, A2, A1, A0, AREF, 3V3, 13.
30 pines. El header ICSP no es un pin.
Eléctrico, donde difiere de la sección 1 de docs/uno.md:
- Port mapping is the Uno's:
0..7= PD0..PD7,8..13= PB0..PB5,A0..A5= PC0..PC5. There is noIOREFand there are no separateSDA/SCLholes, soA4andA5are each one hole rather than two. A6yA7son los canales 6 y 7 del ADC y nada más. El Nano es el paquete TQFP-32, que conectaADC6yADC7como entradas analógicas sin pin de puerto detrás: sin controlador de salida, sin pull-up, sinPINxbit, y sin lectura digital. La placa lee el voltaje de la red en cada uno de esos dos agujeros y se lo entrega al ADC; la máscara de entrada digital nunca lleva un bit para ellos.ADMUXlos valores 6 y 7 los seleccionan. En un Uno (un DIP de 28 pines) no hay almohadilla, así que el mismoADMUXvalor lee 0.RESETyRESETbson una sola pieza de metal. La placa saca la pista de reset en ambos extremos. Los dos agujeros llevan la pull-up de 10 k a 5 V, llevar cualquiera por debajo de 2.5 V mantiene la CPU en reset, y cada agujero muestra lo que hace la red del otro a través deR_STRAP, exactamente como el par delA4/SDAdel Uno.GNDyGNDbson igualmente el mismo riel, y ambos simplemente entregan 0 V.5Ventrega 5 V enR_SUPPLY,3V3entrega 3.3 V,VINes una entrada que la placa ignora (siempre alimentado por USB).- El pin
13tiene el LED integradoLa través de 1 k hacia tierra, como en el Uno.
2. Mapa de memoria
Sin cambios respecto a la sección 2 de docs/uno.md: 32 KB de flash, 2 KB de SRAM en 0x0100..0x08FF, 1 KB de EEPROM, SP en 0x08FF al salir del reset. Es el mismo dado.
3. Periféricos
Sin cambios respecto a la sección 3 de docs/uno.md, con una adición: el multiplexor del ADC tiene ocho canales externos en lugar de seis. MUX3:0 de 0 a 5 seleccionan A0 a A5 como antes; 6 y 7 seleccionan A6 y A7. El 8 es el sensor de temperatura, el 14 el bandgap de 1.1 V y el 15 tierra, como antes. DIDR0 sigue cubriendo solo los bits 0 a 5: ADC6 y ADC7 tampoco tienen búfer de entrada digital que apagar en el silicio.
4. Canal del host
host = "bytes utf-8 en USART0", como el Uno.
5. Modelo de tiempo y el componente
Sin cambios respecto a la sección 5 de docs/uno.md: 16 MHz, segmentos de 10 µs, cambios de pin en su ciclo exacto, SLEEP estaciona el núcleo.
Sonda: la misma máscara de bits. Bit 0 en ejecución, bit 1 dormido, bit 2 el LED integrado del pin 13, bit 3 actividad TX en los últimos 20 ms, bit 4 actividad RX. Poke: 2 = presionar RESET, 3 = soltar. El manejo de crashes es el mismo.
6. Firmware (firmware/nano/)
No hay un segundo runtime. firmware/nano/build.sh ejecuta firmware/uno/build.sh con BOARD=nano, que agrega una bandera, -DMOKXI_BOARD_NANO, y esa bandera hace tres cosas en firmware/uno/include/uno.h y nada más:
| Uno | Nano | |
|---|---|---|
MOKXI_BOARD |
"uno" |
"nano" |
NUM_ANALOG_INPUTS |
6 | 8 |
A6, A7 |
no definido | 20, 21 |
A6 and A7 are past NUM_DIGITAL_PINS, so pinMode, digitalWrite and digitalRead ignore them and analogRead reaches them as channels 6 and 7. Every other line of the runtime, including crt0.S and link.ld, is the same file, so an image built for one of these boards runs on the other, which is what the two boards being one chip means.
Ejemplos en firmware/nano/examples/<name>/sketch.ino, compilados a web/public/firmware/nano/<name>.elf con web/public/firmware/nano/index.json: blink (pin 13), button (pin 2 con INPUT_PULLUP al pin 13), serial, dial (un potenciómetro en A7 que desvanece un LED en el pin 9 con PWM por hardware).
El campo program del índice es "elf32 avr atmega328p nano", y la entrada del catálogo dice lo mismo. Difiere del del Uno, "elf32 avr atmega328p", solo para que el editor ofrezca a cada placa su propia lista de ejemplos; el formato ELF detrás de las dos cadenas es idéntico.
7. Qué no está modelado
Todo lo que docs/uno.md no modela, y una cosa más: el puente USB a serie del Nano (un FT232RL en un original, un CH340 en la mayoría de los clones) no es un componente. Serial llega al monitor serie por el canal del host, como en todas las demás placas aquí, y los pines 0 y 1 siguen siendo GPIO normales en lugar de estar conectados a un puente.
8. De qué está seguro este modelo, y de qué no
El chip es el del Uno, así que la sección 7 de docs/uno.md también es el criterio de esta placa: la misma hoja de datos, el mismo mapa de registros, las mismas pruebas y la misma lista de comportamientos que son aproximaciones y no números de la hoja de datos: un ADC sin error, un reloj exacto de 16 MHz sin deriva, tres estados de pad y un umbral, una alimentación ideal que no puede caer, y un segmento de 10 µs. Su arranque también es el del Uno: los mismos fuses, así que
setup() arranca 66 ms después de la alimentación.
Dos cosas son propias de esta placa y ninguna es una suposición: el orden del header de treinta pines de la sección 1, y A6/A7, que son los canales 6 y 7 del ADC en el encapsulado TQFP y son solo analógicos. No tienen bit de puerto, así que digitalRead, digitalWrite, pinMode y la resistencia pull-up interna no hacen nada en ellos, exactamente como en un Nano real. La sección 7 enumera lo que falta además de la lista del Uno.