Leosac Manual

Table of Contents

• Introduction
  • What is Leosac?
  • Features
  • Documentation summary
  • Usage
  • Notes
  • Issues
  • License

leosac.com

Introduction

What is Leosac?

Leosac is an open source physical access control system software. It is meant to be installed on embedded devices running Linux, to handle the logic processing of an access control. Basically, it opens doors.

A Leosac setup is usually composed of an embedded Linux board running the software, locked in a case, connected to a RFID card reader and to the electric strike of a door.

Features

• Multiple-door/reader support
• Ethernet connectivity
• Fully configurable wiring layout
• Portable on virtually every Linux devices on the market
• Open-source

Documentation summary

See modules for a bit of info about modules.

We recommend you read through the related pages informations, there you will find documentation for each module and how to configure and use them.

Interesting stuff (for end user):

• General configuration information (logger / network / remote control).
• Install guide for a simple setup: Raspberry Pi + Piface + Wiegand + Door.

Interesting stuff (for devs):

• See FGPIO detailed description for GPIO command.
• See FLED detailed description for LED command.
• Understand the authentication system
• Firmware info
• Path management
• Overview of the Remote Control interface.

Usage

./leosac [-d <working_directory>] -k <config_file> [-s] [-v] [--] [--version] [-h]

Short	Long	Description
-d	--working-directory	Directory to cd to.
-k	--kernel-cfg	Leosac's core configuration file
-h	--help	Print the help
-s	--strict	Run more deadly check against the configuration (recommended)
N/A	--version	Display version informations and exit

Notes

boost::serialization version shall be the same on all your Leosac unit. This is to prevent problem when synchronizing configuration between Leosac unit.

Issues

Please report issues (and ask questions) here.

License

This project is released under the GNU Affero GPLv3 license. A copy of the license can be found in the root folder.

Subpages:

• Documentation