M-Labs/urukul-pld
3
0
Fork 4
Code Issues 1 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Urukul firmware port to iCE40 #3

Merged
sb10q merged 39 commits from occheung/urukul-pld:urukul-ice into master 2025-08-06 10:13:22 +08:00
Conversation 5 Commits 39 Files Changed 12 +789 -4
occheung commented 2025-07-09 10:47:38 +08:00
Member
Copy Link

Supersedes #1. No prerequisite PRs. Here are some few key points:

  • Only the rev 9 variant is part of this port.
  • EEM pin ordering is preserved.
  • SU-Servo variant is now a build configuration instead of a DIP-switch flip since bi-directional LVDS is not supported by iCE40.
  • Experimental features are not yet supported as of this PR. The urukul firmware is being worked on my experimental branch.
Supersedes #1. No prerequisite PRs. Here are some few key points: - Only the rev 9 variant is part of this port. - EEM pin ordering is preserved. - SU-Servo variant is now a build configuration instead of a DIP-switch flip since bi-directional LVDS is not supported by iCE40. - Experimental features are not yet supported as of this PR. The urukul firmware is being worked on my [experimental branch](https://git.m-labs.hk/occheung/urukul-pld/src/branch/experimental).
occheung added 31 commits 2025-07-09 10:47:38 +08:00
Port redesign-7 branch to ice40 (without hw testing) e16b18441c
urukul ice40: eems are lvds, not tristate 99f51510c5
fix miso/io_upd_ret double role fd1e6a8bc0
disable red error LED 622a424888
update readme with ICE40 instructions e2158d5cf5
ice platform: eem p and n were mixed up 0eaff94df0
remove unnecessary "sys" clock 1984e61f4f
fix sck1, simplify 4190cd490e
revert proto_rev regression bce3de2b64
update I/O primitives d257097cfd
ice40: use differential I/O 2218324930
add missing import 1b8e3c1c93
fix switch indexing in docs 28a9e69c94
qspi_mosi -> nu_mosi b327d6baac
remove EEM:N pins f90efb785b
ice: forbid signals using global buffer without specified f47cdf1cf3
revert LVDS IO for LVDS tristate 22ce5c8d52 
There are no documentations on how to specify a LVDS tristate.
force all CS wire to go through a LUT 9a23c50bba
fix async dds_reset 7039fdd594
migrate pins to make servo work 7bda499a1e 
- MOSI is always DIFF out on EEM[0].2
- NU_CLK now share EEM[0] with CS[2]
- CS[2] is replaced by IO_UPDATE_N in servo mode
package_pin -> i/o 0d5a24d8ec
remove GB for nu_clk c538e26b28 
icetime does not understand its timing characteristics for some nu_clk uses.
logically detach suservo and standalone in gateware 2b9b8daf8c 
So we get to keep the same pin arrangement in Kasli across versions.
LVDS tristate seems not supported according to project Icestorm's bitstream descriptions.
add used lvds output N pins 074700c02a
remove all mention of iostandard and pullup 3b396c49cb 
I/O standard is not settable. It is fixed by VCCIO*.
Pull up should be configured by PULLUP parameter of SB_IO.

You can observe specifying PULLUP in I/O does nothing according to the generated bitstream. It is already set by default.
See this: https://prjicestorm.readthedocs.io/en/latest/_static/bitdocs-8k/tile_33_2.html
remove timing report 3cd675607f
ice40: update docs eedfe2cc5e
fix io_update_ret resource comment 683c389f86
update urukul sync docs a6da8916cd 
... so SYNC_IN would be an input to Urukul, SYNC_OUT would be an output from Urukul.
There are no changes to routing nor logic.
remove err signal e732c3d555
update ice40 build instructions 8e7a9b726a
sb10q reviewed 2025-07-22 13:39:24 +08:00
urukul_cpld_ice.py Outdated
@@ -0,0 +1,158 @@
from migen.build.generic_platform import *
sb10q commented 2025-07-22 13:39:24 +08:00
Owner
Copy Link

This file should be renamed, ICE40 is FPGA, not CPLD.

This file should be renamed, ICE40 is FPGA, not CPLD.
sb10q commented 2025-07-22 13:40:26 +08:00
Owner
Copy Link

I think that generally the *.py files in this repos should be renamed.

I think that generally the *.py files in this repos should be renamed.
sb10q reviewed 2025-07-22 13:41:01 +08:00
README.md Outdated
@@ -35,6 +35,39 @@ With Digilent [JTAG HS2](https://store.digilentinc.com/jtag-hs2-programming-cabl
- look for ``Verify: Success``
## Building (Urukul DIOT, ICE40)
sb10q commented 2025-07-22 13:41:01 +08:00
Owner
Copy Link

I think it's 1.6? Which can also be used with EEM, so it shouldn't be called DIOT.

I think it's 1.6? Which can also be used with EEM, so it shouldn't be called DIOT.
sb10q reviewed 2025-07-22 13:45:33 +08:00
urukul_ice.py Outdated
@@ -0,0 +561,4 @@
raise ValueError("Expected one optional argument [standalone | suservo]")
elif len(sys.argv) == 2:
if sys.argv[1] not in ["standalone", "suservo"]:
raise ValueError("Expected one optional argument [standalone | suservo]")
sb10q commented 2025-07-22 13:45:33 +08:00
Owner
Copy Link

Just use argparse, and default to non-suservo.

Also, "standalone" conflicts with the DRTIO role of the same name and also isn't accurate (it still needs a core device for example). Please find a better name.

Just use argparse, and default to non-suservo. Also, "standalone" conflicts with the DRTIO role of the same name and also isn't accurate (it still needs a core device for example). Please find a better name.
occheung added 6 commits 2025-07-30 11:43:53 +08:00
restructure files 11369be803 
Recategorize all files into either xc2c or ice40 directories.
use argparse with an optional susservo argument 9846f4e234
name suservo builds as suservo 5c16c9408e
apply some flake8 suggestions on formatting 430eaa8e36
specify servo as SU-Servo 54d287388d
update instructions 6bcaa8f5bc
occheung added 1 commit 2025-07-30 11:46:06 +08:00
remove duplicate platform ee0d605d81
occheung added 1 commit 2025-07-30 11:46:55 +08:00
revert bash removal fc355398c0
sb10q reviewed 2025-08-06 10:12:12 +08:00
README.md
@@ -38,0 +67,4 @@
### Flashing
Use [kasli-i2c](https://github.com/Spaqin/kasli-i2c/tree/flash_urukul).
sb10q commented 2025-08-06 10:12:12 +08:00
Owner
Copy Link

Please move this to git.m-labs.hk/m-labs
https://github.com/Spaqin is not backed up.

Please move this to git.m-labs.hk/m-labs https://github.com/Spaqin is not backed up.
sb10q merged commit fc355398c0 into master 2025-08-06 10:13:22 +08:00
Sign in to join this conversation.
Reviewers
No Reviewers
sb10q
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
jordens occheung sb10q
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: M-Labs/urukul-pld#3
Delete Branch "occheung/urukul-pld:urukul-ice"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?