{"id":21861518,"url":"https://github.com/raleighlittles/uss-dbs-driver","last_synced_at":"2025-03-21T20:19:02.701Z","repository":{"id":117726807,"uuid":"536432995","full_name":"raleighlittles/USS-DBS-Driver","owner":"raleighlittles","description":"A Linux keyboard driver for the US Solid Precision Balance scales (USS-DBS28-30)","archived":false,"fork":false,"pushed_at":"2022-10-01T05:59:08.000Z","size":8956,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-26T14:52:17.985Z","etag":null,"topics":["rs232","uinput","us-solid-precision-balance-scale","uss-dbs28-30","weighing-scales"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/raleighlittles.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["raleighlittles"],"custom":["paypal.me/raleighlittles"]}},"created_at":"2022-09-14T05:53:48.000Z","updated_at":"2022-10-02T22:40:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"c8f4bac2-54ec-445e-9b13-73274b4e6012","html_url":"https://github.com/raleighlittles/USS-DBS-Driver","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raleighlittles%2FUSS-DBS-Driver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raleighlittles%2FUSS-DBS-Driver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raleighlittles%2FUSS-DBS-Driver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raleighlittles%2FUSS-DBS-Driver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raleighlittles","download_url":"https://codeload.github.com/raleighlittles/USS-DBS-Driver/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244860600,"owners_count":20522466,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["rs232","uinput","us-solid-precision-balance-scale","uss-dbs28-30","weighing-scales"],"created_at":"2024-11-28T03:11:52.353Z","updated_at":"2025-03-21T20:19:02.667Z","avatar_url":"https://github.com/raleighlittles.png","language":"C++","funding_links":["https://github.com/sponsors/raleighlittles","paypal.me/raleighlittles"],"categories":[],"sub_categories":[],"readme":"![Picture of scale](./docs/scale-image.jpg)\n\n# Context\n\nI got my hands on a [semi-advanced weighing scale](https://ussolid.com/100-x-0-001g-analytical-balance-1-mg-digital-lab-precision-scale.html) but unfortunately, the 'UNIT' button (and part of the display) didn't work, so I couldn't change units on the device. To make things worse, I found out the scale didn't natively support milligrams. I wanted to see if I could use software to remedy these issues...\n\n# About\n\nThis program is a wrapper around the RS-232 interface implemented by the USS-DBS Digital Analytical Balance Scale. The scale transmits measurements via RS-232 through a USB B connector on the side. My program listens over the serial port to measurements received, and can:\n\n* convert them to any desired unit\n* log the measurements (and the time the measurement was received) to a CSV file\n* transmit the measurement as keyboard input via [`uinput`](https://kernel.org/doc/html/v4.12/input/uinput.html), i.e. which allow you to treat the scale as a keyboard\n\n# Installation\n\nThe program is written in C++ (since it requires the `uinput` interface) and is built via C-Make.\n\n```bash\n$ cmake CMakeLists.txt \u0026\u0026 make\n```\n\n# Usage\n\n```\nUsage: ./us_solid_precision_balance_driver\n-h \t \t \t Shows this help text\n-u [unit name] \t \t Measurements will be converted to the specified unit. (See manual for supported unit descriptions)\n-o [filename] \t Logs measurements to the specified CSV file\n-k \t \t \t Prints measurements from the keyboard directly. Only recommended in single-measurement mode (otherwise it'll be noisy)\n```\n\n# Output\n\nHere's an example of the output you'll see:\n\n```\n[DEBUG] User specified unit: lb\n[DEBUG] User requested output to output-file.csv\n[DEBUG] Measurement received: 0.676918\n[DEBUG] Current Time = Fri Sep 30 22:30:03 2022\n\n[DEBUG] Measurement received: 0.676918\n[DEBUG] Current Time = Fri Sep 30 22:30:03 2022\n```\n\nA few lines of the CSV file created:\n\n```\n'Measurement Time' , 'Measurement Value (Units = g)'\n307.72 , Fri Sep 30 22:08:11 2022\n307.72 , Fri Sep 30 22:08:11 2022\n307.72 , Fri Sep 30 22:08:11 2022\n307.72 , Fri Sep 30 22:08:11 2022\n```\n\n# Contributing/Notes\n\nThe `docs` folder contains information about the format of the data sent by the scale, as well as the product manual.\n\nNote that the scale has 2 modes, a \"continuous\" mode and a \"single-measurement\" mode. The continuous mode will poll the scale very rapidly, so be careful using it if you have either the keyboard or output file set.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraleighlittles%2Fuss-dbs-driver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraleighlittles%2Fuss-dbs-driver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraleighlittles%2Fuss-dbs-driver/lists"}