ArmedF

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #golang #rust #deep-learning #docker #nodejs #macos #vue #pytorch #mcp #openai

(★ 10)

Nichibutsu Armed F / Terra Force WIP

ArmedF Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Nichibutsu M68000 (Armed F) FPGA Implementation

FPGA compatible core of Nichibutsu M68000 (Terra Force Based) arcade hardware for [**MiSTerFPGA**](https://github.com/MiSTer-devel/Main_MiSTer/wiki) written by **Erin Olafson**. Terra Force PCB (different board revisions) donated by [**@atrac17**](https://twitter.com/_atrac17) / [**@djhardrich**](https://twitter.com/djhardrich).

The intent is for this core to be a 1:1 implementation of the Nichibutsu (Terra Force based) 68000 hardware. Currently in an beta state, this core is in active development with assistance from [**atrac17**](https://github.com/atrac17).

## Supported Games

| Title | Status | Released | Protection | Unprotected Sets |
|------|---------|----------|------------|------------------|
[**Terra Force**](https://en.wikipedia.org/wiki/Nihon_Bussan)           | Implemented   | **terraf, terrfj, terrafu**         | NB1414M4 | **terrafjb, terrafb**   |
[**Kozure Ōkami**](https://en.wikipedia.org/wiki/Nihon_Bussan)          | Implemented   | **kozure**                          | NB1414M4 | N/A                     |
[**Chouji Meikyuu Legion**](https://en.wikipedia.org/wiki/Nihon_Bussan) | Implemented   | **legion, legionj2**                | NB1414M4 | **legionjb, legionjb2** |
[**Crazy Climber 2**](https://en.wikipedia.org/wiki/Nihon_Bussan)       | Implemented   | **cclimbr2, cclimbr2a**             | NB1414M4 | N/A                     |
[**Armed F**](https://en.wikipedia.org/wiki/Formation_Armed_F)          | Implemented   | **armedf, armedff**                 | None     | N/A                     |
[**Tatakae! Big Fighter**](https://en.wikipedia.org/wiki/Nihon_Bussan)  | Implemented   | **skyrobo, bigfghtr**               | i8751    | N/A                     |

## External Modules

|Name| Purpose | Author |
|----|---------|--------|
| [**fx68k**](https://github.com/ijor/fx68k)                                                   | [**Motorola 68000 CPU**](https://en.wikipedia.org/wiki/Motorola_68000) | Jorge Cwik                    |
| [**t80**](https://opencores.org/projects/t80)                                                | [**Zilog Z80 CPU**](https://en.wikipedia.org/wiki/Zilog_Z80)           | Daniel Wallner                |
| [**jtopl2**](https://github.com/jotego/jtopl)                                                | [**Yamaha OPL 2**](https://en.wikipedia.org/wiki/Yamaha_OPL#OPL2)      | Jose Tejada                   |
| [**jt8751**](https://github.com/jotego/jtframe/blob/master/hdl/cpu/jtframe_8751mcu.v)        | [**Intel 8751**](https://en.wikipedia.org/wiki/Intel_8051)             | Oregano Systems / Jose Tejada |
| [**yc_out**](https://github.com/MikeS11/MiSTerFPGA_YC_Encoder)  | [**Y/C Video Module**](https://en.wikipedia.org/wiki/S-Video)          | Mike Simone    |

# Known Issues / Tasks

- Screen Flip implementation  
- Layer priority - **Chouji Meikyuu Legion (Japan ver 1.05) [legionj, legionjb]**  
- Service Menu text layer **NB1414M4**

# PCB Check List

FPGA implementation is based on Terra Force and verified against an authentic Nichibutsu U.S.A Terra Force PCB and bootleg PCB.

Reverse engineering of an authentic Terra Force PCB will be done by **Erin Olafson** and schematics will be included in the repository.

### Clock Information

H-Sync      | V-Sync      | Source                                   |
------------|-------------|------------------------------------------|
15.51kHz    | 59.092993Hz | [DSLogic +](https://www.is.gd/AFLNoI)    |

### Crystal Oscillators

Location           | Freq (MHz) | Use          |
-------------------|------------|--------------|
C1 (Top Board)     | 16.000     | M68000       |
F1 (Bottom Board)  | 24.000     | Z80 / YM3812 |

**Pixel clock:** 6.00 MHz

**Estimated geometry:**

_(Terra Force, Kozure Ōkami, Armed F, Tatakae! Big Fighter)_

387 pixels/line
  
    262 pixels/line

_(Chouji Meikyuu Legion, Crazy Climber 2)_

352 pixels/line
  
    248 pixels/line

### Main Components

Location | Chip | Use |
---------|------|-----|
D1  (Top Board)      | [**Motorola 68000 CPU**](https://en.wikipedia.org/wiki/Motorola_68000)   | Main CPU                                  |
H17 (Bottom Board)   | [**Zilog Z80 CPU**](https://en.wikipedia.org/wiki/Zilog_Z80)             | Sound CPU                                 |
K15 (Bottom Board)   | [**Yamaha YM3812**](https://en.wikipedia.org/wiki/Yamaha_OPL#OPL2)       | OPL2                                      |
D1  (Daughter Board) | [**Intel 8751**](https://en.wikipedia.org/wiki/Intel_8051)               | Protection MCU **(Tatakae! Big Fighter)** |

### Nichibutsu Custom Components

| Location | Chip | Use | PCB | ROM set |
|----------|-----|------|-----|---------|
A9 (Top Board) | [**NB1414M4**](https://raw.githubusercontent.com/va7deo/TerraForce/main/doc/Terra%20Force%2026494/Terra%20Force%2026494%20Front.jpg?token=GHSAT0AAAAAABKJR6W6CVBT5FROK2UKF75KYTXT2BA) | Protection IC | **Chouji Meikyuu Legion** **Terra Force** **Kozure Ōkami** **Crazy Climber 2** | **legion, legionj, legionj2** **terraf, terrafu, terrafj** **kozure** **cclimbr2, cclimbr2a** |

# PCB Features

### Debugging Menu

A hidden debug menu can be accessed for all Nichibutsu 68000 (Armed F Based) titles. For more information on each debugging menu per game click [**here**](https://tcrf.net/Category:Games_developed_by_Nichibutsu). Each debug menu has different features to display Character, Object, Scoll, Foreground, Background, Stage Viewer, or Priority tests.

**Follow these steps to access the debug menu (OSD or Keyboard):**

> - Turn on **Service Menu** in the debug OSD options or press **F2**. Then turn on **Debug Menu** or press and hold **R**, **A**, **S**. For **Crazy Climber 2** press and hold **Up**, **LCtrl**, **Spacebar**. 
> - Toggle the **Service Menu** option off; then toggle **Debug Menu** off in the OSD or keep those corresponding keys held and press **F2**. **Note: Crazy Climber 2 is not accessible in the OSD**.

<table><th>Character Graphics ROM</th><th>Object Graphics ROM</th><th>Basic Stage Viewer</th><th>Sprite Priority Test</th></tr><tr><td><img src="https://user-images.githubusercontent.com/32810066/173248334-143ce6d1-0d43-40bf-acfe-333f32bb0059.png"></td><td><img src="https://user-images.githubusercontent.com/32810066/173248338-578e49ec-1836-4752-9dea-04aef77b6ecc.png"></td><td><img src="https://user-images.githubusercontent.com/32810066/173248342-f01e2f65-2c6d-4a09-953f-55899a51bb25.png"></td><td><img src="https://user-images.githubusercontent.com/32810066/173248343-1e6e2017-2117-4abd-bf2e-98cf3f9efb07.png"></td></tr></table>

### Debugging Features

<table><tr><th>Chouji Meikyuu Legion </th><th>Debugging Features [legion, legionj, legionjb]</th></tr><tr><td><img src="https://user-images.githubusercontent.com/32810066/173247174-3ff281fe-89b1-4bae-8340-8e482c5d92b8.png"></img></td><td>Chouji Meikyuu Legion has hidden debug dipswitches by enabling offsets at 0x000488 and 0x0001d6. Bank 1, switch 8 enables these options on bank 2, switch 7 and 8. This enables P1 and P2 Invunerability and the ability to overclock the games framerate by holding the 2P Start Bttn. The dipswitch information was taken from mame, the overclocked framerate was discovered during core development. These features are enabled in the MRA's for the corresponding sets.</td><tr><th>Tatakae! Big Fighter</th><th>Debugging Features [skyrobo, bigfghtr]</th></tr><tr><td><img src="https://user-images.githubusercontent.com/32810066/176574476-6852cfd5-7129-4147-b8d3-0e9f835633dd.png"></img></td><td>There are two dipswitches labeled unused in the in the Tatakae! Big Fighter manual. The dipswitch location for bank 2, switch 6 enables invulnerability and the ability to skip the level by pressing P2 Start Bttn. The dipswitch location on bank 2, switch 8 enables pause in game, this was used for development debugging.</td></table>

# Core Features

### Native Y/C Output

- Native Y/C ouput is possible with the [**analog I/O rev 6.1 pcb**](https://github.com/MiSTer-devel/Main_MiSTer/wiki/IO-Board). Using the following cables, [**HD-15 to BNC cable**](https://www.amazon.com/StarTech-com-Coax-RGBHV-Monitor-Cable/dp/B0033AF5Y0/) will transmit Y/C over the green and red lines. Choose an appropriate adapter to feed [**Y/C (S-Video)**](https://www.amazon.com/MEIRIYFA-Splitter-Extension-Monitors-Transmission/dp/B09N19XZJQ) to your display.

### H/V Adjustments

- There are two H/V toggles, H/V-sync positioning adjust and H/V-sync width adjust. Positioning will move the display for centering on CRT display. The sync width adjust can be used to for sync issues (rolling) without modifying the video timings.

### Scandoubler Options

- Additional toggle to enable the scandoubler without changing ini settings and new scanline option for 100% is available, this draws a black line every other frame. Below is an example.

<table><tr><th>Scandoubler Fx</th><th>Scanlines 25%</th><th>Scanlines 50%</th><th>Scanlines 75%</th><th>Scanlines 100%</th><tr><td> <img width="160" height="120" src="https://user-images.githubusercontent.com/32810066/195706756-30bf8961-ade1-4789-b79c-544c2772d97f.png"></td><td> <img width="160" height="120" src="https://user-images.githubusercontent.com/32810066/195706760-3b1e5d99-9e85-4e3e-893d-c556f77b74ba.png"></td><td> <img width="160" height="120" src="https://user-images.githubusercontent.com/32810066/195706763-e52061fc-c092-4ae4-a8c6-4cc2ffc97ac3.png"></td><td> <img width="160" height="120" src="https://user-images.githubusercontent.com/32810066/195706764-7484cca4-f304-431e-8bf3-987c0e358f19.png"></td><td> <img width="160" height="120" src="https://user-images.githubusercontent.com/32810066/195706768-96d2ea94-54f5-48ed-9f71-c4fd826897b9.png"></td></tr></table>

### GFX Layer Toggle

- The four graphical layers can be toggled in the OSD under the Debug options or by pressing F7-F10 on the keyboard.

<table><tr><th>Text Layer</th><th>Background Layer</th><th>Foreground Layer</th><th>Sprite Layer</th><th>All Layers</th></tr><tr><td><img width="120" height="160" src="https://user-images.githubusercontent.com/32810066/170846019-e70e74b9-1e88-4991-b8c3-3b9b52935ad8.png"></td><td><img width="120" height="160" src="https://user-images.githubusercontent.com/32810066/170846020-8459d346-0a97-41ff-ae5f-f7793a4c7bcb.png"></td><td><img width="120" height="160" src="https://user-images.githubusercontent.com/32810066/170846021-08f8506d-e764-42b6-8c4a-ea19b059060b.png"></td><td><img width="120" height="160" src="https://user-images.githubusercontent.com/32810066/170846022-5237caf6-bf3a-4461-b324-5e44733310ff.png"></td><td><img width="120" height="160" src="https://user-images.githubusercontent.com/32810066/170846026-eefddb1b-6a81-4c20-9a99-509dcb888735.png"></td></tr></table>

# Controls

<table><tr><th>Game</th><th>Joystick</th><th>Service Menu</th><th>Shared Controls</th><th>Dip Default</th></tr><tr><td>Armed F</td><td>8-Way</td><td><img src="https://user-images.githubusercontent.com/32810066/170657740-f1781b3a-f50b-41eb-aff3-63d8b891ccf6.png"></td><td>Upright</td><td>Upright</td><tr><td>Chouji Meikyuu Legion</td><td>8-Way</td><td><img src="https://user-images.githubusercontent.com/32810066/170711151-9d7e8a34-b715-48a5-b89f-9b8004cb04f0.png"></td><td>Co-Op</td><td>Upright</td><tr><td>Crazy Climber 2</td><td>4-Way</td><td><img src="https://user-images.githubusercontent.com/32810066/170847086-105099f0-2e8a-4bdb-af1a-b8fa5a9c5f6d.png"></td><td>Upright</td><td>Upright</td><tr><td>Kozure Ōkami</td><td>8-Way</td><td><img src="https://user-images.githubusercontent.com/32810066/173246143-91d3441b-6993-4860-b739-73ac920bfd9c.png"></td><td>Upright</td><td>Upright</td><tr><td>Terra Force</td><td>8-Way</td><td><img src="https://user-images.githubusercontent.com/32810066/173246181-54916a4f-bf6a-47fb-ae93-b40db12cfab8.png"></td><td>Upright</td><td>Upright</td></tr><td>Tatakae! Big Fighter</td><td>8-Way</td><td><img src="https://user-images.githubusercontent.com/32810066/176583826-fba17901-aa97-4241-b03d-f7261e65074e.png"></td><td>Upright</td><td>Upright</td></table>

### Note: (Only applies once screen flip is implemented)

> Upright cabinets share a **1L3B** control panel layout. Players are required to switch controller. If set the cabinet type is set to table, the screen inverts for cocktail mode per player and has multiple controls. Push button 3 may have no function in game, but corresponds to the original hardware and service menu. Crazy Climber 2 uses two 4-way joysticks and the second stick (right) corresponds to buttons 1 thru 4 for movement.

### Keyboard Handler

- Keyboard inputs mapped to mame defaults for all functions.

|Services|Coin/Start|
|--|--|
|<table> <tr><th>Functions</th><th>Keymap</th></tr><tr><td>Test</td><td>F2</td></tr><tr><td>Reset</td><td>F3</td></tr><tr><td>Service</td><td>9</td></tr><tr><td>Pause</td><td>P</td></tr> </table> | <table><tr><th>Functions</th><th>Keymap</th><tr><tr><td>P1 Start</td><td>1</td></tr><tr><td>P2 Start</td><td>2</td></tr><tr><td>P1 Coin</td><td>5</td></tr><tr><td>P2 Coin</td><td>6</td></tr> </table>|

|Player 1|Player 2|
|--|--|
|<table> <tr><th>Functions</th><th>Keymap</th></tr><tr><td>P1 Up</td><td>Up</td></tr><tr><td>P1 Down</td><td>Down</td></tr><tr><td>P1 Left</td><td>Left</td></tr><tr><td>P1 Right</td><td>Right</td></tr><tr><td>P1 Bttn 1</td><td>L-Ctrl</td></tr><tr><td>P1 Bttn 2</td><td>L-Alt</td></tr><tr><td>P1 Bttn 3</td><td>Space</td></tr><tr><td>P1 Bttn 4</td><td>L-Shift</td></tr> </table> | <table> <tr><th>Functions</th><th>Keymap</th></tr><tr><td>P2 Up</td><td>R</td></tr><tr><td>P2 Down</td><td>F</td></tr><tr><td>P2 Left</td><td>D</td></tr><tr><td>P2 Right</td><td>G</td></tr><tr><td>P2 Bttn 1</td><td>A</td></tr><tr><td>P2 Bttn 2</td><td>S</td></tr><tr><td>P2 Bttn 3</td><td>Q</td></tr><tr><td>P2 Bttn 4</td><td>W</td></tr> </table>|

|Debug|
|--|
|<table> <tr><th>Functions</th><th>Keymap</th></tr><tr><td>Layer (TXT)</td><td>F7</td><tr><td>Layer (FG)</td><td>F8</td></tr><tr><td>Layer (BG)</td><td>F9</td><tr><td>Layer (SP)</td><td>F10</td></tr> </table>|

# Support

Please consider showing support for this and future projects via [**Erin's Ko-fi**](https://ko-fi.com/Erino) and [**atrac17's Patreon**](https://www.patreon.com/atrac17). While it isn't necessary, it's greatly appreciated.

# Licensing

Contact the author for special licensing needs. Otherwise follow the GPLv2 license attached.

ArmedF

ArmedF Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ArmedF

ArmedF Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README