descriptionFS20 PCS linux/unix cli utilities
ownerMichael Gernoth
last changeSat, 29 Jun 2013 10:17:42 +0000 (12:17 +0200)
readme
This repository contains utilities to use the FS20 PCS from ELV on Linux/Unix by using libusb 1.0.

The FS20 PCS can be used to send FS20 commands to different home automation devices (like remote controllable sockets).

Syntax: fs20pcs options

Possible options:
        -V              request firmware-version
        -x              abort sending long press
        -h [ELV|hex]    housecode in ELV- or hex-notation
The following options need an housecode:
        -a [ELV|hex]    destination address
        -s [hex|alias]  send command byte
        -e [hex|time]   extension byte for command or time in seconds (e.g. 10s)
        -r n            repeat sending n times

Command bytes (without extension byte):
hex             alias   description
0x00            off     switch off
0x01-0x10               switch on dimmed (0x01: 6.25%, 0x02: 12.5%, ..., 0x10: 100%)
0x11            on      switch on
0x12            toggle  toggle
0x13            dimup   dimup
0x14            dimdown dimdown
0x15                    dimup, pause, dimdown, pause, ...
0x16                    start/stop programming internal timer
0x17                    learn housecode/address
0x18                    off for internal timer, then back on with current level
0x19                    on (100%) for internal timer, then off
0x1a                    on (old level) for internal timer, then off
0x1b                    factory reset
0x1e                    on (100%) for internal timer, then old level
0x1f                    on (old level) for internal timer, then old state

Command bytes (with timer as extension byte):
hex             alias   description
0x20                    dim down to off while timer is running
0x21-0x30               dim to (0x01: 6.25%, 0x02: 12.5%, ..., 0x10: 100%) while timer is running
0x31                    dim to last level while timer is running
0x32                    dim to off, then after timer dim to off
0x33                    dimup now and switch off after timer
0x34                    dimdown now and switch off after timer
0x35                    dimup or dimdown (toggle) and switch off after timer
0x36                    program internal timer
0x38                    off for timer, then back on with current level
0x39    on-for-timer    on (100%) for timer, then off
0x3a                    on (old level) for timer, then off
0x3c                    program internal ramp-up-time
0x3d                    program internal ramp-down-time
0x3e                    on (100%) for timer, then old level
0x3f                    on (old level) for timer, then old state

Prebuilt package for OpenWRT (ar71xx): fs20pcs_1_ar71xx.ipk
shortlog
2013-06-29 Michael Gernothadd license master
2013-06-12 Michael Gernothfix linker parameter order
2013-05-19 Michael Gernothhigh nibble might not exceed 12
2013-05-19 Michael Gernothparse fractions and use absolute difference in calculation
2013-05-19 Michael Gernothparse time in extensionbyte
2013-05-19 Michael Gernothadd humamn readable command-aliases
2013-05-18 Michael Gernothmore help fixes
2013-05-18 Michael Gernothparse ELV address, too
2013-05-18 Michael Gernothfix help output
2013-05-18 Michael Gernothcommandline parsing
2013-05-18 Michael Gernothudev rules
2013-05-14 Michael Gernothparse fs20pcs-response
2013-04-20 Michael GernothFS20 PCS protocol description
2013-04-20 Michael GernothOpenWrt Makefile
2013-04-20 Michael Gernothfs20pcs utility using libusb to send FS20 commands...
heads
4 years ago master