File	Date	Author	Commit
iMon Helper.xcodeproj	2013-02-23	Eric Pooch	[19701f] README updates
iMon_LCDproc_Helper	2013-02-23	Eric Pooch	[1f9def] Xcode 4.6 and 64 bit
.gitignore	2013-02-18	Eric Pooch	[e87156] Initial Commit
Active_Remote_Script.scpt	2013-02-18	Eric Pooch	[e87156] Initial Commit
README.rtf	2013-02-23	Eric Pooch	[5952c9] Reflect downloads
README.txt	2013-02-23	Eric Pooch	[5952c9] Reflect downloads
iMon Helper.1	2013-02-18	Eric Pooch	[e87156] Initial Commit
imon_helper.c	2013-02-23	Eric Pooch	[1a1994] Version consolidation

Read Me

{\rtf1\ansi\ansicpg1252\cocoartf1187\cocoasubrtf340
{\fonttbl\f0\fswiss\fcharset0 Helvetica;\f1\fmodern\fcharset0 CourierNewPSMT;}
{\colortbl;\red255\green255\blue255;\red12\green99\blue153;}
\vieww10800\viewh8400\viewkind0
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural\qc

\f0\b\fs24 \cf0 iMon_Helper\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\b0 \cf0 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\b \cf0 Requirements:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\b0 \cf0 Mac OS X running on a PPC or Intel processor 
\b \

\b0 LCDproc\
iMon LCD or VFD\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\b \cf0 Information:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\b0 \cf0 iMon_Helper is intended as a go-between to allow your Mac OS X installation of LCDProc to communicate with your iMon display.  Because it is installed a separate binary, you will not need special Mac OS X specific compilations of LCDproc or the iMon driver to take advantage of the features of your iMon display.  This will allow you to keep updated with the latest features of the iMon LCDproc driver.\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\b \cf0 Downloads:
\b0 \
\pard\pardeftab720

\fs26 \cf2 iMon_Helper_0.51.tgz 	-	PPC/32 bit Intel\
iMon_Helper_0.65.tgz	-	32/64 bit Intel
\fs24 \cf0 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural
\cf0 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\b \cf0 Installation:
\b0 \
A good install location would be:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f1 \cf0 /usr/local/bin/iMon_Helper\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f0 \cf0 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\b \cf0 Configuration:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\b0 \cf0 First, change the LCDproc driver path to the correct location.  If you have used 'make install', the correct path is likely:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f1 \cf0 DriverPath=/usr/local/lib/lcdproc/\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f0 \cf0 \
Next, make sure LCDproc is configured to use the correct display.  The LCDd.conf file must be edited for your environment.\
If you have a display that does not use the HID protocol, use:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f1 \cf0 Driver=imon\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f0 \cf0 Otherwise,  if you have a display that does use the HID protocol (there will likely be a small green sticker on the back of the display that says "HID" or white printing on the circuit board), use:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f1 \cf0 Driver=imonlcd\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f0 \cf0 When using the imonlcd driver you will also need to select the correct protocol.  New devices use:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f1 \cf0 Protocol=1\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f0 \cf0 Regardless of what driver you are using, you need to use the following setting:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f1 \cf0 Device=/dev/stdout
\f0 \
This sends the iMon commands from LCDproc to the standard output.\
\
You might also consider adding the following LCDproc [server] settings:\

\f1 ServerScreen=blank \
Backlight=on\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f0 \cf0 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\b \cf0 Testing the configuration:
\b0 \
Make sure LCDproc is loading correctly by first running the program from the command line like so (assuming the default installation location):\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f1 \cf0 /usr/local/sbin/LCDd\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f0 \cf0 \
You should see some unreadable output like:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f1 \cf0 X??? !"#$%&'()*+,-./0123456789:????;\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f0 \cf0 \
Terminate the program by running the command:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f1 \cf0 sudo killall LCDd\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f0 \cf0 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\b \cf0 Testing connection with iMon display:
\b0 \
Run the iMon_Helper program from the command line to see if it connects properly to the display like this (assuming installation in /usr/local/bin):\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f1 \cf0 /usr/local/bin/iMon_Helper\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f0 \cf0 You should see some connection information like:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f1 \cf0 Mac OS X iMON Helper: Found device matching ID:0x15c2/0x0038.\
Mac OS X iMON Helper: found interface: <IOUSBInterface>\
Mac OS X iMON Helper: found HID driver: <IOUSBHIDDriver>\
Mac OS X iMON Helper: Opened HID device.\
Mac OS X iMON Helper: found interface: <IOUSBInterface>\
Mac OS X iMON Helper: found HID driver: <IOUSBHIDDriver>\
Mac OS X iMON Helper: Opened HID device.\
Mac OS X iMON Helper: Reading data from stdin...
\f0 \
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\b \cf0 Running LCDproc with iMon_Helper:
\b0 \
To run LCDproc with the iMon_Helper you must pipe the output of LCDproc to iMon_Helper using a command such as:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f1 \cf0 /usr/local/sbin/LCDd | /usr/local/bin/iMon_Helper\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f0 \cf0 \
Note the "pipe" character ("|") which is shift-backslash on most keyboards.\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\b \cf0 Stopping LCDproc:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\b0 \cf0 You can terminate LCDproc from the command line using a command such as:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f1 \cf0 sudo killall LCDd\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f0 \cf0 \
iMon_Helper will notice that LCDproc has stopped and will automatically close the connection to the iMon display.\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\b \cf0 Using the Remote:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\b0 \cf0 The standard Apple HID drivers will allow most of the buttons on a HID device to function.  If you do not have a HID device, or you want to use the rest of the buttons, install the Active_Remote_Script.app in your Applications folder, or in your home folder.  Then, run iMon_Helper with the '-r' flag like so:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f1 \cf0 /usr/local/sbin/LCDd | /usr/local/bin/iMon_Helper -r\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural

\f0 \cf0 When iMon_Helper reads a remote button press, it passes it on to the AppleScript application bundle, which in turn passes it along to Remote Buddy (http://www.iospirit.com/products/remotebuddy/).  This is a slow process, but has the advantage of allowing the user to create their own remote functions by editing the  Active_Remote_Script.app script.  This script can edited to forward the button press to other programs as well.
\b \
\

\b0 \
Good luck!\
\
iMon_Helper is copyright (c) 2012 Eric Pooch.\
epooch@cox.net\
}