$ sctool
Usage: sctool command [command options...]
Options:
-h Show this message.
Commands:
boot Cause the device to reboot to bootloader
info Get device info
listen Listen for keypresses
read <output file> Read the current config from EEPROM
write <input file> Write the given file to EEPROM
$ scas <input file> <output file>
$ scdis <input file> <output file>
sctool
is a replacement for the original Soarer's converter tools.
I've also included versions of the original scas
and scdis
with some minor
improvements.
I've included the original documentation, but it can be dramatically
simplified. See below for instructions on how to use sctool
to update your
converter's configuration.
The original example configurations can be found in the configs directory.
- autoconf / automake / libtool
- hidapi
The bundled version of hidapi will be built if hidapi is not present.
See the LICENSE file for details. The bundled hidapi is distributed under its included BSD license.
NOTE: Be sure to pass --recursive
to git clone to include the hidapi
submodule, otherwise the build will fail.
Building sctools
is as simple as:
$ ./autogen.sh && make && make install
Note that you can pass arguments to configure
via autogen.sh. for
example:
$ ./autogen.sh --prefix=/usr --sysconfdir=/etc
On Linux, udev rules for the converter will also be installed in
$(sysconfdir)/udev/rules.d
which will give cause the converter to be
owned by the input
group, with permissions of 0660. Thus, you may
want to pass --sysconfdir=/etc
to configure.
The listen
command will output data in the following format, with the
keysym used by scas
between parenthesis.
rF0 r5A -28 (ENTER) u28
To update the configuration, just do the following:
$ scas my_config.sc my_config.bin
scas v1.10
No errors. Wrote: my_config.bin
$ sctool write my_config.bin
Soarer's Converter Tool v1.0
---- Write (54 bytes) ----
Device ready
54 / 54 bytes written
Transfer complete
Now, the new configuration should be applied.
-
For some reason, the
hidraw
variant of hidapi doesn't enumerate the device corresponding to the interface that thelisten
command uses. -
scdis
may be buggy with handling some macro blocks.