mosskoi/Boktai-UV-sensor
1
0
Fork 0
Code Wiki Activity
Page: WiFi Version
Pages
Home Serial Version WiFi Version
Clone
4
WiFi Version
mosskoi edited this page 2025-10-20 04:01:07 +01:00
Table of Contents

Introduction

  • This version of the project needs WiFi.
  • The microcontroller is placed somewhere with a good WiFi connection.
  • The user has a way to supply power to the microcontroller.
  • Sunlight must be within reach of the microcontroller.

Parts

This project is divided in 3 parts.

Patching your Boktai ROM: As mGBA has already an in-emualtor UV sensor, we'll need the patch to disable that and by-pass a "sensor broken" screen. Microcontroller code: To capture UV light and send information over to the server Lua Server: mGBA's script that runs a server and converts UV signal to in-game sun level

You'll need

  • 1 microcontroller of your choice.
  • Jumper wires..
  • 1 UV light sensor.
  • 1 USB cable between the computer and the microcontroller to flash the software.
  • Arduino IDE.
  • mGBA.
  • ROM dump of Boktai.

Don't know which microcontroller to get? I'd recommend an esp32.

The jumper wires will be male-to-male, male-to-female or female-to-female depending on your needs, make sure you get ones that will suit you.

Don't know which UV light sensor to get? I used a GUVA-S12SD, it works fine.

The total price for all these together shouldn't go over 5$.

Step 1: Patch the ROM

  1. Download boktai's patch here: https://github.com/Prof9/Boktai-Solar-Sensor-Patches
  2. Apply patch, you can do that here: https://www.romhacking.net/patch/

Step 2: Microcontroller

  1. Download the source code here
  2. Have the microcontroller, jumper wires and UV sensor at hand.
  3. Connect them with jumper wires, GND to GND, VCC to power supply, and SIG to your GPIO with analog read of choice.
  4. Connect it to your PC via a USB cable.
  5. Open Arduino IDE.
  6. Open the Source code.
  7. Under "Tools" make sure your Board and Serial port are correct, if you your board is not there you'll need to download them on "Board Manager".
  8. Check for your pinout and change the value of UV_SIGNAL_READ to that GPIO number.
  9. Edit SSID to your WiFi's name.
  10. Edit PASS to you WiFi's password.
  11. Edit HOST to your computer's local IP.
  12. Flash the code to the microcontroller.

Step 3: Lua server

  1. Download the source code here
  2. Open mGBA
  3. Start emulating the patched rom.
  4. Under "tools" go to "scripting...".
  5. File and load script.
  6. Select the lua script.

Step 4: Enjoy the game

Reboot the microcontroller in case it didn't connect, but reconnection should be handled. :)