uhppoted implements a set of cross-platform building blocks for access control systems based on the UHPPOTE UT0311-L0x TCP/IP Wiegand access control boards. Currently available components include:

• controller API
• CLI for scripting and system administration
• REST service for integration with HTTP servers and mobile clients
• MQTT endpoint for integration with IOT systems e.g.
  • Eclipse Mosquitto
  • HiveMQ
  • AWS IoT
  • Google Cloud IoT
  • IBM Watson IoT Platform
• AWS S3 integration for file managed access control lists
• Google Sheets integration for spreadsheet managed access control lists
• Integration with the Wild Apricot member management system
• uhppoted-app-db SQL DB integration for access control lists managed in a database
• uhppoted-lib-nodejs NodeJS package
• uhppoted-lib-python Python PyPI package
• uhppoted-lib-dotnet .NET NuGet package
• uhppoted-lib-go standalone Go library for external use
• Node-RED low code environment integration
• Home Assistant custom component

The components supplement the manufacturer supplied application which is 'Windows-only' and provides limited support for integration with other systems.

Hardware:

• uhppoted-breakout, a customisable/hackable replacement CPU board
• uhppoted-wiegand an M5Stack form factor Wiegand reader/emulator

Note:

FYA, after much discussion it has been decided that uhppoted is pronounced u-hop-id-ay-d (juː hɒp ɪt eɪd).

Supported operating systems:

• Linux
• MacOS
• Windows
• RaspberryPi (ARM/ARM7/ARM6)

The primary development language for this repository is Go, but code generated native bindings for the following languages also exist:

• NodeJS
• Python
• Rust
• Zig
• Erlang
• PHP
• Lua

uhppoted-dll implements a shared-lib/DLL for interop with languages other than Go. The implementation includes bindings to:

• C
• C++
• C#
• Python
• Clozure Common Lisp

• ioBroker - kBrausew/ioBroker.wiegand-tcpip
• Andre Becker has written a short guide to getting up and running with uhppoted-mqtt and OpenHAB using Docker.

As per this issue [Question] Compatible Hardware, UHPPOTE appears to be a specific branding (or distributor) for the access control boards manufactured by Shenzhen Wiegand Industrial Co., Ltd.

The software in this repository has been tested and is known to work with these specific boards:

Notes:

1. Firmware v6.62 sends anomalous listen events with 0x19 as the start of message identifier. This appears to have been fixed in later firmware versions but patches to support these events are included in:

• uhppoted-core
• uhppoted-codegen
• uhppoted-lib-node-red
• uhppoted-lib-nodejs
• uhppoted-lib-python
• uhppoted-lib-dotnet
• uhppoted-lib-go
• uhppoted-lib-ada

Almost any reader with a Wiegand-26 interface should probably work (there have been reports of offbrand readers that don't) but the readers below are in active use:

1. Migrated from github to _codeberg.
2. Created uhppoted-lib-ada Ada library.
3. Added set-first-card API for managing first-card swipe privileges.
4. Added first-card privileges to get-card, get-card-by-index and put-card APIs.
5. Added first-card privileges to get-acl, compare-acl and load-acl APIs.
6. Added check and retry for send-to-self to UDP and TCP transports.
7. Updated to Go v1.27 and modern Go (using go fix).
8. Renamed uhppote-simulator to uhppoted-simulator.
9. Renamed uhppote-cli to uhppoted-cli.

Binaries for Linux, Windows, MacOS and Raspbian/ARM7 are distributed in the tarball for each release. To install the binaries, download and extract the tarball to a directory of your choice.

The NodeRED, NodeJS and Python packages are installable from the public repositories:

• node-red-contrib-uhppoted
• uhppoted-nodejs
• uhppoted

uhppoted is the parent project for the individual components which are referenced as git submodules - to clone the entire source tree:

git clone --recurse-submodules https://codeberg.org/uhppoted/uhppoted.git

The supplied Makefile has targets to build binaries for all the supported operating systems:

make build

or

make release

To pull upstream changes for all submodules:

git submodule update --remote

If you like the project and you really want to 🙂:

1. carbonsphere/UHPPOTE PHP
2. carbonsphere/DoorControl PHP
3. andrewvaughan/uhppote-rfid Python
4. tachoknight/uhppote-tools: Go
5. jjhuff/uhppote-go: Go
6. pawl/Chinese-RFID-Access-Control-Library
7. Dallas Makerspace:Reverse Engineering RFID Reader
8. wemakerspace/wiegand-daemon
9. wemakerspace/weigeng-js
10. realashleybailey/DoorControl
11. kBrausew/ioBroker.wiegand-tcpip
12. TCP/IP Wiegand Access Controller (Zutrittskontrolle)
13. YouTube: UHPPOTE 2 door basic set-up
14. wouterdebie/uhppote-rs