diff options
Diffstat (limited to 'readme-mac.txt')
| -rw-r--r-- | readme-mac.txt | 100 |
1 files changed, 100 insertions, 0 deletions
diff --git a/readme-mac.txt b/readme-mac.txt new file mode 100644 index 0000000..89a5fd4 --- /dev/null +++ b/readme-mac.txt @@ -0,0 +1,100 @@ +requirements +------------ +No extra software is required. + + +who/what/where +-------------- +clewarecontrol is written by Folkert van Heusden. +It is specifically meant to control Cleware devices from within MacOS X. +Please do NOT contact cleware if you have problems with this software on your +Mac, contact me instead at: mail@vanheusden.com +Please note that I'm a busy man so it may take a bit before I respond. + + +usage +----- +Clewarecontrol is a command-line program. You can run it from within e.g. the +"terminal"-program. + +To see a list of options, invoke: + clewarecontrol -h + +To, for example, see a list of all Cleware devices connected to your mac, run: + clewarecontrol -l + +Please also check the website for tips and help. + + +devices +------- +- temperature sensor + clewarecontrol -rt + +- humidity sensor + This device needs to be "started" first, then you can read sensor readings + clewarecontrol -ag -rh + +- 2 channel AD converter (analog to digital) + First you need to know what it range it works: 5v, 13v or 24v + then you must select the channel to read from - the device has 2 channels + after selecting the channel, you can keep reading + clewarecontrol -ai x where x is 0 or 1 (selects channel) + clewarecontrol -ra y where y is 0 voor 5v, 1 for 13v, etc. + +- Ampel ("Switch1 (8)") + The traffic light is, from clewarecontrol seen, a device with 3 switches in + it that can be individiually switched on and off + clewarecontrol -as x y where x is 0, 1 or 2 (0=red, 2=green) and + y is 0 or 1 (0 is off) + +- IO16 ("Contact 00 device (48)") + The IO16 is a 16 port I/O interface. You can configure each pin to be either + input or output. This setting is stored in an eprom so that a pin cannot + become accidently output while you expected an input. + Set the direction with: + clewarecontrol -ad x where x is a hex value representing a 1 + or 0 selecting the direction + After that you can set the output pins to 1 or 0 with: + clewarecontrol -am x where is a hex value + +- Luminus + This is in fact an AD converter with integrated hardware which measures the + amount of light. It has 1 chnanel, so you don't need to select it (like the + generic ADC). Reading values (in version 2.5) can be perfomed like his: + clewarecontrol -ra 0 + This gives a value between 0 and 5. I (developer of this Linux program) + need to buy a lux meter to scale this correctly. + + +- USB-cutter + This is a device which is at its heart a switch like the other switches. + To use it, you need to start it: + clewarecontrol -ag + then, you can toggle the USB status like this: + clewarecontrol -as 0 1 this will "cut" the USB device (switching + it off) + clewarecontrol -as 0 0 this will enable the USB device again(!) + indeed, the logic is inverted. + + +-mintrig / -maxtrig +------------------- +Run the program with -c 0 so that it keeps running forever (unless you want to +have it monitor the value for a shorter time). +Also start it with -F so that it runs in the background. +Then set the -mintrig or -maxtrig switches. +As the last parameter, set the sensor to monitor: -rh (humidity), -rt +(temperature), etc. +For example: + clewarecontrol -c 0 -maxtrig 0.5 ./myscript.sh -ra 0 +If the ADC tells us that the voltage is over 0.5 volts, then "myscript.sh" is +invoked. As a parameter, the script will get the measured value. + + +miscellaneous +------------- +I would be delighted if you share your experiences with me! + +Please note: this software contains "hidapi". The original hidapi can be +retrieved from http://www.signal11.us/oss/hidapi/ |