FPDoom: Doom for feature phones

Currently only for feature phones based on the SC6530/SC6531 chipset.

• THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, USE AT YOUR OWN RISK!

Other ports

There are other ports that reuse code written for FPDoom:

fpbuild: Duke 3D, Shadow Warrior, Blood
infones: NES emulator
wolf3d: Wolfenstein 3D

Installation on SD card

Please read the instructions here.

Build

1. libc_server: use the host compiler, based on a spd_dump tool, so build it with the same options.
2. pack_reloc: use the host compiler, the tool to extract and compress relocations from an Elf binary.
3. Download the Doom sources, and copy the linuxdoom-1.10 directory as doom_src. Apply the patch: $ patch -d doom_src -p1 -i ../doom.patch.
4. fpdoom: use compiler from Android NDK, build instructions are the same as for custom_fdl from spd_dump.

• You can find prebuilt fpdoom.bin, and host binaries for Windows in Releases.

How to run FPDoom

1. Figure out how to run spd_dump on your feature phone.
2. Create a working directory workdir and place the Doom resource file here, for example doom1.wad from the shareware version of Doom 1.
3. Put these commands in a script, run it and then connect your phone:

$ ./spd_dump --wait 300 fdl nor_fdl1.bin 0x40004000 fdl fpdoom.bin ram
$ cd workdir && ../libc_server -- --bright 50 --rotate 3 doom

• --bright X is the phone screen brightness (X = 0..100).
• --rotate S[,K] is the screen/keypad rotation in 90 degress units (-1 or 3 = -90, 1 = +90, etc.) All feature phone LCDs I've seen are vertical, if you have a phone with a horizontal display - that means it's a vertical LCD placed horizontally, so you need to use different S and K values.
• You can add extra options for Doom, for example doom -timedemo demo1.

Possible problems

1. Message !!! unknown LCD, and before that LCD: id = 0x000000 - SPI mode is used to connect the LCD. I can't handle it yet.
2. Message !!! unknown LCD, but some number shown in LCD: id = 0x. I can add support for this LCD if you send me a firmware dump from your phone.
3. Message !!! keymap not found, means the firmware scan algorithm can't find the keymap, so you can't use the keypad, only watch replays. I can extract the keymap if you send me a firmware dump.
4. Message Error: W_InitFiles: no files found, means that no .wad files were found. On Linux files must be named in lower case.

List of tested models

#	Name	Chip	LCD	Boot Key
1	F+ F256	SC6531E	240x320 GC9306	*
2	Digma Linx B241	SC6531E	240x320 ST7789	center
3	F+ Ezzy 4	SC6531E	128x160 GC9106	1
4	Joy's S21	SC6531	128x160 GC9108	0
5	Vertex M115	SC6531	128x128 ST7735S	up
6	Vertex С323	SC6531	128x160 GC9106	0
7	Nobby 170B	SC6531E	128x160 GC9106	#
8	SW DZ09	SC6531	240x240 GC9307	none
9	Nokia TA-1174	SC6531E	128x160 ST7735	7
10	BQ 3586	SC6531E	320x480 R61529	#
11	Samsung B310E	SC6530C	128x160 ST7735	center
12	Fontel FP200	SC6531	128x160 GC9106	left soft
13	Vertex D514	SC6531E	240x320 ???	center
14	Fly TS114	SC6531E	240x320 GC9306	right soft
15	Energizer E12	SC6531E	128x160 GC9106	1
16	Itel it5626	SC6531	240x320 GC9307	left soft
17	Sunwind C2401	SC6531E	240x320 ST7789	*
18	DEXP SD2810	SC6531E	240x320 NV3029G	2
19	Nokia TA-1400	SC6531E	240x320 ???	right soft
20	YX Q5 Kids Camera	SC6531	128x160 NV3023	shutter
21	Nomi i184	SC6531	128x160 GC9102	*
22	Sigma IO67	SC6531	240x320 GC9305	dial
23	Samsung GT-E1272	SC6531E	128x160 ST7735P	2
24	Samsung GT-E1272	SC6530	128x160 ST7735	center
25	F+ F197	SC6531E	128x160 NV3023	1
26	Alcatel 2003D	SC6531E	240x320 ST7789	dial
27	Alcatel 2019G	SC6531E	320x240 GC9308	dial
28	Texet TM-122	SC6531	128x160 GC9106	0
29	Texet TM-130	SC6531	128x160 GC9106	0
30	Olmio E29	SC6531E	240x320 GC9300	left soft
31	Texet TM-B307	SC6531E	240x320 ST7789	2
32	Olmio E35	SC6531E	320x480 ILI9481	0
33	Texet TM-D324	SC6531E	320x480 NT35310	0
34	Texet TM-302	SC6531	240x320 ST7789	0
35	Strike A13	SC6531	128x160 GC9106	left soft
36	Olmio A25	SC6531E	240x320 ILI9328	dial
37	Tokky FP50	SC6531	128x160 GC9106	*
38	Texet TM-D328	SC6531E	240x320 GC9306	right
39	Texet TM-321	SC6531E	240x400 SPFD5420A	1
40	Texet TM-308	SC6531E	240x320 S6D04H0A	0
41	Texet TM-B316	SC6531E	128x160 ST7735P	9
42	Texet TM-B323	SC6531E	176x220 ILI9225G	9
43	Texet TM-B213	SC6531E	240x320 GC9300	left soft
44	Olmio A15	SC6531E	128x160 ST7735S	left soft
45	Texet TM-B208	SC6531E	128x160 GC9106	left soft
46	Olmio X04	SC6531	240x320 ILI9341	0
47	Tokky FP10	SC6531	128x64 ST7567A	up
48	Fontel FP100	SC6531	128x64 ST7567A	all d-pad
49	Joy's S16	SC6530C	96x68 HX1230	up
50	Joy's S19	SC6531	128x64 ST7565R	3
51	Vertex M114	SC6530C	96x68 HX1230	up
52	LONG-CZ J9	SC6531E	64x48 SSD1306	right soft
53	Digma Linx A106	SC6530C	96x68 HX1230	up
54	Prestigio Wize J1	SC6531E	128x160 GC9106	9

• Nobby 170B: use --spi 1 --mac 0xa8 without --rotate
• Smart Watch DZ09: use --spi 0 --lcd 0x80009307, no controls - you can only watch replays, no boot key - use boot cable
• Nokia TA-1174: use --spi 1 --spi_mode 1, also add end_data 0 command for spd_dump, before fdl commands
• BQ 3586: use --bl_gpio 19 for backlight to work properly
• Fly TS114: use --spi 1
• Nokia TA-1400: use --spi 1, also add end_data 0 command for spd_dump, before fdl commands
• YX Q5 Kids Camera: use --mac 0xa8 without --rotate
• Alcatel 2019G: use --spi 1, dial key is mapped to left soft key
• Texet TM-122, TM-130: use --lcd 0x80009106, to fix LCD refresh artifacts
• Texet TM-B307: use --gpio_init, to prevent the flashlight from turning on
• Texet TM-B316: use --lcd 0x8083760f --rotate 1,0
• Texet TM-B323, Texet TM-B208: use --rotate 3,0 --keyflags 1
• Texet TM-B323: very rare resolution, not the best support for it
• Tokky FP10, Fontel FP100: use --lcd 0x7567
• Joy's S16, Vertex M114, Digma Linx A106: use --lcd 0x1230
• Joy's S19: use --lcd 0x7565
• LONG-CZ J9: use --lcd 0x1306
• Prestigio Wize J1: use --lcd 0x80009106, 0 and # keys not present in the keymap and implemented differently

• monochrome LCDs: can't be detected, support varies across ports and LCDs, better for screens with ST7567A

Game controls

Key(s)	Action
Left Soft Key	use
Right Soft Key	open/close menu
Direction Pad	movement
D-pad Center	fire
Dial Key	run on/off
2, 4, 5, 6	up/left/down/right
1, 3	strafe left/right
7, 9	prev/next weapon
Power + Center	use
Power + Up	run on/off
Power + Down	open/close menu
Power + L/R	prev/next weapon
Power + LSoft	zoom in
Power + RSoft	zoom out
Power + Dial	map
Power + 0	gamma (0..4)
Power + 1,2,3	I, D, Q
Power + 4,5,6	K, F, A

• D-pad and keys 1-9 are rotated with the --rotate option (with screen or separately).
• For phones without D-pad Center key (Nobby 170B) - up/down keys are used for fire.
• If you don't like the controls - you can change it in keytrn.c.
• Combinations with the power button are for the Children's Camera, which has only six keys. Don't hold down the power button for too long (7 seconds), as this may trigger the device to power off.

Tweaks

• Use --charger 2 option to libc_server so that the battery can be removed for the SC6531 after the game is loaded, the game will continue to run on USB power.