Skip to content

Instantly share code, notes, and snippets.

@frederickk

frederickk/ems-flasher-help.md

Last active December 20, 2024 18:28
Show Gist options
  • Save frederickk/98d7c1dd55fcddf119e9f56c5aa129c2 to your computer and use it in GitHub Desktop.
Save frederickk/98d7c1dd55fcddf119e9f56c5aa129c2 to your computer and use it in GitHub Desktop.
Download ZIP
EMS Flasher's documentation is pretty sparse. This gist is a collection of commands that I use fairly regularly, it is not comprehensive. Caveat, these commands work for me and I cannot guarantee they will work for you. Godspeed and good luck.
Raw
ems-flasher-help.md

EMS Flasher

Dependencies

Install MacPorts, ensure you install the proper version for your Mac. Afterwards, install the following packages required by EMS Flasher.

$ sudo port install pkgconfig
$ sudo port install libusb

Build and Install

$ cd ./ems-flasher
$ ./config.sh
$ make
$ sudo make install

Manging ROMs

Format cart, this will erase all ROMS (but not necessarily the .SAVs 🤔)

$ ./ems-flasher --format --verbose

Delete ROM

Using https://github.com/Drenn1/ems-flasher

$ cd ./ems-flasher-drenn1
$ ./ems-flasher --list
> 0: MENU#
> 1: LSDj-v6.3.9
> 2: LSDj-v6.8.2
$ ./ems-flasher --delete 1 # deletes LSDJ-v6.3.9

Check if ROMs were deleted

$ ./ems-flasher --title --verbose

Output should be something like:

$ trying to find EMS cart
$ claimed EMS cart
$ base address is 0x0
$ Bank  Title             Size     Enhancements

Copy ROM to EMS cart

$ ./ems-flasher --write ./path/to/lsdj_v6.3.9.gb --verbose

Don't worry about the 3% transfer of the menu ROM progress.

Check if ROM was transferred successfully

$ ./ems-flasher --title --verbose

Output should be something like:

$ trying to find EMS cart
$ claimed EMS cart
$ base address is 0x0
$ Bank  Title             Size     Enhancements
$   0   MENU#               32 KB  Color
$  64   LSDj-v6.3.9       1024 KB  Color

SRAM Management

Transfer SRAM to computer

Using https://github.com/rbino/ems-qart

Install EMS Qart, I've opted for using Brew and Cask There appears to no longer be a Brew Cask version, so instead install from DMG

Open the app and make sure the top left has "Read from cart" selected EMS-Qart Screenshot

Click the diskette icon and choose a save location. Click the "Start" button et voilĂ , your SRAM is now backed up. To confirm success I've use the VBM emulator as it allows for importing of batter saves (e.g. SRAM).

Write SRAM to cart

Using https://github.com/rbino/ems-qart

Install EMS Qart, I've opted for using Brew and Cask

$ brew cask install ems-qart

Open the app and make sure the top left has "Write to cart" selected EMS-Qart Screenshot

Click the diskette icon and choose the .sav file to write. Click the "Start" button et voilĂ , your SRAM is now written to your cart. I confirmed sucess using a DMG-01 with LSDJ.

Transfer SRAM to computer with EMS Flasher

Note cannot confirm this works

First list the contents of the cart

$ ./ems-flasher --title --verbose

Output should be something like:

$ trying to find EMS cart
$ claimed EMS cart
$ base address is 0x0
$ Bank  Title             Size     Enhancements
$   0   MENU#               32 KB  Color
$  64   LSDJ              1024 KB  Color
$ 128   LSDj-v6.8.2       1024 KB  Color

Then to dump the SRAM

# [bank]:[filename] e.g 128:lsdj6_8_2.sav
$ /ems-flasher --read 128:lsdj6_8_2.sav

Documentation

lacklustre.net/projects/ems-flasher/

lacklustre.net/projects/ems-flasher/documentation.html

chainsaw.musho.org /stuff/ems-on-mac

kobalabreport.blogspot.com/2014/10/mac-os-x-marverics-gb-usb-smart-card-64m.html

github.com/mikeryan/ems-flasherhttps://github.com/mikeryan/ems-flasher

github.com/rbino/ems-qart

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment