Gccrs - Revision history

Darc: /* Example project */

2024-09-15T01:31:37Z

Example project

← Older revision		Revision as of 01:31, 15 September 2024
Line 39:		Line 39:

	==Example project==		==Example project==
	The [https://github.com/dreamcast-rs/gccrs-fortran-cube/ <code>gccrs-fortran-cube</code>] repository contains an example project using gccrs in conjunction with GFortran, KallistiOS, and GLdc. View [https://www.youtube.com/watch?v=VUiRoEcpvtI footage of the example] running. This example was created by Eric Fradella and used as a demo in the FOSDEM 2024 talk [https://fosdem.org/2024/schedule/event/fosdem-2024-2634-sega-dreamcast-homebrew-with-gcc/ Sega Dreamcast Homebrew with GCC] by [[User:GyroVorbis\|Falco Girgis]].		The [https://github.com/dreamcast-rs/gccrs-fortran-cube/ <code>gccrs-fortran-cube</code>] repository contains an example project using gccrs in conjunction with GFortran, KallistiOS, and GLdc. View [https://www.youtube.com/watch?v=VUiRoEcpvtI footage of the example] running.

Darc at 00:04, 17 June 2024

2024-06-17T00:04:51Z

← Older revision		Revision as of 00:04, 17 June 2024
Line 39:		Line 39:

	==Example project==		==Example project==
	The [https://github.com/~~darcagn~~/~~rust~~-fortran-cube/ <code>~~rust~~-fortran-cube</code>] repository contains an example project using gccrs in conjunction with GFortran, KallistiOS, and GLdc. View [https://www.youtube.com/watch?v=VUiRoEcpvtI footage of the example] running. This example was created by Eric Fradella and used as a demo in the FOSDEM 2024 talk [https://fosdem.org/2024/schedule/event/fosdem-2024-2634-sega-dreamcast-homebrew-with-gcc/ Sega Dreamcast Homebrew with GCC] by [[User:GyroVorbis\|Falco Girgis]].		The [https://github.com/dreamcast-rs/gccrs-fortran-cube/ <code>gccrs-fortran-cube</code>] repository contains an example project using gccrs in conjunction with GFortran, KallistiOS, and GLdc. View [https://www.youtube.com/watch?v=VUiRoEcpvtI footage of the example] running. This example was created by Eric Fradella and used as a demo in the FOSDEM 2024 talk [https://fosdem.org/2024/schedule/event/fosdem-2024-2634-sega-dreamcast-homebrew-with-gcc/ Sega Dreamcast Homebrew with GCC] by [[User:GyroVorbis\|Falco Girgis]].

Darc at 21:00, 8 May 2024

2024-05-08T21:00:03Z

← Older revision		Revision as of 21:00, 8 May 2024
Line 8:		Line 8:
	Follow the [[Getting Started with Dreamcast development]] guide for creating a Dreamcast toolchain until you arrive at the instructions for setting up the <code>dc-chain</code> configuration file.		Follow the [[Getting Started with Dreamcast development]] guide for creating a Dreamcast toolchain until you arrive at the instructions for setting up the <code>dc-chain</code> configuration file.

	- Make sure your shell is currently in the correct directory:		* Make sure your shell is currently in the correct directory:
	cd /opt/toolchains/dc/kos/utils/dc-chain		cd /opt/toolchains/dc/kos/utils/dc-chain

	- (Optional) Make any desired changes to the <code style="inline">Makefile.cfg</code> configuration. Note that to avoid conflicting with an existing stable toolchain at the default path (i.e. <code style="inline">/opt/toolchains/dc/sh-elf</code>), we will be installing to <code>/opt/toolchains/dc/sh-elf-gccrs</code> instead.		* (Optional) Make any desired changes to the <code style="inline">Makefile.cfg</code> configuration. Note that to avoid conflicting with an existing stable toolchain at the default path (i.e. <code style="inline">/opt/toolchains/dc/sh-elf</code>), we will be installing to <code>/opt/toolchains/dc/sh-elf-gccrs</code> instead.

	- To begin compilation and installation, run:		* To begin compilation and installation, run:
	make toolchain_profile=gccrs-dev enable_rust=1 sh_toolchain_path=/opt/toolchains/dc/sh-elf-gccrs		make toolchain_profile=gccrs-dev enable_rust=1 sh_toolchain_path=/opt/toolchains/dc/sh-elf-gccrs

	After building everything, you can clean up the extraneous files in your <code>dc-chain</code> directory by entering:		* After building everything, you can clean up the extraneous files in your <code>dc-chain</code> directory by entering:
	make clean		make clean

Darc at 20:59, 8 May 2024

2024-05-08T20:59:07Z

← Older revision		Revision as of 20:59, 8 May 2024
Line 3:		Line 3:
	At this time, it is recommended to use [[Rust on Dreamcast\|'''rustc_codegen_gcc''']] to develop for Dreamcast using Rust instead of gccrs.		At this time, it is recommended to use [[Rust on Dreamcast\|'''rustc_codegen_gcc''']] to develop for Dreamcast using Rust instead of gccrs.

	Although it is in early stages and highly experimental for Dreamcast dev purposes, it is possible to use this compiler by building a GCC toolchain from a development version or the '''gccrs''' latest toolchain. ~~GCC 15.0.1-dev will get you the latest code upstreamed by the~~ '''~~gccrs~~''' ~~team into the main development branch of GCC, while the~~ '''gccrs''' ~~git repo~~ will ~~get you~~ the absolute latest bleeding edge updates to '''gccrs'''. ~~Both profiles are available in the <code>dc~~-~~chain</code> scripts included with KallistiOS~~. ~~Brief instructions follow for setting up~~ the latest '''gccrs''' ~~toolchain. See [[Getting Started with Dreamcast development]] for more detailed information on how~~ to ~~set up and run <code>dc-chain</code>~~.		Although it is in early stages and highly experimental for Dreamcast dev purposes, it is possible to use this compiler by building a GCC toolchain from a development version or the '''gccrs''' latest toolchain. KallisiOS's '''dc-chain''' scripts include profiles and patches for this. The '''gccrs-dev''' profile will provide with the absolute latest bleeding edge updates to '''gccrs''', while the '''14.1.1-dev''' and '''15.0.1-dev''' profiles will provide the latest changes the '''gccrs''' team has upstreamed to mainline GCC.

	==Building a gccrs-enabled toolchain==		==Building a gccrs-enabled toolchain==
	Follow the [[Getting Started with Dreamcast development]] guide for creating a Dreamcast toolchain until you arrive at the instructions for setting up the <code>dc-chain</code> configuration file.		Follow the [[Getting Started with Dreamcast development]] guide for creating a Dreamcast toolchain until you arrive at the instructions for setting up the <code>dc-chain</code> configuration file.

	Make sure your shell is currently in the correct directory:		- Make sure your shell is currently in the correct directory:
	cd /opt/toolchains/dc/kos/utils/dc-chain		cd /opt/toolchains/dc/kos/utils/dc-chain

	Make any desired changes to the <code style="inline">Makefile.cfg</code> configuration. Note that to avoid conflicting with an existing stable toolchain at the default path (i.e. <code style="inline">/opt/toolchains/dc/sh-elf</code>), we will be installing to <code>/opt/toolchains/dc~~/gccrs~~/sh-elf-gccrs</code> instead. To begin compilation and installation, run:		- (Optional) Make any desired changes to the <code style="inline">Makefile.cfg</code> configuration. Note that to avoid conflicting with an existing stable toolchain at the default path (i.e. <code style="inline">/opt/toolchains/dc/sh-elf</code>), we will be installing to <code>/opt/toolchains/dc/sh-elf-gccrs</code> instead.

			- To begin compilation and installation, run:
	make toolchain_profile=gccrs-dev enable_rust=1 sh_toolchain_path=/opt/toolchains/dc/sh-elf-gccrs		make toolchain_profile=gccrs-dev enable_rust=1 sh_toolchain_path=/opt/toolchains/dc/sh-elf-gccrs

	After building everything, you can clean up the extraneous files in your <code>dc-chain</code> directory by entering:		After building everything, you can clean up the extraneous files in your <code>dc-chain</code> directory by entering:
	make clean		make clean

Darc at 21:20, 7 May 2024

2024-05-07T21:20:37Z

← Older revision		Revision as of 21:20, 7 May 2024
Line 3:		Line 3:
	At this time, it is recommended to use [[Rust on Dreamcast\|'''rustc_codegen_gcc''']] to develop for Dreamcast using Rust instead of gccrs.		At this time, it is recommended to use [[Rust on Dreamcast\|'''rustc_codegen_gcc''']] to develop for Dreamcast using Rust instead of gccrs.

	Although it is in early stages and highly experimental for Dreamcast dev purposes, it is possible to use this compiler by building ~~the~~ GCC ~~14.0.1-dev~~ toolchain or the '''gccrs''' latest toolchain. GCC 14.0.1-dev will get you the latest code upstreamed by the '''gccrs''' team into the main development branch of GCC, while the '''gccrs''' git repo will get you the absolute latest bleeding edge updates to '''gccrs'''. ~~The GCC 14.0.1-dev configuration file is~~ available ~~within~~ the ~~official KallistiOS repo's~~ <code>dc-chain</code> ~~script, while the latest '''gccrs''' configuration is available within the [https://github.com/darcagn/rust-for-dreamcast Rust for Dreamcast] repository~~. Brief instructions follow for setting up the latest '''gccrs''' toolchain. See [[Getting Started with Dreamcast development]] for more detailed information on how to set up and run <code>dc-chain</code>.		Although it is in early stages and highly experimental for Dreamcast dev purposes, it is possible to use this compiler by building a GCC toolchain from a development version or the '''gccrs''' latest toolchain. GCC 15.0.1-dev will get you the latest code upstreamed by the '''gccrs''' team into the main development branch of GCC, while the '''gccrs''' git repo will get you the absolute latest bleeding edge updates to '''gccrs'''. Both profiles are available in the <code>dc-chain</code> scripts included with KallistiOS. Brief instructions follow for setting up the latest '''gccrs''' toolchain. See [[Getting Started with Dreamcast development]] for more detailed information on how to set up and run <code>dc-chain</code>.

	==Building a gccrs-enabled toolchain==		==Building a gccrs-enabled toolchain==

Darc: /* Building a gccrs-enabled toolchain */

2024-05-07T21:19:00Z

Building a gccrs-enabled toolchain

← Older revision		Revision as of 21:19, 7 May 2024
Line 12:		Line 12:

	Make any desired changes to the <code style="inline">Makefile.cfg</code> configuration. Note that to avoid conflicting with an existing stable toolchain at the default path (i.e. <code style="inline">/opt/toolchains/dc/sh-elf</code>), we will be installing to <code>/opt/toolchains/dc/gccrs/sh-elf-gccrs</code> instead. To begin compilation and installation, run:		Make any desired changes to the <code style="inline">Makefile.cfg</code> configuration. Note that to avoid conflicting with an existing stable toolchain at the default path (i.e. <code style="inline">/opt/toolchains/dc/sh-elf</code>), we will be installing to <code>/opt/toolchains/dc/gccrs/sh-elf-gccrs</code> instead. To begin compilation and installation, run:
	make sh_toolchain_path=/opt/toolchains/dc/sh-elf-gccrs		make toolchain_profile=gccrs-dev enable_rust=1 sh_toolchain_path=/opt/toolchains/dc/sh-elf-gccrs
	After building everything, you can clean up the extraneous files in your <code>dc-chain</code> directory by entering:		After building everything, you can clean up the extraneous files in your <code>dc-chain</code> directory by entering:
	make clean		make clean

Darc at 21:18, 7 May 2024

2024-05-07T21:18:02Z

← Older revision		Revision as of 21:18, 7 May 2024
Line 10:		Line 10:
	Make sure your shell is currently in the correct directory:		Make sure your shell is currently in the correct directory:
	cd /opt/toolchains/dc/kos/utils/dc-chain		cd /opt/toolchains/dc/kos/utils/dc-chain
	~~Clone the [https://github.com/darcagn/rust-for-dreamcast Rust for Dreamcast] repository:~~
	~~git clone https://github.com/darcagn/rust-for-dreamcast.git rust~~		Make any desired changes to the <code style="inline">Makefile.cfg</code> configuration. Note that to avoid conflicting with an existing stable toolchain at the default path (i.e. <code style="inline">/opt/toolchains/dc/sh-elf</code>), we will be installing to <code>/opt/toolchains/dc/gccrs/sh-elf-gccrs</code> instead. To begin compilation and installation, run:
	~~Copy the GCC patch in place:~~		make sh_toolchain_path=/opt/toolchains/dc/sh-elf-gccrs
	~~cp rust/patches/toolchain/gcc-rs-kos.diff patches/~~
	~~Copy the <code>dc-chain</code> configuration file into place:~~
	~~cp rust/misc/config.mk.gccrs.sample config.mk~~
	Make any desired changes to the ~~configuration (e.g., change~~ <code>~~makejobs=-j2~~</code> ~~to the number of CPU threads you'd like to use during compilation)~~. Note that to avoid conflicting with an existing stable toolchain at the default path (i.e. <code>/opt/toolchains/dc/sh-elf</code>), we will be installing to <code>/opt/toolchains/dc/gccrs/sh-elf</code> instead. To begin compilation and installation, run:
	make ~~build~~-~~sh4~~
	After building everything, you can clean up the extraneous files in your <code>dc-chain</code> directory by entering:		After building everything, you can clean up the extraneous files in your <code>dc-chain</code> directory by entering:
	make clean		make clean
Line 38:		Line 33:
	</syntaxhighlight>		</syntaxhighlight>

	Make sure before you compile your code that you set <code>export KOS_CC_BASE="/opt/toolchains/dc~~/gccrs~~/sh-elf"</code> in your KallistiOS <code>environ.sh</code> file or <code>make</code> will not find your '''gccrs''' compiler executable.		Make sure before you compile your code that you set <code>export KOS_CC_BASE="/opt/toolchains/dc/sh-elf-gccrs"</code> in your KallistiOS <code>environ.sh</code> file or <code>make</code> will not find your '''gccrs''' compiler executable.

	==Example project==		==Example project==
	The [https://github.com/darcagn/rust-fortran-cube/ <code>rust-fortran-cube</code>] repository contains an example project using gccrs in conjunction with GFortran, KallistiOS, and GLdc. View [https://www.youtube.com/watch?v=VUiRoEcpvtI footage of the example] running. This example was created by Eric Fradella and used as a demo in the FOSDEM 2024 talk [https://fosdem.org/2024/schedule/event/fosdem-2024-2634-sega-dreamcast-homebrew-with-gcc/ Sega Dreamcast Homebrew with GCC] by [[User:GyroVorbis\|Falco Girgis]].		The [https://github.com/darcagn/rust-fortran-cube/ <code>rust-fortran-cube</code>] repository contains an example project using gccrs in conjunction with GFortran, KallistiOS, and GLdc. View [https://www.youtube.com/watch?v=VUiRoEcpvtI footage of the example] running. This example was created by Eric Fradella and used as a demo in the FOSDEM 2024 talk [https://fosdem.org/2024/schedule/event/fosdem-2024-2634-sega-dreamcast-homebrew-with-gcc/ Sega Dreamcast Homebrew with GCC] by [[User:GyroVorbis\|Falco Girgis]].

Darc: /* Building a gccrs-enabled toolchain */

2024-03-18T00:53:16Z

Building a gccrs-enabled toolchain

← Older revision		Revision as of 00:53, 18 March 2024
Line 13:		Line 13:
	git clone https://github.com/darcagn/rust-for-dreamcast.git rust		git clone https://github.com/darcagn/rust-for-dreamcast.git rust
	Copy the GCC patch in place:		Copy the GCC patch in place:
	cp rust/toolchain/gcc-rs-kos.diff patches/		cp rust/patches/toolchain/gcc-rs-kos.diff patches/
	Copy the <code>dc-chain</code> configuration file into place:		Copy the <code>dc-chain</code> configuration file into place:
	cp rust/~~toolchain~~/config.mk.gccrs.sample config.mk		cp rust/misc/config.mk.gccrs.sample config.mk
	Make any desired changes to the configuration (e.g., change <code>makejobs=-j2</code> to the number of CPU threads you'd like to use during compilation). Note that to avoid conflicting with an existing stable toolchain at the default path (i.e. <code>/opt/toolchains/dc/sh-elf</code>), we will be installing to <code>/opt/toolchains/dc/gccrs/sh-elf</code> instead. To begin compilation and installation, run:		Make any desired changes to the configuration (e.g., change <code>makejobs=-j2</code> to the number of CPU threads you'd like to use during compilation). Note that to avoid conflicting with an existing stable toolchain at the default path (i.e. <code>/opt/toolchains/dc/sh-elf</code>), we will be installing to <code>/opt/toolchains/dc/gccrs/sh-elf</code> instead. To begin compilation and installation, run:
	make build-sh4		make build-sh4

Darc at 00:28, 18 February 2024

2024-02-18T00:28:18Z

← Older revision		Revision as of 00:28, 18 February 2024
Line 1:		Line 1:
	'''gccrs''' is the Rust compiler frontend for GCC, currently under active development. This Rust compiler is a new implementation of Rust from the ground up using the GCC toolchain infrastructure. This project is in early stages and is targeting the Rust 1.49 revision from December 2020. As of this writing (February 2024), it is not yet able to compile Rust's <code>libcore</code>, so many basic language features are unimplemented or not functional. Additionally, Rust standard tooling like <code>cargo</code> is not available. Borrow checking is not implemented, but the project plans to later use the next-generation Rust borrow checker [https://github.com/rust-lang/polonius Polonius] from the official Rust project.		'''gccrs''' is the Rust compiler frontend for GCC, currently under active development. This Rust compiler is a new implementation of Rust from the ground up using the GCC toolchain infrastructure. This project is in early stages and is targeting the Rust 1.49 revision from December 2020. As of this writing (February 2024), it is not yet able to compile Rust's <code>libcore</code>, so many basic language features are unimplemented or not functional. Additionally, Rust standard tooling like <code>cargo</code> is not available. Borrow checking is not implemented, but the project plans to later use the next-generation Rust borrow checker [https://github.com/rust-lang/polonius Polonius] from the official Rust project.

			At this time, it is recommended to use [[Rust on Dreamcast\|'''rustc_codegen_gcc''']] to develop for Dreamcast using Rust instead of gccrs.

	Although it is in early stages and highly experimental for Dreamcast dev purposes, it is possible to use this compiler by building the GCC 14.0.1-dev toolchain or the '''gccrs''' latest toolchain. GCC 14.0.1-dev will get you the latest code upstreamed by the '''gccrs''' team into the main development branch of GCC, while the '''gccrs''' git repo will get you the absolute latest bleeding edge updates to '''gccrs'''. The GCC 14.0.1-dev configuration file is available within the official KallistiOS repo's <code>dc-chain</code> script, while the latest '''gccrs''' configuration is available within the [https://github.com/darcagn/rust-for-dreamcast Rust for Dreamcast] repository. Brief instructions follow for setting up the latest '''gccrs''' toolchain. See [[Getting Started with Dreamcast development]] for more detailed information on how to set up and run <code>dc-chain</code>.		Although it is in early stages and highly experimental for Dreamcast dev purposes, it is possible to use this compiler by building the GCC 14.0.1-dev toolchain or the '''gccrs''' latest toolchain. GCC 14.0.1-dev will get you the latest code upstreamed by the '''gccrs''' team into the main development branch of GCC, while the '''gccrs''' git repo will get you the absolute latest bleeding edge updates to '''gccrs'''. The GCC 14.0.1-dev configuration file is available within the official KallistiOS repo's <code>dc-chain</code> script, while the latest '''gccrs''' configuration is available within the [https://github.com/darcagn/rust-for-dreamcast Rust for Dreamcast] repository. Brief instructions follow for setting up the latest '''gccrs''' toolchain. See [[Getting Started with Dreamcast development]] for more detailed information on how to set up and run <code>dc-chain</code>.

Darc at 00:23, 18 February 2024

2024-02-18T00:23:13Z

← Older revision		Revision as of 00:23, 18 February 2024
Line 37:		Line 37:

	Make sure before you compile your code that you set <code>export KOS_CC_BASE="/opt/toolchains/dc/gccrs/sh-elf"</code> in your KallistiOS <code>environ.sh</code> file or <code>make</code> will not find your '''gccrs''' compiler executable.		Make sure before you compile your code that you set <code>export KOS_CC_BASE="/opt/toolchains/dc/gccrs/sh-elf"</code> in your KallistiOS <code>environ.sh</code> file or <code>make</code> will not find your '''gccrs''' compiler executable.

			==Example project==
			The [https://github.com/darcagn/rust-fortran-cube/ <code>rust-fortran-cube</code>] repository contains an example project using gccrs in conjunction with GFortran, KallistiOS, and GLdc. View [https://www.youtube.com/watch?v=VUiRoEcpvtI footage of the example] running. This example was created by Eric Fradella and used as a demo in the FOSDEM 2024 talk [https://fosdem.org/2024/schedule/event/fosdem-2024-2634-sega-dreamcast-homebrew-with-gcc/ Sega Dreamcast Homebrew with GCC] by [[User:GyroVorbis\|Falco Girgis]].