Metadata-Version: 2.4
Name: TAER_Core
Version: 1.0.5
Summary: Core module for TAER (Test AER based sensors).
Author-email: Rafael de la Rosa <rdvidal@us.es>, Ruben Gomez Merchan <rgmerchan@us.es>
Requires-Python: >=3.10.5
Description-Content-Type: text/markdown
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
License-File: LICENSE
Requires-Dist: numpy==1.24.0
Requires-Dist: opencv-python
Requires-Dist: matplotlib<=3.10
Requires-Dist: PyYAML==6.0.1
Requires-Dist: wxPython==4.2.0
Requires-Dist: pre-commit

# TAER-Core module

TAER-Core is the foundational backend module for the TAER App, providing the essential logic, data handling, and control mechanisms required for Test AER-based sensors. Designed for use by developers, TAER-Core implements the [Model-View-Controller (MVC)](https://wiki.wxpython.org/ModelViewController) architecture using the [wxPython](https://wiki.wxpython.org) framework. 

**Key features:**
- Centralizes all core logic and data models for the TAER ecosystem.
- Separates concerns into Model, View, and Controller components for maintainability and scalability.
- Provides reusable components and utilities for sensor data processing, user interface management, and application control.
- Intended to be extended or integrated by developers building on the TAER platform.

**Module structure:**
- **Model:** Handles data management and business logic ([main_model.py](src\TAER_Core\main_model.py))
- **Controller:** Manages application flow and user interactions ([main_presenter.py](src\TAER_Core\main_presenter.py), [delegates.py](src\TAER_Core\Controllers\delegates.py), [interactors.py](src\TAER_Core\Controllers\interactors.py))
- **View:** Responsible for the graphical user interface ([main_view.py](src\TAER_Core\main_view.py), [Views](src\TAER_Core\Views))

This module is not intended for direct use by end users, but rather as a core library for developers extending or maintaining the TAER App.

## FPGA Interface: `Libs/dev_opal_kelly`

The `Libs/dev_opal_kelly` directory contains the implementation of functions and classes required to interface with the FPGA hardware. This library provides the low-level communication and control mechanisms necessary for interacting with the Opal Kelly FPGA board, including:

- Reading and writing to FPGA registers and memory blocks.
- Managing serial and parallel data transfers.
- Handling control signals, triggers, and wire interfaces.
- Providing abstractions for higher-level operations used throughout the TAER-Core module.

The main classes in this file (`Device`, `DeviceInfo`, `DeviceActions`, etc.) encapsulate all the logic needed to communicate with the FPGA, including device connection management, register and memory access, DAC/ADC operations, and serial communication. These classes are designed to be thread-safe and robust, with error checking and logging built in.

> **Extensibility:**  
> The structure of these classes allows for easy adaptation to other hardware devices. To support a different device, you can implement a new module that keeps the same class and method structure as in `dev_opal_kelly.py`, but adapts the internal logic to the specifics of the new hardware. This ensures compatibility with the rest of the TAER-Core and TAER-App ecosystem, while allowing flexibility for new devices.

This code is essential for enabling the TAER platform to communicate with and control AER-based sensor hardware via the FPGA.

## Creating a New Release

This project uses GitHub Actions to automate the release process. To create a new release, follow these steps:

1. **Commit and push your changes to the main branch.**  
   Example command lines:
   ```sh
   git add .
   git commit -m "Describe your changes"
   git push origin main
   ```

2. **Check the build process on GitHub Actions.**  
   Go to the "Actions" tab in your GitHub repository and verify that the build workflow is running and finishes without errors.  
   If there are errors, review the output log, fix the issues in your code, and repeat step 1.

3. **Create a new tag for the new version and push the tag.**  
   Example command lines:
   ```sh
   git tag vX.Y.Z   # Replace X.Y.Z with your new version number
   git push origin vX.Y.Z
   ```

4. **Verify the release workflow.**  
   After pushing the tag, a new GitHub Actions job will start. This workflow will build the project and, if successful, create a new release and upload it to the PyPI database.

5. **Update TAER-Core in TAER-App.**  
   Users can now update the TAER-Core module from the TAER-App using:
   ```sh
   pip install --upgrade TAER-Core
   ```
