Prereq's:
1. Need an ubuntu CD (Alternate or desktop CD should work)
2. Need a broadband connection (for updates and needed packages)
3. Need a computer with a free disk partition, or enough free space to shrink an existing partition (backup first!), OR vmware-player or VirtualBox to install it into a virtual machine (allows using linux on windows), setting up vmware-player or VirtualBox (http://virtualbox.org) to do this is beyond the scope of this document but I can assist users if requested.
First, install ubuntu. (stick in CD, boot off of it, Double Click the "Install" Icon in the gui follow prompts until done, it's pretty easy that an 8-18 year old should have little trouble with that part, if you get confused, call a neighborhood kid over to help you)
Next part. Login to your ubuntu install.
Then, open a Terminal (Go to top panel, upper left, it's under the Applications menu. in the Accessories submenu)
In this terminal run
Code: Select all
sudo apt-get update
Now run
Code: Select all
sudo apt-get upgrade
Once it comes back up, relogin and open a terminal again. (Applications->Accessories->Terminal)
Now we install all the stuff megatunix needs in one shot.
run this:
Code: Select all
sudo apt-get install pkg-config libtool intltool libgtkglext1-dev g++ gcc flex bison glade-gnome-2 libglade2-dev make git-core gdb automake1.9
Code: Select all
sudo apt-get install pkg-config libtool intltool libgtkglext1-dev g++ gcc flex bison glade libglade2-dev make git-core gdb automake1.9
OK, you've gotten everything installed needed to compile megatunix from source or Git.
Downloading and compiling a MegaTunix tarball
Run the Firefox browser and go to http://sourceforge.net/projects/megatunix scroll down and download the latest version (0.9.23 is up there now as of this writing)
Firefox will ask you if you want to open the file with an application or to Save to Disk. Select "Save to disk". Firefox by default puts everything on your desktop, so in that same terminal run
Code: Select all
cd ~/Desktop
If you do an "ls" (list files, equal to "dir" on DOS/windows) you should see
Code: Select all
megatunix-0.x.y.tar.gz
Code: Select all
tar xvzf megatunix-x.y.z.tar.gz
"cd" (change directory) into the megatunix dir,
Code: Select all
cd megatunix-0.<TAB> then <ENTER>
Code: Select all
./configure ; make
Code: Select all
sudo make install
Code: Select all
sudo ldconfig
END of procedure for users NOT wanting to use Git
Downloading and compiling MegaTunix from Git
To get a copy from Git run these commands:
Code: Select all
cd
mkdir git
cd git
Anonymous Git procedure below:
Code: Select all
git clone git://github.com/djandruczyk/MegaTunix.git
Code: Select all
cd ~/git/MegaTunix
./autogen.sh
make
Code: Select all
sudo make install
Code: Select all
sudo ldconfig
Now, if you want to keep up to date with changes as I commit them in between releases, that's even easier..
just cd into the MegaTunix directory:
Code: Select all
cd ~/git/MegaTunix
Code: Select all
git pull
then rebuild;
Code: Select all
./autogen.sh ; make clean ; make ; sudo make install ; sudo ldconfig
And you're up to date and running on the bleeding edge
To run MegaTunix, you should be able to run "megatunix" from any open terminal, or you can create a new icon (or launcher) on the desktop, though having it run from a terminal will show you output that might otherwise not be visible.
It sounds long and hard but in practice it really isn't.
NOTE about serial ports:
Under linux (and most unix's in general) all device drivers are accessed through "files" (In Unix/Linux basically EVERYTHING is a file) in a directory called /dev (or /devices on sun) Serial ports are known typically as /dev/ttySx with x being a number starting from 0 and going up. (/dev/ttyS0 = COM1 on windows, /dev/ttyS1 is COM2 and so on) For those of you with USB to serial adapters, they are usually named a little bit differently, typically /dev/ttyUSBx with x starting and 0 and going up. On MAC OS-X there tends to be multiple devices per serial port (because OS-X is based on the BSD codebase), /dev/ttyS's and /dev/cuax's. In megatunix's case you want the cua device instead of the tty one as some users have reported that the cua one worked but the tty one did NOT as the CUA one is a "raw callout device" and not just a text device (like os-X consider's some of it's tty's to be)
So, in megatunix the first thing most users need to change is the serial port, and that's on the "General" tab. The text will change from to red when you've made a change but NOT committed it (gotta hit enter to make megatunix try that device, notice the status messages below that box as it'll say if the device could be opened or not. Watch the titlebar for feedback as well. If you found an open port but no ECU, make sure that your ECU is powered up, and that you're actually using the right port (many computers have two serial ports), so try the other one just in case..
Enjoy!
David J. Andruczyk
MegaTunix Author
Updated 05/19/2012