GW1N-2B: false CRC check failure after successful embedded flash programming

Open
#722 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
72/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Quiet
Tech stack
cpp

Research direction

Start by locating the .fs checksum parser and its handling of Gowin IDCODE 0x0120681B; compare the reported checksum with the supplied output and bitstream. Done means the GW1N-2B example no longer reports a false CRC failure while preserving the matching status code and User Code.

Written by the indexing model from the issue text.

Description

Description

Programming the embedded flash of a Gowin GW1N-2B using a GWU2X cable completes successfully, but openFPGALoader reports a false CRC failure.

The FPGA status and User Code reported by openFPGALoader are identical to those reported by the official Gowin Programmer after a successful operation.

Hardware
  • FPGA: Gowin GW1N-2B
  • IDCODE: 0x0120681B
  • Cable: Gowin GWU2X
  • Cable VID:PID: 0x33aa:0x0120
  • Operating system: Windows 11
  • Environment: MSYS2 UCRT64
Software
  • openFPGALoader: 1.1.1
  • Gowin Programmer: V1.9.12 SP1
Command
openFPGALoader -c gwu2x -f gtia_rgb_1_2.fs -v
Relevant openFPGALoader output
idcode 0x120681b
manufacturer Gowin
family GW1N
model GW1N-2
irlength 8

File type : fs
Parse file Parse gtia_rgb_1_2.fs:
Warning: Unknown IDCODE
checksum 0x0000
Done

bitstream header infos
CRCCheck: ON
Compress: OFF
ConfDataLength: 722
LoadingRate: 2500000
ProgramDoneBypass: OFF
SPIAddr: 00000000
SecurityBit: ON
idcode: 0120681b

Erase SRAM DONE
Erase FLASH DONE
Erasing FLASH: 100.00%
write Flash: 100.00%
Done

CRC check : FAIL
Read: 0x00004f73 checksum: 0x0000

after program flash: displayReadReg 0001f020
    Memory Erase
    Gowin VLD
    Done Final
    Security Final
    Ready
    POR
Gowin Programmer result

The same file and device are successfully programmed using the official programmer:

Cable found: Gowin USB Cable(GWU2X)
Target Device: GW1N-2B(0x0120681B)
Operation "embFlash Erase,Program" for device#1...
Status Code is: 0x00019020
Status Code is: 0x0001F020
User Code: 0x00004F73
Program Finished!
Observation

Both applications produce the same final status code:

0x0001F020

They also read the same User Code:

0x00004F73

The programmed FPGA works correctly after power cycling.

It appears that the .fs parser does not recognize IDCODE 0x0120681B when calculating the checksum. It consequently returns 0x0000, causing the correctly read User Code 0x00004F73 to be reported as a CRC mismatch.

Could support for the GW1N-2B IDCODE be added to the .fs checksum parser?

gtia_rgb.fs.zip

Dominant language
C++
Stars
1.7k
Forks
396
Avg merge
2d 4h
Merged PRs (30d)
15

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from trabucayre/openFPGALoader

All issues in trabucayre/openFPGALoader

Similar issues

More C++ issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.