FAQ - adwinying/FreeLwIP-Nios-II GitHub Wiki

Troubleshooting/Known Issues (FAQ)

Index

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:

  1. SBT returns error saying TSE_MAC_BASE is undefined when building project
  2. 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.