OS-9 - Revision history

Jfed: Changes to add FoenixMgr configuration instructions

2025-05-18T13:46:10Z

Changes to add FoenixMgr configuration instructions

← Older revision		Revision as of 09:46, 18 May 2025
Line 40:		Line 40:

	=== Configure FoenixMgr ===		=== Configure FoenixMgr ===
	The makefiles for f256 NitrOS-9 use the <code>bulk-flash</code> command from FoenixMgr. This command is in the <code>bin</code> directory of coco-shelf. The <code>bin</code> directory must be in your <code>PATH</code> in order for the flash procedure to work from the NitrOS-9 makefile. On linux, ~~you can~~ add a line to your <code>.profile</code> similar to:		The makefiles for f256 NitrOS-9 use the <code>bulk-flash</code> command from FoenixMgr. This command is in the <code>bin</code> directory of coco-shelf. The <code>bin</code> directory must be in your <code>PATH</code> in order for the flash procedure to work from the NitrOS-9 makefile. On linux, add a line to your <code>.profile</code> similar to:

	~~<code>~~PATH="$HOME/coco-shelf/bin:$PATH"~~</code>~~		PATH="$HOME/coco-shelf/bin:$PATH"

	FoenixMgr's <code>foenixmgr.ini</code> file must also be configured with the correct port to flash the f256. The F256 Jr.Jr. and F256 K2 both have a USB-C serial port that requires no additional drivers. The F256 Jr. and F256-K have a USB debug port which requires a special driver to work. The procedure for the F256 Jr.Jr. and F256 K2: plug the usb cable to your computer and the F256 and turn on the F256. On linux, type lsusb to verify the connection. The output should show an FT4232 UART:		FoenixMgr's <code>foenixmgr.ini</code> file must also be configured with the correct port to flash the f256. The F256 Jr.Jr. and F256 K2 both have a USB-C serial port that requires no additional drivers. The F256 Jr. and F256-K have a USB debug port which requires a special driver to work. The procedure for the F256 Jr.Jr. and F256 K2: plug the usb cable to your computer and the F256 and turn on the F256. On linux, type lsusb to verify the connection. The output should show an FT4232 UART:

	~~<code>~~~/coco-shelf/FoenixMgr $ lsusb~~</code>~~		~/coco-shelf/FoenixMgr $ lsusb

	~~<code>~~Bus 002 Device 002: ID 174c:55aa ASMedia Technology Inc. ASM1051E SATA 6Gb/s bridge, ASM1053E SATA 6Gb/s bridge, ASM1153 SATA 3Gb/s bridge, ASM1153E SATA 6Gb/s bridge~~</code>~~		Bus 002 Device 002: ID 174c:55aa ASMedia Technology Inc. ASM1051E SATA 6Gb/s bridge, ASM1053E SATA 6Gb/s bridge, ASM1153 SATA 3Gb/s bridge, ASM1153E SATA 6Gb/s bridge
			Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
	~~<code>~~Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub~~</code>~~		'''Bus 001 Device 017: ID 0403:6011 Future Technology Devices International, Ltd FT4232H Quad HS USB-UART/FIFO IC'''
			Bus 001 Device 003: ID 248a:8367 Maxxter Telink Wireless Receiver
	~~<code>B~~'''us 001 Device 017: ID 0403:6011 Future Technology Devices International, Ltd FT4232H Quad HS USB-UART/FIFO IC'''~~</code>~~		Bus 001 Device 002: ID 2109:3431 VIA Labs, Inc. Hub

	~~<code>~~Bus 001 Device 003: ID 248a:8367 Maxxter Telink Wireless Receiver~~</code>~~

	~~<code>~~Bus 001 Device 002: ID 2109:3431 VIA Labs, Inc. Hub~~</code>~~

	Next change directory to coco-shelf/FoenixMgr and run python <code>FoenixMgr/FoenixMgr.py --list-ports</code>.		Next change directory to coco-shelf/FoenixMgr and run python <code>FoenixMgr/FoenixMgr.py --list-ports</code>.

	~~<code>~~~~~/projects~~/coco-shelf/FoenixMgr $ python FoenixMgr/fnxmgr.py --list-ports~~</code>~~		~/coco-shelf/FoenixMgr $ python FoenixMgr/fnxmgr.py --list-ports

	~~<code>~~++ python3 FoenixMgr/fnxmgr.py --list-ports~~</code>~~		++ python3 FoenixMgr/fnxmgr.py --list-ports
			Description: n/a
	~~<code>/dev/ttyS0</code>~~		Manufacturer: None
			Product: None
	~~<code> Description~~: n/a~~</code>~~		/dev/ttyUSB3
			Description: New Retro Computer - New Retro Computer
	~~<code> Manufacturer~~: None~~</code>~~		Manufacturer: Xilinx
			Product: New Retro Computer
	~~<code> Product~~: None~~</code>~~		/dev/ttyUSB2
			Description: New Retro Computer - New Retro Computer
	~~<code>~~/dev/ttyUSB3~~</code>~~		Manufacturer: Xilinx
			Product: New Retro Computer
	~~<code> Description~~: New Retro Computer - New Retro Computer~~</code>~~		/dev/ttyUSB1
			Description: New Retro Computer - New Retro Computer
	~~<code> Manufacturer~~: Xilinx~~</code>~~		Manufacturer: Xilinx
			Product: New Retro Computer
	~~<code> Product~~: New Retro Computer~~</code>~~		/dev/ttyUSB0</code>
			Description: New Retro Computer - New Retro Computer
	~~<code>~~/dev/ttyUSB2~~</code>~~		Manufacturer: Xilinx
			Product: New Retro Computer
	~~<code> Description~~: New Retro Computer - New Retro Computer~~</code>~~

	~~<code> Manufacturer~~: Xilinx~~</code>~~

	~~<code> Product~~: New Retro Computer~~</code>~~

	~~<code>~~/dev/ttyUSB1~~</code>~~

	~~<code> Description~~: New Retro Computer - New Retro Computer~~</code>~~

	~~<code> Manufacturer~~: Xilinx~~</code>~~

	~~<code> Product~~: New Retro Computer~~</code>~~

	~~<code>~~/dev/ttyUSB0</code>

	~~<code> Description~~: New Retro Computer - New Retro Computer~~</code>~~

	~~<code> Manufacturer~~: Xilinx~~</code>~~

	~~<code> Product~~: New Retro Computer~~</code>~~

	The second port,<code>/dev/ttyUSB1</code>, should be the correct port. Change the port line in <code>foenixmgr.ini</code> to this port and save it (you don't have to worry about the other settings):		The second port,<code>/dev/ttyUSB1</code>, should be the correct port. Change the port line in <code>foenixmgr.ini</code> to this port and save it (you don't have to worry about the other settings):

	~~<code>~~~/coco-shelf/FoenixMgr/foenixmgr.ini~~</code>~~		~/coco-shelf/FoenixMgr/foenixmgr.ini

	~~<code>~~[DEFAULT]~~</code>~~		[DEFAULT]
			'''port=/dev/ttyUSB1'''
	~~<code>~~port=/dev/ttyUSB1~~</code>~~		labels=sample.lbl
			flash_address=380000
	~~<code>~~labels=sample.lbl~~</code>~~		chunk_size=1024
			cpu=65816
	~~<code>~~flash_address=380000~~</code>~~

	~~<code>~~chunk_size=1024~~</code>~~

	~~<code>~~cpu=65816~~</code>~~

	FoenixMgr should now be configured to flash the <code>FEU</code>.		FoenixMgr should now be configured to flash the <code>FEU</code>.

Jfed: /* Tooling */ Add configuring FoenixMgr

2025-05-18T13:23:40Z

Tooling: Add configuring FoenixMgr

@@ Line 38: / Line 38: @@
 or
   make ANON=1 run-f256k-flash       # TODO fix this
 == Building FEU and OS-9 Level 1 from scratch ==

Jfed: /* Building OS-9 Level 2 */

2024-10-22T13:01:10Z

Building OS-9 Level 2

← Older revision		Revision as of 09:01, 22 October 2024
Line 62:		Line 62:

	== Building OS-9 Level 2 ==		== Building OS-9 Level 2 ==
	To build OS-9 Level 2, run these commands (this assumes you have added the NITROS9DIR environment variable as above: export NITROS9DIR=$PWD):		To build OS-9 Level 2, run these commands (this assumes you have added the NITROS9DIR environment variable as above: export NITROS9DIR=$PWD from the top level nitros9 directory):
	cd ../../level2/f256		cd ../../level2/f256
	make dsk		make dsk

Jfed: /* Building OS-9 Level 2 */

2024-10-22T13:00:31Z

Building OS-9 Level 2

← Older revision		Revision as of 09:00, 22 October 2024
Line 62:		Line 62:

	== Building OS-9 Level 2 ==		== Building OS-9 Level 2 ==
	To build OS-9 Level 2, run these commands:		To build OS-9 Level 2, run these commands (this assumes you have added the NITROS9DIR environment variable as above: export NITROS9DIR=$PWD):
	cd ../../level2/f256		cd ../../level2/f256
	make dsk		make dsk

Jfed at 12:53, 22 October 2024

2024-10-22T12:53:51Z

← Older revision		Revision as of 08:53, 22 October 2024
Line 55:		Line 55:
	make flash_f256k		make flash_f256k

	Then:		Then (this is in addition to make flash_f256jr or make flash_f256k):

	~~<code>~~make flash_f0~~</code>~~		make flash_f0

	Once the flash completes, restart the machine and FEU should come up.		Once the flash completes, restart the machine and FEU should come up.

Jfed: /* Building FEU and OS-9 Level 1 from scratch */

2024-10-22T12:52:16Z

Building FEU and OS-9 Level 1 from scratch

← Older revision		Revision as of 08:52, 22 October 2024
Line 54:		Line 54:
	cd feu		cd feu
	make flash_f256k		make flash_f256k

			Then:

			<code>make flash_f0</code>

	Once the flash completes, restart the machine and FEU should come up.		Once the flash completes, restart the machine and FEU should come up.

Strick9: The new commands did not work, so I'm adding back the old one

2024-06-26T21:51:03Z

The new commands did not work, so I'm adding back the old one

← Older revision		Revision as of 17:51, 26 June 2024
Line 33:		Line 33:
	Then you have to edit the `port=` line in `FoenixMgr/foenixmgr.ini`		Then you have to edit the `port=` line in `FoenixMgr/foenixmgr.ini`
	and run the command again (with the cable plugged in):		and run the command again (with the cable plugged in):
	make ANON=1 run-~~f256jr~~-flash		make ANON=1 run-f256-flash # Old command for F256Jr that works?
	or		or
	make ANON=1 run-f256k-flash		make ANON=1 run-f256jr-flash # TODO fix this
			or
			make ANON=1 run-f256k-flash # TODO fix this

	== Building FEU and OS-9 Level 1 from scratch ==		== Building FEU and OS-9 Level 1 from scratch ==

Strick9: support both Jr and K with the flash command

2024-06-26T21:44:21Z

support both Jr and K with the flash command

← Older revision		Revision as of 17:44, 26 June 2024
Line 29:		Line 29:
	in case you want to push changes.)		in case you want to push changes.)

	There is a special Make target for re-flashing the ~~F256 Jr~~,		There is a special Make target for re-flashing the F256Jr or F256K,
	but first time you run this command, it should fail.		but first time you run this command, it should fail.
	Then you have to edit the `port=` line in `FoenixMgr/foenixmgr.ini`		Then you have to edit the `port=` line in `FoenixMgr/foenixmgr.ini`
	and run the command again (with the cable plugged in):		and run the command again (with the cable plugged in):
	make ANON=1 run-~~f256~~-flash		make ANON=1 run-f256jr-flash
			or
			make ANON=1 run-f256k-flash

	== Building FEU and OS-9 Level 1 from scratch ==		== Building FEU and OS-9 Level 1 from scratch ==

Strick9: specify that my flash command is for the Jr

2024-06-26T21:40:28Z

specify that my flash command is for the Jr

← Older revision		Revision as of 17:40, 26 June 2024
Line 29:		Line 29:
	in case you want to push changes.)		in case you want to push changes.)

	There is a special Make target for re-flashing the F256,		There is a special Make target for re-flashing the F256 Jr,
	but first time you run this command, it should fail.		but first time you run this command, it should fail.
	Then you have to edit the `port=` line in `FoenixMgr/foenixmgr.ini`		Then you have to edit the `port=` line in `FoenixMgr/foenixmgr.ini`

Strick9: /* Tooling */

2024-06-26T21:23:31Z

Tooling

← Older revision		Revision as of 17:23, 26 June 2024
Line 21:		Line 21:
	git clone <nowiki>https://github.com/strickyak/coco-shelf.git</nowiki>		git clone <nowiki>https://github.com/strickyak/coco-shelf.git</nowiki>
	cd coco-shelf		cd coco-shelf
	export PATH=$PATH:$HOME/coco-shelf/bin		export PATH="$PATH:$HOME/coco-shelf/bin"
	make ~~mirror-stuff~~ done~~-lwtools~~ done-~~cmoc done~~-~~toolshed done~~-~~nitros9~~		make ANON=1 nitros9/done FoenixMgr/done

			(If you have a github account and your github ssh key is loaded,
			you can omit `ANON=1` on the last command,
			so it will check out git repositories using your github username,
			in case you want to push changes.)

			There is a special Make target for re-flashing the F256,
			but first time you run this command, it should fail.
			Then you have to edit the `port=` line in `FoenixMgr/foenixmgr.ini`
			and run the command again (with the cable plugged in):
			make ANON=1 run-f256-flash

	== Building FEU and OS-9 Level 1 from scratch ==		== Building FEU and OS-9 Level 1 from scratch ==