diff options
| -rw-r--r-- | addon/TMS9918A/README.md | 102 |
1 files changed, 102 insertions, 0 deletions
diff --git a/addon/TMS9918A/README.md b/addon/TMS9918A/README.md new file mode 100644 index 0000000..e06f1da --- /dev/null +++ b/addon/TMS9918A/README.md @@ -0,0 +1,102 @@ +# TMS9918A Video Card for RC2014 + +This is a TMS9918A-based video card for the RC2014. It allows the RC2014 to produce NTSC composite graphics using a classic chip of the 1980s. The TMS9918A was used in the TI-99/4A, MSX, ColecoVision, and Sega SG-1000. Enhanced derivatives were used in later MSX computers, the Sega Master System, and the Sega Genesis. + +This board is based on a [circuit](https://retrobrewcomputers.org/n8vem-pbwiki-archive/0/35845334/48860720/33053543/SRAM%20Replacement%20for%20TMS99x8%20VRAM.pdf) described by Tom LeMense for interfacing the TMS9918A with SRAM. I started with his schematics, added port address decoding and laid out the circuit on an RC2014 module. + +This board can be configured to use the same ports as the MSX or ColecoVision, so it's possible to run some software from these systems, such as [ColecoVision games](https://hackaday.io/project/159057-game-boards-for-rc2014/log/156298-running-colecovision-games) and [MSX-BASIC](https://hackaday.io/project/158338-z80ctrl/log/157750-msx-basic-on-rc2014). + +## Assembly Instructions + +[Ready-to-Assemble Kits](https://www.tindie.com/products/mfkamprath/tms9918a-video-module-for-rc2014/) are available on Tindie. These are sold by Michael Kamprath with my permission. However, I offer no warranty or guarantee of support. + +[Gerbers](https://cdn.hackaday.io/files/1590576805094688/TMS9918_rev4_gerbers.zip) for the PCB are available. I highly recommend [JLCPCB](https://jlcpcb.com/) for PCB fabrication. Alternatively, boards can be ordered from the shared project on [OSH Park](https://oshpark.com/shared_projects/mwSt2s6V). + +Refer to the [schematic](TMS9918.pdf), the picture below, and the bill of materials below for assembly guidance. + + + +### Bill of Materials + +| Component | Description | +|---|---| +| PCB | rc9918 PCB | +| U1 | 74HCT32 quad OR gate | +| U2 | 74HCT138 3-8 line decoder | +| U3 | TMS9918A video chip | +| U4 | 74HCT04 hex inverter | +| U5, U6, U7 | 74HCT574 octal flip-flops | +| U8 | AS6C62256-55PCN, HM62256BLP-7, UM61M256K-15, or other compatible 32KB SRAM. I have put two footprints so either a wide or narrow DIP-28 will work as long as the pin-out is the same. | +| R1 | 75 ohm resistor | +| R2 | 0 ohm resistor. Wire jumper can be used in place of 0 ohm resistor. | +| R3 | 470 ohm resistor | +| L1 | Ferrite bead (FBA04HA600VB-00 or similar) | +| Y1 | 10.73866MHz crystal (LFXTAL029962REEL or similar) | +| C1, C2 | 16pf ceramic or MLCC capacitor | +| C3-C11 | 0.1uf ceramic or MLCC capacitor | +| Q1 | NPN transistor (2N4401 or similar) | +| J1 & J5 | 2x40 pin right angle header, with pins from upper row removed to fit J5 | +| J2 | KLPX-0848A-2-Y RCA connector | +| J4 | 2x8 pin straight header and 1 jumper block | +| J6 | 2x3 pin straight header and 1 jumper block | +| J7 | 1x4 pin straight header and 1 jumper block | +| JP1 | 1x3 pin straight header and 1 jumper block | +| JP2 | 1x3 pin straight header and 1 jumper block | +| JP4 | 1x3 pin straight header and 1 jumper block | +| D1 | REV4 only: Schottky diode (BAT81 or similar) | + +Aside from the board and the TMS9918A itself, all parts are available from Mouser and probably other suppliers as well. + +## Jumper Descriptions + +### Default Jumper Configurations +The default jumper configurations for the RC2014 are below. + +| Jumper | Jumper Block Configuration | Results | +|---|---|---| +| `J4` | 5th from left | Port 80-9F | +| `J6` | Right | Upper half of port range selected by `J4` | +| `JP1` | Upper | Ports 98 & 99 | +| `JP2` | Upper | Ports 98 & 99 | +| `JP4` | Lower Pair | TMS9918A interrupts sent to NMI | +| `J7` | _None_ | This is the clock signal header | + +See jumper description at [the Hackaday.io article](https://hackaday.io/project/159057-rc9918/log/149923-new-board-revision) for more detail on each jumper. + +### Port Address Jumpers + +* `J4` configures address bits 7-5 which lets you select a block of 32 addresses: 00-1F (left) ... E0-FF (right). For ColecoVision, you would set this to A0-BF (6th position). For MSX, you'd set it to 80-9F (5th position). For Sord M5, you'd set it to 00-1F (1st position). +* `J6` configures address bit 4. There are 3 options: ignore (left), 0 (middle), or 1 (right). This lets you use the entire 32 address range, the lower half, or the upper half, respectively. For ColecoVision, you would set this to ignore (left). For MSX and Sord, you would set it to 1 (right). +* `JP1` configures address bit 2 and 1. In the upper position, they must both be 0. In the lower position, they are ignored. For MSX, you would set this to the upper position. For ColecoVision and Sord, you would set it to the lower position. +* `JP2` configures address bit 3. In the upper position, it must be 1. In the lower position, it is ignored. For MSX, you would set this to the upper position. For ColecoVision or Sord, you would set it to the lower position. + +### Interrupt Configuration Jumper +The jumper `JP4` is used to determine where the TMS9918A interrupt signal to either INT (upper position) or NMI (lower position) on the RC2014 bus. ColecoVision connects the video interrupt to NMI, so this change was necessary for compatibility. MSX uses INT, and most other systems do as well. + +**Warning**: It appears that the TMS9918A does not have an open collector interrupt output. If you have other cards that make use of the /INT line, such as the SIO card that comes with the RC2014 it's possible the TMS9918A will fight with other chips for control of the interrupt line, which will prevent proper operation and could potentially damage both chips. For safety, it is recommended to use NMI instead of INT in this case. REV4 of the board adds a diode to prevent this. + +### Clock Header +The optional `J7` header has pins (from left to right) for RC2014 CLK1 (REV4 only), CPUCLK, GROMCLK, EXTVDP, and GND. These pins can be used as follows: + +- CPUCLK and GROMCLK provide 3.58MHz and 447 kHz clock signals, respectively. A jumper block can be placed on the RC2014 CLK1 and CPUCLK pins to use the TMS9918A's clock output as the RC2014's system clock (be sure to remove other clock sources if you do this). The clock signals could also be used by other boards via jumper cables. + +- It should also be possible to daisy-chain multiple TMS9918A chips using the EXTVDP signal, or to genlock an external video source. The extra GND pin can be used with an external video source if needed. + +## Resources + +- [TMS9918 Manual](http://map.grauw.nl/resources/video/texasinstruments_tms9918.pdf) +- [TI VDP Programmer's Guide](http://map.grauw.nl/resources/video/ti-vdp-programmers-guide.pdf) +- [More TMS9918 Documents](https://github.com/cbmeeks/TMS9918) +- [Discussion Thread](https://groups.google.com/d/topic/rc2014-z80/0m0kbzIJ3tw/discussion) +- [Hackaday Page](https://hackaday.io/project/159057-rc9918) +- [Example Assembly Programs](examples) + +## License + +Copyright 2018 J.B. Langston + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |