Skip to content

hacklabkyiv/prismo

Repository files navigation

overview

PRISMO Access system

PRISMO is a fully open-source and easy-to-install access system designed to control access to tools and equipment in maker spaces. Our goal is to create a system that any maker space in the world can easily set up for its own use. The system is completely open-source, including the backend, reader firmware, and PCB schematics.

⚠️ ☢️ 🚀 Attention!!! Disclaimer!!! PRISMO is in early alpha, NOT for production use! Expect bugs, limitations, and security risks. Use only in controlled environments. We take no responsibility for damages. Contribute responsibly!

Setup on Raspberry Pi OS

Simplest way to bring PRISMO to your life is to use Raspberry Pi and graphical desktop environment. Here is full description how to do this: instruction

Reader hardware build

Readers itself has their own repository and building instructions, follow repo to build your own beautiful reader.

Reader software flashing

Once you got your PRISMO Reader, it is time to flash it with firmware. Flashing reader is performed from Raspberry Pi itself. To flash your brand new, fresh reader you need to perform such steps.

  1. Set correct WiFi credentials in system settings. Go go "Settings" Tab in PRISMO webapp(http://prismo.local): wifi settings
  2. Connect your PRISMO Reader HW to Raspberry Pi via USB Cable: flash reader animation
  3. Reboot Raspberry Pi
  4. Go to "Devices" Tab fill "Device Name" field and Press "Add Device" button. flash reader
  5. Press "Start" and wait to complete! That is all!

Add new users to database

Ok, after flashing new reader you can add new tags and users to database.

  1. Bring new RFID tag to PRISMO Reader. You should hear "Deny" sound and purple light signal from it.

Access denied

  1. Go to "Users" Tab in PRISMO App, you should see latest time of tag use. Add new user name in field below:

add user

That is all! Now you can toggle checkbox with PRISMO Reader name, and user will have an access for this device! But to apply changes on PRISMO Reader you need to reboot it or to use any tag again, because reader updates its keys only during boot or after any key use.

Access Granted

Contribution

As we said, PRISMO is in early alpha stage, a lot of improvements needed, so contact us and join our team! We also can provide more detailed instructions about building HW part.

List of contributors:

Financial support

System is developed mainly on a volunteering basis, but finantial support for writing documentation was given by TOLOCAR program in Ukraine: a project funded by the German Government @bmz_bund and implemented by the GIZ with support of At Stake gGmbH in close collaboration with Ukrainian and international partners.

Also, please support our hackerspace at Patreon to keep our PRISMO development active!