COOL OSX HACKS
 
 

 

Here are some hacks that we worked out in OSX. Hopefully some of you may find them handy too!

Fax setup for a Non-Apple Modem
(serial or USB) - for 10.3-10.4 (below) & 10.5.

We wanted to get a serial, then a USB modemworking with the OS X built in Fax software. The problem is that OS X will only reconize a Apple built in modem that has OS X drivers. We have a G4 with a Steath Serial Port hooked up to an USR Courier modem, and later moved to a Best Data USB modem. This technique should also work with a serial modem hooked up though a "USB to Serial" adaptor such as the Keyspan variety, or directly with USB.

Requirements:

. Knolledge of unix command line.
. The "Terminal" application.
. Editor such as "vi".

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

For OS X 10.5 (1/9/2008)

STEP BY STEP:

. First install the appropriate serial driver for the device (if applicable), in our first case, the Stealth Serial driver for OS X 10.5. Note: USB modems should just show up.
. Launch the Terminal application and do a

ls -l /dev/cu.*

This gives you a list of the serial and USB modem devices. You should see a line like:

crw-rw-rw- 2 root wheel 8, 1 22 Dec 18:53 /dev/cu.serial

or for example the "Best Data 56K USB Modem":

crw-rw-rw- 2 root wheel 8, 1 22 Dec 18:53 /dev/cu.usbmodem3a10

. For the Stealth serial we see an item named "cu.serial". For a Keyspan USB -> Serial adaptor you may see something like "cu.USA19181P1.1". For USB we see "cu.usbmodem3a10". This is the driver for the device. NOTE: if you change the USB port that the modem/adaptor is plugged into, it will change the numbers on the end (e.g. 3a10) and you will have to reconfigure.

. In Terminal, enter super-user mode:

sudo -s

. It will ask you for your password. Next you need to edit the "efax.rc" file. We need to add two lines. Note: it is case sensitive! Also note, due to permissions issues, we use "vi", which is a built-in Unix text editor. Although we cannot attempt to try and explain all the commands of vi, we will try to let you know enough to edit the file. If you get stuck, type ":q!" (without quotes) to exit without saving changes.

vi /etc/efax.rc

. This will open the file and display the document in the terminal window. Use the "down arrow" key until you are on the line "VCMD=". Next hit the Capital letter "O" (Ooh, not zero). This will put you in edit mode, on the next line. Now enter the next two lines.

DEV=cu.usbmodem3a10
DEVANSWER=tty.usbmodem3a10

. Where you enter the "cu." and "tty." of your device that you discovered above. After you've entered them, hit the ESC key once.

ESC

This will take you out of edit mode. Now type

:wq

That is the colon and wq (":wq" with no spaces). This will write the file and bring you back to the termial mode.

. Now you are done with Terminal, so you can quit out of it.

. Just go into the System Preferences -> Print & Fax. Add your fax modem, configure settings and you should be good to go and are done! If you cannot get the modem to show up then do the following:

Add the fax manually using cups:

. Launch Safari or Firefox.

In the URL enter: http://localhost:631
Click the "Add Printer" button.
Name: Fax
(and enter a Location and Description or leave blank)
Click Continue
Select Device: Fax Printer(fax)
Click Continue
Enter Device URI: fax://dev/cu.usbmodem
(with extension if applicable (e.g. fax://dev/cu.usbmodem3a10)
Click Continue
Click on the Choose File button to Provide a PPD file.
Navigate to: (harddrive) -> System -> Library -> Frameworks -> ApplicationServices.frameworks -> Frameworks -> PrintCore.frameworks ->Resources -> English.lproj -> Fax.ppd
(or appropriate language if not English)
Click Add Printer

When asked for a username and password, enter your username and password. It
should report that the printer was added successfully. Close Safari and open System
Preferences -> Print & Fax Your fax printer should now appear there. You can now
configure the fax settings there.

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

For OS X 10.3 or 10.4 (updated 4/25/2005)

STEP BY STEP:

. First install the appropriate serial driver for the device (if applicable), in our first case, the Stealth Serial driver for OS X 10.3. Note: USB modems should just show up.
. Launch the Terminal application and do a

ls -l /dev/cu.*

This gives you a list of the serial and USB modem devices. You should see a line like:

crw-rw-rw- 2 root wheel 8, 1 22 Dec 18:53 /dev/cu.serial

or for example the "Best Data 56K USB Modem":

crw-rw-rw- 2 root wheel 8, 1 22 Dec 18:53 /dev/cu.usbmodem091

. For the Stealth serial we see an item named "cu.serial". For a Keyspan USB -> Serial adaptor you may see something like "cu.USA19181P1.1". For USB we see "cu.usbmodem091". This is the driver for the device. We need to make "links" (alias) to this device called "cu.modem" and "tty.modem". Since devices such as these are dynamic, and re-loaded at startup, it will be necessary to add this link at every startup. We wrote a little script that you can modify and put in you system, for this purpose, since it is run when we boot the machine.

faxsetup.dmg (download me)

. Now back in the Finder, you must first edit the script by dragging the "FaxSetup" file onto "TextEdit" (which is in your Applications folder). You will see the following text:

#!/bin/sh

ln -s /dev/cu.usbmodem091 /dev/cu.modem
ln -s /dev/tty.usbmodem091 /dev/tty.modem

You must now change the "usbmodem091" to the string that you determined in the section above.

. Now you need to move the folder into the "Startupitems" folder. It is located:

(Harddrive) -> System -> Library -> Startupitems

It will ask you for your password, enter that so it copies the folder.

. Now go back to Terminal and enter super-user mode:

sudo -s

It will ask you for your password. Next you must navigate to the "Startupitems" folder from Terminal. We need to set the proper 'owner' so that the system will execute the file when booted.

cd /System/Library/StartupItems/FaxSetup

chown -R root:wheel FaxSetup

. Now you are done with Terminal, so you can quit out of it.

. Next we need to assign the faxmodem for the system. Open the "System Preferences" panel and choose "Print & Fax". Select the "Printing" tab and hit the button for "Setup Printers" (or "Printer Setup" in Tiger).

. *** For Panther, Hold down the "option" key and click on the "Add" button. Choose the "Advanced" option from the bottom of the pulldown menu. In "Device" choose "Fax Printer (fax)".

. *** For Tiger, Click the "Add" button. In the "Printer Browser" window, hold down the "option" key and click on the "More Printers" button. Choose the "Advanced" option from the bottom of the pulldown menu. In "Device" choose "Fax Printer (fax)".

. In the "Device URl:" type:

fax://dev/cu.modem

Under "Printer Model" select "Other". Now for the fun part. You must select the "fax.ppd" which is located at:

(harddrive) -> System -> Library -> Frameworks -> ApplicationServices.frameworks -> Versions -> A -> Frameworks -> PrintCore.frameworks -> Versions -> A -> Resources -> English.lproj

Or if your language is not English, select the appropriate .lproj folder.

Click "Add". You should now be able to see it in the "Fax List" (View -> Show Fax List). Close the Printer Setup program. Go back to the "System Preferences" and in the Print & Fax, select the "Receive faxes on this computer".

. Reboot. The fax should now be working.

To verify this you can look at the"Activity Monitor" (Applications -> Utilities) and look at the "Administrator Processes" and you should see an item called "Efax". If this is there, you should be all set.

367 efax root 0.00 1 388.00 KB 17.80 MB

Good luck and happy faxing!