{"id":2249,"date":"2023-12-25T01:14:49","date_gmt":"2023-12-25T00:14:49","guid":{"rendered":"https:\/\/dlabi.cz\/?p=2249"},"modified":"2023-12-30T12:48:04","modified_gmt":"2023-12-30T11:48:04","slug":"flexicard","status":"publish","type":"post","link":"https:\/\/dlabi.cz\/en\/flexicard\/","title":{"rendered":"Flexi Card"},"content":{"rendered":"
\"\"<\/figure>
\n

A multipurpose card that emulates ROM and RAM. The ROM content is loaded from the SD card, as well as single-part programs in machine code stored in the CAS format. Below I provide a complete guide on how to make own Flexi Card. <\/p>\n<\/div><\/div>\n\n\n\n\n\n\n\n

<\/p>\n\n\n\n

<\/p>\n\n\n\n

Introduction<\/h2>\n\n\n\n

Flexi card (hereinafter FC) would probably never have been created if I had not come across the pages of Kernelcrash1<\/a><\/sup>, who inspired me with his projects and from which FC is based. Some parts of his code are used in my project without changes. I thank KernelCrash for not keeping his knowledge to himself, and for allowing me to draw on his experience. Therefore, I am also making this project available to others.<\/p>\n\n\n\n

\n\n\n\n

Hardware<\/h2>\n\n\n
\n
\"\"<\/figure>\n<\/div>\n\n\n

FC uses a Chinese development board DevEBox.2<\/a><\/sup>\u00a0The advantages of this board are its small size, low price3<\/a><\/sup>, the presence of a slot for a micro SD card. It has a large number of IO ports and, most importantly, and this is also the reason for choosing this processor, that most of its GPIO ports are 5V tolerant, which is essential for cooperation with TTL logic. It is also very easy to flash and contains a debug port. The heart of this board is the STM32F407 processor from the Arm Cortex-M4 family2. Specifically, the VET6 variant, which has 512 KB of Flash memory3. It goes without saying that the use of a development board is not essential for the project, if you are able to design your own PCB with a minimal circuitry of the processor plus the necessary components for the operation of the SD card. I chose a development board, which is more convenient for prototyping and contains everything necessary.<\/p>\n\n\n\n

\n\n\n\n

Pin wiring<\/h2>\n\n\n\n

The choice of pins used seems messy, but it should be pointed out that each pin in the STM serves several functions that are activated\/deactivated in software. So it depends what peripherals you want to use. <\/p>\n\n\n\n

\n
\n
\n
Sord <\/strong><\/th>GPIO pin<\/strong><\/th><\/tr><\/thead>
IOWR<\/td>PB0 <\/td><\/tr>
IORD<\/td>PB1<\/td><\/tr>
RFSH<\/td>*PC1<\/td><\/tr>
WAIT<\/td>PC5<\/td><\/tr>
RST<\/td>PB10<\/td><\/tr>
MRD<\/td>PC3<\/td><\/tr>
MWR<\/td>PC2<\/td><\/tr>
ROMDS<\/td>PC13<\/td><\/tr>
ROM0<\/td>PC0<\/td><\/tr>
MRQ<\/td>PC4<\/td><\/tr>
CLK<\/td>*PC6<\/td><\/tr>
D0..D7<\/td>PD8-PD15<\/td><\/tr>
A0..A15<\/td>PE0-PE15<\/td><\/tr><\/tbody><\/table>
* marks pins not yet used in fw<\/figcaption><\/figure>\n\n\n\n
used by FLASH<\/strong><\/td><\/tr>
\/CS<\/td>PA15<\/td><\/tr>
MOSI <\/td>PB5<\/td><\/tr>
SCK<\/td>PB3<\/td><\/tr>
MISO<\/td>PB4<\/td><\/tr>
used by SWD<\/strong><\/td><\/tr>
SWDIO<\/td>PA13<\/td><\/tr>
SWCLK<\/td>PA14<\/td><\/tr>
SWO<\/td>PB3 <\/td><\/tr>
user LEDS<\/strong><\/td><\/tr>
LED1<\/td>PA1<\/td><\/tr>
used by SD<\/strong><\/td><\/tr>
DAT2<\/td>PC10<\/td><\/tr>
DAT3<\/td>PC11<\/td><\/tr>
CMD<\/td>PD2<\/td><\/tr>
CLK<\/td>PC12<\/td><\/tr>
DAT0<\/td>PC8<\/td><\/tr>
DAT1<\/td>PC9<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

debugging output (not used in normal mode except PA1 for LED) PA0-PA3<\/strong><\/p>\n<\/div>\n\n\n\n

\n
\"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n<\/div>\n<\/div>\n<\/div><\/div>\n\n\n\n
\n
\"\"<\/figure>\n<\/div>\n\n\n

Important:
The FC power supply can be implemented in several ways. For the final operation, the board is ready to use the Sord's power supply. However, if you need flash or connect the FC using the STLINK dongle, you must first disconnect JMP1, otherwise you may damage the FC or Sord!<\/em><\/strong><\/h3>\n<\/blockquote>\n\n\n\n

<\/p>\n\n\n\n

<\/p>\n\n\n\n

<\/p>\n\n\n\n

\n\n\n\n

Function<\/h2>\n\n\n\n

After reset or power on, the FC tests for the presence of the SD card. If the sordm5<\/strong>  directory is found in the root, which is a kind of indicator that the SD card contains compatible programs, the presence of the menu.rom<\/strong> file in the root of the card is tested. If it is found, it is loaded at address 2000H (i.e. as a ROM cartridge) and run. This then shows the user the contents of the SD card and allows the user to select programs. Alternatively, if a file called debug.cas<\/strong>  is found in the root, it is loaded into memory as well. I have often used this to debug z80 code.<\/p>\n\n\n\n

If any of this testing fails, FC goes into Basic – F + 32kB RAM<\/strong> and the SD card is not used.<\/p>\n\n\n\n

The program has a time-critical part written in arm assembler. This is the MREQ handler,
where we emulate RAM and ROM. The rest is written in C, which is easier to write, although I personally don't like it, so please excuse any nonsense in the code. That being said, without the SD card, the FC behaves like a 64KBF DIY card (I may redo it in the future to a slightly different mode), which in the modified Sord4<\/a><\/sup> allows you to reach up to 64kB of RAM by disabling the MONITOR ROM and the cartridge. In the unmodified Sord, of course, only 32kB. To prevent damage to the unmodified Sord, there is a ROM0 jumper on the FC which, when disconnected, prevents control of the ROM0 signal used to disable MONITOR ROM.<\/strong> The memory modes are controlled via port 30h as follows: <\/p>\n\n\n

\n
\"\"<\/figure>\n<\/div>\n\n\n

If a falling edge is detected on MREQ, an interrupt is generated, in which it is determined by reading the MWR and MRD signals whether it is a read or write to RAM or ROM memory. The time required to start the interrupt service routine is about 83nS and lasts ~583nS at the maximum processor frequency.
Furthermore, it is determined according to the set memory mode whether the memory area is under the control of FC and whether it is a RAM type area in case of writing. Otherwise, the interrupt is quickly terminated to leave the processor time to the main thread.<\/p>\n\n\n\n

This is formed by an infinite loop, in which the state of the variable main_thread_cmd is tested, which indicates whether Sord requires something from the FC card (or vice versa). This variable is set in the interrupt activated by the falling edge on IOWR, which is initiated by writing a command to port 81h. Then, depending on the command, data is sent or read on port 80h. Currently, FC recognizes these commands:<\/p>\n\n\n\n

0<\/td>BREAK <\/td>Breaks current command<\/td><\/tr>
1<\/td>GET_COUNT <\/td>Returns the file count<\/td><\/tr>
2<\/td>SET_INDEX<\/td>Sets pointer position on file number<\/td><\/tr>
3<\/td>GET_INDEX <\/td>Gets pointer position<\/td><\/tr>
4<\/td>NEXT_FILE<\/td>Increase pointer position by 1<\/td><\/tr>
5<\/td>PREV_FILE<\/td>Decrease pointer position by 1<\/td><\/tr>
6<\/td>FIRST_FILE<\/td>Resets pointer<\/td><\/tr>
7<\/td>GET_FILENAME<\/td>Reads filename at pointer position from buffer<\/td><\/tr>
8<\/td>LOAD_FILE<\/td>Loads file to memory<\/td><\/tr>
9<\/td>RESET_SORD<\/td>Not implemented yet<\/td><\/tr>
10<\/td>DIR_SORD<\/td>Dirs SD card to buffer<\/td><\/tr>
11<\/td>OFFSET_RAM_ON<\/td>Offsets FC ram region 7000-7FFF to 8000-8FFF<\/td><\/tr>
12<\/td>OFFSET_RAM_OFF<\/td>Disables FC ram offset<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Program menu.rom<\/strong> is written in z80 assembler. The program provides a list of programs located on the SD card in a pageable menu. After the user selects a program cmd8<\/strong><\/em>\u00a0 is used to load the selected program into the RAM area. However, if the program is located in the area 7000-7fff, it is \u201ccovered<\/em>\u201d by the Sord's internal RAM. For these purposes cmd11<\/em><\/strong>  is used, which can temporarily offset the \u201ccovered<\/em>\" area by +1000h, i.e. to the area 8000-8fff. Then it is up to menu.rom<\/strong>\u00a0 to copy the data from here to the Sord's internal memory and then cancel the offset with cmd12<\/em><\/strong> .This trick is mainly used for the MSX programs, where the MSX bios is located in the area 7000-7fff<\/p>\n\n\n\n

Another task of the main loop is to test the RST signal. If its activity is detected, the duration of the press is recorded. If it is shorter than about 3s, only Sord is reset (FC does not react). If it is longer, FC is also reset. Another way to reset FC independently of Sord is to use the RST button under the SD slot.<\/p>\n\n\n\n

For communication of FC with SD card, the open source library FatFs is used.5<\/a><\/sup><\/p>\n\n\n\n

\n\n\n\n

Compilation<\/h2>\n\n\n\n

You will need the arm cross compiler. A description of how to get one for your platform is beyond the scope of this article. I use WSL, so the following description will use the Linux environment.<\/p>\n\n\n\n

Most Linux distributions will install it:<\/p>\n\n\n\n

sudo apt install build-essential\nsudo apt install gcc-arm-none-eabi\nsudo apt install gdb-multiarch<\/code><\/pre>\n\n\n\n
Next, you will need the firmware package for the STM32F4DISCOVERY board from st.com.
It is called STSW-STM3206866<\/a><\/sup>, unzip it somewhere and set this directory in the Makefile in the STM_COMMON variable  <\/strong>.<\/p>\n\n\n\n
Then you will need the Basic-F rom, copy it to the roms directory, rename it to basic-f.rom. If you want to run MSX, you will also need msx.rom. Once you have everything together, follow these steps to start the compilation.<\/p>\n\n\n\n
cd src\nmake<\/code><\/pre>\n\n\n\n
To compile menu.rom<\/strong> you will need the z80 cross compiler. I use pasmo<\/strong>7<\/a><\/sup>which you can install using<\/p>\n\n\n\n
sudo apt install pasmo<\/code><\/pre>\n\n\n\n
And then you compile with the command<\/p>\n\n\n\n
make menu<\/code><\/pre>\n\n\n\n
\n\n\n\n
Firmware flashing<\/h2>\n\n\n\n
There are basically two ways to flash. Either via the built-in USB port in DFU<\/strong> mode, which you switch the card to by switching the BOOT0 pin from GND to 3V3. Then you connect to your computer and flash using the dfu-util<\/em><\/strong>8<\/a><\/sup> on Linux with the make flash-dfu<\/code> command, or using the DfuSe Demo<\/strong> for Windows. In this case you will need your compiled code in dfu format. To create the dfu format you can use this utility: hex2dfu<\/strong>9<\/a><\/sup>.<\/p>\n\n\n
\n
\"\"
Original programmer<\/figcaption><\/figure>\n<\/div>\n\n
\n
\"\"
Chinese clone<\/figcaption><\/figure>\n<\/div>\n\n\n
The second way requires the STLINK programmer. In this case you don't need to switch BOOT0 at all, the programmer will do everything by itself. I used the Linux program st-flash<\/em><\/strong>10<\/a><\/sup>which you will run by command make flash<\/code>.<\/p>\n\n\n\n
<\/p>\n\n\n\n
\n\n\n\n
SD card preparation<\/h2>\n\n\n\n
Format the card to FAT32 format. KernelCrash recommends cards with small capacity, or at least format them to a smaller size, because they are then less problematic. I have been using a 4GB card without any problems during testing.<\/p>\n\n\n\n
Place menu.rom<\/strong> and optionally debug.cas<\/strong> in the root of the card. Create a directory here called sordm5<\/strong> and copy the files you want to run into it. Remember, however, that the sorting is not alphabetical, but according to the order in which you wrote them to the card. To properly recognize the programs, you need to adjust the extensions of the programs as follows:<\/p>\n\n\n\n