Maximilian Rehkopf c8b24a9618 Firmware: fix loading of partial-size BS dumps 10 years ago
..
bootldr 4ff823078f Bootloader: fix flash buffer alignment 10 years ago
tests a734ae1ec5 pamper the compiler 10 years ago
utils 6cff0f66e0 Firmware: auto-detect version number base in firmware image generator 12 years ago
Makefile 83b18cc447 Firmware: fix compile errors with newer gccs 11 years ago
README 3f2e4e37db menu: rename menu.a65 to filesel.a65; add required library to README 10 years ago
bits.h 4bc455f12b SD acceleration, display file size in menu (fw side) 13 years ago
ccsbcs.c 40248e61af mk2 fw wip 13 years ago
cfg.c 0f3138124e add missing files cfg.[ch] and sysinfo.[ch] 12 years ago
cfg.h 0f3138124e add missing files cfg.[ch] and sysinfo.[ch] 12 years ago
cfgware.h 576cedd285 Update embedded FPGA config 12 years ago
cic.c 97aef4a2d3 Firmware: gather+display system information 12 years ago
cic.h 97aef4a2d3 Firmware: gather+display system information 12 years ago
cli.c fee97e5016 Firmware/CLI: list short file name and file size in ls command; print file name when saving SRAM 11 years ago
cli.h d4b7d9630b cic interface, cli for real this time... 13 years ago
clock.c 28949ac307 Firmware: preparations for USB 10 years ago
clock.h 28949ac307 Firmware: preparations for USB 10 years ago
conf2h.awk e121b34cf4 Initial Commit 15 years ago
config 443f7b138c Firmware: update version number to 0.1.5 11 years ago
config.h 28949ac307 Firmware: preparations for USB 10 years ago
crc.S 31d9e1a1d2 some sanity checks, early status messages 13 years ago
crc.h 40248e61af mk2 fw wip 13 years ago
crc16.c bfe9a91d07 firmware: adjustments for Mk.II Rev.C; enable timesetting from SNES menu 13 years ago
crc16.h bfe9a91d07 firmware: adjustments for Mk.II Rev.C; enable timesetting from SNES menu 13 years ago
crc32.c 46a42fe5ac mk2 fw: iap preparation, so96 mapper, reduce db size, delay with real sleep mode, cli 13 years ago
crc32.h 220b8c32a4 SaveRAM+directory CRC16 -> CRC32 13 years ago
diskio.h 2eeaaefcef Firmware/SD: implement FatFs CTRL_SYNC ioctl (issue #4) 12 years ago
faulthandler.c fa28f6035e mk2 fw wip 13 years ago
ff.c f4b8d57810 Firmware/FatFs: make f_gets break on NUL character as well 12 years ago
ff.h 3fda86125c firmware: speed up directory scanning 12 years ago
ffconf.h 39f1548dbd firmware: add feature to run previously loaded file 12 years ago
fileops.c 39f1548dbd firmware: add feature to run previously loaded file 12 years ago
fileops.h 39f1548dbd firmware: add feature to run previously loaded file 12 years ago
filetypes.c a734ae1ec5 pamper the compiler 10 years ago
filetypes.h 11bf7ffd5b firmware: case-insensitive system directory hiding 12 years ago
flash.cfg d9abb0811e begin ARM firmware 13 years ago
flash.script c97278c3d6 Firmware: adjust to reduced bootloader size 12 years ago
fpga.c f7d393451a Firmware: timeouts for FPGA configuration; LED flash codes for various FPGA related errors 10 years ago
fpga.h 3bf7788693 Firmware: remove now unused mcu_ovr statements 12 years ago
fpga_spi.c 7233278db2 Firmware: fix FPGA DMA call 11 years ago
fpga_spi.h c204aa9a0b Firmware/FPGA: replace magic numbers with constants 11 years ago
init.gdb 40248e61af mk2 fw wip 13 years ago
integer.h f063cb31f9 mk2 fw wip (cleanup indent+comment) 13 years ago
irq.c e99c5eb863 firmware: add missing irq.c 13 years ago
led.c f7d393451a Firmware: timeouts for FPGA configuration; LED flash codes for various FPGA related errors 10 years ago
led.h f7d393451a Firmware: timeouts for FPGA configuration; LED flash codes for various FPGA related errors 10 years ago
lpc1754.cfg c380ce9503 Adjust OpenOCD configuration for more recent versions 10 years ago
lpc1754.ld c97278c3d6 Firmware: adjust to reduced bootloader size 12 years ago
main.c f7d393451a Firmware: timeouts for FPGA configuration; LED flash codes for various FPGA related errors 10 years ago
memory.c c8b24a9618 Firmware: fix loading of partial-size BS dumps 10 years ago
memory.h 5939b6e581 Firmware: sort by entire filename, not just first 20 characters 11 years ago
msu1.c c204aa9a0b Firmware/FPGA: replace magic numbers with constants 11 years ago
msu1.h 1183718234 Firmware: ST0010 support + peripheral enable switches 13 years ago
openocd-usb.cfg 40a2ae00fb Firmware/build: Be more OpenOCD 0.4.0 friendly 12 years ago
power.c 28949ac307 Firmware: preparations for USB 10 years ago
power.h 72b9444861 firmware: initial power management 13 years ago
printf.c fa28f6035e mk2 fw wip 13 years ago
reset.cfg db45a5afaf mk2 fw wip 13 years ago
rle.c d7efa83e71 firmware: RLE 13 years ago
rle.h d7efa83e71 firmware: RLE 13 years ago
rtc.c bfe9a91d07 firmware: adjustments for Mk.II Rev.C; enable timesetting from SNES menu 13 years ago
rtc.h bfe9a91d07 firmware: adjustments for Mk.II Rev.C; enable timesetting from SNES menu 13 years ago
sdnative.c 2eeaaefcef Firmware/SD: implement FatFs CTRL_SYNC ioctl (issue #4) 12 years ago
sdnative.h 2eeaaefcef Firmware/SD: implement FatFs CTRL_SYNC ioctl (issue #4) 12 years ago
smc.c c8b24a9618 Firmware: fix loading of partial-size BS dumps 10 years ago
smc.h c8b24a9618 Firmware: fix loading of partial-size BS dumps 10 years ago
snes.c fee97e5016 Firmware/CLI: list short file name and file size in ls command; print file name when saving SRAM 11 years ago
snes.h 023901cab2 Firmware: refactor SNES reset pulse 12 years ago
snesboot.h 9eebd5cd73 Firmware: embed new SNES boot message code 12 years ago
sort.c 5939b6e581 Firmware: sort by entire filename, not just first 20 characters 11 years ago
sort.h fa28f6035e mk2 fw wip 13 years ago
spi.c d9e1680800 Firmware: remove SPI speed switching 12 years ago
spi.h d9e1680800 Firmware: remove SPI speed switching 12 years ago
startup.S d9abb0811e begin ARM firmware 13 years ago
sysinfo.c 0f3138124e add missing files cfg.[ch] and sysinfo.[ch] 12 years ago
sysinfo.h 0f3138124e add missing files cfg.[ch] and sysinfo.[ch] 12 years ago
tests.h 747e04e010 firmware: add tests.h 13 years ago
timer.c b67e2a5c77 Firmware: clean up clock/timer init 11 years ago
timer.h d88fbb6124 firmware/timer: move constants to header files 12 years ago
uart.c e2e628d6fb preliminary MSU-1 audio support 13 years ago
uart.h 561477ec53 SD native write support (still needs error handling), DB creation update (display file sizes) 13 years ago
xmodem.c 83b18cc447 Firmware: fix compile errors with newer gccs 11 years ago
xmodem.h f6df5e1158 Firmware: remove magic number for XModem block size 12 years ago

README

How to build:

a) Build requirements
* make
* Cortex M3 toolchain
* snescom/sneslink
* Xilinx FPGA synthesis tool (e.g. ISE WebPack)
* PIC assembler

b) Cortex M3 toolchain
* obtain the cm3-toolchain builder:
git clone http://snowcat.de/toolchain-cm3.git/
* build the cm3-toolchain. Some tools, libraries, and headers are required,
including but probably not limited to:
- libz-dev
- libcloog-ppl-dev
- texinfo
- libmpfr-dev
- libgmp3-dev
- libmpc-dev
- gawk
- bison
- recode
- flex
- libncurses5-dev
- libexpat-dev
- make
- gcc
Package names may differ for your distribution.
Newer gccs complain when compiling binutils, so you may have to add
'--disable-werror' to the compiler options for binutils in the Makefile.
The Makefile will install immediately so make sure you can write to the
installation directory.

c) snescom/sneslink
* http://bisqwit.iki.fi/source/snescom.html

d) ISE WebPack
* http://www.xilinx.com/products/design-tools/ise-design-suite/ise-webpack.htm

e) PIC assembler
* e.g. GPUTILS, http://gputils.sourceforge.net/

f) general order of operations
1) program the PIC (cic/supercic/supercic-key.asm)
2) build and program the bootloader.
3) build the firmware and copy it to the memory card
4) build the snes menu and copy it to the memory card
5) build and compress the FPGA configuration and copy it to the memory card
6) insert memory card, power on; the bootloader should begin flashing the
firmware and boot it

1) Programming the PIC
Use a PIC assembler + programmer of your choice and program a PIC12F629 with
cic/supercic/supercic-key.asm. Make sure that the clock source is set to
EC_OSC and MCLRE is disabled.
After programming you can solder the PIC to the board and short JP401.
Open JP401 in case you need to reprogram the PIC on board.

2) Building & programming the bootloader
The Makefile is prepared for JTAG programming using OpenOCD 0.4 and an FT2232
based USB-JTAG adapter.
Connect a JTAG cable to J401 (14-pin header). The pinout is printed on the
board. cd to src/bootldr and make && make program.

3) Building the firmware
cd to src/utils and make.
cd to src/ and make.
You should obtain a firmware file called obj/firmware.img. Copy this file to
/sd2snes/firmware.img.

4) Building the SNES menu
snescom is required.
cd to snes/ and make.
Copy the resulting file menu.bin to /sd2snes/menu.bin.

5) Building the FPGA configuration
Compile the RLE compressor in utils/rle.c:
$ gcc -Wall -o rle rle.c

Load verilog/sd2snes/sd2snes.xise in Xilinx ISE (or create your own project).
Target is a XC3S400-4PQ208.
Generate the programming file and compress it using utils/rle.c:
$ rle main.bit fpga_base.bit

Copy fpga_base.bit to /sd2snes/fpga_base.bit