Development Tools:Linux setup - Revision history

Ped7g: adding more info about possible MAME config

2026-04-29T18:19:21Z

adding more info about possible MAME config

Ped7g: /* Installing the executable and configuration */

2026-04-25T18:52:10Z

Installing the executable and configuration

@@ Line 316: / Line 316: @@
 === Installing the executable and configuration ===
 TODO
 === Checking if it all works ===

Ped7g at 22:11, 22 April 2026

2026-04-22T22:11:53Z

← Older revision		Revision as of 23:11, 22 April 2026
Line 301:		Line 301:
	# If you want to, you can change to TOOLS=1 to build also "various additional tools, such as chdman"		# If you want to, you can change to TOOLS=1 to build also "various additional tools, such as chdman"
	# The name of resulting binary is affected by SUBTARGET=tbblue, leave it out if you want "mame"		# The name of resulting binary is affected by SUBTARGET=tbblue, leave it out if you want "mame"
	make REGENIE=1 EMULATOR=1 TOOLS=0 SOURCES=sinclair/specnext.cpp SUBTARGET=tbblue -j $(nproc)		make REGENIE=1 EMULATOR=1 TOOLS=0 SOURCES=sinclair/next/specnext.cpp SUBTARGET=tbblue -j $(nproc)
	# check the build output to confirm that compilation succeeded. To list binary:		# check the build output to confirm that compilation succeeded. To list binary:
	ls -lh tbblue</nowiki>		ls -lh tbblue</nowiki>

Ped7g: Adding MAME source retrieval and compilation notes

2026-01-21T21:48:36Z

Adding MAME source retrieval and compilation notes

@@ Line 270: / Line 270: @@
 == MAME emulator ==
-TODO: placeholder for compilation and setup notes, to be added hopefully soon by Ped7g
+MAME got Next emulation and it got improved a lot around end of 2025, turning it into probably most accurate and performant Next emulator currently available. But as that shift is quite recent, the developers community haven’t transitioned to it yet in large numbers and the tutorials and examples are non-existent. This section provides a basic Linux setup guide.
 == #CSpect emulator ==

Ped7g: add placeholder for MAME lore

2026-01-21T16:46:26Z

add placeholder for MAME lore

← Older revision		Revision as of 17:46, 21 January 2026
Line 267:		Line 267:
	* Mount points are created under <code>/media/$USER/</code> unless overridden by system policy.		* Mount points are created under <code>/media/$USER/</code> unless overridden by system policy.
	* UDisks may auto‑mount partitions immediately after '''loop‑setup''' depending on desktop environment settings.		* UDisks may auto‑mount partitions immediately after '''loop‑setup''' depending on desktop environment settings.

			== MAME emulator ==

			TODO: placeholder for compilation and setup notes, to be added hopefully soon by Ped7g

	== #CSpect emulator ==		== #CSpect emulator ==

Ped7g: adding mount card with udisksctl and change losetup -D advice

2026-01-21T16:32:41Z

adding mount card with udisksctl and change losetup -D advice

@@ Line 210: / Line 210: @@
 When finished:
   <nowiki>sudo umount next-card/
-sudo losetup -D</nowiki>
+sudo losetup -d /dev/loop0
 This detaches the loop device and frees all associated /dev/loop* entries.
@@ Line 217: / Line 218: @@
 * Do not use the image in an emulator while it is mounted.
 * If the image has no partition table, --partscan will not create /dev/loop0p1.
-* If multiple loop devices are active, check losetup -a to confirm which one is yours.
+* If multiple loop devices are active, check <code>losetup -a</code> to confirm which one is yours.
-=== TODO: udiskctl loop device mounting option ===
+== Mounting sd‑card image with udisksctl ==
-From discord: "udisksctl loop-setup --file ~/spec/SpectrumNext/tbblue/image/tbblue.mmc"
+The <code>udisksctl</code> tool provides a desktop‑friendly way to attach loop devices and mount filesystems without manually calculating offsets or using <code>losetup</code>. It integrates with system services such as UDisks2, and on many desktop Linux systems it allows non‑root users (who are in the correct group) to mount images safely.
-TODO: describe this solution and check possible gotchas/CLI options (like user must be in udiskctl group to run this without sudo, etc).
+=== Prerequisites ===
 == #CSpect emulator ==

Ped7g: adding mount card with losetup

2026-01-21T15:59:28Z

adding mount card with losetup

← Older revision		Revision as of 16:59, 21 January 2026
Line 191:		Line 191:

	Check the result. If the unmounting fails (probably with "target is busy"), find which process is still accessing/viewing the files in the next-card directory, and try to unmount it again.		Check the result. If the unmounting fails (probably with "target is busy"), find which process is still accessing/viewing the files in the next-card directory, and try to unmount it again.

			== Mounting sd-card image with losetup ==

			Alternative using losetup to use local "loop" device for mounting the image. This method can automatically detect partitions inside the image and exposes them as loop devices.

			Prepare mounting dir and make sure you have <code>mount</code> and <code>losetup</code> available, Ubuntu based systems packages:
			<nowiki>sudo apt-get install util-linux mount</nowiki>

			=== Use losetup to attach image and scan its partitions ===

			<nowiki>sudo losetup --partscan --show --find NextZXOS.img
			# this will print new loop device and automatically create partition devices like /dev/loop0p1
			# now mount the desired FAT32 partition:
			sudo mount /dev/loop0p1 next-card/</nowiki>

			=== Unmounting and cleanup of loop device ===

			When finished:
			<nowiki>sudo umount next-card/
			sudo losetup -D</nowiki>

			This detaches the loop device and frees all associated /dev/loop* entries.

			Notes and gotchas:
			* Do not use the image in an emulator while it is mounted.
			* If the image has no partition table, --partscan will not create /dev/loop0p1.
			* If multiple loop devices are active, check losetup -a to confirm which one is yours.

	=== TODO: udiskctl loop device mounting option ===		=== TODO: udiskctl loop device mounting option ===

Ped7g: adding alternative way to create card image documenting compatibility caveat

2026-01-21T00:00:13Z

adding alternative way to create card image documenting compatibility caveat

@@ Line 136: / Line 136: @@
 du -h tbblue.img
 z l tbblue.img | more</nowiki>
 == Mounting sd-card image directly ==

Ped7g: unifying usage of tags and terms in main titles

2025-12-22T20:05:19Z

unifying usage of tags and terms in main titles

← Older revision		Revision as of 21:05, 22 December 2025
Line 107:		Line 107:
	...</nowiki>		...</nowiki>

	== Extracting all files from the SD image ==		== Extracting all files from the sd-card image ==

	7-zip is the most convenient tool to extract the the files from the existing image.		7-zip is the most convenient tool to extract the the files from the existing image.
Line 115:		Line 115:
	To extract all the files from an existing image <code>tbblue.img</code> to a new subdirectory <code>myfiles</code>:		To extract all the files from an existing image <code>tbblue.img</code> to a new subdirectory <code>myfiles</code>:

	<~~code~~>7z x tbblue.img -omyfiles</~~code~~>		<nowiki>7z x tbblue.img -omyfiles</nowiki>

	== Creating a new SD image ~~from the archive~~ ==		== Creating new sd-card image with hdfmonkey ==

	This example:		This example:
Line 128:		Line 128:
	* starts listing the content of the newly created image		* starts listing the content of the newly created image

	<~~pre~~>		<nowiki>
	wget https://www.specnext.com/distro/24.11/sn-complete-24.11.zip		wget https://www.specnext.com/distro/24.11/sn-complete-24.11.zip
	7z x sn-complete-24.11.zip -otmptb		7z x sn-complete-24.11.zip -otmptb
Line 135:		Line 135:
	rm -rf tmptb		rm -rf tmptb
	du -h tbblue.img		du -h tbblue.img
	7z l tbblue.img \| more		7z l tbblue.img \| more</nowiki>
	</~~pre~~>

	== Mounting sd-card image directly ==		== Mounting sd-card image directly ==

Johnnyo: New sections about extracting the files and creating the image

2025-11-27T16:16:33Z

New sections about extracting the files and creating the image

@@ Line 106: / Line 106: @@
 usage: hdfmonkey <command> [args]
 ...</nowiki>
 == Mounting sd-card image directly ==