kernel at kernelcrash dot com More details on this at www.kernelcrash.com
A bit like an Electron Plus 1 specifically set up for hooking an SD card onto it and using the MMFS ROM https://github.com/hoglet67/MMFS, but should be able to emulate any 16KB Electron ROM
Uses a cheap STM32F407 board directly into the expansion connector of the Electron. Most F407 pins are 5V tolerant. Some of these boards have a micro SD card slot, or you can wire a micro SD socket in.
Emulates 8 ROM slots (slots 4, 5, 6, 7 and 12, 13, 14 and 15) but they all act as sideways RAM slots
Can load rom files directly from flash on the stm32f407. This requires you to 'compile the roms in'. See Troubleshooting further down for how to do this.
Loads 16KB rom files from an SD card on boot. You need a directory on your FAT32 sdcard like so:
boot/4
boot/5
boot/6
boot/7
boot/12/ESWMMFS.rom
boot/13
boot/14
boot/15
ie. Put one rom file in the boot/12 directory, and it will be loaded into rom slot 12 on boot. Put one rom in boot/13 and it will be loaded into slot 13 etc.
If one of the rom slots contains the Electron Plus 1 version of MMFS, then MMFS will 'see' the SD card attached to the STM32F407 board and look for a BEEB.MMB file on it. It's recommended to use the sideways ram version of MMFS (ESWMMFS.rom) as it sets PAGE = E00, which is more compatible with a lot of games compared to the standard EMMFS.rom . Note, MMFS has a very minimal FAT interface layer, so you should always format the SD card (the first partition), copy your BEEB.MMB onto it (doing this as the first filecopy to a freshly formatted SD card is pretty important), then make all the boot directories (eg. boot/12, boot/13 etc) and then copy the appropriate roms into those directories.
You can also dynamically insert roms off the SD card while the Electron is running. So after you've set up the roms you want on boot under 'boot', create a 'roms' directory in the root of the SD card. Then create numbered directories underneath it and put a single 16K rom in each directory. For example;
roms/1/Hopper.rom
roms/2/Viewsheet.rom
So boot the Electron now with the SD card inserted. Let's says you want to insert Hopper into rom slot 15. 15 is 'F' in hex, so type this at the Electron prompt
?&FC0F = 1
That tells it to take the rom in 'roms/1' and insert it into slot 15 (ie. 'F'). If I wanted to put Viewsheet in I would go '?&FC0F = 2' . If I wanted Hopper in slot 4 (ie. '4' ) instead then I would go :
?&FC04 = 1
After you insert a ROM like this, you can ctrl-break to reboot the Electron, and hopefully you should be able to interact with the ROM.
This interface is effectively a proof of concept for simple communication between the interupt and a main outer loop that runs on the stm32f4 board.
Currently there are eight memory addresses that correspond to the 8 rom slots;
&FC04 - rom slot 4
&FC05 - rom slot 5
&FC06 - rom slot 6
&FC07 - rom slot 7
&FC0C - rom slot 12
&FC0D - rom slot 13
&FC0E - rom slot 14
&FC0F - rom slot 15
There are analog ports that operate like the Plus 1 joystick ports. They possibly operate a little differently:
PA2 - Analog channel 1
PA3 - Analog channel 2
PA4 - Analog channel 3
PA5 - Analog channel 4
PC2 - Fire button (bit 4 when you read &FC72)
PC3 - Fire buton 2 (bit 5 when you read &FC72)
The analog ports are looking for a voltage between 0 and 3.3V. If you connect the centre pin of the joystick potentiometers to PA2 and PA3, and the other pins of the potentiometers to GND and 3.3V (ie they just act as a simple voltage divider) then it should work. There are some settings in main.h that allow you to 'jump to the extremes' of the analog range in case your joystick cannot go all the way to 0 or all the way to 255. For example, If you want any value less than 64 to return 0, and any value greater than 192 to return 255, then do this in main.h;
#define ADC_LOW_THRESHOLD 64
#define ADC_HIGH_THRESHOLD 192
Wiring from the 50 pin edge connector on the Electron to the STM42F407VET6 board is as follows
BOTTOM TOP (towards the AC INPUT)
2 1
4 3
6 5
GND 8 7 GND
+5V 10 9 +5V
12 11
(PC0) Phi0 14 13
16 15
(PC1) _R/W 18 17
(PD14) D6 20 19 D7 (PD15)
(PD12) D4 22 21 D5 (PD13)
(PD10) D2 24 23 D3 (PD11)
(PD8) D0 26 25 D1 (PD9)
28 27
30 29
(PE14) A14 32 31 A15 (PE15)
(PE12) A12 34 33 A13 (PE13)
(PE10) A10 36 35 A11 (PE11)
(PE0) A0 38 37 A9 (PE9)
(PE2) A2 40 39 A1 (PE1)
(PE4) A4 42 41 A3 (PE3)
(PE6) A6 44 43 A5 (PE5)
(PE8) A8 46 45 A7 (PE7)
GND 48 47 GND
+5V 50 49 +5V
Some STM32F407 boards have an SD card slot and already wired in the 'standard way' for SDIO . Otherwise wire up the SD card as follows;
/CS - PC11
MOSI - PD2
SCK - PC12
MISO - PC8
Obviously connect the GND's up and remember that the SD card runs at 3.3V and should not have a level converter between the stm32f407 and the card.
An older version of this program sat in a tight timing loop watching the phi0 output of the Electron. Phi0 is effectively the clock for the Electron. It is 'mostly 2MHz' but will slow down when accessing peripherals or RAM.
So that version watched for phi0 going high, read the address lines of the 6502, worked out if it was a sideways rom access, presented a byte from the STM32's flash rom, left it long enough on the databus for the 6502 to read it, then quickly tri-stated the databus again ... and waited for next rising edge of phi0.
This newer interrupt version connects phi0 to an interrupt on the STM32. Rather than interrupt on the rising edge of phi0 when the address bus would be known to be stable, the interrupt occurs on the negative edge of phi0 which is effectively the end of the previous cycle.
The reason for doing this is that it takes time to respond to an interrupt, so the latency between an 'edge' that causes an interrupt and the first executing line of an interrupt service routine (ISR) is at least 100ns, but more like 150ns ... but can be higher. If the first executing line of the ISR occurred 150ns after the positive edge, then it would be too late to do anything useful (the 100ns or so left is not a lot of instructions).
So we interrupt on the negative edge and the ISR routine goes like this;
But if its a request for us, then we do whats appropriate. The most common thing is for a ROM access in the 8000-BFFF range. We keep a sideways ROM register, such that if this register has been set to say '12' and then there was an access between 8000-BFFF, then we know we need to present a byte from a ROM.
Grabbing the byte from RAM or ROM in the STM32 is the easy part. But we need to un-tristate the databus lines, put the associated byte on the databus lines, then wait for phi0 to end. To do that as accurately as possible we use the wfe instruction to 'wait for an event'. The event we wait for is the next negative edge of phi0. Once we get that edge, we immediately tri-state the databus lines and loop back to polling for phi0 going high. Some key points here;
Still this is a miniscule amount of time to service an interrupt. Key stuff:
vmov r3,s3 // r3 = EXTI
vstr s1,[r3,PR] // clear interrupt by writing 1 to it.
You need the ST standard peripheral library. I used the STSW-STM32068 firmware package for the stmf4 Discovery from st.com. In the Makefile ST_COMMON needs to point to it.
You need an ARM GCC build chain in your path.
Generally you put your roms on the SD card, but there is way to load some from internal flash (see troubleshooting notes further down).
Do a
make
Look at transfer.sh for how you might transfer it to your board.
If you have trouble with the roms loading from SD card , check a few things
Preferably the SD card is a smaller and/or older one. In 2019, I tend to buy cheap 8GB cards as they are about the smallest you can get. Buy the slowest you can find.
Partition the SD card so there is one partition and its less than 4GB (I tend to make a 1GB partition, but even that is overkill)
Format the partition with FAT32 . I am just using linux, and am not doing
anything special (eg. sudo mkfs.vfat /dev/sd
Find a decent BEEB.MMB for the Electron on the stardot forums.
Copy the BEEB.MMB as the very first file you copy to your formatted SD card. MMFS has a minimal FAT layer, so I think I read that BEEB.MMB has to be one of the first 8 files written to the SD card (I could be wrong).
After you've copied the BEEB.MMB in, make the boot roms directories (eg. boot/12 , boot/13 etc) and copy some roms in. To keep it simple I would just copy ESWMMFS.rom into boot/12 and leave the other slots empty. One thing to note is that a different FAT interface runs on the stm32f407 board and it does not have the same limitations as MMFS (all you need to know is MMFS wants to find BEEB.MMB. Any other files on the SD card are used directly by the stm32f407 board.
Try booting. If the SD card is too slow then you may not see any rom related banners when you boot the Electron. Try doing a ctrl-break on the Electron to get the Electron to boot without power cycling the stm32f407 board.
Normally when an SD card is initialised in SPI mode, it starts off with a slow clock and after an initialisation phase it switches to a faster clock. You can lock it in a slower clock if you think that is the problem. Look in sdmm.c for the disk_initialize method, and towards the end of it is this.
BitDelay=0;
Comment it out , and recompile.
The current code has two ways of loading ROMS as the system boots;
Both methods are attempted on boot in the order shown above. So let's say you defined two ROMs in roms-preloaded-from-flash.S, and they were defined to load as slot 12 and 13. But it you also put a ROM in boot/12 on the SD card, then slot 12 would be overridden with what you had on the SD card. Similarly slot 13 would be overridden in you had a ROM in boot/13 on the SD card and so on.
To use preloading from flash, place the roms paths as incbin lines after the relevant slot labels in roms-preloaded-from-flash.S
slot_4_base:
.incbin "roms/ESWMMFS.rom"
slot_5_base:
.incbin "roms/AP6v130ta.rom"
slot_6_base:
//.incbin "roms/blank.rom"
slot_7_base:
//.incbin "roms/blank.rom"
Obviously 'make' and flash the hex file to the stm32f407 board to use these. (you might need to do a 'make clean' then 'make')
For reference the AP6v130ta.rom referred to above is the 16K AP6 rom from http://mdfs.net/Software/BBC/SROM/Plus1/ . That will give you a *ROMS command as well as various sideways ram load/save commands. I often put this as rom 13.
//FLASH->ACR = FLASH_ACR_PRFTEN | FLASH_ACR_ICEN |FLASH_ACR_DCEN |FLASH_ACR_LATENCY_5WS;
FLASH->ACR = FLASH_ACR_ICEN |FLASH_ACR_DCEN |FLASH_ACR_LATENCY_5WS;
The line with FLASH_ACR_PRFTEN turns on the flash prefetch feature which is generally a good thing but might cause problems on some chips. You can try commenting one line and not the other to turn it on and off.