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.

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

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

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

ems-qart-read.png

ems-qart-write.png