WiiColEm

WiiColEm
General
Author	Raz0red
Type	Console
Version	0.3
License	Mixed
Last Updated	2019/12/25
Links
Download
Website
Source

WiiColEm is a port of the ColEm ColecoVision emulator version developed by Marat Fayzullin.

Features

• Super Game Module (SGM) compatibility.
• Multiple video modes (240p, GX+VI, GX).
• Support for driving, roller, and super action controllers.
• Tilt-based (Wiimote) driving support.
• Cartridge database w/ recommended controller settings and keypad descriptions for most commercial cartridges.
• Cartridge keypad overlays.
• Per-cartridge button mappings.

Installation

To install WiiColEm, simply extract the zip file directly to your SD card or USB device (retain the hierarchical structure exactly).

User guide

SMB/Network support

WiiColEm allows for loading ROMs over the network via SMB. To enable SMB support, you must edit the "wiicolem.conf" file located in the "/wiicolem" directory and provide values for the following:

• share_ip - IP address of the computer to connect to.
• share_name - Name of the share on the computer.
• share_user - Name of the user to connect as
• share_pass - Password for the user.

Cartridge database

WiiColem ships with a database that contains recommended settings for most commercial cartridges. These settings cover controls mappings, keypad overlays, keypad button descriptions, and advanced settings (whether the cartridge requires an EEPROM, SRAM, etc).

To view/edit the settings applied for a particular cartridge perform the following steps:

• Load the cartridge (via the "Load cartridge" menu item).
• Return to the WiiColem menu.
• Select "Cartridge settings (current cartridge)" menu item.
• Examine the "Control settings" and "Advanced" settings for the cartridge.

For more information on mapping controls and creating and/or customizing cartridge settings, see Cartridge Settings.

Cartridge settings

WiiColEm contains the ability to manage per-cartridge settings. The settings that can be edited include:

• Control settings.
• Advanced settings (Whether it requires an EEPROM, SRAM, etc).

Control settings

The following control options are available:

• The controller type (standard, super action, driving/tilt, driving/analog, roller).
• Wiimote orientation .
• Sensitivity (Roller and driving controllers).
• ColecoVision keypad and controller button mappings.

When mapping buttons, you map a ColecoVision keypad or controller button to one of the "button groups" listed below. This allows you to map a button once across the different Wii controllers.

You can use the "View as" menu item to toggle and view how the ColecoVision buttons are mapped to a particular Wii controller (Wiimote, Nunchuk, Classic/Pro, and GameCube).

Group	Wiimote	Nunchuk	Classic Controller	GCN Controller
Button 1	2	C	A	A
Button 2	1	Z	B	B
Button 3	A	--	X	X
Button 4	B	--	Y	Y
Button 5	--	--	R	R
Button 6	--	--	L	L
Button 7	--	--	ZR	--
Button 8	--	--	ZL	--

Keypad Controls

The keypad allows you to press keys on the ColecoVision controller keypads. If a description has been provided for the currently selected key it will be displayed above the keypad.

You can select whether you want emulation to pause while the keypad is displayed via the "Keypad pause" option in "Advanced" settings (pausing is enabled by default). This value can be overridden on a cartridge-by-cartridge basis via Cartridge Settings.

Note: The "Keypad pause" option is not available when the GX+VI or Double strike (240p) video modes are enabled. (Keypad pause is enabled and cannot be disabled).

When keypad pause is enabled, the keypad will be closed when a keypad button is pressed (or the keypad is explicitly closed). It is important to note that the keypad button will continue to be pressed as long as the controller button is held. This is necessary for games like War Room where you need to hold the keypad buttons down to see the different factories, etc. It is also necessary for games that require a longer button press for the selection to register (Star Trek, etc).

When keypad pause is disabled, emulation will continue while the keypad is displayed. The keypad will continue to be displayed until it is explicitly closed. This mode works well for games like Lord of the Dungeon and Ken Uston Blackjack that require lots of button presses.

Controls

Default mappings

The following section contains the default control mappings for WiiColEm (Menu, Keypad and Standard in-game).

It is important to note that if the cartridge that is being loaded exists in the Cartridge Database it may contain non-default mappings.

Wiimote Horizontal

Menu:

D-Pad Up/Down - Scroll through the Menu

D-Pad Left/Right - Page through the Menu

A - Select menu item

B - Previous menu

Home - Exit to Homebrew channel

Power - Power off

In game (Keypad):

D-Pad - Choose Key

2/1/A/B - Press Key

Plus - Close Keypad

In game (Standard):

D-Pad - Move

2 - Left Fire Button

1 - Right Fire Button

Plus - Toggle Keypad

Home - Display WiiColEm menu (see above)

Wiimote & Nunchuk

Menu:

D-Pad Up/Down or Nunchuk Analog - Scroll through the Menu

D-Pad Left/Right or Nunchuk Analog - Page through the Menu

A or Nunchuk C - Select menu item

B or Nunchuk Z - Previous menu

Home - Exit to Homebrew channel

In game (Keypad):

D-Pad or Nunchuk Analog - Choose Key

C/Z/A/B - Press Key

Plus - Close Keypad

In game (Standard):

D-Pad or Nunchuk Analog - Move

Nunchuk C - Left Fire Button

Z - Right Fire Button

Plus - Toggle Keypad

Home - Display WiiColEm menu (see above)

Classic Controller/Pro

Menu:

D-Pad Up/Down or Left Analog - Scroll through the Menu

D-Pad Left/Right or Left Analog - Page through the Menu

A - Select menu item

B - Previous menu

Home - Exit to Homebrew channel

In game (Keypad):

D-Pad or Analog - Choose Key

A/B - Press Key

Plus - Close Keypad

In game (Standard):

D-Pad or Analog - Move

A - Left Fire Button

B - Right Fire Button

Plus - Toggle Keypad

Home - Display WiiColEm menu (see above)

GameCube Controller

Menu:

D-Pad Up/Down or Analog - Scroll through the Menu

D-Pad Left/Right or Analog - Page through the Menu

A - Select menu item

B - Previous menu

Z - Exit to Homebrew channel

In game (Keypad):

D-Pad or Analog or C Stick - Choose Key

A/B - Press Key

Start - Close Keypad

In game (Standard):

D-Pad or Analog or C Stick - Move

A - Left Fire Button

B - Right Fire Button

Start - Toggle Keypad

Z - Display WiiColEm menu (see above)

Non-default mappings

The following section contains the non-default control mappings for WiiColEm.

Super action:

• Very few games use the "spinner" that is a part of the super action controller. You can enable/disable the "spinner" via Cartridge Settings.
• By disabling the spinner, you have more options available for the move controls (Nunchuk analog, both analogs on the Classic and GameCube controllers).

Driving / Tilt:

• In this mode, you steer by tilting the Wiimote (similar to Excite Truck/Bots).
• You can adjust the tilt sensitivity via Cartridge Settings.

Driving / Analog:

• In this mode, you steer by using the analog controls (Nunchuk, Classic, GameCube).

Roller:

• In this mode, the trackball motion is simulated via analog controls (Nunchuk, Classic, GameCube).
• You can adjust the analog sensitivity via Cartridge Settings.

Aquattack:

• Aquattack has a very unique control scheme. It uses the keypad buttons to fire in eight different directions.
• Essentially, it uses the "keypad" as a "D-Pad". While the keypad buttons have been mapped to the eight different buttons on the Classic controller (and pro) it is cumbersome to use.
• In addition to mapping these buttons, a special control scheme has been added to WiiColEm that allows for the use of the right analog stick on both the GameCube and Classic controller/Pro for firing in the eight different directions.

Wiimote & Nunchuk

In game (Super action):

D-Pad or Nunchuk Analog - Move (if spinner disabled)

D-Pad - Move (if spinner enabled)

Nunchuk Analog - Spinner (if enabled)

2 or or Nunchuk C - Yellow Button

1 or or Nunchuk Z - Orange Button

A - Blue Button

B - Purple Button

Plus - Toggle Keypad

Home - Display WiiColEm menu (see above)

In game (Driving/Tilt):

Hold the Wiimote sideways.

Tilt - Steer

D-Pad - Shift

2 - Gas

1 - Brake

Plus - Toggle Keypad

Home - Display WiiColEm menu (see above)

In game (Driving/Analog):

Nunchuk Analog - Steer

D-Pad - Shift

2 or Nunchuk C - Gas

1 or Nunchuk Z - Brake

Plus - Toggle Keypad

Home - Display WiiColEm menu (see above)

In game (Roller):

Nunchuk Analog - Move

2 or Nunchuk C - Left Fire (2p)

1 or Nunchuk Z - Right Fire (2p)

A - Left Fire

B - Right Fire

Plus - Toggle Keypad

Home - Display WiiColEm menu (see above)

Classic Controller/Pro

In game (Super action):

D-Pad or Analog - Move (if spinner disabled)

D-Pad or Left Analog - Move (if spinner enabled)

Right Analog - Spinner (if enabled)

A/R - Yellow Button

B/L - Orange Button

X/ZR - Blue Button

Y/ZL - Purple Button

Plus - Toggle Keypad

Home - Display WiiColEm menu (see above)

In game (Driving/Analog):

Right Analog - Steer

D-Pad - Shift

A - Gas

B - Brake

Plus - Toggle Keypad

Home - Display WiiColEm menu (see above)

In game (Roller):

Left Analog - Move

A - Left Fire (2p)

B - Right Fire (2p)

X - Left Fire

Y - Right Fire

Plus - Toggle Keypad

Home - Display WiiColEm menu (see above)

GameCube Controller

In game (Super action):

D-Pad or Analog or C Stick - Move (if spinner disabled)

D-Pad or Left Analog - Move (if spinner enabled)

C Stick - Spinner (if enabled)

A/R - Yellow Button

B/L - Orange Button

X - Blue Button

Y - Purple Button

Start - Toggle Keypad

Z - Display WiiColEm menu (see above)

In game (Driving/Analog):

C Stick - Steer

D-Pad - Shift

A - Gas

B - Brake

Start - Toggle Keypad

Z - Display WiiColEm menu (see above)

In game (Roller):

Analog - Move

A - Left Fire (2p)

B - Right Fire (2p)

X - Left Fire

Y - Right Fire

Start - Toggle Keypad

Z - Display WiiColEm menu (see above)

Screenshots

Media

WiiColEm 0.3 + ColecoVision Homebrew (Chris Smith)

WiiColEm (Chris Smith)

Changelog

0.3 2019/12/25

• Updated to latest version of ColEm (4.8).
  • Super Game Module (SGM) emulation.
  • 24c08 and 24c256 EEPROM emulation.
• Display enhancements.
  • Double strike (240p).
  • GX+VI mode.
  • 16:9 correction.
  • Full widescreen support.
  • Ability to enable/disable bilinear filter (GX mode).
  • Color trap filter.
• Hierarchical file navigation support.
• SMB (Network support) for loading ROMs.
• Multi-save slot support.
• Support for launching via WiiFlow (and returning).
• Updated to latest versions of devkitPPC (r35) and libogc (1.8.23).

0.2 2011/03/07

• Cartridge-specific overlays.
• Default keypad (controller) image for cartridges without specific overlays.
  • Ability to set the default keypad (controller) size.
• Ability to specify whether to use cartridge-specific overlays (global and per-cartridge).
• GX based scaler.
  • Ability to adjust screen size to any size/dimensions via the "Screen Size" option under "Display". If this is entered after loading a cartridge, the last frame will be displayed to assist in sizing.
• USB support.
• SDHC support.
• Classic Controller Pro support.
• Support for ColecoVision MegaCart(R).
• Fixed Lord of the Dungeon save/load state issues.
• Fixed Opcode memory expansion save/load state issues.
• Fixed save/load state bug causing the palette to not be restored correctly (Aquattack, War Room).
• Ability to set Wiimote orientation (sideways/upright) for navigating menus.
• Firing in Aquattack is now supported via the right analog stick (GameCube, Classic/Pro controllers).
• Fixed bugs caused by pressing multiple keypad buttons simultaneously.

0.1 2010/01/28

• Initial release.

Credits

• NeoRame - Icon.
• Pixelboy - Source overlays.
• James Carter - Source overlays.
• Mastershoes - Testing (0.3).
• Murph74 - Testing (0.2).
• Astroman - Testing (0.2).
• Yurkie - Testing (0.1).

Special thanks:

• Tantric - Menu example code and SDL enhancements.
• Marat Fayzullin - Creating an awesome emulator and answering all of my annoying questions.
• Daniel Bienvenu (newcoleco) - Help resolving the Mode 2 issues.
• Opcode - Providing a ROM for testing the Opcode memory expansion and MegaCart(R) support.

External links

• GitHub - https://github.com/raz0red/wiicolem
• WiiBrew - https://wiibrew.org/wiki/WiiColEm