Manual Completo de Programación para SNES

Introducción a la Programación SNES

La Super Nintendo Entertainment System (SNES) fue lanzada en 1990 y representa uno de los sistemas de 16 bits más populares. Programar para SNES requiere entender su arquitectura única y trabajar con limitaciones específicas.

Conceptos Clave

• ROM: El juego se distribuye como un archivo ROM que contiene todo el código y datos.
• ASM: El lenguaje principal es el ensamblador (ASM) del procesador 65c816.
• Modos Gráficos: La SNES tiene varios modos gráficos con diferentes capacidades.
• Sprites y Fondos: Elementos fundamentales para la visualización.

Arquitectura del Hardware SNES

Especificaciones Técnicas

Mapa de Memoria

$0000-$1FFF: WRAM (8KB mirrored)
$2100-$21FF: Registros PPU
$4200-$44FF: Registros del sistema y DMA
$7E0000-$7FFFFF: WRAM (128KB)
$8000-$FFFF: ROM del juego (bank switching)
        

Herramientas de Desarrollo

Ensambladores

• WLA-DX: Ensamblador multiplataforma con soporte para SNES
• ASAR: Ensamblador con características avanzadas
• xkas: Alternativa más antigua pero funcional

Emuladores para Desarrollo

• bsnes/higan: Emulador de alta precisión
• Mesen-S: Emulador moderno con buenas herramientas de depuración
• snes9x: Más rápido pero menos preciso

Otras Herramientas

• YY-CHR: Editor de gráficos
• Tile Layer Pro: Editor de mapas y tilesets
• SPC700 DSP Tool: Para trabajar con sonido

Programación en ASM para SNES

Estructura Básica de un Programa

; Cabecera SNES
.MEMORYMAP
    SLOTSIZE $8000
    DEFAULTSLOT 0
    SLOT 0 $8000
.ENDME

.ROMBANKSIZE $8000
.ROMBANKS 1

.BANK 0 SLOT 0
.ORG $0000

.SECTION "Inicio" SEMIFREE

Start:
    ; Inicializar el sistema
    sei             ; Deshabilitar interrupciones
    clc             ; Limpiar carry
    xce             ; Cambiar a modo nativo
    
    rep #$30        ; A=16 bits, X/Y=16 bits
    ldx #$1FFF      ; Configurar stack pointer
    txs
    
    ; Configurar modo gráfico
    lda #$80        ; Forzar blank
    sta $2100
    
    ; Más inicialización...
    
    ; Habilitar display
    lda #$0F
    sta $2100
    
    ; Bucle principal
MainLoop:
    wai             ; Esperar VBlank
    jmp MainLoop
    
.ENDS
        

Registros del 65c816

El 65c816 tiene tres registros principales de 16 bits:

• A: Acumulador (puede usarse como 8 bits con .B)
• X/Y: Registros índice
• P: Registro de estado (flags)

Modos de Direccionamiento

; Ejemplos de direccionamiento
lda #$1234         ; Inmediato
lda $00            ; Direct page
lda $1234          ; Absoluto
lda ($00),y        ; Indirecto indexado
lda $1234,x        ; Absoluto indexado
        

Modos Gráficos de la SNES

La SNES tiene varios modos gráficos (0-7) que determinan cómo se renderizan los fondos y sprites:

Configurar un Modo Gráfico

; Configurar modo 1 con prioridad para BG3
lda #$09
sta $2105           ; Registro BGMODE

; Configurar tamaños de tile
lda #$04            ; BG3 16x16 tiles
sta $2107           ; Registro BG3SC

; Configurar direcciones VRAM
lda #$00            ; BG1 tiles en $0000
sta $210B           ; Registro BG12NBA
lda #$01            ; BG2 tiles en $1000
sta $210B
        

Trabajando con Sprites

Los sprites (OBJ) en SNES son elementos gráficos que se mueven independientemente de los fondos. Cada sprite puede ser de 8x8 a 64x64 píxeles.

Estructura de Datos de Sprites

; OAM (Object Attribute Memory) estructura:
; Byte 0: Coordenada X (9 bits)
; Byte 1: Coordenada Y
; Byte 2: Número de tile
; Byte 3: Atributos (prioridad, paleta, flip, etc.)
        

Cargar Sprites

; Cargar sprite en OAM
LoadSprite:
    lda #$80        ; X = 128
    sta $0200       ; OAM low table
    lda #$00
    sta $0201       ; Byte alto X (bit 9)
    
    lda #$50        ; Y = 80
    sta $0202
    
    lda #$01        ; Tile 1
    sta $0203
    
    lda #$30        ; Paleta 3, prioridad 1, no flip
    sta $0204
    
    ; Actualizar OAM
    lda #$02        ; Iniciar DMA en canal 2
    sta $420B
        

Programación de Sonido

El sonido en SNES es manejado por el chip SPC700 con su propio DSP. Se programa cargando código y datos en su memoria.

Estructura Básica de Sonido

; Inicializar sonido
InitSound:
    lda #$AA        ; Comando de inicialización
    sta $2140
    lda #$BB
    sta $2141
    
    ; Esperar respuesta
-   lda $2140
    cmp #$CC
    bne -
    
    ; Cargar datos SPC
    ; (usando DMA para transferir el programa SPC)
        

Reproducir un Sonido

; Reproducir muestra de sonido
PlaySound:
    lda #$01        ; Canal 1
    sta $2140
    lda #$00        ; Volumen completo
    sta $2141
    lda #sample_id  ; ID de la muestra
    sta $2142
    lda #$00
    sta $2143
        

Manejo de Input (Controles)

La SNES puede leer hasta 8 botones por control (A, B, X, Y, Start, Select, L, R) más direccionales.

Leer Input

; Leer estado del control 1
ReadInput:
    lda $4218       ; Byte bajo (B, Y, Select, Start, Up, Down, Left, Right)
    sta controller1
    lda $4219       ; Byte alto (A, X, L, R)
    sta controller1+1
    
; Verificar botón A
    lda controller1+1
    and #$80        ; Máscara para A
    beq NoAPressed
    ; Código cuando A está presionado
NoAPressed:
        

Ejemplo Completo: Juego Básico

Este es un esqueleto básico para un juego simple:

; Inicialización del juego
InitGame:
    ; Configurar modo gráfico
    lda #$09        ; Modo 1, prioridad BG3
    sta $2105
    
    ; Cargar tiles en VRAM
    jsr LoadTiles
    
    ; Cargar paletas
    jsr LoadPalettes
    
    ; Inicializar sprites
    jsr InitSprites
    
    ; Habilitar display
    lda #$0F
    sta $2100
    
; Bucle principal del juego
GameLoop:
    wai             ; Esperar VBlank
    
    ; Leer controles
    jsr ReadInput
    
    ; Actualizar lógica del juego
    jsr UpdateGame
    
    ; Renderizar
    jsr Render
    
    jmp GameLoop
    
; Rutinas del juego
LoadTiles:
    ; Implementar carga de tiles
    rts
    
LoadPalettes:
    ; Implementar carga de paletas
    rts
    
InitSprites:
    ; Inicializar OAM
    rts
    
UpdateGame:
    ; Actualizar posición de sprites, etc.
    rts
    
Render:
    ; Actualizar OAM, scroll, etc.
    rts
        

Recursos Adicionales

Documentación Oficial

• Manual de Programación SNES de Nintendo (PDF)
• Documentación del chipset SNES

Comunidades

• SNESDev en Reddit
• Foros de SMW Central
• Discord de SNES Homebrew

Tutoriales

• SNES Assembly Tutorials en YouTube
• Documentación de WLA-DX
• Ejemplos de código en GitHub