# Introduction

This tutorial is an online version of my 65c816 assembly tutorial which is hosted on [SMW Central](https://www.smwcentral.net/). I originally wrote this tutorial in order to teach the SMW Central community the 65c816 assembly language in plain English. Nowadays, it's read by various people in the ROM hacking scene in general. Therefore, I decided to open source this tutorial on GitHub, so that people can make improvements or translations.

Although I'm a member of SMW Central, this tutorial is not associated with Super Mario World, thus this tutorial is not tailored towards that game. Instead, this tutorial can be applied in all SNES context.

## The language

65c816 assembly is the language used by the Super Nintendo Entertainment System's (SNES) Ricoh 5A22 chip. Breaking down the different parts of the acronym 65c816: 816 means that the processor can be either 8-bit mode or 16-bit mode. The c stands for CMOS, 65 means that this processor is from the 65xx CPU family. The processor is supposed to be pretty revolutionary for its time. This tutorial explains mnemonics/instructions (i.e. opcodes) and how to use them properly. This tutorial does not focus on SNES-specific topics, such as hardware registers.

With 65c816 ASM you can code things for SNES games (such as custom features for Super Mario World). ASM is a 2nd generation programming language, which is low-level compared to C# for example. It is readable machine code, which eventually gets translated into hexadecimal machine code. All the opcodes consist of 3 letters, along with various parameters.

## Special thanks

Many special thanks go to the following people for reviewing the original tutorial on SMW Central: [**spigmike**](https://www.smwcentral.net/?p=profile\&id=132)**,** [**Roy**](https://www.smwcentral.net/?p=profile\&id=845)**,** [**smkdan**](https://www.smwcentral.net/?p=profile\&id=411)**,** [**S.N.N**](https://www.smwcentral.net/?p=profile\&id=23)**,** [**andy\_k\_250**](https://www.smwcentral.net/?p=profile\&id=67)**,** [**Domiok**](https://www.smwcentral.net/?p=profile\&id=7211)**,** [**reghrhre**](https://www.smwcentral.net/?p=profile\&id=4176)**,** [**ChaoticFox**](https://www.smwcentral.net/?p=profile\&id=3462)**,** [**Tails\_155**](https://www.smwcentral.net/?p=profile\&id=6151)**,** [**GreenHammerBro**](https://www.smwcentral.net/?p=profile\&id=18802)**,** [**Vitor Vilela**](https://www.smwcentral.net/?p=profile\&id=8251)

Many special thanks also go to the [contributors](https://github.com/Ersanio/snes-assembly-book/graphs/contributors) of this repository!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ersanio.gitbook.io/assembly-for-the-snes/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.