Setting up JXM

FreeBSD is the 2nd easiest platform for JXM (second only to the Mac).

  1. If you don't have one already, you need to go buy an XM PCR.
  2. You should be running 4.10-RELEASE or newer.
  3. As root, kldload uftdi.ko.
  4. Using the ports tree, install a native JRE of at least 1.4. At the moment, the only choice is java/jdk14.
  5. Using the ports tree, install comms/java-commapi.
  6. Using the ports tree, install comms/java-commapi-freebsd. NOTE: at the moment there is a bug in the java-commapi-freebsd port that causes it to not recognize /dev/ucom devices under FreeBSD 5.x. The fix is to patch the device prefix list in one of the java classes.
  7. Using the ports tree, install audio/jxm.
  8. Plug in your XM PCR antenna and aim it towards the satellites. Plug a pair of powered speakers into the line-out jack and connect a USB cable directly from a USB port on your machine to the XM PCR (see the FAQ for why USB hubs aren't recommended).
  9. Make sure you have read/write permissions on the PCR device. Usually, the easiest way to do this is to add yourself to the 'dialer' group.
  10. Run jxm. This is a shell script the port installed in ${PREFIX}/bin.
  11. Open the preferences. In the device tab, you should see the "Pick device" menu. Select the XMPCR device from the list. It is probably the only one that starts with either "/dev/ttyU" or "/dev/ucom". Click "OK".
  12. Click the 'power' checkbox.
  13. That should be it. You should hear the XM preview channel come out of the speakers. If so, then you're done!
If you're running FreeBSD 5.x and you get complaints about IPv6 and mapped IPv4 addresses when you perform network I/O, then as root type sysctl -w net.inet6.ip6.v6only=0.

If you're having trouble, the best place to turn for help is the XM411 software support forum.