readme v0.3.2

WOWSlider generated by WOWSlider.com

readme v0.3.2


CHAMELEONPI Readme

v0.3.2 SUMMER MANIA 06/2013 - 12/2012
by Carles Oriol - carlesoriol@gmail.com, Barcelona - Catalonia

http://chameleon.enging.com 
MANUAL - Stefano Paganini at http://www.stefanopaganini.com/raspberry-pi-chameleon-overview-and-tutorial/
TORRENT - Get the image at: http://chameleon.enging.com/?q=download

RPI Chameleon it's a Raspbian remix without the X grpahical environment that uses it's own launcher to run emulators for old computers, arcades and consoles.

All changes to the system are open source and use the GPL license.

I hope you love it as I do.
(don't shutdown the computer on the screensaver ;-) )

Carles Oriol

SELECTOR

Key Function
< > Arrows move through emulated systems
ENTER, 1 Run current system, with first option
2, 3, ... Select alternatives for current system
(read on screen information ex: spectrum emulator 1- fuse 2-unreal_speccy
Q Shuts down the system
E Opens emulator online help forum in browser
C Opens computer online help forum in browser
W Opens emulator website in browser
T Opens terminal window (exit returns to system selector)
O Configuration options screen
H, F1 Shows help README
Ctrl+Alt+DEL or Ctrl+Alt+ESC Return to launcher on emulator crash.
They use diferent closing methods

USER AND PASSWORD

default user name is: zx
default password is: spectrum 
root user password has been forced to raspberry

THIS EMULATOR HAS NOT BEEN DONE HAVING SECURITY AS A PRIORITY, zx USER HAS SUDO PASWORDLESS PERMISIONS.
KEEP IT IN MIND IF YOU USE IN A PUBLIC ENVIRONMENT.

HOW TO LOAD ROMS

Directly to SD

Plug SD on your computer.
Copy your roms to "roms" partition. Now in fat32 to simplfy it to windows/mac users

Network

Browse the network with your computer for rpichameleon (smb share)
open roms folder (user: zx, password: spectrum, workgroup: WORKGROUP)

Copy roms on each emulator folder.

Network - AUTOLINK

Create a shared folder in your computer named CHAMELEONPIROMS wit guest permisions
Boot chameleonpi. It will scan for this share in the full network and if found will mount it as /roms folder

USB DISK

Connect a usb to your raspberry pi
On every launch restart, will look for plugged usbs. If found will mount them to /roms/USB/Vol1, Vol2...

EXPAND YOUR SD TO FULL SIZE

Press O to go to options menu.
Select resize roms partitions. It will modify your chameleonpi allowing to use all space on your sd

AUTOEXEC

On your roms folder you have two files:

  • AUTOEXEC.system
  • AUTOEXEC.launcher

They will allow you to add extra initialization when you start the emulator. So you will can mount external ftp sites, configure joysticks... whatever you want.

AUTOEXEC.system - Is executed one single time when you start the system.
AUTOEXEC.launcher - Is executed every time before the launcher is executed.

Why I named init scripts AUTOEXEC???? .... Easy! ... I felt the name so retro that I thought was perfect for this project

ROMPACKS

Since v0.3 you can put files squashfs on the roms folder and the system will automatically mount them on boot time as a read/write folder.
This folder can be one of the existing ones, spectrum, zx81...

squashfs is a compressed partition image, you can also do it to your existing folders just writing:

mksquashfs folder folder.squashfs -force-gid 1001 -force-uid 1001
It's also the best way to keep your rom packs and move between your diferent raspberries.

 

EMULATORS NOTES

SPECTRUM

Here you have the gratest computer of all time (2nd is raspberry)

You have THREE great emulators to run in raspberry FUSE, UNREAL, FBZX both are so perfect that's very dificult to search one or the other... so beter to have them all :-)

You can get all documentation and all great programs at the amazing web site www.worldofspectrum.com

FUSE, F1 - Opens the menu

UNREAL ESC - Opens the menu

ATARI VCS

SCUMMVM

ADVMAME

DOS

ORIC

COMMODORE

AMSTRAD

CAPRICE

ATARI ST

ZX81

NOTES:

DOS emulator sometimes crashes at exit when runs win3.1 it's so real!

HELP ME

This remix it's a personal development just for fun. I would love to have help to make it better. If you have any suggestions, developments, ideas, documentation, or anything else that you thing could be great for chameleon please contact me at carlesoriol@gmail.com if we are enough I could create a mail distribution list.


Thanks to all people that's collaborating to made chameleon pi so amazing, specially:

Stefano Paganini - Milano, Italy
Josh Campbell - Australia
Harald Latzko - Germany
Swen Mulderij - Nederland
Antonios Anyfantakis - Greece
Olli Raatikainen - Finland

AreaScout aka Daniel Mehrwald - (Austria) - Vice on raspberry pi

Impacte Comunicaci├│ - Barcelona

Also to all people participation in so many forums.

Chameleon PI couldn't exist without:

Raspberry PI - The most amazing computer since zx spectrum
Raspbian - Linux distribution. Chameleon is only a remix of the installed software on this system.
Debian - All in one linux distribution father of raspbian and ubuntu
Linux Foundation
Free software foundation


An all fantasic and incredible emulators that we have included in the chameleon, great pieces of software done by great people thanks to them we can enjoy again all the software, games and lost moments from our childhood.

Simon Owen - from simcopue

And also all original developers of software and hardware who has been great artists and explorers of the future.

We also want to thanks wikimedia for they great images and wikipedia for the content we temporally copied in computers descriptions.  All rights on theses contents depends on their authors. Bill Bertram - http://en.wikipedia.org/wiki/User:Pixel8 -http://commons.wikimedia.org/wiki/User:ADSR6581

Carles Oriol - Barcelona/Catalonia


Chameleon is and will always be a free project. It's done on free time by people around the world.

Chameleon is a raspbian remix so it uses the same license as raspbian.
All software included in it and the same raspbian are under GPL or other free licenses. http://www.raspbian.org
All software and launchers developed specifically for chameleon are gpl3 licensed. http://www.gnu.org/licenses/gpl.html
Computer images are from wikimedia. All authors have it's own conditions. Most of them are from Bill Bertram - http://en.wikipedia.org/wiki/User:Pixel8 - http://commons.wikimedia.org/wiki/User:ADSR6581
Some text in computers descriptions are from the wikipedia.
All emulators an all files in it's content are under the it's licenses and the web pages are linked to it's sources.
Apple ][ and Apple // are registered trademarks owned by Apple Computer Inc..
MSX is copyright of MSX Association.
Amstrad has kindly given its permission for the redistribution of its copyrighted material but retains that copyright, Sinclair Baisc -http://www.worldofspectrum.org/sinclairbasic/
Orbitron font is copyrighted by Matt McInerney and licensed under the SIL Open Font License, Version 1.1.
Quattrocento font is copyrighted by Pablo Impallari, Igino Marini, Brenda Gallo and licensed under the SIL Open Font License, Version 1.1.
All other products names and icons are trademarks of their respective holders.

33 Comments

Hi. I've no general problems

Hi. I've no general problems with my roms (some of them have problems from mame's version to version changes). If you have enough level could you please try to run it from the console and post me the error?

How to enable wifi usb-dongel

How to enable wifi usb-dongel In /etc/network/interfaces check that you find wlan in your config cat /etc/network/interfaces auto lo iface lo inet loopback iface eth0 inet dhcp auto wlan0 iface wlan0 inet dhcp wpa-conf /opt/selector/wifiwpa.config In /opt/selector/wifiwap.config enter your ssid and your password sudo vi /opt/selector/wifiwap.config network={ ssid="YOUR SSID" proto=RSN key_mgmt=WPA-PSK pairwise=CCMP TKIP group=CCMP TKIP psk="YOUR PASSWORD" } and then restart network sudo /etc/init.d/networking restart

How to enable wifi - usb

How to enable wifi - usb dongle in /etc/network/interfaces check that you find wlan in your config $ cat /etc/network/interfaces auto lo iface lo inet loopback iface eth0 inet dhcp auto wlan0 iface wlan0 inet dhcp wpa-conf /opt/selector/wifiwpa.config in wpa-conf /opt/selector/wifiwap.config enter your ssid and your password $ sudo vi /opt/selector/wifiwap.config network={ ssid="YOUR SSID" proto=RSN key_mgmt=WPA-PSK pairwise=CCMP TKIP group=CCMP TKIP psk="YOUR PASSWORD" } and then restart network $ sudo /etc/init.d/networking restart

This is great! One "small"

This is great! One "small" suggestion however -- instead of making an OS download image, it would be better to offer these as .deb packages for the emulators and other files. If someone already has Raspbian (or Occidentalis derivative by Adafruit) then they could just install this. (Occidentalis by the way has reallly nice WiFi configuration and also has Bonjour installed).

Could be nice. If you made

Could be nice. If you made any project in this direction made me know.

Hello, I mad about install

Hello, I mad about install chamaleon on a new raspberry Pi and no luck , I read Chamaleon not work on news Raspberry :( please check this and make a udpate version for fix this issue. any way continue the cool Work in here Carles.

I have paired via Bluetooth a

I have paired via Bluetooth a PS3 DualShock controller and it is working nicely on the emulators. However, I would like to use it too to move left and right and select items on the launcher. Is there anyway to achieve this? Thanks!

Thanks for your great job

Thanks for your great job guys! Do you know if there is any way to map the keys of an USB gamepad? Mine is a supernintendo style gamepad, it works to select the emulator but not in the games...

Hi!

Hi! Firs of all, thank you very much! This is an incredible project! Now a question... I got a kind of retro USB gamepad (SNES). When I test it it works fine but it doesn┬┤t work in the emulators... Is the re any way to remap the keys? Thanks!

If I change the resolution in

If I change the resolution in the config.txt from 1920p to normal pal 720x576 the emulators stop working.

I also had issues expanding

I also had issues expanding the partition. I ended up copying everything out of /roms, deleting the partition /dev/mmcblk0p3 and then recreating it, mounting it to /roms and copied the data back. Worked for me. To recreate the Partition I did the following (copy the data out to a temporary place first): You may need to umount the /dev/mmcblk0p3 partition first (can't remember) >sudo parted (parted)> print list Number Start End Size Type File system Flags 1 4194kB 62.9MB 58.7MB primary fat32 2 62.9MB 3521MB 3458MB primary ext4 3 3521MB 32.1GB 28.6GB primary fat32 lba Note the Start and End Numbers (parted)> rm 3 (parted)> mkpartfs primary fat32 3521MB 32.1GB then do a mount /dev/mmcblk0p3 /roms Hope that helps someone... I'm no expert with linux so it took me a few hours of trying to expand with fatresize to no avail, so the delete/recreate seemed to be my only hope. I read something that fatresize doesn't work on FAT32 partitions under 512MB, which I believe my initial size when I did a df was just over 300mb. Hopefully this helps someone else

I am having the same problem

I am having the same problem as Mark. Here is the output of both commands for mine as well. I am also using a 32 gig SD. zx@rpichameleon ~ $ sudo /opt/selector/tools/cpi_resize.sh Resizing of FAT partition not needed, unallocated size of SD card is 1 bytes. zx@rpichameleon ~ $ sudo parted /dev/mmcblk0 u b p Model: SD SA32G (sd/mmc) Disk /dev/mmcblk0: 31163678720B Sector size (logical/physical): 512B/512B Partition Table: msdos Number Start End Size Type File system Flags 1 4194304B 62914559B 58720256B primary fat32 2 62914560B 3521118207B 3458203648B primary ext4 3 3521118208B 31163678719B 27642560512B primary fat32

will this be compatible with

will this be compatible with raspberry pi similar devices? i was hoping it would work on the hackberry A10

I know people who did it. We

I know people who did it. We didn't have any "similar" device... may be when ouya will be available.

i think i'll take you up on

i think i'll take you up on that offer! I'd love it sent back in return though.

I'm trying to use a logitech

I'm trying to use a logitech gamepad, but I don't know how configure it, key mappings and other stuff. Anybody can help me? thank you so much.

Hi have you tried retroarch

Hi have you tried retroarch-joyconfig in console mode? Have tested with micro$oft sidewinder usb pad, work well in carrousel but no luck in emulator like snes, the pad is reconized but don't work. i have probably missed something? thank in advance

Im with ya on that one, I can

Im with ya on that one, I can find no information on setting up a controller anywhere

just about to try for the

just about to try for the first time! looks very cool!!! does it have xbox 360 controller support ( Xbox 360 wireless gaming receiver for PC) thanks

Yes, I am trying to figure

Yes, I am trying to figure this out as well. I have it installed, but get nothing from my xbox 360 controller. Wonder if its something I'm missing.

hi, the image i download with

hi, the image i download with torrent does not start at all on my raspberry model B. the SD (4GB) has 3 partition but if i use diskpart to check i see Partion 1 fat Partion 0 Ext4 Partion 0 Fat why 2 partition with id = 0? Could this be the problem?

you had a problem,

you had a problem, downloading unpacking or saving the image to sd. Try again.

I've tried both nes and snes

I've tried both nes and snes emulators, they have unplayable input lag. Anyone else confirm?

sudo /opt/selector/tools/cpi

sudo /opt/selector/tools/cpi_resize.sh returned: Resizing of FAT partition not needed, unallocated size of SD card is 1 bytes. zx@rpichameleon ~ $ sudo parted /dev/mmcblk0 u b p Model: SD SDC (sd/mmc) Disk /dev/mmcblk0: 32462864384B Sector size (logical/physical): 512B/512B Partition Table: msdos Number Start End Size Type File system Flags 1 4194304B 62914559B 58720256B primary fat32 2 62914560B 3521118207B 3458203648B primary ext4 3 3521118208B 32462864383B 28941746176B primary fat32

Great OS remix. I have

Great OS remix. I have really enjoyed it this weekend. My Linux experience is fairly limited. Typically I am able to follow guides and get terminal commands from googling problems to work, but that is about it. I had no problem editing the files in the terminal to use my wi-fi. In regular Raspbian when I select the resize the next reboot would take a long time as I assume it was resizing a partion during this time. I never noticed a long boot time with Chameleon. I'm guessing I need to move space allocated to mmcblk0p1 to mmcblk0p3. Harald, I will run the commands and post them after work this evening. Thank you both for your help in looking at this.

Hi,

Hi, could you please open a terminal ("o" -> "1") and execute the following command manually? Post the output here: sudo /opt/selector/tools/cpi_resize.sh As an additional information, please give the output of the following command: sudo parted /dev/mmcblk0 u b p

Could you describe the

Could you describe the problem a little more. What is your linux knowledge level? (to see what can we help you and how can you help us with this problem that you have)

I'm having trouble expanding

I'm having trouble expanding the partition. Tried both the Options expand partition and the raspi-config. I have a 32 gb sd card. How can I make the roms partition bigger? Filesystem 1K-blocks Used Available Use% Mounted on rootfs 3324056 2167356 987844 69% / /dev/root 3324056 2167356 987844 69% / devtmpfs 183620 0 183620 0% /dev tmpfs 38376 1812 36564 5% /run tmpfs 5120 0 5120 0% /run/lock tmpfs 76740 0 76740 0% /run/shm /dev/mmcblk0p1 3748324 17268 3731056 1% /boot /dev/mmcblk0p3 319860 291640 28220 92% /roms