Bug 791

Summary:	dev-env-setup script for dfutil, openFPGALoader, ujprog and fujprog
Product:	Libre-SOC's first SoC	Reporter:	Veera <veerakumar.r>
Component:	Documentation	Assignee:	Veera <veerakumar.r>
Status:	RESOLVED FIXED
Severity:	normal	CC:	libre-soc-bugs, lkcl
Priority:	---
Version:	unspecified
Hardware:	PC
OS:	Linux
NLnet milestone:	NLnet.2019.02.012	total budget (EUR) for completion of task and all subtasks:	600
budget (EUR) for this task, excluding subtasks' budget:	600	parent task for budget allocation:	22
child tasks for budget allocation:		The table of payments (in EUR) for this task; TOML format:	vklr = { amount = 600, submitted = 2022-04-16, paid = 2022-04-28 }
Attachments:	ulx3s udev orangecrab udev ecp5 udev

Description Veera 2022-03-27 13:36:39 BST

Automated build and needed dependency installation script for dfutil, openFPGALoader, ujprog and fujprog from source code to be made.

to be added to dev-env-setup:
https://git.libre-soc.org/?p=dev-env-setup.git;a=summary

uri: https://github.com/emard/ulx3s/blob/master/doc/MANUAL.md

xc3sprog: https://github.com/xtrx-sdr/xc3sprog/
ecpprog: https://github.com/gregdavill/ecpprog/
dfu-util: apt-get install dfu-util

Comment 1 Luke Kenneth Casson Leighton 2022-03-27 13:55:05 BST

there is plenty of information on each of these, it would also
be useful to add some udev.d rule entries, for each of
* orangecrab
* versa_ecp5
* ulx3s

i will add some attachmnents of what i have

Comment 2 Luke Kenneth Casson Leighton 2022-03-27 13:56:01 BST

Created attachment 157 [details]
ulx3s udev

Comment 3 Luke Kenneth Casson Leighton 2022-03-27 13:56:21 BST

Created attachment 158 [details]
orangecrab udev

Comment 4 Luke Kenneth Casson Leighton 2022-03-27 13:56:42 BST

Created attachment 159 [details]
ecp5 udev

Comment 5 Veera 2022-04-04 23:22:08 BST

Also add installation script for:

xc3sprog: https://github.com/xtrx-sdr/xc3sprog/
ecpprog: https://github.com/gregdavill/ecpprog/

All these (dfu-util,...) are to be combined in a single installation script.

Comment 6 Luke Kenneth Casson Leighton 2022-04-04 23:38:13 BST

for an Arty A7-100t, an entry in /etc/udev/rules.d is needed with these:

SUBSYSTEM=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6010", GROUP="users", MODE="0666"

Comment 7 Veera 2022-04-07 03:10:49 BST

Add a section for FPGA/Boards boot-loaders-programmers in software prerequisites in https://libre-soc.org/HDL_workflow/

Add new installation page for FPGA/Boards Boot-Loaders Programmers.
uri: https://libre-soc.org/HDL_workflow/fpga-boot-loaders-progs/

Comment 8 Veera 2022-04-08 04:29:51 BST

Update all programs installation instructions in page for FPGA/Boards Boot-Loaders Programmers.

uri: https://libre-soc.org/HDL_workflow/fpga-boot-loaders-progs/

Instructions are working by hand typing. Shortly I will make dev-env-script for this.

Comment 9 Luke Kenneth Casson Leighton 2022-04-08 09:20:25 BST

great.  do just leave them installed in /usr/local/bin, no need to
set INSTALL_PREFIX, otherwise the number of
entries needed to be added to $PATH becomes ridiculous.

/usr/local/bin is perfectly fine

Comment 10 Veera 2022-04-08 10:33:56 BST

Uploaded fpga-boot-load-prog-install script:

uri: https://git.libre-soc.org/?p=dev-env-setup.git;a=commitdiff;h=79cda71f73537fcb51f78ea6d3083a66b1f9334b

I have run this in Raptor Power server and it builds and installs successfully.
Checked the installed binaries with plain invocation.

Kindly review and give feedback.

Comment 11 Luke Kenneth Casson Leighton 2022-04-08 10:44:42 BST

it looks good to me, i am happy with it.

Comment 12 Veera 2022-04-08 10:51:41 BST

Updated and corrected page: https://libre-soc.org/HDL_workflow/fpga-boot-loaders-progs/
based on above fpga-boot-load-prog-install script (Comment 10).

- Important correction for xc3sprog build instructions
- Other minor changes