Changes between Version 50 and Version 51 of Tutorials/Wireless/Fosphor

Timestamp:

Jan 16, 2026, 5:21:17 PM (15 hours ago)

Author:

omikumar

Comment:

—

Tutorials/Wireless/Fosphor

@@ -118 +118 @@
 
 [[Image(rfnoc_fosphor_2_4G.PNG, width=800px)]] 
+
+
+==== Caution ====
+
+While imaging the ceiling USRP-X310 nodes (for example, node18-20 on the grid), you might encounter the following error while executing the fosphor flowgraph with GNURadio Companion,
+
+{{{
+Generating: "/tmp/rfnoc_fosphor.py"
+
+Executing: /usr/bin/python3 -u /tmp/rfnoc_fosphor.py
+
+[INFO] [UHD] linux; GNU C++ version 11.4.0; Boost_107400; UHD_4.4.0.0-33-g4a77791c
+[INFO] [X300] X300 initialization sequence...
+[INFO] [X300] Connecting to niusrpriorpc at localhost:5444...
+Traceback (most recent call last):
+  File "/tmp/rfnoc_fosphor.py", line 287, in <module>
+    main()
+  File "/tmp/rfnoc_fosphor.py", line 264, in main
+    tb = top_block_cls()
+  File "/tmp/rfnoc_fosphor.py", line 72, in __init__
+    self.rfnoc_graph = uhd_rfnoc_graph = uhd.rfnoc_graph(uhd.device_addr(",type=x300,resource=RIO0"))
+RuntimeError: EnvironmentError: IOError: Could not find the image 'usrp_x310_fpga_HG.lvbitx' in the image directory /usr/local/share/fosphor_bit/
+For more information regarding image paths, please refer to the UHD manual.
+
+>>> Done (return code 1)
+}}}
+
+==== Why is this error happening ? ====
+
+This is happening because when we execute the flowgraph, UHD tries to load a specific FPGA image named:
+
+{{{#!shell
+usrp_x310_fpga_HG.lvbitx
+}}}
+
+But in the system that exact file does not exist. So UHD aborts and your script crashes.
+
+==== Possible solution ====
+
+One possible solution can be to create a symbolic link that points to an existing FPGA bitstream file located elsewhere on the system. Essentially, it tricks UHD into finding the file it expects, even though the actual file has a different name.
+
+{{{#!shell
+sudo ln -s /usr/local/share/fosphor_bit/usrp_x310_fpga_XG.lvbitx /usr/local/share/fosphor_bit/usrp_x310_fpga_HG.lvbitx
+}}}