Skip to content

Commit b649ee2

Browse files
committed
add a troubleshooting section to the readme
1 parent cff654a commit b649ee2

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

README.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,16 @@ Before building the bootloader, you will need to do a couple of things.
3636
This will build the bootloader in the `build/bootloader.bin` file.
3737
If you installed QEMU and want to run the bootloader, you can do so by running `make run` in the root directory of the project.
3838

39+
### Troubleshooting
40+
41+
#### `qemu-system-i386: -accel kvm: invalid accelerator kvm`
42+
By default, the Makefile uses KVM as an accelerator for QEMU. Since KVM is exclusive to Linux, you might need to change it to something else. If you are on Windows or macOS, you can comment the `QEMUFLAGS` variable altogether, the default one should work fine. If it doesn't work fine (runs really slowly), feel free to experiment with different accelerators (you can find a list of them [here](https://www.qemu.org/docs/master/system/introduction.html#virtualisation-accelerators)).
43+
44+
#### It's too slow/fast and/or the frame rate is unstable!
45+
Sadly, it's really difficult to get the original speed of the video, since the CPU cannot keep a stable frame rate. If you want to get closer to the original speed, you can try to increase or decrease the `DELAY_TIME` value on line 63 in [`src/print.asm`](src/print.asm).
46+
47+
In the future, I might implement something bigger, like a custom interrupt handler, to get a stable frame rate. But for now, playing around with the `DELAY_TIME` value is the only thing you can try to make it run more faithfully.
48+
3949
## FAQ
4050

4151
### Why?

0 commit comments

Comments
 (0)