Hardware Forum - openfnirs Forum

Question about open source license for NinjaNIRS

麒为陈 — Wed, 17 Sep 2025 13:26:18 +0000

Hello,

I have been exploring the NinjaNIRS project on GitHub. However, I did not find a LICENSE file in the repository. I noticed that some firmware files include a BSD-3-Clause license header (inherited from the Raspberry Pi SDK), but it is not clear to me whether this applies to the entire project (including hardware design files, documentation, and FPGA code) or only to those specific files.

Could you please clarify the overall open-source license status of the NinjaNIRS project?

Thank you very much!

Help needed: Error Encountered And Need Help

麒为陈 — Thu, 19 Jun 2025 14:43:04 +0000

Hi everyone,

We are trying to use ninja GUI with ninjaNIRS 2022 hardware.

The respective firmware has been flashed to the Control Board and the Detector Interface Card. The git branch of ninja GUI has switched to ninjaNIRS22, and the correct device type has also been selected in the configuration file.

Problem Description:

When we launch the GUI, we get the following output:

>> ninjaGUI('cqw')

Checking compatible devices...
This install is compatible with the following devices:
NIRS1k
ninjaNIRS2020
ninjaNIRS2021a
ninjaNIRS2022
ninjaNIRS2024
Looking for cqw.cfg...
Loading cqw.cfg...
Setting GUI environment for device ninjaNIRS2022
Starting ninjaGUI application

Connecting to serial port COM5

36 rb = read(s, 7, 'uint8');

Warning: The specified amount of data was not returned within the timeout period of 'read'.
'serialport' was unable to read all requested data. For more information on possible reasons, see the 'serialport' read warning.
37 if 240 ~= rb(1)

StatReg readback header error

StatReg readback command error

The variable rb ends up being an empty array [], or sometimes;

A screenshot showing the details of the variable 's' has been attached.

Does anyone know what might be going wrong here?

Any help or suggestions would be greatly appreciated!

s.png

Clarification Regarding R1-0402 Package Resistor Value in BOM_Block_NN23_Det_Optode_02_OPA

walden — Mon, 12 May 2025 07:52:39 +0000

I would like to clarify the resistor value specified as "R1, 330M" in the BOM for the 0402 package. Does it represent 330 MΩ (megaohms) or 330 mΩ (milliohms)? We have only been able to find a maximum of 20 MΩ for the 0402 package, while the 330 MΩ resistors we found are typically in the 0603 package.

If a 330 MΩ resistor is indeed available in the 0402 package, could you please provide a link to it? I would greatly appreciate it.

Thank you for your assistance.

0402-res-330M.png

generate stl file from sd file through bfnirs website

Yuanyuan Gao — Wed, 26 Mar 2025 13:48:42 +0000

Hi I tried to use the BFNIRS website to generate an STL file. I have attached the SD and the STL files here. However, the STL files don't look correct. The ear slits look off. Does anyone have the same issue?

Existing Grommets

Schuyler Hou — Fri, 01 Nov 2024 01:15:14 +0000

According to the websit, there are four existing grommets for the NinjaCap. However, not all of them are compatible with the pipeline. Only #PMRK1 and #NIRX2 work. I am particularly interested in using #NN21b and would appreciate any guidance or assistance you could provide regarding its compatibility.

NinjaCap for HD-EEG

Schuyler Hou — Sun, 27 Oct 2024 03:38:52 +0000

Hi everyone,

I'm exploring the use of ninjaCap for HD-EEG applications that require coverage of the face, like a 256-channel setup. Has anyone modified the cap design for this purpose?

Also, is it possible to create and modify these caps using traditional methods instead of the automated pipeline? Any guidance would be greatly appreciated.

If there are better solutions or tips for adapting the ninjaCap, I'd love to hear your suggestions!

Thanks for your help!

Request for Information on Firmware Release

麒为陈 — Thu, 26 Sep 2024 03:24:49 +0000

Our lab has successfully completed the implementation of all the PCBs except for the IMU bundle. We are eager to see the outstanding system your team has designed in action! However, we are currently unable to proceed without the firmware.

Could you please tell us the estimated timeline for the firmware release? We would be glad to share our experiences from the process so far and offer any assistance you may need.

ninjaNIRS22 paper is published

David Boas — Wed, 04 Sep 2024 16:41:51 +0000

I am happy to announce that our paper describing the ninjaNIRS22 system is published. The journal paper describing the system is published in Biomedical Optics Express at https://doi.org/10.1364/BOE.531501. More details about the hardware are elsewhere on this website here.

Empty Firmware and Optodes folders on GitHub

sheehanxu — Mon, 15 Jul 2024 02:08:59 +0000

First, I want to say that the work you are doing with OpenFNIRS is fantastic. Making fNIRS technology more accessible will enable many more researchers to utilize this powerful brain imaging method. Thank you for your efforts!

I noticed that currently, the Firmware folder in the NN22 Technical Documents repository on GitHub is empty:
https://github.com/BUNPC/NN22-Technical-Documents/tree/4586286b928220642feb743bc18696b0ee9e1169/Firmware

Are there plans to upload the firmware files there in the future? Having access to the firmware would be very helpful for those of us building the OpenFNIRS systems.

Additionally, I saw that the Optodes folder is also currently empty. Will the newer 3D models, drawings, or specifications for the optodes be provided?

Any information you can share on the timeline for adding firmware and optode files would be much appreciated. Thanks again for the important work you are doing in democratizing fNIRS technology! I'm excited to see OpenFNIRS continue to grow and enable cutting-edge research around the world.

The GitHub Link for the IMU Interface Card Does Not Match

麒为陈 — Tue, 09 Jul 2024 08:11:57 +0000

The provided image of the IMU Interface Card looks like this, but the .pcb file from the GitHub link shows a completely different design. Could someone please help clarify this discrepancy? Thank you!

Q.jpg