DOCSEARCHbyAlgolia
Submit Docs

COSMIIC Documentation

website·Indexed 32 days ago

https://docs.cosmiic.org

Documentation for the COSMIIC system, an open-source framework for implantable neural interfaces. Includes hardware guides for Power Modules (PM), EMG modules (BP2), and IPG modules (PG4), as well as software resources for the MATLAB-based NNP-API, .nnpscript operational codes, and network management protocols (NMT).

Tokens
23.8K
Snippets
83
Records
161
Agent score
61%

What's inside COSMIIC

  1. Overview of Network Management (NMT) Protocol

    Network Management (NMT) is a CANopen protocol used in the COSMIIC system to send commands to modules, change operational states, and manage overall network behavior. NMT commands change the mode of a specific device or multiple devices collectively. Note that not all NMT commands are implemented by every module; implementation is defined in the canFest/include/def.h file of each module's application source code.

  2. Overview of COSMIIC System scripts

    Scripts in the COSMIIC System provide a constrained mechanism to customize the operation of an implanted device for individual users. They use an assembly-like scripting language stored in .nnpscript files, which are uploaded wirelessly and executed directly on the Pulse Generator (PM). This allows for autonomous operation, state management, stimulation control, and data logging without requiring a continuous wireless connection. The system firmware enforces constraints to ensure that script adjustments do not cause unsafe device behavior.

  3. Overview of COSMIIC System functional modules

    The COSMIIC System utilizes network-integrated modules designed for specific functional goals. The current module ecosystem includes the following components:
    ModulePurpose
    WINGWireless externals: Radio connection and closed-loop charger
    SWARM (Fusion)Host module for remote sensor integration
    HIVE (Nova)High-density recording and stim module
    NECTAR (Gamma)High-frequency nerve block module

  4. Overview of the BP2 Biopotential Recording Module

    The BP2 is a 2-channel EMG (electromyography) module designed to record myoelectric signals (MES) from muscles under voluntary control for neuroprosthetic control. It can record from two different muscles and process signals independently. The module uses differential recording with two metal contacts separated by 1cm, supporting either epimysial or intramuscular electrode designs. Its small size allows placement in extremities near the target muscles to reduce lead length and improve signal quality.

  5. Use the Wireless Link for system communication

    The Wireless Link acts as an Access Point that bridges desktop computers (via MATLAB) or mobile devices to the COSMIIC system. It communicates wirelessly with the radio on the Power Module (PM), which then controls the rest of the system.

    Setup:

    • Connect the Wireless Link to a computer using a USB-C data/power cable.
    • The device will appear as a USB device on the host computer.
    • Communication is initiated via MATLAB commands to start a session.

  6. COSMIIC System Architecture Overview

    The COSMIIC System operates through a layered architecture bridging external software and embedded firmware via wireless radio communication. The layers are:

    • Module Firmware: Consists of Bootloaders (fail-safe entry/updates), Application Firmware (module-specific logic for PM, PG4, and BP2 modules), and the CANopen network layer.
    • Scripts: Customizations executed within the power module (PM).
    • Wireless Interface: Radio firmware and software that translates messages between external apps and hardware.
    • External Control (MATLAB): The NNP API allows bi-directional communication via radio to control network modules. This includes the NNP-API repository containing core commands (NNPCORE, NNPHELPERS) and GUI apps.

  7. Understand the COSMIIC development board architecture

    Each development board is composed of two primary components:

    1. Module Circuit Board: A miniature, enclosure-ready design used in both the dev kit and actual implantable modules.
    2. Frame Board: A breakout board or board shield that holds the module circuit board. It provides a consistent form factor for easier benchtop handling and adds ports and points for diagnostic interaction.

  8. Access COSMIIC System resources and community support

    Depending on the task, use the following resources:

    • Implantables: Find summarized material about system components in the Implantables sidebar.
    • Regulatory Documents: Download Investigational Device Exemption (IDE) examples via Resources -> Regulatory.
    • Licensing: Review permissive licensing details on the Licensing page.
    • Community Support: Post questions or involvement opportunities on the COSMIIC Forum (community.cosmiic.org).
    • Private Inquiries: Contact the team via email at open_source@cosmiic.org.

  9. PG4 4-channel Pulse Generator Module Overview

    The PG4 is a remote implantable module designed for electrical stimulation of nerve and muscle tissue. It can deliver stimulation to four independent monopolar electrodes, utilizing the module's metal case as the common return electrode. It connects to the NNP network via a single network cable, which provides both power and data for stimulation parameters. The module supports network branching, featuring four total network connections (one input and three outputs).

  10. Implement safety and failsafe mechanisms

    The COSMIIC system employs a three-level safety architecture to prevent unsafe operation:

    1. Hardware Charge Limits: Physical limits on the amount of charge delivered.
    2. Software Parameter Limits: Constraints enforced by the firmware on configurable values.
    3. Magnetic Switch: An emergency shutdown mechanism in the Power Module. When activated by a strong static magnetic field, it immediately stops all stimulation.

  11. Understand the NNP Power Module functions and architecture

    The Power Module is an implanted component that serves two primary roles: providing power to the entire NNP implanted system via rechargeable Li-ion batteries and providing a wireless MedRadio link for transcutaneous communication and system programming. It distributes power to remote modules through a network cable. While primarily a power source, it features a 32-bit ARM-7 microprocessor (NXP Semiconductor LPC2129) running a real-time operating system (RTOS), allowing it to perform signal processing and data storage for remote modules.

  12. COSMIIC System documentation overview

    The COSMIIC documentation site provides information on hardware, software, mechanical components, test documents, and regulatory documents required for benchtop, pre-clinical, and human use. Note that this site is a reference guide and does not host source files; the single source of truth for all COSMIIC System source files is hosted on GitHub.