Skip to content

Serial (Link Cable) support #232

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 5 commits into
base: master
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
interrupt-based working. wip
  • Loading branch information
Baekalfen committed May 21, 2025
commit c29ffe9b6f5bfa2f265b4aabdab5d2ed93628dce
9 changes: 6 additions & 3 deletions pyboy/__main__.py
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,10 @@ def valid_sample_rate(freq):

parser.add_argument("--serial-bind", action="store_true", help="Bind to this TCP addres for using Link Cable")
parser.add_argument(
"--serial-address", default=None, type=str, help="Connect (or bind) to this TCP addres for using Link Cable"
"--serial-address", default=None, type=str, help="Connect (or bind) to this TCP address for using Link Cable"
)
parser.add_argument(
"--serial-interrupt-based", action="store_true", help="Use only interrupt-based transfers for using Link Cable"
)

gameboy_type_parser = parser.add_mutually_exclusive_group()
Expand Down Expand Up @@ -165,8 +168,8 @@ def valid_sample_rate(freq):
def main():
argv = parser.parse_args()

if argv.serial_bind and not argv.serial_address:
parser.error("--serial-bind requires --serial-address")
if (argv.serial_bind or argv.serial_interrupt_based) and not argv.serial_address:
parser.error("--serial-bind and --serial-interrupt-based requires --serial-address")

print(
"""
Expand Down
1 change: 0 additions & 1 deletion pyboy/core/mb.pxd
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,6 @@ cdef class Motherboard:
cdef pyboy.core.serial.Serial serial
cdef pyboy.core.sound.Sound sound
cdef pyboy.core.cartridge.base_mbc.BaseMBC cartridge
cdef object serial
cdef bint bootrom_enabled
cdef char[1024] serialbuffer
cdef uint16_t serialbuffer_count
Expand Down
7 changes: 2 additions & 5 deletions pyboy/core/mb.py
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,6 @@
PyBoyException,
PyBoyOutOfBoundsException,
INTR_TIMER,
INTR_SERIAL,
INTR_HIGHTOLOW,
INTR_SERIAL,
OPCODE_BRK,
Expand All @@ -35,6 +34,7 @@ def __init__(
randomize=False,
serial_address=None,
serial_bind=None,
serial_interrupt_based=False,
):
if bootrom_file is not None:
logger.info("Boot-ROM file provided")
Expand All @@ -52,11 +52,10 @@ def __init__(
logger.debug("Cartridge type auto-detected to %s", ("CGB" if self.cartridge.cgb else "DMG"))

self.timer = timer.Timer()
self.serial = serial.Serial()
self.serial = serial.Serial(serial_address, serial_bind, serial_interrupt_based)
self.interaction = interaction.Interaction()
self.ram = ram.RAM(cgb, randomize=randomize)
self.cpu = cpu.CPU(self)
self.serial = serial.Serial(serial_address, serial_bind)

if cgb:
self.lcd = lcd.CGBLCD(
Expand Down Expand Up @@ -351,8 +350,6 @@ def tick(self):

if self.timer.tick(self.cpu.cycles):
self.cpu.set_interruptflag(INTR_TIMER)
if self.serial.tick(cycles):
self.cpu.set_interruptflag(INTR_SERIAL)

if lcd_interrupt := self.lcd.tick(self.cpu.cycles):
self.cpu.set_interruptflag(lcd_interrupt)
Expand Down
7 changes: 4 additions & 3 deletions pyboy/core/serial.pxd
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,12 @@
# GitHub: https://github.com/Baekalfen/PyBoy
#

cimport cython
from libc.stdint cimport int64_t, uint8_t, uint16_t, uint32_t, uint64_t

from pyboy.logging.logging cimport Logger
from pyboy.utils cimport IntIOInterface

import cython

from pyboy.logging.logging cimport Logger

cdef uint64_t MAX_CYCLES, CYCLES_8192HZ
cdef Logger logger
Expand All @@ -19,8 +18,10 @@ cdef class Serial:
cdef int64_t _cycles_to_interrupt
cdef uint64_t last_cycles, clock, clock_target
cdef bint transfer_enabled, double_speed, internal_clock
cdef bint serial_connected

cdef bint tick(self, uint64_t) noexcept nogil
cdef void stop(self) noexcept

cdef void set_SB(self, uint8_t) noexcept nogil
cdef void set_SC(self, uint8_t) noexcept nogil
Expand Down
102 changes: 10 additions & 92 deletions pyboy/core/serial.py
Original file line number Diff line number Diff line change
Expand Up @@ -3,17 +3,16 @@
# GitHub: https://github.com/Baekalfen/PyBoy
#

import socket
import logging
import pyboy
from pyboy.utils import MAX_CYCLES

logger = logging.getLogger(__name__)
logger = pyboy.logging.get_logger(__name__)

CYCLES_8192HZ = 128


class Serial:
def __init__(self, serial_address, serial_bind, serial_interrupt_based=True):
def __init__(self):
self.SB = 0xFF # Always 0xFF for a disconnected link cable
self.SC = 0
self.transfer_enabled = 0
Expand All @@ -23,37 +22,6 @@ def __init__(self, serial_address, serial_bind, serial_interrupt_based=True):
self.clock = 0
self.clock_target = MAX_CYCLES

self.connection = None

self.trans_bits = 0
self.serial_interrupt_based = serial_interrupt_based

if not serial_address:
logger.info("No serial address supplied. Link Cable emulated as disconnected.")
return

if not serial_address.count(".") == 3 and serial_address.count(":") == 1:
logger.info("Only IP-addresses of the format x.y.z.w:abcd is supported")
return

address_ip, address_port = serial_address.split(":")
address_tuple = (address_ip, int(address_port))

if serial_bind:
self.binding_connection = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
self.binding_connection.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
logger.info(f"Binding to {serial_address}")
self.binding_connection.bind(address_tuple)
self.binding_connection.listen(1)
self.connection, _ = self.binding_connection.accept()
logger.info(f"Client has connected!")
else:
self.connection = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
logger.info(f"Connecting to {serial_address}")
self.connection.connect(address_tuple)
logger.info(f"Connection successful!")
# self.connection.setblocking(False)

def set_SB(self, value):
# Always 0xFF when cable is disconnected. Connecting is not implemented yet.
self.SB = 0xFF
Expand Down Expand Up @@ -82,64 +50,16 @@ def tick(self, _cycles):
self.clock += cycles

interrupt = False
if self.transfer_enabled:
if self.connection is None:
# Disconnected emulation
if self.clock >= self.clock_target:
self.SC &= 0x80
self.transfer_enabled = 0
# self._cycles_to_interrupt = MAX_CYCLES
self.clock_target = MAX_CYCLES
interrupt = True
else:
# Connected emulation
if self.clock >= self.clock_target:
# if self.SC & 1: # Master
send_bit = bytes([(self.SB >> 7) & 1])
self.connection.send(send_bit)

data = self.connection.recv(1)
self.SB = ((self.SB << 1) & 0xFF) | data[0] & 1

logger.info(f"recv sb: {self.SB:08b}")
self.trans_bits += 1

if self.trans_bits == 8:
self.trans_bits = 0
self.SC &= 0b0111_1111
return True
return False
if self.transfer_enabled and self.clock >= self.clock_target:
# Disconnected emulation
self.SC &= 0x80
self.transfer_enabled = 0
self.clock_target = MAX_CYCLES
interrupt = True

self._cycles_to_interrupt = self.clock_target - self.clock
return interrupt

# if self.serial_interrupt_based:
# if self.SC & 1: # Master
# if self.SC & 0x80:
# logger.info(f'Master sending!')
# self.connection.send(bytes([self.SB]))
# # self.connection.setblocking(True)
# data = self.connection.recv(1)
# self.SB = data[0]
# self.SC &= 0b0111_1111
# return True
# else:
# try:
# if self.SC & 0x80:
# # self.connection.setblocking(False)
# logger.info(f'Slave recv!')
# self.connection.send(bytes([self.SB]))
# data = self.connection.recv(1)
# self.SB = data[0]
# self.SC &= 0b0111_1111
# return True
# except BlockingIOError:
# pass
# return False
# return False
# else:
# Check if serial is in progress

def save_state(self, f):
f.write(self.SB)
f.write(self.SC)
Expand All @@ -160,7 +80,5 @@ def load_state(self, f, state_version):
self.clock = f.read_64bit()
self.clock_target = f.read_64bit()


def stop(self):
if self.connection:
self.connection.close()
pass
8 changes: 6 additions & 2 deletions pyboy/pyboy.py
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,9 @@ def __init__(
color_palette=defaults["color_palette"],
cgb_color_palette=defaults["cgb_color_palette"],
title_status=False,
serial_address=None,
serial_bind=None,
serial_interrupt_based=False,
**kwargs,
):
"""
Expand Down Expand Up @@ -209,8 +212,9 @@ def __init__(
sound_sample_rate,
cgb,
randomize=randomize,
serial_address=kwargs["serial_address"],
serial_bind=kwargs["serial_bind"],
serial_address=serial_address,
serial_bind=serial_bind,
serial_interrupt_based=serial_interrupt_based,
)

# Validate all kwargs
Expand Down