Chords-LSL-Connector#

Ringkasan#

Chords-LSL-Connector menghubungkan Neuro Playground Lite Anda (yang menjalankan Chords Firmware) ke ekosistem LSL, menyediakan:

  • Streaming data real-time dengan latensi rendah.

  • Dukungan lintas platform (Windows, macOS, Linux).

  • Mode GUI untuk alur kerja yang fleksibel.

  • Penemuan perangkat otomatis dan iklan stream LSL.

Chords-LSL-Connector Landing Page

Chords-LSL-Connector#

Fitur#

  • Streaming sinyal bio-potensial multi-saluran melalui LSL.

  • Bekerja dengan build firmware yang kompatibel Chords apa pun.

Apa itu Lab Streaming Layer (LSL)?#

Lab Streaming Layer (LSL) adalah protokol sumber terbuka dan kerangka kerja perangkat lunak untuk streaming data waktu-sinkron secara real-time, terutama dalam eksperimen neurosains dan biomedis.

LSL adalah ekosistem middleware jaringan sumber terbuka untuk streaming, menerima, menyinkronkan, dan merekam stream data neural, fisiologis, dan perilaku yang diperoleh dari perangkat keras sensor yang beragam.

Untuk mengetahui lebih lanjut tentang LSL klik di sini.

Persyaratan Sistem#

  • Sistem Operasi: Windows 10+ / macOS 10.15+ / Linux (glibc 2.27+)

Persyaratan Perangkat Keras#

Menyiapkan perangkat keras#

Buat semua koneksi sesuai dengan perangkat keras yang Anda gunakan, termasuk koneksi sensor dengan papan pengembangan, koneksi tubuh dengan sensor, dan koneksi dari papan pengembangan ke laptop Anda.

Instalasi#

  1. Unduh installer dari rilis terbaru: Chords LSL Connector Release

  2. Pilih installer untuk OS Anda:

    • Fedora → .rpm

    • Debian/Ubuntu → .deb

    • macOS → .dmg

    • Windows → .msi

    • Atau unduh source bundle untuk membangun sendiri

  3. Jalankan installer untuk OS Anda:

Windows (.msi)

  1. Klik ganda file .msi yang diunduh.

  2. Jika Anda melihat peringatan SmartScreen, klik More Info → Run Anyway.

  3. Lanjutkan melalui wizard installer: Next → pilih lokasi instal → Install → Finish.

Fedora (.rpm)

  1. Buka terminal dan jalankan:

sudo dnf install chords-lsl-connector-0.3.0-1.x86_64.rpm

  1. Masukkan kata sandi Anda dan konfirmasi instalasi saat diminta.

  2. Setelah instalasi, luncurkan Chords LSL Connector dari menu Applications Anda.

Debian/Ubuntu (.deb)

  1. Buka terminal dan jalankan:

sudo apt install ./chords-lsl-connector_<version>_amd64.deb

  1. Jika Anda menemukan dependensi yang hilang, jalankan:

sudo apt --fix-broken install

  1. Luncurkan Chords LSL Connector dari launcher desktop Anda atau via:

chords-lsl-connector
macOS (.dmg)

  1. Klik ganda file chords-lsl-connector.dmg yang diunduh.

  2. Ketika Anda melihat peringatan macOS:

  3. “chords-lsl-connector.dmg” diunduh dari Internet.

Apakah Anda yakin ingin membukanya?

klik **Open**

  1. Seret Chords LSL Connector.app ke folder Applications Anda.

  2. Keluarkan image yang dipasang dan buka aplikasi dari Applications.

  1. (Optional) Build from source

git clone https://github.com/upsidedownlabs/Chords-LSL-Connector.git
cd Chords-LSL-Connector
npm i
cargo tauri build

Mem-flash Firmware#

  • Untuk mem-flash firmware: Kunjungi Halaman GitHub dengan mengklik Get Firmware, dan kemudian unduh firmware sesuai dengan papan pengembangan Anda.

Chords LSL Connector Get Firmware Button

  • Anda juga dapat menggunakan NPG Lite Flasher untuk mem-flash firmware yang diinginkan, untuk mengetahui lebih lanjut kunjungi dokumentasi NPG Lite Flasher.

Visualisasi LSL#

Setelah perangkat Anda terhubung, Anda dapat memilih dari beberapa opsi tergantung pada bagaimana Anda berencana menggunakan NPG Lite - termasuk Bluetooth Low Energy (BLE), Serial atau Wi-Fi.

  1. Luncurkan aplikasi Chords LSL Connector.

  2. Klik tab Bluetooth LE.

Chords LSL Connector BLE Device

  1. Jika Anda tidak dapat menemukan perangkat, flash firmware BLE dari langkah Mem-flash Firmware dan nyalakan papan Anda.

  2. Tunggu dialog Available Devices untuk mencantumkan perangkat NPG Anda (misalnya NPG-54:32:04:29:39:b6) dan klik ikon link-nya.

Chords LSL Connector BLE Device Scan
Chords LSL Connector BLE Device Connect

  1. Amati panel Connection Statistics yang menampilkan laju sampling dan total sampel.

Chords LSL Connector BLE Device Visualise

  1. Gunakan tombol built-in

untuk memvisualisasikan atau merekam stream LSL langsung Anda.

Chords LSL Connector Visualise Tab

  1. Luncurkan aplikasi Chords LSL Connector.

  2. Klik tab Serial.

Chords LSL Connector Serial Device

  1. Jika Anda tidak dapat menemukan perangkat, flash firmware Serial dari langkah Mem-flash Firmware dan nyalakan papan Anda.

  2. Tunggu dialog Available Devices untuk mencantumkan perangkat NPG Anda, jika menggunakan beberapa perangkat maka klik ikon link-nya, untuk perangkat terhubung tunggal akan terdeteksi dan terhubung secara otomatis.

Chords LSL Connector Serial Device Connect

  1. Amati panel Connection Statistics yang menampilkan laju sampling dan total sampel.

Chords LSL Connector Serial Device Visualise

  1. Gunakan tombol built-in

untuk memvisualisasikan atau merekam stream LSL langsung Anda.

Chords LSL Connector Visualise Tab

  1. Luncurkan aplikasi Chords LSL Connector.

  2. Buka pengaturan Wi-Fi komputer Anda, pilih jaringan perangkat NPG Lite (misalnya npg-lite-2) dari daftar, dan klik Connect - Anda akan melihat “Connecting” diikuti oleh “Connected” setelah link terjalin.

Chords LSL Connector WiFi Connect

  1. Jika Anda tidak dapat menemukan perangkat, flash firmware WiFi dari langkah Mem-flash Firmware dan nyalakan papan Anda.

  2. Sekarang, Klik tab WiFi.

Chords LSL Connector WiFi Device

  1. Amati panel Connection Statistics yang menampilkan laju sampling dan total sampel.

Chords LSL Connector WiFi Device Visualise

  1. Gunakan tombol built-in

untuk memvisualisasikan atau merekam stream LSL langsung Anda.

Chords LSL Connector Visualise Tab

Repositori GitHub#

Untuk kode sumber lengkap, pelacakan masalah, dan panduan kontribusi, kunjungi repo GitHub Chords-LSL-Connector.

Anda akan menemukan panduan setup dan dapat melacak pengembangan berkelanjutan - termasuk perbaikan bug dan peningkatan fitur: Chords LSL GitHub