Advanced IC10 Programming - Revision history

TK421: Using syntax highlighting module instead

2026-02-22T07:48:32Z

Using syntax highlighting module instead

@@ Line 66: / Line 66: @@
 == Loops ==
-<div style="background: #000000; float: none">
+j main
-<p style="float: none; white-space: pre; line-height: 1; color: #FFFFFF; background: #000000; font-size: 110%;font-family:Consolas; margin-left: 10px;><span style="color: #00FFFF;">alias</span><span> </span><span>rIterator</span><span> </span><span>r0</span><span>
+}}
 The challenge with loops is to keep them clean. Relative jumps are a great way to save lines but they can quickly turn code messy because adding lines might break them if you don't adjust the relative jump. If code length is not an issue, stick to labels where possible.

TK421: Using syntax highlighting module instead

2026-02-22T07:45:35Z

Using syntax highlighting module instead

@@ Line 84: / Line 84: @@
 == Indexing With Relative Jump ==
-<div style="background: #000000; float: none">
+main:
-<p style="float: none; white-space: pre; line-height: 1; color: #FFFFFF; background: #000000; font-size: 110%;font-family:Consolas; margin-left: 10px;><span style="color: #00FFFF;">alias</span><span> </span><span>rIndex</span><span> </span><span>r0</span><span>
+move rIndex 1
-</span><span style="color: #00FFFF;">alias</span><span> </span><span>rTemp</span><span> </span><span>r1</span><span>
+mul rTemp rIndex 2
-</span><span style="color: #00FFFF;">alias</span><span> </span><span>rValue</span><span> </span><span>r2</span><span>
+add rTemp rTemp 1
 Use this to set one or more parameters or call functions using an index number you calculated (or read from a dial button). We multiply it by 2 because we need space for a jump after each move command so we don't run the subsequent ones and we add 1 because for a 0 index "jr 0" would lock up our IC.
 == Indexing With Comparison ==

TK421: Using syntax highlighting module instead

2026-02-22T03:18:37Z

Using syntax highlighting module instead

← Older revision		Revision as of 03:18, 22 February 2026
Line 112:		Line 112:

	== Indexing With Comparison ==		== Indexing With Comparison ==
			{{ICCode\|
			alias rIndex r0
			alias rValue r1

	~~<div style="background: #000000; float: none">~~		main:
	<p style="float: none; white-space: pre; line-height: 1; color: #FFFFFF; background: #000000; font-size: 110%;font-family:Consolas; margin-left: 10px;><span style="color: #00FFFF;">alias</span><span> </span><span>rIndex</span><span> </span><span>r0</span><span>		move rIndex 1</span>
	~~</span><span style="color: #00FFFF;">alias</span><span> </span><span>rValue</span><span> </span><span>r1</span><span>~~		move rValue 123 #Index 0
			sub rIndex rIndex 1
	~~</span><span>~~main:~~</span><span></span>~~		select rValue rIndex rValue 456 #Index 1
	~~<span style="color: #6666FF;">~~move~~</span><span> </span><span>~~rIndex~~</span><span> </span><span>~~1</span>		sub rIndex rIndex 1
	~~<span style="color: #6666FF;">~~move~~</span><span> </span><span>~~rValue~~</span><span> </span><span>~~ 123~~</span><span> </span><span style="color: #FF8000;">~~ #Index 0~~</span>~~		select rValue rIndex rValue 789 #Index 2
	~~<span style="color: #6666FF;">~~sub~~</span><span> </span><span>~~rIndex~~</span><span> </span><span>~~rIndex~~</span><span>~~ 1~~</span>~~		j main
	~~<span style="color: #FF0000;">~~select~~</span><span>~~ rValue~~</span><span>~~ rIndex~~</span><span>~~ rValue~~</span><span>~~ 456~~</span><span style="color: #FF8000;">~~ #Index 1~~</span>~~		}}
	~~<span style="color: #6666FF;">~~sub~~</span><span> </span><span>~~rIndex~~</span><span> </span><span>~~rIndex~~</span><span>~~ 1~~</span>~~
	~~<span style="color: #FF0000;">~~select~~</span><span>~~ rValue~~</span><span>~~ rIndex~~</span><span>~~ rValue~~</span><span>~~ 789~~</span><span style="color: #FF8000;">~~ #Index 2~~</span>~~
	~~<span style="color: #FF0000;">~~j~~</span><span> </span><span>~~main~~</span><span>~~

	~~</span>~~
	~~</p>~~
	~~</div>~~
	In most programming languages, you can do the same thing in different ways. A third way would be to use the stack.		In most programming languages, you can do the same thing in different ways. A third way would be to use the stack.

TK421: Using syntax highlighting module instead

2026-02-21T09:41:41Z

Using syntax highlighting module instead

← Older revision		Revision as of 09:41, 21 February 2026
Line 134:		Line 134:

	Say you have a complex function that manipulates a device (reads/writes multiple parameters, controls timing etc) and you want to reuse it for multiple devices. You could copy paste the whole function, or you could redefine the alias you used and point it to another device, like this:		Say you have a complex function that manipulates a device (reads/writes multiple parameters, controls timing etc) and you want to reuse it for multiple devices. You could copy paste the whole function, or you could redefine the alias you used and point it to another device, like this:
			{{ICCode\|
	~~<div style="background: #000000; float: none">~~		main:
	~~<p style="float: none; white-space: pre; line-height: 1; color: #FFFFFF; background: #000000; font-size: 110%;font-family:Consolas; margin-left: 10px;><span>~~main:~~</span><span>~~		alias dCurrent d0
	~~</span><span style="color: #00FFFF;">~~alias~~</span><span> </span><span>~~dCurrent~~</span><span> </span><span>~~d0~~</span><span>~~		jal _MyFunction
	~~</span><span style="color: #FF0000;">~~jal~~</span><span> </span><span>~~_MyFunction~~</span><span>~~		alias dCurrent d1
	~~</span><span style="color: #00FFFF;">~~alias~~</span><span> </span><span>~~dCurrent~~</span><span> </span><span>~~d1~~</span><span>~~		jal _MyFunction
	~~</span><span style="color: #FF0000;">~~jal~~</span><span> </span><span>~~_MyFunction~~</span><span>~~		j main
	~~</span><span style="color: #FF0000;">~~j~~</span><span> </span><span>~~main~~</span><span>~~		}}

	~~</span>~~
	~~</p>~~
	~~</div>~~
	''NOTE: This wouldn't work in real languages since aliases and defines are just directives for the (pre)compiler, they're not evaluated during runtime by the CPU''		''NOTE: This wouldn't work in real languages since aliases and defines are just directives for the (pre)compiler, they're not evaluated during runtime by the CPU''

	You can combine this with a loop and indexing to run your function on multiple devices automatically.		You can combine this with a loop and indexing to run your function on multiple devices automatically.
	~~<div style="background: #000000; float: none">~~		{{ICCode\|
	~~<p style="float: none; white-space: pre; line-height: 1; color: #FFFFFF; background: #000000; font-size: 110%;font-family:Consolas; margin-left: 10px;><span style="color: #00FFFF;">~~alias~~</span><span> </span><span>~~rIterator~~</span><span> </span><span>~~r0~~</span><span>~~		alias rIterator r0
	~~</span><span style="color: #00FFFF;">~~alias~~</span><span> </span><span>~~rTemp~~</span><span> </span><span>~~r1~~</span><span>~~		alias rTemp r1
	~~</span><span>~~main:~~</span><span>~~		main:
	~~</span><span style="color: #6666FF;">~~move~~</span><span> </span><span>~~rIterator~~</span><span> </span><span>~~0~~</span><span>~~		move rIterator 0
	~~</span><span>~~Loop:~~</span><span>~~		Loop:
	~~</span><span style="color: #FF0000;">~~jal~~</span><span> </span><span>~~_UpdateReference~~</span><span>~~		jal _UpdateReference
	~~</span><span style="color: #FF0000;">~~jal~~</span><span> </span><span>~~_FunctionForDevice~~</span><span>~~		jal _FunctionForDevice
	~~</span><span style="color: #6666FF;">~~add~~</span><span> </span><span>~~rIterator~~</span><span> </span><span>~~rIterator~~</span><span> </span><span>~~1~~</span><span>~~		add rIterator rIterator 1
	~~</span><span style="color: #FF0000;">~~bgt~~</span><span> </span><span>~~rIterator~~</span><span> </span><span>~~3~~</span><span> </span><span>~~Loop_End~~</span><span>~~		bgt rIterator 3 Loop_End
	~~</span><span style="color: #FF0000;">~~j~~</span><span> </span><span>~~Loop~~</span><span>~~		j Loop
	~~</span><span>~~Loop_End:~~</span><span>~~		Loop_End:
	~~</span><span style="color: #FF0000;">~~j~~</span><span> </span><span>~~main~~</span><span>~~		j main

	~~</span><span>_UpdateReference:</span><span>~~
	~~</span><span style="color: #6666FF;">mul</span><span> </span><span>rTemp</span><span> </span><span>rIterator</span><span> </span><span>2</span><span>~~
	~~</span><span style="color: #6666FF;">add</span><span> </span><span>rTemp</span><span> </span><span>rTemp</span><span> </span><span>1</span><span>~~
	~~</span><span style="color: #FF0000;">jr</span><span> </span><span>rTemp</span><span>~~
	~~</span><span style="color: #00FFFF;">alias</span><span> </span><span>dCurrentDevice</span><span> </span><span>d0</span><span> </span><span style="color: #FF8000;">#Index 0~~
	~~</span><span style="color: #FF0000;">j</span><span> </span><span>Select_end</span><span>~~
	~~</span><span style="color: #00FFFF;">alias</span><span> </span><span>dCurrentDevice</span><span> </span><span>d1</span><span> </span><span style="color: #FF8000;">#Index 1~~
	~~</span><span style="color: #FF0000;">j</span><span> </span><span>Select_end</span><span>~~
	~~</span><span style="color: #00FFFF;">alias</span><span> </span><span>dCurrentDevice</span><span> </span><span>d2</span><span> </span><span style="color: #FF8000;">#Index 2~~
	~~</span><span style="color: #FF0000;">j</span><span> </span><span>Select_end</span><span>~~
	~~</span><span style="color: #00FFFF;">alias</span><span> </span><span>dCurrentDevice</span><span> </span><span>d3</span><span> </span><span style="color: #FF8000;">#Index 3~~
	~~</span><span style="color: #FF0000;">j</span><span> </span><span>Select_end</span><span>~~
	~~</span><span>Select_end:</span><span>~~
	~~</span><span style="color: #FF0000;">j</span><span> </span><span>ra</span><span>~~

	~~</span><span>_FunctionForDevice~~:~~</span><span>~~		_UpdateReference:
	~~</span><span style="color:~~ #~~FF8000;">~~#~~Manipulate~~ dCurrentDevice		mul rTemp rIterator 2
	~~</span><span style="color~~: ~~#FF0000;">~~j~~</span><span> </span><span>~~ra~~</span><span>~~		add rTemp rTemp 1
			jr rTemp
			alias dCurrentDevice d0 #Index 0
			j Select_end
			alias dCurrentDevice d1 #Index 1
			j Select_end
			alias dCurrentDevice d2 #Index 2
			j Select_end
			alias dCurrentDevice d3 #Index 3
			j Select_end
			Select_end:
			j ra

	~~</span>~~		_FunctionForDevice:
	~~</p>~~		#Manipulate dCurrentDevice
	~~</div>~~		j ra
			}}

	= Device Manipulation =		= Device Manipulation =

TK421: oops... deleted a 0 by mistake...

2026-02-20T07:23:40Z

oops... deleted a 0 by mistake...

← Older revision		Revision as of 07:23, 20 February 2026
Line 194:		Line 194:
	WaitForDevices:		WaitForDevices:
	yield		yield
	ls rBusy dSorter Occupied		ls rBusy dSorter 0 Occupied
	bgtz rBusy WaitForDevices		bgtz rBusy WaitForDevices
	ls rBusy dSorter 1 Occupied		ls rBusy dSorter 1 Occupied

TK421: Used ICCode template

2026-02-20T07:21:52Z

Used ICCode template

← Older revision		Revision as of 07:21, 20 February 2026
Line 191:		Line 191:

	Some devices don't react well to having parameters changed while they're performing an action such as import or export. Notable mentions are the stacker, sorter and the vending machine. You can avoid them locking up (or getting jammed with items) either by adding delays (yield, sleep) or by actively waiting for their slots to become unoccupied, or their Activation to become 0.		Some devices don't react well to having parameters changed while they're performing an action such as import or export. Notable mentions are the stacker, sorter and the vending machine. You can avoid them locking up (or getting jammed with items) either by adding delays (yield, sleep) or by actively waiting for their slots to become unoccupied, or their Activation to become 0.
	~~<div style="background: #000000; float: none">~~		{{ICCode\|
	~~<p style="float: none; white-space: pre; line-height: 1; color: #FFFFFF; background: #000000; font-size: 110%;font-family:Consolas; margin-left: 10px;><span>~~WaitForDevices:~~</span><span>~~		WaitForDevices:
	~~</span><span>~~yield~~</span><span>~~		yield
	~~</span><span style="color: #00FFFF;">~~ls~~</span><span> </span><span>~~rBusy~~</span><span> </span><span>~~dSorter~~</span><span> </span><span>0</span><span> </span><span>~~Occupied~~</span><span>~~		ls rBusy dSorter Occupied
	~~</span><span style="color: #FF0000;">~~bgtz~~</span><span> </span><span>~~rBusy~~</span><span> </span><span>~~WaitForDevices~~</span><span>~~		bgtz rBusy WaitForDevices
	~~</span><span style="color: #00FFFF;">~~ls~~</span><span> </span><span>~~rBusy~~</span><span> </span><span>~~dSorter~~</span><span> </span><span>~~1~~</span><span> </span><span>~~Occupied~~</span><span>~~		ls rBusy dSorter 1 Occupied
	~~</span><span style="color: #FF0000;">~~bgtz~~</span><span> </span><span>~~rBusy~~</span><span> </span><span>~~WaitForDevices~~</span><span>~~		bgtz rBusy WaitForDevices
	~~</span><span style="color: #00FFFF;">~~ls~~</span><span> </span><span>~~rBusy~~</span><span> </span><span>~~dSorter~~</span><span> </span><span>~~2~~</span><span> </span><span>~~Occupied~~</span><span>~~		ls rBusy dSorter 2 Occupied
	~~</span><span style="color: #FF0000;">~~bgtz~~</span><span> </span><span>~~rBusy~~</span><span> </span><span>~~WaitForDevices~~</span><span>~~		bgtz rBusy WaitForDevices
	~~</span><span style="color: #00FFFF;">~~ls~~</span><span> </span><span>~~rBusy~~</span><span> </span><span>~~dVender~~</span><span> </span><span>~~0~~</span><span> </span><span>~~Occupied~~</span><span>~~		ls rBusy dVender 0 Occupied
	~~</span><span style="color: #FF0000;">~~bgtz~~</span><span> </span><span>~~rBusy~~</span><span> </span><span>~~WaitForDevices~~</span><span>~~		bgtz rBusy WaitForDevices
	~~</span><span style="color: #00FFFF;">~~ls~~</span><span> </span><span>~~rBusy~~</span><span> </span><span>~~dVender~~</span><span> </span><span>~~1~~</span><span> </span><span>~~Occupied~~</span><span>~~		ls rBusy dVender 1 Occupied
	~~</span><span style="color: #FF0000;">~~bgtz~~</span><span> </span><span>~~rBusy~~</span><span> </span><span>~~WaitForDevices~~</span><span>~~		bgtz rBusy WaitForDevices
	~~</span><span style="color: #FF0000;">~~j~~</span><span> </span><span>~~ra~~</span><span>~~		j ra
	~~</span>~~		}}
	~~</p>~~
	~~</div>~~

	'''NOTE:''' The slot reader labels slots from 1 but in the IC they start at 0. It is also a good idea to check any device involved in your solution with both a logical and slot reader as the current databases may not list all existing slots or parameters. You should always make use of all data available from devices as they may greatly simplify your project.		'''NOTE:''' The slot reader labels slots from 1 but in the IC they start at 0. It is also a good idea to check any device involved in your solution with both a logical and slot reader as the current databases may not list all existing slots or parameters. You should always make use of all data available from devices as they may greatly simplify your project.

2001:8003:C35E:6B00:1169:1B7F:64D2:67D9: Added a section on how to dynamically detect devices attached to networks

2026-02-18T04:08:06Z

Added a section on how to dynamically detect devices attached to networks

← Older revision		Revision as of 04:08, 18 February 2026
Line 212:		Line 212:

	Using delays is convenient, but has downsides. You're giving up real-time control over the process and may miss certain events or react too late and cause a device to jam. You also need to consider that code takes time to run, and for example if you have a complicated condition for setting the output of a sorter depending on the item that entered it, it may be better to leave it OFF by default and only turn it on once the output is correctly set. (Devices react differently to being fed items while powered down. ie the stacker will keep it in the Import slot but the vending machine will completely import it, so make sure to manually test everything you can prior to automating it)		Using delays is convenient, but has downsides. You're giving up real-time control over the process and may miss certain events or react too late and cause a device to jam. You also need to consider that code takes time to run, and for example if you have a complicated condition for setting the output of a sorter depending on the item that entered it, it may be better to leave it OFF by default and only turn it on once the output is correctly set. (Devices react differently to being fed items while powered down. ie the stacker will keep it in the Import slot but the vending machine will completely import it, so make sure to manually test everything you can prior to automating it)

			== Detecting devices on a network ==

			Sometimes it is convenient to use code to detect the devices connected to the data network, instead of using pins on the housing, or via usage of the batch commands (such as <code>lbn</code> or <code>sbn</code>). The current way to detect attached devices is via a <code>get</code> command, passing in a network id: <code>get r0 db:0 3</code>.

			What the above snippet does is to run the <code>get</code> command, addressed to the network connection (network <code>0</code> in <code>db:0</code>) attached to the housing of the chip (<code>db</code>). The <code>get</code> command normally accesses the stack of the device being addressed (such as the chip itself, or a sorter), but if the address being passed to the <code>get</code> command is a network reference (with the colon and number indicating which connection), then the <code>get</code>command will return the <code>ReferenceId</code> of the device at the given index (<code>3</code> in the example above - if there is no such a device at the index, then <code>-1</code> is returned). The order is not determined by anything specific (even though it seems to remain the same until the network itself is changed, so write your code accordingly).

			With a <code>ReferenceId</code> being returned (in the example above it is saved in <code>r0</code>), this can be used in a later command to obtain information about the device - such as their <code>PrefabHash</code> to detect the device type (and/or any other LogicProperty it has available).

			One scenario where this is useful is in dynamically detecting newly attached structures without a priori having their device name(s), or even a count of how many, and being able to control them individually (rather than as a batch like one would for solar tracking) - centrifuges is one such type of device where this is helpful, since their cycle times are not synced up, you cannot use a batch command to control them (without losing efficiency). Below is reproduced some code from [https://old.reddit.com/r/Stationeers/comments/1r7k148/ic10_control_centrifuges_via_data_connection/ various] [https://old.reddit.com/r/Stationeers/comments/1r6uer7/ic10_is_there_a_way_to_dynamically_adress_all/ reddit] [https://old.reddit.com/r/Stationeers/comments/1q30e9z/coal_power_plant_math_check/nxy1g7n/ posts] that discuss this scenario:

			{{ICCode\|
			alias refid r14
			alias index r15
			alias devicecount r13
			alias ticks r12
			define centrifuge HASH("StructureCentrifuge")

			discoveryinit:
			yield
			move sp 0
			lb r0 centrifuge PrefabHash Sum
			div devicecount r0 centrifuge
			move index 0

			discovery:
			get refid db:0 index
			l r0 refid PrefabHash
			bne r0 centrifuge wrongid
			push refid
			s refid On 1

			wrongid:
			beq devicecount sp maininit
			add index index 1
			j discovery

			maininit:
			move ticks 0
			beqz sp discoveryinit

			main:
			bge ticks 120 discoveryinit
			add ticks ticks 1
			move sp devicecount
			yield

			loop:
			beqz sp main
			pop refid
			bdns refid discoveryinit
			l r0 refid Error
			beqz r0 loop
			l r0 refid Reagents
			sge r0 r0 5
			s refid Open r0
			j loop
			}}

	= Sample Projects =		= Sample Projects =

OwnerOfThePlace: /* Loops */ Removed 2 unnecessary lines from the loop itself; now the amount of executions can be seen because the condition makes more sense; made the problem with relative jumps clearer.

2025-05-24T05:34:59Z

Loops: Removed 2 unnecessary lines from the loop itself; now the amount of executions can be seen because the condition makes more sense; made the problem with relative jumps clearer.

← Older revision		Revision as of 05:34, 24 May 2025
Line 74:		Line 74:
	</span><span>...</span><span>		</span><span>...</span><span>
	</span><span style="color: #6666FF;">add</span><span> </span><span>rIterator</span><span> </span><span>rIterator</span><span> </span><span>1</span><span>		</span><span style="color: #6666FF;">add</span><span> </span><span>rIterator</span><span> </span><span>rIterator</span><span> </span><span>1</span><span>
	</span><span style="color: #FF0000;">~~bgt~~</span><span> </span><span>rIterator</span><span> </span><span>~~3</span><span> </span><span>Loop_End</span><span>~~		</span><span style="color: #FF0000;">blt</span><span> </span><span>rIterator</span><span> </span><span>4</span><span> </span><span>Loop</span><span>
	~~</span><span style="color: #FF0000;">j~~</span><span> </span><span>Loop~~</span><span>~~
	~~</span><span>Loop_End:~~</span><span>

	</span><span style="color: #FF0000;">j</span><span> </span><span>main</span><span>		</span><span style="color: #FF0000;">j</span><span> </span><span>main</span><span>
Line 83:		Line 81:
	</p>		</p>
	</div>		</div>
	The challenge with loops is to keep them clean. Relative jumps are a great way to save lines but they can quickly turn code messy ~~and~~ adding lines might break them if you ~~overlook them~~. If code length is not an issue, stick to labels where possible.		The challenge with loops is to keep them clean. Relative jumps are a great way to save lines but they can quickly turn code messy because adding lines might break them if you don't adjust the relative jump. If code length is not an issue, stick to labels where possible.

	== Indexing With Relative Jump ==		== Indexing With Relative Jump ==

2A02:8071:6191:8EA0:B81A:51AD:4C4:84CD: Different ways

2025-03-12T05:57:56Z

Different ways

@@ Line 111: / Line 111: @@
 </div>
 Use this to set one or more parameters or call functions using an index number you calculated (or read from a dial button). We multiply it by 2 because we need space for a jump after each move command so we don't run the subsequent ones and we add 1 because for a 0 index "jr 0" would lock up our IC.
 == Redefining Aliases ==

Emilgardis: Use proper/better category -> IC10

2024-05-23T18:06:27Z

Use proper/better category -> IC10

← Older revision		Revision as of 18:06, 23 May 2024
Line 1:		Line 1:
	[[Category:~~MIPS~~ Programming]]		[[Category:IC10 Programming]]
	= VS code extension =		= VS code extension =
	'''For convenient operation, there is an extension for the visual studio code IDE''' [https://marketplace.visualstudio.com/items?itemName=Traineratwot.stationeers-ic10 Link]		'''For convenient operation, there is an extension for the visual studio code IDE''' [https://marketplace.visualstudio.com/items?itemName=Traineratwot.stationeers-ic10 Link]