/fpdoom

Doom for feature phones

Primary LanguageCThe UnlicenseUnlicense

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
  • 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: only games on the Build engine work with this resolution, others need --scaler 1 option
  • Tokky FP10, Fontel FP100: use --lcd 0x7567
  • Joy's S16: use --lcd 0x1230
  • Joy's S19: use --lcd 0x7565
  • 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.