mirror of https://github.com/erjiang/usbscale
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
65 lines
2.6 KiB
Markdown
65 lines
2.6 KiB
Markdown
usbscale
|
|
========
|
|
|
|
**Usbscale** is a program that reads weight data from a USB scale. Compilation
|
|
is very simple and should work on any system with libusb-1.0 and gcc.
|
|
|
|
[![ko-fi](https://www.ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/O5O51UXOI)
|
|
|
|
Installation
|
|
------------
|
|
|
|
You will need the development headers for **libusb-1.0**. Once you have that,
|
|
you simply need to run `make` in the source directory. If you get a "permission
|
|
denied" error when running usbscale, you may need to configure **udev** on your
|
|
system to give permission to use the scale. The file **50-usb-scale.rules**
|
|
contains a sample udev rule file that should be placed in `/etc/udev/rules.d/`.
|
|
|
|
Usage
|
|
-----
|
|
|
|
Simply run `usbscale` and it will automatically report on the first USB scale
|
|
that it finds. The weight will be output to `stdout`, while any diagnostic or
|
|
error messages will be sent to `stderr`. An exit code of 0 means that a scale
|
|
was found and a weight was successfully read. Any other error code indicates
|
|
that a weight reading was unavailable.
|
|
|
|
## Zeroing the scale
|
|
|
|
There is somewhat-experimental support for sending a tare command to the scale.
|
|
You can invoke it by running `usbscale zero`. Not all scales seem to do the
|
|
right thing when they receive this command, but please let us know whether your
|
|
scale works in the GitHub issues.
|
|
|
|
Adding support for more scales
|
|
------------------------------
|
|
|
|
By default, **usbscale** only supports a very limited number of USB scales. It
|
|
does not search for just any USB scale, but only those listed in **scales.h**.
|
|
To add support for another USB scale, it should be enough to add its vendor and
|
|
product IDs to **scales.h**. In any case, you should contact me (see below) so
|
|
that I can add your new scale to the main source code to benefit all users who
|
|
may have the same scale.
|
|
|
|
License
|
|
-------
|
|
|
|
The license for **usbscale** is the GPLv3, whose full text can be found in the
|
|
file `COPYING`. This means that you can reproduce and redistribute this
|
|
software, as long as you provide any and all modifications that you have made
|
|
to the software available under the same license. Notably, you may not
|
|
integrate this software into another product without making the whole product
|
|
open source. This paragraph is not definitive; please read the license
|
|
carefully.
|
|
|
|
Additional licensing terms may be negotiable.
|
|
|
|
Contact
|
|
-------
|
|
|
|
If you have a code-related issue (bugs, patches, etc.), then you can create an
|
|
issue on the [usbscale Github repo][]. Otherwise, the best way to contact me is
|
|
by sending mail to erjiang at alumni-iu-edu.
|
|
|
|
[usbscale Github repo]: https://github.com/erjiang/usbscale
|