FAQ - adwinying/FreeLwIP-Nios-II GitHub Wiki
Troubleshooting/Known Issues (FAQ)
Index
- File System import error in NIOS II SBT
- TSE_MAC_BASE undefined
- Make error (Rebuilding BSP)
- Unable to set MAC address in uIP
- Shadow Registers
- Switching Between GMII/MII mode and RGMII mode
File System import error in NIOS II SBT
Symptom
When importing files into project directory in NIOS II SBT, the operation fails.
Problem
The SBT messes up Windows' file permissions. Trying to manually copy and paste into the project directory would cause "You need administrator privileges to continue" dialog
Solution
Fix the permissions. Follow this tutorial here. Apply this to the main projects folder. Ensure your user account has full ownership on folders, subfolders and files.
TSE_MAC_BASE undefined
Symptom
One of the following has occurred:
- SBT returns error saying
TSE_MAC_BASE
is undefined when building project - In lwIP(no OS) the UART log is forever stuck at
Waiting for link...
Problem
The Triple Speed Ethernet (TSE) is incorrectly named.
Solution
Go to Qsys and rename the TSE name to tse_mac
. Instructions could be found here
Make error (Rebuilding BSP)
Symptom
The following error occurred when building project:
make[1]: *** [makefile] Error 1
make: *** [../FreeLwIP_bsp/-recurs-make-lib] Error 2
Problem
The SOPC file associated with the project is outdated.
Solution
Rebuild the BSP. Right click the project's BSP directory and select Nios II > Generate BSP. Once completed attempt to build the project again.
Unable to set MAC address in uIP
Symptom
Although uIP has the ability to set a device's MAC address, it does not work on atk2-uip
. It still retains its original MAC address.
Problem
Unknown as of time of publishing. FreeLwIP-NIOS-II
seems to have the same problem.
Workaround
Locate the device's original MAC address. In the case of DE2-115, the default MAC address is 01:60:6E:11:02:0F
(ie. DE2-115 FPGA responds to this MAC address)
Shadow Registers
Symptom
Error has occurred when attempted to create Application + BSP in NIOS II SBT. In the Console log it states that At least one shadow register is required to be enabled.
Problem
Shadow registers need to be added into SOPC file.
Solution
Refer to this instruction. Go to Qsys
and right click the cpu
> Edit > Advanced > Features tab and set Number of shadow register sets to 1
. Save, generate and start compilation.
Switching Between GMII/MII mode and RGMII mode
Symptom
lwIP runs and can receive packets and packets are claimed to be "sent" by the console / TX LED lights up but no response packet is visible to the computer.
Problem
RGMII mode is enabled in Qsys under the TSE properties.
Solution
Refer to this support article.
[Untested] Changing the TSE mode back to GMII/MII might work as well.