forked from mikeryan/ems-flasher
-
Notifications
You must be signed in to change notification settings - Fork 0
/
ems-flasher.1
82 lines (82 loc) · 1.76 KB
/
ems-flasher.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
.Dd October 18, 2013
.Dt EMS-FLASHER 1
.Os
.Sh NAME
.Nm ems-flasher
.Nd utility to flash EMS 64 Mbit USB Game Boy cartridge
.Sh SYNOPSIS
.Nm
.Fl Fl read\ \&
.Op Fl Fl bank Ar num
.Op Fl Fl blocksize Ar size
.Op Fl Fl rom
.Op Fl Fl save
.Op Fl Fl verbose
.Ar romfile
.Nm
.Fl Fl write
.Op Fl Fl bank Ar num
.Op Fl Fl blocksize Ar size
.Op Fl Fl rom
.Op Fl Fl save
.Op Fl Fl verbose
.Ar romfile
.Nm
.Fl Fl title
.Sh DESCRIPTION
The
.Nm
utility reads data from or writes data to a EMS 64 Mbit USB Game Boy cartridge.
One of the following flags is required:
.Bl -tag -width x
.It Fl Fl read
read ROM/SRAM from cart
.It Fl Fl write
write ROM/SRAM to cart
.It Fl Fl header
print header of ROMs on cart to standard output
.El
.Pp
When in write or read mode,
.Nm
will automatically choose ROM versus SRAM based on the filename:
if the filename ends in
.Dq .sav ,
SRAM is assumed.
.Pp
In read or write mode, the available options are as follows:
.Bl -tag -width Ds
.It Fl Fl bank
Select cart bank (1 or 2).
.It Fl Fl blocksize Ar size
Specify the blocksize in bytes.
The default is 4096 for read, 32 for write.
.It Fl Fl rom
Force read/write of Flash ROM.
.It Fl Fl save
Force read/write of SRAM.
.It Fl Fl verbose
Display more information.
.El
.Sh EXIT STATUS
.Ex -std ems-flasher
.Sh EXAMPLES
Write the ROM to the cart:
.Dl $ ems-flasher --write totally_legit_rom.gb
.Pp
Save the contents of bank 2 into a file; print some extra info:
.Dl $ ems-flasher --verbose --bank 2 --read not_warez.gb
.Pp
Read the SRAM from bank 1:
.Dl $ ems-flasher --read my_pokeymans.sav
.Pp
Print out the headers:
.Dl $ ems-flasher --title
.Sh AUTHORS
.Nm
was written by
.An "Mike Ryan" Aq Mt [email protected]
and others.
.Sh HOMEPAGE
.Lk https://lacklustre.net/projects/ems-flasher/
.Lk https://github.com/mikeryan/ems-flasher/