Jump to: navigation, search

Difference between revisions of "LimeSDR on FreeBSD"

(Initial version. Reprint of https://github.com/myriadrf/LimeSuite/wiki/LimeSDR-on-FreeBSD.)
m
Line 1: Line 1:
= LimeSDR on FreeBSD =
 
 
 
Work in progress, stay tuned :-)
 
Work in progress, stay tuned :-)
  
 
People involved: [https://github.com/JanBeh janBeh], [https://github.com/hselasky HPS], [https://github.com/cederom/ CeDeROM], [https://github.com/DianeBruce DB].
 
People involved: [https://github.com/JanBeh janBeh], [https://github.com/hselasky HPS], [https://github.com/cederom/ CeDeROM], [https://github.com/DianeBruce DB].
  
== LimeSDR utilities on FreeBSD ==
+
= LimeSDR utilities on FreeBSD =
  
=== GQRX + LimeSDR Mini. ===
+
== GQRX + LimeSDR Mini. ==
 
* TODO
 
* TODO
  
=== LimeSuite FreeBSD Port. ===
+
== LimeSuite FreeBSD Port. ==
 
* [DONE] source port <code>portsnap</code> and binary package <code>pkg</code> available for everyone.
 
* [DONE] source port <code>portsnap</code> and binary package <code>pkg</code> available for everyone.
 
* [DONE] commit to port tree: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=252032.
 
* [DONE] commit to port tree: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=252032.
Line 25: Line 23:
  
  
== Known problems ==
+
= Known problems =
  
=== Software / Utilities ===
+
== Software / Utilities ==
  
==== LimeSuite and SoapySDR cannot open LimeSDR USB device while detect works fine. ====
+
=== LimeSuite and SoapySDR cannot open LimeSDR USB device while detect works fine. ===
 
* [ONGO] problem fixed. upstream / firmware updated.
 
* [ONGO] problem fixed. upstream / firmware updated.
 
** [TODO] make solution public.
 
** [TODO] make solution public.
Line 38: Line 36:
 
* [DONE] Create LimeSuite port for FreeBSD.
 
* [DONE] Create LimeSuite port for FreeBSD.
  
==== wx assertions on application startup. ====
+
=== wx assertions on application startup. ===
 
* [TODO] problem fixed. upstream / firmware updated.
 
* [TODO] problem fixed. upstream / firmware updated.
 
* [TODO] cause found.
 
* [TODO] cause found.
Line 44: Line 42:
  
  
=== Software / OS / FreeBSD ===
+
== Software / OS / FreeBSD ==
  
==== Excessive debug output. ====
+
=== Excessive debug output. ===
 
* [ONGO] problem fixed. upstream / firmware updated.
 
* [ONGO] problem fixed. upstream / firmware updated.
 
** [TODO] make solution public.
 
** [TODO] make solution public.
Line 55: Line 53:
  
  
=== Firmware / USB ===
+
== Firmware / USB ==
  
==== USB reset. ====
+
=== USB reset. ===
 
* This is a FreeBSD related issue. See post on the freebsd-usb mailinglist: https://lists.freebsd.org/pipermail/freebsd-usb/2020-July/016715.html and its follow-ups.
 
* This is a FreeBSD related issue. See post on the freebsd-usb mailinglist: https://lists.freebsd.org/pipermail/freebsd-usb/2020-July/016715.html and its follow-ups.
 
* [TODO] analyze LibUSB reset problem that prevents LimeSDR working on FreeBSD.
 
* [TODO] analyze LibUSB reset problem that prevents LimeSDR working on FreeBSD.
Line 63: Line 61:
  
  
=== Firmware / RADIO ===
+
== Firmware / RADIO ==
  
==== `LimeSDR-Mini` Hardware Self-Test fail with `LimeQuickTest`. ====
+
=== `LimeSDR-Mini` Hardware Self-Test fail with `LimeQuickTest`. ===
 
* [TODO] problem won't fix: changes to testing application not welcome (see https://github.com/myriadrf/LimeSuite/issues/339).
 
* [TODO] problem won't fix: changes to testing application not welcome (see https://github.com/myriadrf/LimeSuite/issues/339).
 
* [TODO] cause found: tests need to be performed with antennas disconnected (both RX and TX port empty) and device should be cold (board temperature over 40C will fail <code>RF Loopback Test</code>).
 
* [TODO] cause found: tests need to be performed with antennas disconnected (both RX and TX port empty) and device should be cold (board temperature over 40C will fail <code>RF Loopback Test</code>).
Line 71: Line 69:
 
* [TODO] some tests fail, depends on hardware and firmware relese. verify. confirmed with @cederom device on FreeBSD.
 
* [TODO] some tests fail, depends on hardware and firmware relese. verify. confirmed with @cederom device on FreeBSD.
  
==== MCU error 3 / SXR tune failed. ====
+
=== MCU error 3 / SXR tune failed. ===
 
* Issue seems to be reproducible with a [test program](https://sapphire.magnetkern.de/paste_1d1b4528287690e1e2dc1200acb41427/limetest_2020-09-03_0731Z.c). Under FreeBSD, ensure that ``libLMS7Support.so`` of Lime Suite has been installed in `/usr/local/lib/SoapySDR/modules0.7` and compile with: <code>cc -Wall -o limetest-mcu-error -I /usr/local/include limetest_2020-09-03_0731Z.c -L /usr/local/lib -l SoapySDR</code>. Further notes on that issue can be found in the thread [MCU error 3 (SXR tune failed) on LimeSDR USB](https://discourse.myriadrf.org/t/mcu-error-3-sxr-tune-failed-on-limesdr-usb/5303).
 
* Issue seems to be reproducible with a [test program](https://sapphire.magnetkern.de/paste_1d1b4528287690e1e2dc1200acb41427/limetest_2020-09-03_0731Z.c). Under FreeBSD, ensure that ``libLMS7Support.so`` of Lime Suite has been installed in `/usr/local/lib/SoapySDR/modules0.7` and compile with: <code>cc -Wall -o limetest-mcu-error -I /usr/local/include limetest_2020-09-03_0731Z.c -L /usr/local/lib -l SoapySDR</code>. Further notes on that issue can be found in the thread [MCU error 3 (SXR tune failed) on LimeSDR USB](https://discourse.myriadrf.org/t/mcu-error-3-sxr-tune-failed-on-limesdr-usb/5303).
 
* [TODO] problem fixed. upstream / firmware updated.
 
* [TODO] problem fixed. upstream / firmware updated.

Revision as of 17:44, 14 January 2021

Work in progress, stay tuned :-)

People involved: janBeh, HPS, CeDeROM, DB.

1 LimeSDR utilities on FreeBSD

1.1 GQRX + LimeSDR Mini.

  • TODO

1.2 LimeSuite FreeBSD Port.


2 Known problems

2.1 Software / Utilities

2.1.1 LimeSuite and SoapySDR cannot open LimeSDR USB device while detect works fine.

  • [ONGO] problem fixed. upstream / firmware updated.
    • [TODO] make solution public.
    • [TODO] verify the solution.
    • [TODO] fix the device open problem.
  • [TODO] unable to open usb device - find a cause of the problem - probably a LibUSB reset related.
  • [DONE] Make LimeSuite work with SoapySDR (LimeSuite generates a driver for SoapySDR).
  • [DONE] Create LimeSuite port for FreeBSD.

2.1.2 wx assertions on application startup.


2.2 Software / OS / FreeBSD

2.2.1 Excessive debug output.

  • [ONGO] problem fixed. upstream / firmware updated.
    • [TODO] make solution public.
    • [TODO] verify the solution.
    • [TODO] fix the device open problem.
  • Likely setting the verbosity level to a different value in FreeBSD could fix the issue, as maybe libusb on FreeBSD is just more verbose, but I’m not sure if there are any real errors or issues).
  • one way to control LibUSB verbosity is using environmental variables like LIBUSB_DEBUG=0 LimeSuiteGUI.


2.3 Firmware / USB

2.3.1 USB reset.

  • This is a FreeBSD related issue. See post on the freebsd-usb mailinglist: https://lists.freebsd.org/pipermail/freebsd-usb/2020-July/016715.html and its follow-ups.
  • [TODO] analyze LibUSB reset problem that prevents LimeSDR working on FreeBSD.
  • [TODO] enabling non-root FreeBSD users to execute a reset or removing the call from the driver, we’re still debating on how or if the first can be achieved)


2.4 Firmware / RADIO

2.4.1 `LimeSDR-Mini` Hardware Self-Test fail with `LimeQuickTest`.

  • [TODO] problem won't fix: changes to testing application not welcome (see https://github.com/myriadrf/LimeSuite/issues/339).
  • [TODO] cause found: tests need to be performed with antennas disconnected (both RX and TX port empty) and device should be cold (board temperature over 40C will fail RF Loopback Test).
  • [TODO] report issue on upstream github, done: https://github.com/myriadrf/LimeSuite/issues/339
  • [TODO] some tests fail, depends on hardware and firmware relese. verify. confirmed with @cederom device on FreeBSD.

2.4.2 MCU error 3 / SXR tune failed.

3 References