core

uhppote-core

Go API for low-level access to the UT0311-L0x* TCP/IP Wiegand access control boards. This module implements the device level interface used by uhppote-cli, uhppoted-api, uhppoted-rest, etc.

Supported operating systems:

• Linux
• MacOS
• Windows
• RaspberryPi (ARM7)

Releases

Development

Building from source

Assuming you have Go and make installed:

git clone https://github.com/uhppoted/uhppote-core.git
cd uhppote-core
make build

If you prefer not to build manually:

git clone https://github.com/uhppoted/uhppote-core.git
cd uhppote-core
mkdir bin
go build -trimpath -o bin ./...

Dependencies

API

• GetDevices
• GetDevice
• SetAddress
• GetListener
• SetListener
• GetTime
• SetTime
• GetDoorControlState
• SetDoorControlState
• RecordSpecialEvents
• GetStatus
• GetCards
• GetCardById
• GetCardByIndex
• PutCard
• DeleteCard
• DeleteCards
• GetTimeProfile
• SetTimeProfile
• ClearTimeProfiles
• ClearTaskList
• AddTask
• RefreshTaskList
• GetEvent
• GetEventIndex
• SetEventIndex
• OpenDoor
• SetPCControl
• SetInterlock
• Listen

Other than GetDevices API which specifically uses UDP broadcast to issue a request, the API will use the configured controller IP address if possible, falling back to a broadcast request if necessary.

GetDevices

Retrieves a list of all UHPPOTE controllers that respond to a broadcast get-device request.

GetDevice

Retrieves the controller information for a specific UHPPOTE controller from the response to a get-device request.

SetAddress

Sets the IPv4 address, subnet mask and gateway address for a controller.

GetListener

Retrieves the IPv4 address of the host configured to receive events from the controller.

SetListener

Sets the IPv4 address of the host to receive events from the controller.

GetTime

Retrieves the controller date and time.

SetTime

Sets the controller date and time.

GetDoorControlState

Retrieves a door control state (normally open, normally closed or controlled) from the controller.

SetDoorControlState

Sets a door control state (normally open, normally closed or controlled) on the controller.

RecordSpecialEvents

Enables or disables the door and relay events on a controller.

GetStatus

Retrieves the controller current status.

GetCards

Retrieves the number of cards stored on a controller.

GetCardByID

Retrieves a stored card's information using the card number.

GetCardByIndex

Retrieves a stored card's information using an index into the card list.

PutCard

Adds or updates a card record on the controller.

NOTE: The UHPPOTE access controller has a weird behaviour around the PIN field. According to the SDK documentation, valid PINs are in the range 0 to 999999. However the controller will accept a PIN number out of that range and only keep the lower 7 nibbles of the 32-bit unsigned value. e.g:

To avoid unexpected behaviour, the uhppote-core put-card implementation returns an error if the PIN is out of range.

DeleteCard

Deletes a card record from the controller.

DeleteCards

Deletes all card records from the controller.

GetTimeProfile

Retrieves a numbered time profile from the controller.

SetTimeProfile

Adds or updates a numbered time profile on the controller.

ClearTimeProfiles

Deletes all stored time profiles from a controller.

ClearTaskList

Clears the scheduled task list on a specific UHPPOTE controller, preparatory to using AddTask and RefreshTask.

AddTask

Adds a scheduled task to the task list on a specific UHPPOTE controller. The task is not activated until RefreshTaskList is invoked. ClearTaskList should have been invoked prior to invoking a sequence of AddTask invocations to put the task list in a known state.

RefreshTaskList

Activates all tasks added by AddTask.

GetEvent

Retrieves a single stored event (by index) from the controller.

GetEventIndex

Retrieves the current value of the controller event index (typically used as a marker for events that have been retrieved).

SetEventIndex

Sets the current value of the controller event index (typically used to update the marker for events that have been retrieved).

OpenDoor

Unlocks a door remotely.

SetPCControl

Enables or disables remote host access control.

If remote host access control is enabled, the access controller expects the host to communicate at least once every 30 seconds otherwise it reverts to local control of access using the stored list of cards (the communication is not required to be a 'set-pc-control' command - any command is sufficient). If the access controller has reverted to local control because no message has been received from the host for more than 30 seconds, any subsequent communication from the remote host will re-establish remote control mode again.

SetInterlock

Sets the interlocking between doors, with support for the following operational modes:

• disabled
• doors 1&2
• doors 3&4
• doors 1&2 and 3&4
• doors 1&2&3
• doors 1&2&3&4

Listen

Establishes a 'listening' UDP connection to receive events from a controller (or multiple controller) and invokes a callback function to process each received event.