Бесключевой доступ и учет рабочего времени с RC522 (RFID) и AI-агентом ASI Biont: полный гайд по интеграции через ESP32

Введение

Управление доступом к помещениям, учет рабочего времени сотрудников, контроль использования оборудования — задачи, которые в 2026 году решаются дешево и надежно с помощью RFID-модуля RC522 и AI-агента ASI Biont. Модуль RC522 (работающий на частоте 13.56 МГц) стоит около 3 долларов и поддерживает стандартные карты и метки MIFARE. В сочетании с AI-агентом ASI Biont вы получаете не просто считыватель, а полноценную систему: AI сам пишет код интеграции, управляет логикой доступа, ведет логи и оповещает в Telegram.

Проблема: ручной учет и небезопасный доступ к помещениям или оборудованию. Решение: подключение RFID-модуля RC522 к ASI Biont через ESP32, настройка логики AI-агента для автоматической идентификации и логирования. Результат: бесключевой доступ, автоматический учет рабочего времени, экономия на охране и снижение рисков.

Что такое RC522 и почему его стоит подключить к AI-агенту

RC522 — это недорогой RFID-модуль, который считывает и записывает данные на карты и метки стандарта ISO 14443 Type A (MIFARE). Он широко используется в системах контроля доступа, автоматизации складов, учете инструментов и т.д. Подключение к AI-агенту ASI Biont превращает его в интеллектуальное устройство, которое может:

• Автоматически идентифицировать пользователя по RFID-карте.
• Логировать время входа/выхода.
• Отправлять уведомления в Telegram при попытке прохода неавторизованного сотрудника.
• Давать команду на открытие замка через реле (если подключено).
• Интегрироваться с системами учета рабочего времени.

Как AI-агент ASI Biont подключается к RC522

ASI Biont подключается к устройствам через облачный sandbox (execute_python) и Hardware Bridge на стороне пользователя. Поскольку RC522 — это SPI-модуль, который обычно работает в связке с микроконтроллером (ESP32, Arduino), оптимальный способ интеграции — через Hardware Bridge.

Hardware Bridge: как это работает

Bridge — это отдельное приложение (bridge.py), которое пользователь запускает на своем ПК (Windows/Linux/macOS). Оно подключается к ASI Biont через HTTP long polling. AI отправляет команды через industrial_command tool, они уходят на bridge пользователя, и bridge читает/пишет в COM-порт через pyserial локально. Пользователь указывает порт (например, COM3) и baud rate (9600, 115200 и т.д.).

Почему именно Hardware Bridge?
- RC522 не имеет прямого сетевого интерфейса — он подключается к ESP32 по SPI.
- ESP32 общается с ПК по UART (COM-порт).
- ASI Biont не может напрямую обратиться к COM-порту из облака — для этого нужен bridge.

Конкретный сценарий: ESP32 + RC522 + ASI Biont

Что понадобится

Шаг 1. Прошивка ESP32

Загрузите на ESP32 простой скетч, который:
- Инициализирует модуль RC522 по SPI.
- При обнаружении карты отправляет её UID в COM-порт (например, CARD:ABC123).
- Принимает команды из COM-порта: UNLOCK — открыть замок, LOCK — закрыть.

Пример кода (Arduino IDE):

#include <SPI.h>
#include <MFRC522.h>

#define SS_PIN 5
#define RST_PIN 22
#define RELAY_PIN 4

MFRC522 rfid(SS_PIN, RST_PIN);

void setup() {
  Serial.begin(115200);
  SPI.begin();
  rfid.PCD_Init();
  pinMode(RELAY_PIN, OUTPUT);
  digitalWrite(RELAY_PIN, LOW);
}

void loop() {
  if (rfid.PICC_IsNewCardPresent() && rfid.PICC_ReadCardSerial()) {
    String uid = "";
    for (byte i = 0; i < rfid.uid.size; i++) {
      uid += String(rfid.uid.uidByte[i], HEX);
    }
    uid.toUpperCase();
    Serial.println("CARD:" + uid);
    rfid.PICC_HaltA();
  }

  if (Serial.available()) {
    String cmd = Serial.readStringUntil('\n');
    cmd.trim();
    if (cmd == "UNLOCK") {
      digitalWrite(RELAY_PIN, HIGH);
      Serial.println("UNLOCKED");
    } else if (cmd == "LOCK") {
      digitalWrite(RELAY_PIN, LOW);
      Serial.println("LOCKED");
    }
  }
}

Подключите RC522 к ESP32 по SPI (стандартная распиновка — SDA к GPIO5, SCK к GPIO18, MOSI к GPIO23, MISO к GPIO19, RST к GPIO22). Реле подключите к GPIO4.

Шаг 2. Запуск Hardware Bridge

Скачайте bridge.py с официального репозитория ASI Biont (ссылка в документации). Запустите:

python bridge.py --token=ВАШ_ТОКЕН --ports=COM3 --default-baud=115200

• --token — ваш токен из личного кабинета ASI Biont (обязателен).
• --ports — порт, к которому подключен ESP32 (узнать можно в диспетчере устройств).
• --default-baud — скорость, которую вы задали в скетче (115200).

Bridge подключится к облаку и будет готов принимать команды.

Шаг 3. Настройка AI-агента в чате ASI Biont

Откройте чат с AI-агентом ASI Biont. Опишите задачу естественным языком:

«Подключись к моему ESP32 через Hardware Bridge на порту COM3, скорость 115200. Когда приходит строка с CARD:, извлеки UID карты. Если UID совпадает с разрешенным списком, отправь команду UNLOCK и запиши событие в лог. При несовпадении — отправь мне уведомление в Telegram. Разрешенные UID: A1B2C3, D4E5F6.»

AI-агент самостоятельно сгенерирует и выполнит код. Вот как это выглядит внутри (пример упрощенный):

import time
import requests
from typing import Optional

# Параметры (AI подставит их из диалога)
TOKEN = "ВАШ_ТОКЕН"
TELEGRAM_BOT_TOKEN = "ваш_бот_токен"
TELEGRAM_CHAT_ID = "ваш_chat_id"
ALLOWED_UIDS = {"A1B2C3", "D4E5F6"}

# Функция отправки команды через industrial_command
def send_command(cmd: str):
    # AI использует tool industrial_command, но для примера покажем через requests
    # В реальности это tool call, а не Python-функция
    pass

# Основной цикл (упрощенно)
def process_card(uid: str):
    if uid in ALLOWED_UIDS:
        send_command("UNLOCK")
        log_entry = f"Доступ разрешен: {uid}"
        # Отправляем в Telegram
        requests.post(f"https://api.telegram.org/bot{TELEGRAM_BOT_TOKEN}/sendMessage",
                      json={"chat_id": TELEGRAM_CHAT_ID, "text": log_entry})
    else:
        log_entry = f"Доступ запрещен: {uid}"
        requests.post(f"https://api.telegram.org/bot{TELEGRAM_BOT_TOKEN}/sendMessage",
                      json={"chat_id": TELEGRAM_CHAT_ID, "text": log_entry})

AI-агент выполнит этот код в sandbox, и система начнет работать.

Шаг 4. Результат

• Когда сотрудник подносит разрешенную карту — ESP32 отправляет CARD:A1B2C3 в COM-порт.
• Bridge передает данные в облако.
• AI-агент получает строку, извлекает UID, сравнивает с разрешенными, отправляет UNLOCK через bridge.
• ESP32 получает команду, включает реле, открывает замок.
• В Telegram приходит сообщение: «Доступ разрешен: A1B2C3».
• Если карта не разрешена — замок не откроется, а в Telegram придет предупреждение.

Почему это выгодно

• Не нужно писать код вручную. AI-агент ASI Biont пишет весь код интеграции на Python с использованием pyserial, paho-mqtt, pymodbus или других библиотек. Вы просто описываете задачу в чате.
• Подключение к любому устройству. ASI Biont подключается к чему угодно через execute_python — не нужно ждать, пока разработчики добавят поддержку нового датчика. Пользователь просто описывает в чате, к какому устройству подключиться и какие параметры (порт, IP, baud rate, API-ключ).
• Экономия времени. Интеграция, которая раньше занимала часы или дни, теперь делается за минуты.
• Гибкость. Вы можете менять список разрешенных карт, добавлять новые команды (например, «открой на 10 секунд») или настраивать сценарии — все через чат.

Возможные подводные камни и как их избежать

1. ESP32 не отправляет данные. Проверьте, что bridge запущен с правильным портом и baud rate. Убедитесь, что ESP32 подключен к ПК по USB.
2. UID приходит в неверном формате. В скетче я использовал uid.uidByte[i], HEX. Если формат отличается, AI-агент сам подстроится — просто опишите проблему в чате.
3. Bridge не подключается к облаку. Проверьте интернет-соединение на ПК. Убедитесь, что токен верный.
4. Команда UNLOCK не срабатывает. Проверьте подключение реле и питание замка. AI может отправить тестовую команду LOCK/UNLOCK для диагностики.

Заключение

Интеграция RC522 с AI-агентом ASI Biont через ESP32 и Hardware Bridge — это простой и надежный способ построить систему контроля доступа с минимальными затратами. AI-агент берет на себя всю рутинную работу: написание кода, обработку данных, логирование и уведомления. Вам остается только описать задачу в чате — и система готова.

Попробуйте прямо сейчас: asibiont.com — подключите RC522 или любое другое устройство к AI-агенту и убедитесь, насколько это просто.