Installing APRSIS32 on Puppy Linux...on a USB Stick.
First step is to download Puppy Linux.
Puppy is sponsored for download on ibiblio.org. You can download it here.
If you don't want to burn to a standard CD, use a CD-RW. There are several image burning softwares out there. From Windows, Imgburn is a good, free software that will work well and can be downloaded here.
Once you have the image file burnt to the CD, insert the disc into your cd drive and boot the machine. If you don't have your computer set to boot on CD, catch on the inital screen and press the appropriate keey to change the boot process. On most Dell machines, that is F12. Select the CD Drive and continue booting.
You can select as small as 2GB USB stick to do this project. You can use a 1GB stick if needed. I chose 2GB because of mapping. Make sure you have backed up or saved any files that you may have on the stick. You can format the stick right here in Puppy.
From the main screen, insert a USB Stick into the port. On the Desktop, you will see an icon pop up. That is your stick you just put in. Below the icon, you will see something like sdb1 sdb2 or sdc1...depending on any previous usb drives that may have already been recognized. Remember this drive as it will be the drive you will write to for creating your USB Puppy bootable stick.
RIGHT CLICK ANYWHERE IN THE OPEN DESKTOP.
A menu will drop down. Scroll down to "Setup". Scroll down to Puppy Universal Installer. On the next screen, It will ask you if you want to install Puppy to a Removable Media. First one highlighted on the list should be USB Flash drive. Click OK to go to the next screen. Your USB drive should be listed. Select the proper drive, and MAKE SURE YOU SELECT THE CORRECT DRIVE OR YOU COULD ERASE ANOTHER DRIVE CONNECTED AND THAT DATA CANNOT BE RETRIEVED!
Next, select the top icon, asking you to install Puppy to sd** (whichever drive you have previously selected. Click Okay on the next screen. If you are running Puppy from the CD, on the next screen, select the CD option. The CD should still be in your drive, click next on the following screen.
The next screen asks you about the MBR. I have selected mbr.bin as recommended by the instructions. I have not had any problems with booting using this option.
Next screen defaults to Just Keep Going. If you have a problem booting your stick, you will have to get back to this point, and select one of the other options listed. I can tell you, Gparted is easy to use, but dangerous too. If you get back to this point and have to use Gparted, under devices, you need to select the proper drive that was previously identified.
If you select the Gparted option, a new window will open up. Click okay on the first window. It is telling you that once you're done using Gparted, it will return you to the Puppy Universal Installer.
On Gparted, on the upper left hand, drop Gparted down and select devices and the previously recognized USB drive. Where your device is listed in the graphic (/dev/sd**), right click on the drive. A drop down menu will open. Select Format to and select FAT 32. At the top, select apply. Once it is finished formatting, right click on the drive again and selece manage flags. Select the Boot flag. Then click close.
At this point, your next window opening up will be back in the Puppy Universal Installer program. Press enter to acknowledge the prompt.
If you wish to remove all files from the drive, press any alpha numeric key and continue, otherwise, just press enter to continue.
Next window will ask if you want to boot into ram. If you have a computer with greater than 256 MB, select any alpha numeric key and continue, otherwise press enter.
The next prompt you get should be "Finished. You should have a bootable USB Key.
Rightclick anywhere on the open desktop and select Shutdown, Power off. At the prompt, asking to save, select NO.
Now, boot your computer with the stick installed. You may have to press the F12 Key again to select USB drive to boot (if that is the key to select boot process, otherwise, you will have to change your bios settings to boot to the USB stick.
Once you get to the main screen of Puppy, the first prompted window will have you set your clock and screen resolution. Make those changes and click OK.
Next window should pop up, asking you to restart, click yes and the screen will go black and back right up to where you just were.
If you do not get the next window asking for your internet, click on the "Connect" button on the left. You will have several buttons to choose from, ETH0, WLAN or Windows. ETH0 is if you have an ethernet connection. WLAN is for your wireless card. If your wireless card doesn't work, you can try the Windows button and load the driver necessary to run your card. Personally, I have not had to venture to load any windows drivers to make my wireless card work. With the latest versions of Puppy, they have been more than capable of recognizing your card and getting you connected.
Once you have connection, your next step is to install WINE. From the main screen, click on "QuickPet" button. On the next screen, you will see the Wine link. You will get another window that comes up. Scroll down and select the Wine 1.3.13 version.
You will have a prompt for gecko installation, accept it. A control panel window will eventually pop up, accept it as well.
Once it is loaded, you should be back at the desktop window where in the upper left corner, an icon labeled "File" is listed. Click on it and you will see the folders. In the menu bar are other icons. Click on the "eyeball" to show the hidden files. Scroll down the list and locate the file folder ".wine".
Navigate to drive_c/Program Files.
Under there, create a folder of your desire. I named mine APRSIS32. Place the APRSIS32.exe file here.
At this point, you want to save all of the work you've donu thus far. Right click anywhere on the open desktop and navigate to the Shutdown option and shutdown. The mouse will not work for this portion, all keyboard and/or arrows. The first window will ask you if you want to save. Save to File.
Next window, you should see a line with your stick drive listed. (e.g. sdc1,sdb1...). Make sure you select the correct one if more than one is listed. Press enter to continue.
Next choose file system. You have ext2 or ext3. Your choice. ext 3 is supposed to give you better recover if power is lost.
Next, give your file a name. Press enter.
Next, you have the option for diverent levels of encryption. Normal encryption doesn't require password. Any other level you choose will require you to input a password when you boot. Your choice. Press enter.
It will take a bit to create this file. Once everything is done, it should be complete and will shut down.
Booting Back Up.
Boot back up to the key. You should now have a bootable Puppy USB stick with APRSIS32 installed.
Click on the "File" icon in the upper left hand corner of the Desktop. Click on the "eyeball" to see hidden files and navigate to the .wine folder. Continue navigating to drive_c/Program Files/APRSIS32.
At the top of THIS webpage, you can right click and save the picture as an icon file (aprsis32.ico) to the folder where the APRSIS32.exe file is located (/root/.wine/drive_c/Program Files/APRSIS32). Right click on the executable file and navigate to "set icon". Drag and drop that icon file you just saved into the window as instructed. For ease of operation, you can create a link to your program on the desktop. Left click and drag the APRSIS32.exe to an open space in the desktop and let go. This will create a link to the program for ease in starting.
Port Settings
Two things need to happen.
1)
On the Desktop, click on console. Through the terminal, you can create your symbolic link to ports.
Code
ttyS0 is for com1. ttyS1 is for com2 and so on. If you are using a serial to USB adapter, change your /dev/ttyS0 to /dev/ttyUSB0.
You can confirm what port is being consumed.
Code
You have to be careful with USB adapters. If you reboot or lose power and it reboots, the assignment of the adapter may change and then render your port non-functional.
2)
A small change needs to occur to the registry in order for APRSIS32 to recognize com ports, even with the above sym link in place. The following information is provided from wine-wiki.org. http://wiki.jswindle.com/index.php/Wine_Registry#Serial_Com_Port
Open system.reg under the .wine directory. Under #arch=win32, add the following information:
[HARDWARE\\DEVICEMAP\\SERIALCOMM]
"COM1"="COM1"
"COM2"="COM2"
Save your file!
Reboot Puppy and initiate APRSIS32. You should be able to navigate, setting up ports as necessary. If you need additional com ports, add them as previously mentioned.
If you don't want to burn to a standard CD, use a CD-RW. There are several image burning softwares out there. From Windows, Imgburn is a good, free software that will work well and can be downloaded here.
Once you have the image file burnt to the CD, insert the disc into your cd drive and boot the machine. If you don't have your computer set to boot on CD, catch on the inital screen and press the appropriate keey to change the boot process. On most Dell machines, that is F12. Select the CD Drive and continue booting.
You can select as small as 2GB USB stick to do this project. You can use a 1GB stick if needed. I chose 2GB because of mapping. Make sure you have backed up or saved any files that you may have on the stick. You can format the stick right here in Puppy.
From the main screen, insert a USB Stick into the port. On the Desktop, you will see an icon pop up. That is your stick you just put in. Below the icon, you will see something like sdb1 sdb2 or sdc1...depending on any previous usb drives that may have already been recognized. Remember this drive as it will be the drive you will write to for creating your USB Puppy bootable stick.
RIGHT CLICK ANYWHERE IN THE OPEN DESKTOP.
A menu will drop down. Scroll down to "Setup". Scroll down to Puppy Universal Installer. On the next screen, It will ask you if you want to install Puppy to a Removable Media. First one highlighted on the list should be USB Flash drive. Click OK to go to the next screen. Your USB drive should be listed. Select the proper drive, and MAKE SURE YOU SELECT THE CORRECT DRIVE OR YOU COULD ERASE ANOTHER DRIVE CONNECTED AND THAT DATA CANNOT BE RETRIEVED!
Next, select the top icon, asking you to install Puppy to sd** (whichever drive you have previously selected. Click Okay on the next screen. If you are running Puppy from the CD, on the next screen, select the CD option. The CD should still be in your drive, click next on the following screen.
The next screen asks you about the MBR. I have selected mbr.bin as recommended by the instructions. I have not had any problems with booting using this option.
Next screen defaults to Just Keep Going. If you have a problem booting your stick, you will have to get back to this point, and select one of the other options listed. I can tell you, Gparted is easy to use, but dangerous too. If you get back to this point and have to use Gparted, under devices, you need to select the proper drive that was previously identified.
If you select the Gparted option, a new window will open up. Click okay on the first window. It is telling you that once you're done using Gparted, it will return you to the Puppy Universal Installer.
On Gparted, on the upper left hand, drop Gparted down and select devices and the previously recognized USB drive. Where your device is listed in the graphic (/dev/sd**), right click on the drive. A drop down menu will open. Select Format to and select FAT 32. At the top, select apply. Once it is finished formatting, right click on the drive again and selece manage flags. Select the Boot flag. Then click close.
At this point, your next window opening up will be back in the Puppy Universal Installer program. Press enter to acknowledge the prompt.
If you wish to remove all files from the drive, press any alpha numeric key and continue, otherwise, just press enter to continue.
Next window will ask if you want to boot into ram. If you have a computer with greater than 256 MB, select any alpha numeric key and continue, otherwise press enter.
The next prompt you get should be "Finished. You should have a bootable USB Key.
Rightclick anywhere on the open desktop and select Shutdown, Power off. At the prompt, asking to save, select NO.
Now, boot your computer with the stick installed. You may have to press the F12 Key again to select USB drive to boot (if that is the key to select boot process, otherwise, you will have to change your bios settings to boot to the USB stick.
Once you get to the main screen of Puppy, the first prompted window will have you set your clock and screen resolution. Make those changes and click OK.
Next window should pop up, asking you to restart, click yes and the screen will go black and back right up to where you just were.
If you do not get the next window asking for your internet, click on the "Connect" button on the left. You will have several buttons to choose from, ETH0, WLAN or Windows. ETH0 is if you have an ethernet connection. WLAN is for your wireless card. If your wireless card doesn't work, you can try the Windows button and load the driver necessary to run your card. Personally, I have not had to venture to load any windows drivers to make my wireless card work. With the latest versions of Puppy, they have been more than capable of recognizing your card and getting you connected.
Once you have connection, your next step is to install WINE. From the main screen, click on "QuickPet" button. On the next screen, you will see the Wine link. You will get another window that comes up. Scroll down and select the Wine 1.3.13 version.
You will have a prompt for gecko installation, accept it. A control panel window will eventually pop up, accept it as well.
Once it is loaded, you should be back at the desktop window where in the upper left corner, an icon labeled "File" is listed. Click on it and you will see the folders. In the menu bar are other icons. Click on the "eyeball" to show the hidden files. Scroll down the list and locate the file folder ".wine".
Navigate to drive_c/Program Files.
Under there, create a folder of your desire. I named mine APRSIS32. Place the APRSIS32.exe file here.
At this point, you want to save all of the work you've donu thus far. Right click anywhere on the open desktop and navigate to the Shutdown option and shutdown. The mouse will not work for this portion, all keyboard and/or arrows. The first window will ask you if you want to save. Save to File.
Next window, you should see a line with your stick drive listed. (e.g. sdc1,sdb1...). Make sure you select the correct one if more than one is listed. Press enter to continue.
Next choose file system. You have ext2 or ext3. Your choice. ext 3 is supposed to give you better recover if power is lost.
Next, give your file a name. Press enter.
Next, you have the option for diverent levels of encryption. Normal encryption doesn't require password. Any other level you choose will require you to input a password when you boot. Your choice. Press enter.
It will take a bit to create this file. Once everything is done, it should be complete and will shut down.
Booting Back Up.
Boot back up to the key. You should now have a bootable Puppy USB stick with APRSIS32 installed.
Click on the "File" icon in the upper left hand corner of the Desktop. Click on the "eyeball" to see hidden files and navigate to the .wine folder. Continue navigating to drive_c/Program Files/APRSIS32.
At the top of THIS webpage, you can right click and save the picture as an icon file (aprsis32.ico) to the folder where the APRSIS32.exe file is located (/root/.wine/drive_c/Program Files/APRSIS32). Right click on the executable file and navigate to "set icon". Drag and drop that icon file you just saved into the window as instructed. For ease of operation, you can create a link to your program on the desktop. Left click and drag the APRSIS32.exe to an open space in the desktop and let go. This will create a link to the program for ease in starting.
Port Settings
Two things need to happen.
1)
On the Desktop, click on console. Through the terminal, you can create your symbolic link to ports.
Code
ln -s /dev/ttyS0
/root/.wine/dosdevices/com1 |
ttyS0 is for com1. ttyS1 is for com2 and so on. If you are using a serial to USB adapter, change your /dev/ttyS0 to /dev/ttyUSB0.
You can confirm what port is being consumed.
Code
dmesg | grep USB |
You have to be careful with USB adapters. If you reboot or lose power and it reboots, the assignment of the adapter may change and then render your port non-functional.
2)
A small change needs to occur to the registry in order for APRSIS32 to recognize com ports, even with the above sym link in place. The following information is provided from wine-wiki.org. http://wiki.jswindle.com/index.php/Wine_Registry#Serial_Com_Port
Open system.reg under the .wine directory. Under #arch=win32, add the following information:
[HARDWARE\\DEVICEMAP\\SERIALCOMM]
"COM1"="COM1"
"COM2"="COM2"
Save your file!
Reboot Puppy and initiate APRSIS32. You should be able to navigate, setting up ports as necessary. If you need additional com ports, add them as previously mentioned.