Update README

1 files changed, 53 insertions, 14 deletions

diff --git a/README.md b/README.md
index 975201c..0988e6e 100644
--- a/README.md
+++ b/README.md
@@ -9,22 +9,20 @@ screen or console devices, including the beautiful DVD bouncing.
 ## Building from source
 
 To build this software you need the [devkitPro][devkitpro] SDK. Once installed,
-You may need to modify the Makefile to set up the path:
+you may need to modify the Makefile to ensure the path is correct, but should
+work with the default devikit installation methods on Linux and macOS.
 
 ```
-DEVKITPRO  := /opt/devkitpro
-DEVKITARM  := /opt/devkitpro/devkitARM
-PATH       := $(DEVKITARM)/bin:$(PATH)
-LIBGBA_DIR := $(DEVKITPRO)/libgba
-LIBGBA_SRC := /opt/devkitpro/libgba/include/
-LIBGBA     := $(LIBGBA_DIR)/lib/libgba.a
-LIBGBA     += $(LIBGBA_DIR)/lib/libfat.a
-LIBGBA     += $(LIBGBA_DIR)/lib/libmm.a
+DEVKITPRO   := /opt/devkitpro
+DEVKITBIN   := $(DEVKITPRO)/devkitARM/bin
+DEVKITTOOLS := $(DEVKITPRO)/tools/bin
+LIBGBA_DIR  := $(DEVKITPRO)/libgba
+LIBGBA_SRC  := $(DEVKITPRO)/libgba/include/
+LIBGBA      := $(LIBGBA_DIR)/lib/libgba.a
+LIBGBA      += $(LIBGBA_DIR)/lib/libfat.a
+LIBGBA      += $(LIBGBA_DIR)/lib/libmm.a
 ```
 
-An intermediate build step will create a `src/uxn/roms/boot.c` file, for which
-you need the `bin2carr` utility that can be found [here][bin2carr].
-
 If everything is properly installed, you should be able to run `make` to compile
 the program into a `uxngba.gba` rom. If you have `mgba-qt` installed, you can
 test it with: `make run`.
@@ -33,8 +31,49 @@ To use a specific UXN compiled rom, you can pass it as the `ROM_SRC` make
 parameter:
 
 ```
-make run ROM_SRC=src/uxn/roms/piano.rom
+make run ROM_SRC=roms/noodle.rom
 ```
 
+If you have compiled a rom already and want to change it, you probably want to
+use `make clean` beforehand.
+
 [devkitpro]: https://devkitpro.org/
-[bin2carr]: https://git.badd10de.dev/gba-dev-tools/
+
+## Configuration
+
+The output .gba files will embed the rom used for installation. Different roms
+have different needs, such as the usage of different input methods or the
+desired audio quality. These options can be selected by defining the right
+macros on compile time as described below.
+
+### Input method order
+
+Uxngba currently supports three different control schemes that can be cycled by
+pressing the SELECT button: `CONTROL_CONTROLLER`, `CONTROL_MOUSE` and
+`CONTROL_KEYBOARD`. To select the order and available methods set the
+`CONTROL_METHODS` macro on compile time. For example, [noodle][noodle] doesn't
+make much use of the controller scheme, and we may want to use the mouse as the
+default input method. This can be achieved with the following command:
+
+```
+make run ROM_SRC=roms/noodle.rom CONFIG="-DCONTROL_METHODS=CONTROL_MOUSE,CONTROL_KEYBOARD"
+```
+
+### Audio quality
+
+Audio processing can be computationally expensive and the GBA has limited
+resources. uxngba supports 4 audio channel devices simultaneously, and depending
+on the demands of the rest of the program, the audio quality can be increased or
+decreased. By default, sounds will play on a 18157 Hz buffer, which offers
+a good quality-performance compromise. A high quality and low-fi audio modes can
+be selected by setting the `AUDIO_HIFI` or `AUDIO_LOFI` macros:
+
+```
+make run ROM_SRC=roms/audio.rom CONFIG="-DAUDIO_HIFI"
+
+  or
+
+make run ROM_SRC=roms/audio.rom CONFIG="-DAUDIO_LOFI"
+```
+
+[noodle]: https://wiki.xxiivv.com/site/noodle.html