FlashGBX 4.3__py3-none-any.whl → 4.4__py3-none-any.whl

FlashGBX/Mapper.py

@@ -1647,7 +1647,7 @@ class AGB_GPIO:
 			temp = self.CartRead(self.GPIO_REG_DAT) & 0xFF
 			bit = (temp & 2) >> 1
 			data = (data >> 1) | (bit << 7)
-			# print("RTCReadData(): i={:d}/temp={:X}/bit={:x}/data={:x}".format(i, temp, bit, data))
+			# dprint("RTCReadData(): i={:d}/temp={:X}/bit={:x}/data={:x}".format(i, temp, bit, data))
 		return data
 	
 	def RTCWriteData(self, data):
@@ -1703,7 +1703,8 @@ class AGB_GPIO:
 			status = self.RTCReadStatus()
 		else:
 			status = buffer[0]
-		
+
+		dprint("Status:", bin(status))
 		if (status >> 7) == 1:
 			dprint("No RTC because of set RTC Status Register Power Flag:", status >> 7 & 1)
 			return 1
@@ -1723,7 +1724,7 @@ class AGB_GPIO:
 		else:
 			rom2 = buffer[1:7]
 
-		dprint(' '.join(format(x, '02X') for x in rom1), "/", ' '.join(format(x, '02X') for x in rom2))
+		dprint("RTC Data:", ' '.join(format(x, '02X') for x in rom1), "/", ' '.join(format(x, '02X') for x in rom2))
 		if (rom1 == rom2):
 			dprint("No RTC because ROM data didn’t change:", rom1, rom2)
 			return 3
@@ -1908,7 +1909,6 @@ class AGB_GPIO:
 		}
 
 		if rtc_y == 0 and rtc_m == 0 and rtc_d == 0 and rtc_h == 0 and rtc_i == 0 and rtc_s == 0:
-			#raise ValueError("Invalid RTC data")
 			d["string"] = "Invalid RTC data"
 			d["rtc_valid"] = False
 		else:

FlashGBX/PocketCameraWindow.py

@@ -7,6 +7,7 @@ from PIL.ImageQt import ImageQt
 from PIL import Image, ImageDraw
 from .pyside import QtCore, QtWidgets, QtGui, QDesktopWidget
 from .PocketCamera import PocketCamera
+from .UserInputDialog import UserInputDialog
 
 class PocketCameraWindow(QtWidgets.QDialog):
 	CUR_PIC = None
@@ -20,6 +21,7 @@ class PocketCameraWindow(QtWidgets.QDialog):
 	APP_PATH = "."
 	CONFIG_PATH = "."
 	APP = None
+	FORCE_EXIT = False
 	PALETTES = [
 		[ 255, 255, 255,   176, 176, 176,   104, 104, 104,   0, 0, 0 ], # Grayscale
 		[ 208, 217, 60,   120, 164, 106,   84, 88, 84,   36, 70, 36 ], # Game Boy
@@ -33,6 +35,8 @@ class PocketCameraWindow(QtWidgets.QDialog):
 		QtWidgets.QDialog.__init__(self)
 		self.setAcceptDrops(True)
 		if icon is not None: self.setWindowIcon(QtGui.QIcon(icon))
+
+		self.FORCE_EXIT = False
 		self.CUR_FILE = file
 		self.CONFIG_PATH = config_path
 		self.APP_PATH = app_path
@@ -188,7 +192,9 @@ class PocketCameraWindow(QtWidgets.QDialog):
 			self.CUR_PALETTE = len(self.PALETTES) - 1
 		
 		if self.CUR_FILE is not None:
-			self.OpenFile(self.CUR_FILE)
+			if self.OpenFile(self.CUR_FILE) is False:
+				self.FORCE_EXIT = True
+				return
 
 		self.CUR_EXPORT_PATH = self.APP.SETTINGS.value("LastDirPocketCamera")
 		if self.CUR_EXPORT_PATH is None:
@@ -201,6 +207,9 @@ class PocketCameraWindow(QtWidgets.QDialog):
 		self.btnSaveAll.setFocus()
 	
 	def run(self):
+		if self.FORCE_EXIT:
+			self.reject()
+			return
 		self.layout.update()
 		self.layout.activate()
 		screenGeometry = QDesktopWidget().screenGeometry(self)
@@ -217,6 +226,26 @@ class PocketCameraWindow(QtWidgets.QDialog):
 		self.UpdateViewer(self.CUR_INDEX)
 	
 	def OpenFile(self, file):
+		if isinstance(file, bytearray) and len(file) == 0x100000 or isinstance(file, str) and os.path.getsize(file) == 0x100000:
+			dlg_args = {
+				"title":"Photo!",
+				"intro":"A Photo! save file was detected.\n\nPlease select the roll of pictures that you would like to load.",
+				"params": [
+					[ "index", "cmb", "Roll:", [ "Current Save Data" ] + [ "Flash Directory Slot {:d}".format(l) for l in range(1, 8) ], 0 ],
+				]
+			}
+			dlg = UserInputDialog(self, icon=self.windowIcon(), args=dlg_args)
+			if dlg.exec_() == 1:
+				result = dlg.GetResult()
+				index = result["index"].currentIndex()
+				if isinstance(file, str):
+					with open(file, "rb") as f:
+						file = bytearray(f.read())
+				file = file[0x20000 * index:][:0x20000]
+			else:
+				self.CUR_PC = None
+				return False
+
 		try:
 			self.CUR_PC = PocketCamera()
 			if self.CUR_PC.LoadFile(file) == False:
@@ -285,6 +314,7 @@ class PocketCameraWindow(QtWidgets.QDialog):
 		self.SavePicture(self.CUR_INDEX)
 	
 	def btnClose_Clicked(self, event):
+		self.FORCE_EXIT = True
 		self.reject()
 	
 	def hideEvent(self, event):

FlashGBX/RomFileAGB.py

@@ -121,6 +121,7 @@ class RomFileAGB:
 	def GetHeader(self, unchanged=False):
 		buffer = bytearray(self.ROMFILE)
 		data = {}
+		if len(buffer) < 0x180: return {}
 		hash = hashlib.sha1(buffer[0:0x180]).digest()
 		nocart_hashes = []
 		nocart_hashes.append(bytearray([ 0x4F, 0xE9, 0x3E, 0xEE, 0xBC, 0x55, 0x93, 0xFE, 0x2E, 0x23, 0x1A, 0x39, 0x86, 0xCE, 0x86, 0xC9, 0x5C, 0x11, 0x00, 0xDD ])) # Method 0
@@ -187,7 +188,9 @@ class RomFileAGB:
 		(data["game_title"] == "CARDE READER" and data["game_code"] == "PSAE" and data["header_checksum"] == 0x95):
 			data["ereader"] = True
 
-		data["unchanged"] = copy.copy(data)
+		if unchanged:
+			data["unchanged"] = copy.copy(data)
+		
 		self.DATA = data
 		data["db"] = self.GetDatabaseEntry()
 

FlashGBX/RomFileDMG.py

@@ -140,8 +140,9 @@ class RomFileDMG:
 		data["rom_checksum_calc"] = self.CalcChecksumGlobal()
 		data["rom_checksum_correct"] = data["rom_checksum"] == data["rom_checksum_calc"]
 		
-		data["unchanged"] = copy.copy(data)
-		if not unchanged:
+		if unchanged:
+			data["unchanged"] = copy.copy(data)
+		else:
 			# MBC2
 			if data["mapper_raw"] == 0x06:
 				data["ram_size_raw"] = 0x100
@@ -437,6 +438,10 @@ class RomFileDMG:
 				data["ram_size_raw"] = 0x03
 				data["mapper_raw"] = 0x206
 
+			# Photo!
+			if data["game_title"] == "PHOTO":
+				data["ram_size_raw"] = 0x204
+
 		if data["mapper_raw"] in Util.DMG_Header_Mapper:
 			data["mapper"] = Util.DMG_Header_Mapper[data["mapper_raw"]]
 		elif data["logo_correct"]:

FlashGBX/Util.py

@@ -8,9 +8,9 @@ from enum import Enum
 
 # Common constants
 APPNAME = "FlashGBX"
-VERSION_PEP440 = "4.3"
+VERSION_PEP440 = "4.4"
 VERSION = "v{:s}".format(VERSION_PEP440)
-VERSION_TIMESTAMP = 1731015769
+VERSION_TIMESTAMP = 1748007939
 DEBUG = False
 DEBUG_LOG = []
 APP_PATH = ""
@@ -28,9 +28,9 @@ DMG_Mapper_Types = { "None":[ 0x00, 0x08, 0x09 ], "MBC1":[ 0x01, 0x02, 0x03 ], "
 DMG_Header_ROM_Sizes = [ "32 KiB", "64 KiB", "128 KiB", "256 KiB", "512 KiB", "1 MiB", "2 MiB", "4 MiB", "8 MiB", "16 MiB", "32 MiB", "64 MiB", "128 MiB" ]
 DMG_Header_ROM_Sizes_Map = [ 0x00, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0A, 0x0B, 0x0C ]
 DMG_Header_ROM_Sizes_Flasher_Map = [ 0x8000, 0x10000, 0x20000, 0x40000, 0x80000, 0x100000, 0x200000, 0x400000, 0x800000, 0x1000000, 0x2000000, 0x4000000, 0x8000000 ]
-DMG_Header_RAM_Sizes = [ "None", "4K SRAM (512 Bytes)", "16K SRAM (2 KiB)", "64K SRAM (8 KiB)", "256K SRAM (32 KiB)", "512K SRAM (64 KiB)", "1M SRAM (128 KiB)", "MBC6 SRAM+FLASH (1.03 MiB)", "MBC7 2K EEPROM (256 Bytes)", "MBC7 4K EEPROM (512 Bytes)", "TAMA5 EEPROM (32 Bytes)", "Unlicensed 4M SRAM (512 KiB)", "Unlicensed 1M EEPROM (128 KiB)" ]
-DMG_Header_RAM_Sizes_Map = [ 0x00, 0x100, 0x01, 0x02, 0x03, 0x05, 0x04, 0x104, 0x101, 0x102, 0x103, 0x201, 0x203, 0x204 ]
-DMG_Header_RAM_Sizes_Flasher_Map = [ 0, 0x200, 0x800, 0x2000, 0x8000, 0x10000, 0x20000, 0x108000, 0x100, 0x200, 0x20, 0x80000, 0x20000, 0x80000 ] # RAM size in bytes
+DMG_Header_RAM_Sizes = [ "None", "4K SRAM (512 Bytes)", "16K SRAM (2 KiB)", "64K SRAM (8 KiB)", "256K SRAM (32 KiB)", "512K SRAM (64 KiB)", "1M SRAM (128 KiB)", "MBC6 SRAM+FLASH (1.03 MiB)", "MBC7 2K EEPROM (256 Bytes)", "MBC7 4K EEPROM (512 Bytes)", "TAMA5 EEPROM (32 Bytes)", "Unlicensed 4M SRAM (512 KiB)", "Unlicensed 1M EEPROM (128 KiB)", "Unlicensed Photo! Directory (1 MiB)", "Unlicensed Batteryless SRAM" ]
+DMG_Header_RAM_Sizes_Map = [ 0x00, 0x100, 0x01, 0x02, 0x03, 0x05, 0x04, 0x104, 0x101, 0x102, 0x103, 0x201, 0x203, 0x204, 0x205 ]
+DMG_Header_RAM_Sizes_Flasher_Map = [ 0, 0x200, 0x800, 0x2000, 0x8000, 0x10000, 0x20000, 0x108000, 0x100, 0x200, 0x20, 0x80000, 0x20000, 0x100000, 0x80000 ] # RAM size in bytes
 DMG_Header_SGB = { 0x00:'No support', 0x03:'Supported' }
 DMG_Header_CGB = { 0x00:'No support', 0x80:'Supported', 0xC0:'Required' }
 
@@ -410,8 +410,14 @@ def EncodeBCD(value):
 def ParseCFI(buffer):
 	buffer = copy.copy(buffer)
 	info = {}
-	magic = "{:s}{:s}{:s}".format(chr(buffer[0x20]), chr(buffer[0x22]), chr(buffer[0x24]))
-	if magic != "QRY": # nothing swapped
+	magic_8bit = "{:s}{:s}{:s}".format(chr(buffer[0x10]), chr(buffer[0x11]), chr(buffer[0x12]))
+	magic_16bit = "{:s}{:s}{:s}".format(chr(buffer[0x20]), chr(buffer[0x22]), chr(buffer[0x24]))
+	buffer_conv = bytearray()
+	if magic_8bit == "QRY":
+		buffer_conv = bytearray(b for x in buffer for b in (x, x))
+		buffer = buffer_conv
+
+	if magic_8bit != "QRY" and magic_16bit != "QRY": # nothing swapped
 		return False
 	
 	try:
@@ -522,7 +528,10 @@ def ConvertMapperTypeToMapper(mapper_type):
 	return 0
 
 def GetDumpReport(di, device):
-	header = di["header"]["unchanged"]
+	header = di["header"]
+	if "unchanged" in di["header"]:
+		header = di["header"]["unchanged"]
+	
 	if "db" in di["header"]: header["db"] = di["header"]["db"]
 	if di["system"] == "DMG":
 		mode = "DMG"
@@ -925,6 +934,19 @@ def find_size(data, max_size, min_size=0x20):
 			break
 	return offset
 
+def bitmap2pixmap(data, scale_factor=4):
+	try:
+		from .pyside import QtGui
+		from PIL.ImageQt import ImageQt
+		from PIL import Image
+		data_converted = data.convert("RGBA")
+		pixmap = QtGui.QPixmap.fromImage(ImageQt(data_converted.resize((data_converted.width * scale_factor, data_converted.height * scale_factor), Image.NEAREST)))
+		pixmap.setDevicePixelRatio(scale_factor)
+		return pixmap
+	except:
+		print("Couldn’t convert bitmap to pixmap.")
+		return False
+
 def dprint(*args, **kwargs):
 	stack = traceback.extract_stack()
 	stack = stack[len(stack)-2]

FlashGBX/fw_JoeyJr.py

@@ -3,6 +3,7 @@
 # Author: Lesserkuma (github.com/lesserkuma)
 
 import zipfile, time, os, struct, serial, platform
+from serial import SerialException
 try:
 	from . import Util
 except ImportError:
@@ -120,8 +121,14 @@ class FirmwareUpdater():
 			fncSetStatus(text="Connecting...")
 			try:
 				dev = serial.Serial(port, 2000000, timeout=0.2)
+			except SerialException as e:
+				if "Errno 13" in str(e) and platform.system() == "Linux":
+					fncSetStatus(text="No permission to use device! See README file.", enableUI=True)
+				else:
+					fncSetStatus(text="Device not accessible.", enableUI=True)
+				return 2
 			except:
-				fncSetStatus(text="Device not accessible.", enableUI=True)
+				fncSetStatus(text="Unknown error while accessing the device.", enableUI=True)
 				return 2
 			dev.reset_input_buffer()
 

FlashGBX/hw_GBFlash.py

@@ -9,7 +9,7 @@ class GbxDevice(LK_Device):
 	DEVICE_NAME = "GBFlash"
 	DEVICE_MIN_FW = 1
 	DEVICE_MAX_FW = 12
-	DEVICE_LATEST_FW_TS = { 5:1730731680, 10:1730731680, 11:1730731680, 12:1730731680, 13:1730731680 }
+	DEVICE_LATEST_FW_TS = { 5:1747991884, 10:1747991884, 11:1747991884, 12:1747991884, 13:1747991884 }
 	PCB_VERSIONS = { 5:'', 12:'v1.2', 13:'v1.3' }
 	
 	def __init__(self):
@@ -197,7 +197,7 @@ class GbxDevice(LK_Device):
 		if self.FW["pcb_ver"] == 5 or self.FW["fw_ts"] < 1730592000: # unofficial firmware
 			self.FW_UPDATE_REQ = True
 			return True
-		if self.FW["fw_ts"] < self.DEVICE_LATEST_FW_TS[self.FW["pcb_ver"]]:
+		if self.FW["fw_ts"] != self.DEVICE_LATEST_FW_TS[self.FW["pcb_ver"]]:
 			return True
 		self.FW_UPDATE_REQ = False
 		return False

FlashGBX/hw_GBxCartRW.py

@@ -9,13 +9,13 @@ class GbxDevice(LK_Device):
 	DEVICE_NAME = "GBxCart RW"
 	DEVICE_MIN_FW = 1
 	DEVICE_MAX_FW = 1
-	DEVICE_LATEST_FW_TS = { 4:1709317610, 5:1722774120, 6:1722774120, 2:0, 90:0, 100:0 }
+	DEVICE_LATEST_FW_TS = { 4:1709317610, 5:1747991884, 6:1747991884, 2:0, 90:0, 100:0 }
 	PCB_VERSIONS = { 5:'v1.4', 6:'v1.4a/b/c', 2:'v1.1/v1.2', 4:'v1.3', 90:'XMAS v1.0', 100:'Mini v1.0' }
 	BAUDRATE = 1000000
 	MAX_BUFFER_READ = 0x1000
 	MAX_BUFFER_WRITE = 0x400
 
-	def Initialize(self, flashcarts=None, port=None, max_baud=2000000):
+	def Initialize(self, flashcarts=None, port=None, max_baud=1500000):
 		if self.IsConnected(): self.DEVICE.close()
 		if platform.system() == "Darwin": max_baud = 1000000
 		
@@ -31,7 +31,7 @@ class GbxDevice(LK_Device):
 			if len(ports) == 0: return False
 		
 		for i in range(0, len(ports)):
-			for baudrate in (1000000, 1700000, 2000000):
+			for baudrate in (1000000, 1500000):
 				if max_baud < baudrate: continue
 				try:
 					if self.TryConnect(ports[i], baudrate):
@@ -49,8 +49,8 @@ class GbxDevice(LK_Device):
 					continue
 			
 			if self.FW is None or self.FW == {}: continue
-			if max_baud >= 1700000 and self.FW is not None and "pcb_ver" in self.FW and self.FW["pcb_ver"] in (5, 6, 101) and self.BAUDRATE < 1700000:
-				self.ChangeBaudRate(baudrate=1700000)
+			if max_baud >= 1500000 and self.FW is not None and "pcb_ver" in self.FW and self.FW["pcb_ver"] in (5, 6, 101) and self.BAUDRATE < 1500000:
+				self.ChangeBaudRate(baudrate=1500000)
 				self.DEVICE.close()
 				dev = serial.Serial(ports[i], self.BAUDRATE, timeout=0.1)
 				self.DEVICE = dev
@@ -74,8 +74,8 @@ class GbxDevice(LK_Device):
 				self.MAX_BUFFER_WRITE = 0x100
 			
 			conn_msg.append([0, "For help with your GBxCart RW device, please visit the insideGadgets Discord: https://gbxcart.com/discord"])
-			if self.FW["pcb_ver"] == 4:
-				conn_msg.append([0, "Note: Your GBxCart RW hardware revision does not fully support the latest features due to technical limitations. Please consider upgrading to a newer device."])
+			#if self.FW["pcb_ver"] == 4:
+			#	conn_msg.append([0, "Note: Your GBxCart RW hardware revision does not fully support the latest features due to technical limitations. Please consider upgrading to a newer device."])
 
 			self.PORT = ports[i]
 			self.DEVICE.timeout = self.DEVICE_TIMEOUT
@@ -173,8 +173,8 @@ class GbxDevice(LK_Device):
 	def ChangeBaudRate(self, baudrate):
 		if not self.IsConnected(): return
 		dprint("Changing baud rate to", baudrate)
-		if baudrate == 1700000:
-			self._write(self.DEVICE_CMD["OFW_USART_1_7M_SPEED"])
+		if baudrate == 1500000:
+			self._write(self.DEVICE_CMD["OFW_USART_1_5M_SPEED"])
 		elif baudrate == 1000000:
 			self._write(self.DEVICE_CMD["OFW_USART_1_0M_SPEED"])
 		self.BAUDRATE = baudrate
@@ -253,10 +253,10 @@ class GbxDevice(LK_Device):
 			return ["DMG"]
 		else:
 			return ["DMG", "AGB"]
-		
+
 	def IsSupported3dMemory(self):
 		return True
-	
+
 	def IsClkConnected(self):
 		return self.FW["pcb_ver"] in (5, 6, 101)
 
@@ -270,7 +270,7 @@ class GbxDevice(LK_Device):
 			dprint("LinkNLoad detected:", is_lnl)
 			if is_lnl: return False
 		return self.FW["pcb_ver"] in (2, 4, 5, 6, 90, 100, 101)
-	
+
 	def FirmwareUpdateAvailable(self):
 		if self.FW["fw_ver"] == 0 and self.FW["pcb_ver"] in (2, 4, 90, 100, 101):
 			if self.FW["pcb_ver"] == 4:
@@ -279,12 +279,12 @@ class GbxDevice(LK_Device):
 				self.FW_UPDATE_REQ = 2
 			return True
 		if self.FW["pcb_ver"] not in (4, 5, 6): return False
-		if self.FW["pcb_ver"] in (5, 6) and self.FW["fw_ts"] < self.DEVICE_LATEST_FW_TS[self.FW["pcb_ver"]]:
+		if self.FW["pcb_ver"] in (5, 6) and self.FW["fw_ts"] != self.DEVICE_LATEST_FW_TS[self.FW["pcb_ver"]]:
 			return True
-		if self.FW["pcb_ver"] == 4 and self.FW["fw_ts"] < self.DEVICE_LATEST_FW_TS[self.FW["pcb_ver"]]:
+		if self.FW["pcb_ver"] == 4 and self.FW["fw_ts"] != self.DEVICE_LATEST_FW_TS[self.FW["pcb_ver"]]:
 			self.FW_UPDATE_REQ = True
 			return True
-	
+
 	def GetFirmwareUpdaterClass(self):
 		if self is None or self.FW["pcb_ver"] in (5, 6): # v1.4 / v1.4a/b/c
 			try:

FlashGBX/hw_JoeyJr.py

@@ -9,7 +9,7 @@ class GbxDevice(LK_Device):
 	DEVICE_NAME = "Joey Jr"
 	DEVICE_MIN_FW = 1
 	DEVICE_MAX_FW = 12
-	DEVICE_LATEST_FW_TS = 1722774120
+	DEVICE_LATEST_FW_TS = 1747991884
 	PCB_VERSIONS = { -1:"", 0x01:"V2", 0x81:"V2", 0x02:"V2C", 0x82:"V2C", 0x03:"V2CC", 0x83:"V2CC/V2++" }
 	
 	def __init__(self):
@@ -256,7 +256,7 @@ class GbxDevice(LK_Device):
 		if self.FW["cfw_id"] == "G":
 			self.FW_UPDATE_REQ = True
 			return True
-		if self.FW["fw_ts"] < self.DEVICE_LATEST_FW_TS:
+		if self.FW["fw_ts"] != self.DEVICE_LATEST_FW_TS:
 			return True
 		self.FW_UPDATE_REQ = False
 		return False

{FlashGBX-4.3.dist-info → FlashGBX-4.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: FlashGBX
-Version: 4.3
+Version: 4.4
 Summary: Reads and writes Game Boy and Game Boy Advance cartridge data
 Home-page: https://github.com/lesserkuma/FlashGBX
 Author: Lesserkuma
@@ -17,15 +17,25 @@ Classifier: Intended Audience :: Developers
 Requires-Python: >=3.7
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: pyserial >=3.5
+Requires-Dist: pyserial>=3.5
 Requires-Dist: Pillow
 Requires-Dist: setuptools
 Requires-Dist: requests
 Requires-Dist: python-dateutil
 Provides-Extra: qt5
-Requires-Dist: PySide2 >=5.14 ; extra == 'qt5'
+Requires-Dist: PySide2>=5.14; extra == "qt5"
 Provides-Extra: qt6
-Requires-Dist: PySide6 ; extra == 'qt6'
+Requires-Dist: PySide6; extra == "qt6"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 # FlashGBX (by Lesserkuma)
 
@@ -51,47 +61,6 @@ for Windows, Linux, macOS (→ [Download](https://github.com/lesserkuma/FlashGBX
 - [GBFlash](https://github.com/simonkwng/GBFlash) (tested with v1.2 and v1.3)
 - [Joey Jr](https://bennvenn.myshopify.com/collections/game-cart-to-pc-interface/products/usb-gb-c-cart-dumper-the-joey-jr) (tested with V2++)
 
-## Installing and running
-
-### Pre-compiled binaries and packages
-
-Available in the GitHub [Releases](https://github.com/lesserkuma/FlashGBX/releases) section are pre-compiled downloads available for:
-
-* **Windows (64-bit)**
-  * Setup: An installer that will add the application to the start menu and optionally create a desktop icon
-  * Portable: Have everything in one place including the config files
-  
-  *(For users of Windows 7, legacy “Qt5” versions are provided as well.)*
-
-* **Linux**
-  * Ubuntu (.deb file): Install using `dpkg -i /path/to/FlashGBX_x.x_Ubuntu-all.deb`.<br>*(Based on a contribution by [JJ-Fox](https://github.com/JJ-Fox))*
-  * Other distributions: Pre-made packages are contributed by JJ-Fox [here](https://github.com/JJ-Fox/FlashGBX-Linux-builds/releases/latest).
-
-* **macOS**
-  * x86-64/arm64 (.dmg file): Install by opening the .dmg file and copying over the “FlashGBX” application to the desktop.<br>If it doesn’t run, it probably got quarantined during download. Run the following command in a Terminal window to unquarantine it: `xattr -d com.apple.quarantine /path/to/FlashGBX.app`.<br>*(Based on a contribution by [Cliffback](https://github.com/Cliffback))*
-
-  *(If you have a Joey Jr and use macOS, please run the [Joey Jr Firmware Updater](https://github.com/lesserkuma/JoeyJr_FWUpdater) before using FlashGBX.)*
-
-### Run via Python
-
-FlashGBX can also be run in a Python environment like so:
-
-1. Download and install [Python](https://www.python.org/downloads/) (version 3.10.11 is recommended)
-2. Open a Terminal or Command Prompt window
-3. Install FlashGBX with this command:<br>`pip3 install "FlashGBX[qt6]"`
-* If installation fails, try this command instead:<br>`pip3 install "FlashGBX[qt5]"`
-* If installation still fails, you can install the minimal version (command line interface) with this command:<br>`pip3 install FlashGBX`
-* Update to the latest version by replacing `install` with `install -U`.
-
-#### Running
-Use this command in a Terminal or Command Prompt window to launch the installed FlashGBX application:
-
-`python3 -m FlashGBX`
-
-*FlashGBX should work on pretty much any operating system that supports Qt-GUI applications built using [Python](https://www.python.org/downloads/) with [PySide2](https://pypi.org/project/PySide2/) or [PySide6](https://pypi.org/project/PySide6/), [pyserial](https://pypi.org/project/pyserial/), [Pillow](https://pypi.org/project/Pillow/), [setuptools](https://pypi.org/project/setuptools/), [requests](https://pypi.org/project/requests/) and [python-dateutil](https://pypi.org/project/python-dateutil/) packages. To run FlashGBX in portable mode without installing, you can also download the source code archive and call `python3 run.py` after installing the prerequisites yourself.*
-
-*Note: On Linux systems, the `brltty` module may render serial communication devices non-accessible. See the troubleshooting section for details.*
-
 ## Cartridge Compatibility
 ### Supported cartridge memory mappers
 - Game Boy
@@ -131,7 +100,8 @@ Use this command in a Terminal or Command Prompt window to launch the installed
 
   - 29LV Series Flash BOY with 29LV160DB
   - Action Replay
-  - BennVenn MBC3000 RTC cart
+  - BennVenn MBC3000 v4 RTC cart
+  - BennVenn MBC3000 v5 RTC cart
   - BLAZE Xploder GB¹
   - BUNG Doctor GB Card 4M
   - BUNG Doctor GB Card 16M
@@ -151,10 +121,12 @@ Use this command in a Terminal or Command Prompt window to launch the installed
   - DIY cart with MX29LV640
   - DIY cart with SST39SF040
   - DMG-MBC5-32M-FLASH (G/A) Development Cartridge, E201264
+  - DMG-MBC5-32M-FLASH (G/A-I) Development Cartridge, E201264
   - Ferrante Crafts cart 32 KB
   - Ferrante Crafts cart 64 KB
   - Ferrante Crafts cart 512 KB
   - FunnyPlaying MidnightTrace 4 MiB Flash Cart
+  - Gamebank-web DMG-29W-04 with M29W320EB
   - Gamebank-web DMG-29W-04 with M29W320ET
   - GameShark Pro
   - GB-CART32K-A with SST39SF020A
@@ -174,6 +146,7 @@ Use this command in a Terminal or Command Prompt window to launch the installed
   - insideGadgets 4 MiB, 32 KiB FRAM, MBC3+RTC
   - insideGadgets 4 MiB (2× 2 MiB), 32 KiB FRAM, MBC5
   - insideGadgets MegaDuck 32K
+  - ModRetro Chromatic Cartridge with 39VF1681
   - Mr Flash 64M
   - Sillyhatday MBC5-DUAL-FLASH-4/8MB
   - Squareboi 4 MiB (2× 2 MiB)
@@ -220,8 +193,8 @@ Use this command in a Terminal or Command Prompt window to launch the installed
   - DRV with 29LV320DB and ALTERA CPLD
   - DRV with AM29LV160DB and ALTERA CPLD
   - DRV with AM29LV160DT and ALTERA CPLD
-  - DVP DRV with MX29LV320CB
-  - DVP DRV with MX29LV320CT
+  - DVP DRV with MX29LV320CB¹
+  - DVP DRV with MX29LV320CT¹
   - ES29LV160_DRV with 29DL32TF-70
   - GB-M968 with 29LV160DB
   - GB-M968 with M29W160EB
@@ -349,6 +322,68 @@ Many different reproduction cartridges share their flash chip command set, so ev
 
 *¹ = Cannot always be auto-detected, select cartridge type manually*
 
+## Installing and running
+
+### Pre-compiled binaries and packages
+
+Available in the GitHub [Releases](https://github.com/lesserkuma/FlashGBX/releases) section are pre-compiled downloads available for:
+
+* **Windows (64-bit)** *(Windows 8 or newer)*
+  * Setup: An installer that will add the application to the start menu and optionally create a desktop icon
+  * Portable: Have everything in one place including the config files
+
+* **Linux**
+  * Pre-made packages are contributed by JJ-Fox [here](https://github.com/JJ-Fox/FlashGBX-Linux-builds/releases/latest).
+
+* **macOS** *(Monterey 12 or newer)*
+  * x86-64/arm64 (.dmg file): Install by opening the .dmg file and copying over the “FlashGBX” application to the desktop.<br>If it doesn’t run, it probably got quarantined during download. Run the following command in a Terminal window to unquarantine it: `xattr -d com.apple.quarantine /path/to/FlashGBX.app`.<br>*(Based on a contribution by [Cliffback](https://github.com/Cliffback))*
+
+  *(If you have a Joey Jr and use macOS, please run the [Joey Jr Firmware Updater](https://github.com/lesserkuma/JoeyJr_FWUpdater) before using FlashGBX.)*
+
+### Run via Python
+
+FlashGBX can also be run in a Python environment like so:
+
+1. Download and install [Python](https://www.python.org/downloads/) (version 3.10.11 is recommended)
+2. Open a Terminal or Command Prompt window
+3. Install FlashGBX with this command:<br>`pip3 install "FlashGBX[qt6]"`
+* If installation fails, try this command instead:<br>`pip3 install "FlashGBX[qt5]"`
+* If installation still fails, you can install the minimal version (command line interface) with this command:<br>`pip3 install FlashGBX`
+* Update to the latest version by replacing `install` with `install -U`.
+
+#### Running
+Use this command in a Terminal or Command Prompt window to launch the installed FlashGBX application:
+
+`python3 -m FlashGBX`
+
+*FlashGBX should work on pretty much any operating system that supports Qt-GUI applications built using [Python](https://www.python.org/downloads/) with [PySide2](https://pypi.org/project/PySide2/) or [PySide6](https://pypi.org/project/PySide6/), [pyserial](https://pypi.org/project/pyserial/), [Pillow](https://pypi.org/project/Pillow/), [setuptools](https://pypi.org/project/setuptools/), [requests](https://pypi.org/project/requests/) and [python-dateutil](https://pypi.org/project/python-dateutil/) packages. To run FlashGBX in portable mode without installing, you can also download the source code archive and call `python3 run.py` after installing the prerequisites yourself.*
+
+*Note: When using GBxCart RW or GBFlash on some Linux systems, the `brltty` module may render serial communication devices non-accessible. See the troubleshooting section for details.*
+
+### Steam Deck
+#### Installation
+1. Boot your Steam Deck in Desktop Mode.
+2. Open System Settings → Users.
+3. Set a password for your user account (“deck”), if you do not have one set yet. (Make sure you do not forget this password in the future.)
+4. Create a new folder where you want to install FlashGBX.
+5. Right click the folder and select “Open Terminal Here”.
+6. Enter the following commands in order:<br>
+`python3 -m venv FlashGBX_venv`<br>
+`source FlashGBX_venv/bin/activate`<br>
+`wget https://bootstrap.pypa.io/get-pip.py`<br>
+`python3 get-pip.py`<br>
+`python3 -m pip install "FlashGBX[qt6]"`<br>
+`deactivate`<br>
+`sudo usermod -a -G uucp $USER`<br>
+(You may need to enter the password you set earlier.)
+7. Restart your Steam Deck.
+
+#### Running
+1. In Desktop Mode, right click your FlashGBX folder and select “Open Terminal Here”.
+2. Use these commands to launch the installed FlashGBX application:<br>
+`source FlashGBX_venv/bin/activate`<br>
+`python3 -m FlashGBX`<br>
+
 ### Troubleshooting
 
 * If something doesn’t work as expected, first try to clean the game cartridge contacts (best with IPA 99.9%+ on a cotton swab) and reconnect the device. An unstable cartridge connection is the most common reason for read or write errors.
@@ -369,7 +404,9 @@ Many different reproduction cartridges share their flash chip command set, so ev
 
 * If you’re using macOS version 10.13 or older, there may be no driver for serial communication devices installed on your system. You can either upgrade your macOS version to 10.14+ or manually install a driver which is available [here](https://github.com/adrianmihalko/ch340g-ch34g-ch34x-mac-os-x-driver).
 
-* If you’re using macOS and get a “Segmentation Fault: 11.” error, try the “Run using Python” method with Python version 3.10.11.
+* If you’re using macOS and get a “Segmentation Fault: 11.” error, try the “Run via Python” method with Python version 3.10.11 and install FlashGBX with `pip3 install "FlashGBX[qt5]"`.
+
+* If the save data detection says “512K FLASH (64 KiB) or 1M FLASH (128 KiB)”, that means the size can not be determined until actual save data is written to the cartridge.
 
 ## Miscellaneous
 
@@ -381,11 +418,13 @@ Many different reproduction cartridges share their flash chip command set, so ev
 
 The author would like to thank the following very kind people for their help, contributions or documentation (in alphabetical order):
 
-2358, 90sFlav, AcoVanConis, AdmirtheSableye, AlexiG, ALXCO-Hardware, AndehX, antPL, aronson, Ausar, bbsan, BennVenn, ccs21, chobby, ClassicOldSong, Cliffback, CodyWick13, Corborg, Cristóbal, crizzlycruz, Crystal, Därk, Davidish, DevDavisNunez, Diddy_Kong, djedditt, Dr-InSide, dyf2007, easthighNerd, EchelonPrime, edo999, Eldram, Ell, EmperorOfTigers, endrift, Erba Verde, ethanstrax, eveningmoose, Falknör, FerrantePescara, frarees, Frost Clock, gandalf1980, gboh, gekkio, Godan, Grender, HDR, Herax, Hiccup, hiks, howie0210, iamevn, Icesythe7, ide, inYourBackline, iyatemu, Jayro, Jenetrix, JFox, joyrider3774, jrharbort, JS7457, julgr, Kaede, kane159, KOOORAY, kscheel, kyokohunter, Leitplanke, litlemoran, LovelyA72, Lu, Luca DS, LucentW, manuelcm1, marv17, Merkin, metroid-maniac, Mr_V, Mufsta, olDirdey, orangeglo, paarongiroux, Paradoxical, Rairch, Raphaël BOICHOT, redalchemy, RetroGorek, RevZ, RibShark, s1cp, Satumox, Sgt.DoudouMiel, SH, Shinichi999, Sillyhatday, simonK, Sithdown, skite2001, Smelly-Ghost, Sonikks, Squiddy, Stitch, Super Maker, t5b6_de, Tauwasser, TheNFCookie, Timville, twitnic, velipso, Veund, voltagex, Voultar, Warez Waldo, wickawack, Winter1760, Wkr, x7l7j8cc, xactoes, xukkorz, yosoo, Zeii, Zelante, zipplet, Zoo, zvxr
+2358, 90sFlav, AcoVanConis, AdmirtheSableye, AlexiG, ALXCO-Hardware, AndehX, antPL, aronson, Ausar, bbsan, BennVenn, ccs21, chobby, ClassicOldSong, Cliffback, CodyWick13, Corborg, Cristóbal, crizzlycruz, Crystal, Därk, Davidish, delibird_deals, DevDavisNunez, Diddy_Kong, djedditt, Dr-InSide, dyf2007, easthighNerd, EchelonPrime, edo999, Eldram, Ell, EmperorOfTigers, endrift, Erba Verde, ethanstrax, eveningmoose, Falknör, FerrantePescara, frarees, Frost Clock, Gahr, gandalf1980, gboh, gekkio, Godan, Grender, HDR, Herax, Hiccup, hiks, howie0210, iamevn, Icesythe7, ide, infinest, inYourBackline, iyatemu, Jayro, Jenetrix, JFox, joyrider3774, jrharbort, JS7457, julgr, Kaede, kane159, KOOORAY, kscheel, kyokohunter, Leitplanke, litlemoran, LovelyA72, Lu, Luca DS, LucentW, luxkiller65, manuelcm1, marv17, Merkin, metroid-maniac, Mr_V, Mufsta, olDirdey, orangeglo, paarongiroux, Paradoxical, Rairch, Raphaël BOICHOT, redalchemy, RetroGorek, RevZ, RibShark, s1cp, Satumox, Sgt.DoudouMiel, SH, Shinichi999, Sillyhatday, simonK, Sithdown, skite2001, Smelly-Ghost, Sonikks, Squiddy, Stitch, Super Maker, t5b6_de, Tauwasser, TheNFCookie, Timville, twitnic, velipso, Veund, voltagex, Voultar, Warez Waldo, wickawack, Winter1760, Wkr, x7l7j8cc, xactoes, xukkorz, yosoo, Zeii, Zelante, zipplet, Zoo, zvxr
+
+Thanks to the No-Intro project for their game databases which FlashGBX’s databases are partly based on.
 
 ## Third Party Notices and Licenses
 
-Please view the <a href="https://raw.githubusercontent.com/lesserkuma/FlashGBX/master/Third Party Notices.md">Third Party Notices</a>.
+Please view the <a href="https://github.com/lesserkuma/FlashGBX/blob/master/Third%20Party%20Notices.md">Third Party Notices</a>.
 
 ## DISCLAIMER