Actions

Difference between revisions of "Active Vent"

From Unofficial Stationeers Wiki

(Update to use the new Structurebox syntax)
(description fix)
 
(32 intermediate revisions by 17 users not shown)
Line 2: Line 2:
 
<translate>
 
<translate>
 
<!--T:1-->
 
<!--T:1-->
[[Category:Atmospherics]][[Category:Data Network]]
+
[[Category:Atmospherics]]
 
{{Itembox
 
{{Itembox
| name       = Active Vent
+
| name = Kit (Active Vent)
| image       = [[File:ItemActiveVent.png]]
+
| image = [[File:ItemActiveVent.png]]
| createdwith = [[Hydraulic Pipe Bender]], [[Fabricator]]
+
| prefabhash = -842048328
| cost        = 5g [[Iron]], 1g [[Gold]], 5g [[Copper]]
+
| prefabname = ItemActiveVent
| stacks      = 5
+
| stacks = 5
 +
| slot_class = SlotClass.None
 +
| sorting_class = SortingClass.Kits
 +
| recipe_machine1 = Hydraulic Pipe Bender
 +
| recipe_cost1 = 5g [[Iron]], 1g [[Gold]], 5g [[Copper]]
 +
| constructs = [[Active Vent]]
 
}}
 
}}
 
{{Structurebox
 
{{Structurebox
| name             = Active Vent
+
| name = Active Vent
| power_usage      = 100W
+
| image = [[File:StructureActiveVent.png]]
| placed_with_item = [[Active Vent (Item)]]
+
| prefab_hash = -1129453144
| placed_on_grid   = Small Grid
+
| prefab_name = StructureActiveVent
| decon_with_tool1 = [[Hand Drill]]
+
| power_usage = 100W
| item_rec1       = [[Active Vent (Item)]]
+
| placed_on_grid = Small Grid
 +
| decon_with_tool1 = [[Hand Drill]]
 +
| placed_with_item = [[Kit (Active Vent)]]
 +
| item_rec1 = [[Kit (Active Vent)]]
 
}}
 
}}
  
 
== Description == <!--T:2-->
 
== Description == <!--T:2-->
Used to move gasses from pipes, by using its inward or outward switches. It needs to be powered to function.
+
 
 +
The Active Vent moves gas between the connected [[Pipe Network]] and the atmosphere surrounding the active vent.
 +
It requires electric power to work (100 Watt).
 +
 
 +
The "PressureExternal" value is a measure of the atmosphere surrounding the active vent.
 +
The "PressureInternal" value is a measure of the pressure inside the active vent pipe network.
 +
 
 +
Contrary to popular belief, both values are enforced, so the Active Vent comes with the functionality of a Pressure Regulator and simultaneously also Back Pressure Regulator. Note that setting these value and changing the Mode afterwards is ill-advised: Changing the Mode always resets both values to their defaults (101/0 for pumping into the room, 0/50 for pumping into the pipe), so they must be set (if at all) *after* setting the Mode.
 +
 
 +
* In "Outward mode" (switch is blue), the Active Vent increases the external pressure by moving gas from the pipe network to the surrounding atmosphere, up to "PressureExternal", but never allowing the pipe's pressure to drop below "PressureInternal".
 +
* In "Inward mode" (switch is red), the Active Vent decreases the external pressure by moving gas from the surrounding atmosphere to the pipe network, down to "PressureExternal", never exceeding the pipe pressure set in "PressureInternal".
 +
 
 +
The "PressureExternal" value is set to 100 kPa when the [[Circuitboard (Airlock Control)|Circuitboard (Airlock Control)]] is used in a [[console|Console]]. This is the reason why the airlock is unable to pressurize when the atmosphere surrounding the active vent is unable to reach 100 kPa within the airlock.
 +
 
 +
The "PressureExternal" values can also be inconvenient on worlds like Loulan whose atmosphere is well above 101kPa. Manually-operated airlocks can not equalise the pressure within the airlock during the exit cycle to the Loulan atmosphere pressures. Without equal pressures you can not prevent wind currents from occurring when opening airlock doors. The active vent has no effect when the external pressure within the airlock surrounding the active vent is already >101kPa. When the pressure is <101kPa the vent will stop when it reaches 101kPa.
 +
 
 +
The "PressureExternal" and "PressureInternal" values can be modified using [[Kit (Logic I/O)|logic chips]] or programmatically via IC10 scripts.
 +
 
 +
'''Note''': These values reset to default values on mode change. Values can be set through logic chips, if the value is modified after a mode change.
 +
 
 +
'''Note''': Switching logic chips off then on will not modify values on the active vent, the values supplied to the chips must be altered for the values to be written.
 +
 
 +
 
 +
To calculate the moles per tick, use the following equation:
 +
 
 +
n = (P * V) / (R * T)
 +
 
 +
Where (Inward vent):
 +
* P = Room pressure (Min 10.1325 kPa)
 +
* V = 8000 litres
 +
* n = Moles per tick
 +
* R = Gas constant (8.3144)
 +
* T = Room temperature
 +
 
 +
Where (Outward vent):
 +
* P = Pipe pressure (Min 10.1325 kPa)
 +
* V = Pipe volume in litres
 +
* n = Moles per tick
 +
* R = Gas constant (8.3144)
 +
* T = Pipe temperature
 +
 
 +
(These do not take into account the constraints imposed by "PressureExternal" and "PressureInternal")
 +
 
 +
'''Note''': In order to get the proper units out of this calculation you need to use either kilopascal (kPa) and litre (l), or Pascal (Pa) and cubic meters (m<sup>3</sup>).
  
 
'''Note''': The insert slot currently takes any item and seems to have no effect.
 
'''Note''': The insert slot currently takes any item and seems to have no effect.
  
== Data Network Properties ==
+
{{Data Network Header}}
These are all [[:Category:Data Network|Data Network]] properties of this device.
 
 
 
 
=== Mode Values ===
 
=== Mode Values ===
 
These lists the values and meanings for the "Mode" property of the Active Vent.
 
These lists the values and meanings for the "Mode" property of the Active Vent.
 
{| class="wikitable"
 
{| class="wikitable"
|-
+
|-
! Value !! Meaning
+
! Value !! Meaning
|-
+
|-
| 0 || "Outward" mode (Pumping gas from the connected pipe network to the outside.)
+
| 0 || "Outward" mode (Moves gas from the connected pipe network to the surrounding atmosphere.)
|-
+
|-
| 1 || "Inward" mode (Pumping gas from the outside to the connected pipe network.)
+
| 1 || "Inward" mode (Moves gas from the surrounding atmosphere to the connected pipe network.)
|-
+
|}
| 2 || (Unknown)
+
{{Data Parameters|
|}
+
{{Data Parameters/row|Power|Boolean|w=0|Can be read to return if the device is correctly powered or not, set via the power system, return 1 if powered and 0 if not|multiple=2|0|Off|1|On}}
 +
{{Data Parameters/row|Open|Integer|1 if device is open, otherwise 0}}
 +
{{Data Parameters/row|Mode|Integer|The mode of the Active Vent.|multiple=2|0|Outward|1|Inward}}
 +
{{Data Parameters/row|Error|Boolean|w=0|1 if device is in error state, otherwise 0|multiple=2|0|<p></p>|1|Error}}
 +
{{Data Parameters/row|PressureExternal|Float|<div>"Outward" mode: Maximum pressure of the surrounding atmosphere. The default value is 101.325 (kPa)<br>
 +
"Inward" mode": Minimum pressure of the surrounding atmosphere. The default value is 0 (kPa)</div>}}
 +
{{Data Parameters/row|PressureInternal|Float|<div>"Outward" mode: Minimum pipe network pressure. The default value is 0 (kPa).<br>
 +
"Inward" mode: Maximum pipe network pressure. The default value is 50662.5 (kPa).</div>}}
 +
{{Data Parameters/row|Lock|Boolean|Disable manual operation of the Active Vent.|multiple=2|0|Unlocked|1|Locked}}
 +
{{Data Parameters/row|Setting|Integer|A variable setting that can be read or written.}}
 +
{{Data Parameters/row|Maximum|Integer|w=0|Maximum setting of the device}}
 +
{{Data Parameters/row|Ratio|Float|w=0|Context specific value depending on device, 0 to 1 based ratio|0.0 to 1.0}}
 +
{{Data Parameters/row|On|Boolean|The current state of the Active Vent.|multiple=2|0|Off|1|On}}
 +
{{Data Parameters/row|RequiredPower|Integer|w=0|Idle operating power quantity, does not necessarily include extra demand power}} 
 +
{{Data Parameters/row|PrefabHash|Integer|w=0|The hash of the structure}}
 +
{{Data Parameters/row|ReferenceId|Integer|w=0|Unique Reference Identifier for this object}}
 +
{{Data Parameters/row|NameHash|Integer|w=0|Provides the hash value for the name of the object as a 32 bit integer.}}
 +
}}
  
=== Data Parameters ===
+
'''Note''': The value of "PressureExternal" and "PressureInternal" will be reset to the default when changing modes.
These are all parameters, that can be written to with a [[Kit_(Logic_I/O)#Logic_Writer|Logic Writer]] or a [[Kit_(Logic_I/O)#Batch_Writer|Batch Writer]]. The outputs are listed in the order a Logic Writer's "VAR" setting cycles through them.
 
{| class="wikitable"
 
|-
 
! Parameter Name !! Data Type !! Description
 
|-
 
| Open || Boolean || Opens the Active Vent, when set to 1. Closes it, when set to 0. (Untested)
 
|-
 
| Mode || Integer || Sets the Active Vent mode to the passed setting. (See [[#Mode_Values|Mode Values]])
 
|-
 
| PressureExternal || Float || Sets the desired external pressure of the space outside the Active Vent. (Untested)
 
|-
 
| PressureInternal || Float || Sets the desired internal pressure of the pipe network, connected to the Active Vent. (Untested)
 
|-
 
| Lock || Boolean || Locks the Active Vent, when set to 1. Unlocks it, when set to 0.
 
|-
 
| Setting || Float || Takes a range from 0.0 to 100.0. (Assumption) This sets the percentage amount of pumping throughput of the Active Vent.
 
|-
 
| On || Boolean || Turns the Active Vent on, when set to 1. Turns it off, when set to 0.
 
|}
 
  
=== Data Outputs ===
+
'''Note''': If turned on, the vent will still consume energy when the target pressure is reached.
These are all parameters, that can be read with a [[Kit_(Logic_I/O)#Logic_Reader|Logic Reader]]. The outputs are listed in the order a Logic Reader's "VAR" setting cycles through them.
 
{| class="wikitable"
 
|-
 
! Output Name !! Data Type !! Description
 
|-
 
| Power || Boolean || Returns whether the Active Vent is receiving power and is turned on. (0 for no, 1 for yes)
 
|-
 
| Open || Boolean || Returns whether the Active Vent is open. (0 for no, 1 for yes) (Untested)
 
|-
 
| Mode || Integer || Returns the setting of the current mode of the Active Vent. (See [[#Mode_Values|Mode Values]])
 
|-
 
| Error || Boolean || Returns whether the Active Vent is currently flashing an error. (0 for no, 1 for yes)
 
|-
 
| PressureExternal || Float || Returns the desired external pressure of the Active Vent. (Untested)
 
|-
 
| PressureInternal || Float || Returns the desired internal pressure of the Active vent. (Untested)
 
|-
 
| Lock || Boolean || Returns whether the Active Vent is locked. (0 for no, 1 for yes)
 
|-
 
| Setting || Float || Returns a range from 0.0 to 100.0. (Assumption) Returns the percentage amount of pumping throughput of the Active Vent.
 
|-
 
| Maximum || Integer || Returns 100. (Assumption) Returns the maximum throughput percentage of the Active Vent.
 
|-
 
| Ratio || Float || Returns a range from 0.0 to 1.0. (Assumption) Returns the percentage amount of pumping throughput of the Active Vent.
 
|-
 
| On || Boolean || Returns whether the Active Vent is set to on. (0 for no, 1 for yes)
 
|-
 
| RequiredPower || Integer || Returns the current amount of power needed for the Active Vent.
 
|}
 
 
</translate>
 
</translate>

Latest revision as of 07:19, 9 August 2024

Other languages:
English • ‎español
Kit (Active Vent)
ItemActiveVent.png
Constructing Options Active Vent
Properties
Stacks Yes (5)
Recipes
Hydraulic Pipe Bender 5g Iron, 1g Gold, 5g Copper
Logic
Item Hash -842048328
Item Name ItemActiveVent
Logic Classes
SlotClass.None
SortingClass.Kits
Active Vent
StructureActiveVent.png
Operation
Power Usage 100W
Prefab Hash -1129453144
Prefab Name StructureActiveVent
Construction
Placed with Kit (Active Vent)
Placed on Small Grid
Stage 1
Deconstruction
Deconstructed with Hand Drill
Item received Kit (Active Vent)



Description[edit]

The Active Vent moves gas between the connected Pipe Network and the atmosphere surrounding the active vent. It requires electric power to work (100 Watt).

The "PressureExternal" value is a measure of the atmosphere surrounding the active vent. The "PressureInternal" value is a measure of the pressure inside the active vent pipe network.

Contrary to popular belief, both values are enforced, so the Active Vent comes with the functionality of a Pressure Regulator and simultaneously also Back Pressure Regulator. Note that setting these value and changing the Mode afterwards is ill-advised: Changing the Mode always resets both values to their defaults (101/0 for pumping into the room, 0/50 for pumping into the pipe), so they must be set (if at all) *after* setting the Mode.

  • In "Outward mode" (switch is blue), the Active Vent increases the external pressure by moving gas from the pipe network to the surrounding atmosphere, up to "PressureExternal", but never allowing the pipe's pressure to drop below "PressureInternal".
  • In "Inward mode" (switch is red), the Active Vent decreases the external pressure by moving gas from the surrounding atmosphere to the pipe network, down to "PressureExternal", never exceeding the pipe pressure set in "PressureInternal".

The "PressureExternal" value is set to 100 kPa when the Circuitboard (Airlock Control) is used in a Console. This is the reason why the airlock is unable to pressurize when the atmosphere surrounding the active vent is unable to reach 100 kPa within the airlock.

The "PressureExternal" values can also be inconvenient on worlds like Loulan whose atmosphere is well above 101kPa. Manually-operated airlocks can not equalise the pressure within the airlock during the exit cycle to the Loulan atmosphere pressures. Without equal pressures you can not prevent wind currents from occurring when opening airlock doors. The active vent has no effect when the external pressure within the airlock surrounding the active vent is already >101kPa. When the pressure is <101kPa the vent will stop when it reaches 101kPa.

The "PressureExternal" and "PressureInternal" values can be modified using logic chips or programmatically via IC10 scripts.

Note: These values reset to default values on mode change. Values can be set through logic chips, if the value is modified after a mode change.

Note: Switching logic chips off then on will not modify values on the active vent, the values supplied to the chips must be altered for the values to be written.


To calculate the moles per tick, use the following equation:

n = (P * V) / (R * T)

Where (Inward vent):

  • P = Room pressure (Min 10.1325 kPa)
  • V = 8000 litres
  • n = Moles per tick
  • R = Gas constant (8.3144)
  • T = Room temperature

Where (Outward vent):

  • P = Pipe pressure (Min 10.1325 kPa)
  • V = Pipe volume in litres
  • n = Moles per tick
  • R = Gas constant (8.3144)
  • T = Pipe temperature

(These do not take into account the constraints imposed by "PressureExternal" and "PressureInternal")

Note: In order to get the proper units out of this calculation you need to use either kilopascal (kPa) and litre (l), or Pascal (Pa) and cubic meters (m3).

Note: The insert slot currently takes any item and seems to have no effect.

Data Network Properties[edit]

These are all Data Network properties of this device.

Mode Values[edit]

These lists the values and meanings for the "Mode" property of the Active Vent.

Value Meaning
0 "Outward" mode (Moves gas from the connected pipe network to the surrounding atmosphere.)
1 "Inward" mode (Moves gas from the surrounding atmosphere to the connected pipe network.)

Data Parameters[edit]

These are all parameters that can be written with a Logic Writer, Batch Writer, or Integrated Circuit (IC10), and can be read with a Logic Reader, Batch Reader, or Integrated Circuit (IC10).

Click here to see/hide all the data network properties
Parameter Name Data Type Access Value Description
Power Boolean
Read
0 Off Can be read to return if the device is correctly powered or not, set via the power system, return 1 if powered and 0 if not
1 On
Open Integer
Read Write
1 if device is open, otherwise 0
Mode Integer
Read Write
0 Outward The mode of the Active Vent.
1 Inward
Error Boolean
Read
0

1 if device is in error state, otherwise 0
1 Error
PressureExternal Float
Read Write
"Outward" mode: Maximum pressure of the surrounding atmosphere. The default value is 101.325 (kPa)
"Inward" mode": Minimum pressure of the surrounding atmosphere. The default value is 0 (kPa)
PressureInternal Float
Read Write
"Outward" mode: Minimum pipe network pressure. The default value is 0 (kPa).
"Inward" mode: Maximum pipe network pressure. The default value is 50662.5 (kPa).
Lock Boolean
Read Write
0 Unlocked Disable manual operation of the Active Vent.
1 Locked
Setting Integer
Read Write
A variable setting that can be read or written.
Maximum Integer
Read
Maximum setting of the device
Ratio Float
Read
0.0 to 1.0 Context specific value depending on device, 0 to 1 based ratio
On Boolean
Read Write
0 Off The current state of the Active Vent.
1 On
RequiredPower Integer
Read
Idle operating power quantity, does not necessarily include extra demand power
PrefabHash Integer
Read
The hash of the structure
ReferenceId Integer
Read
Unique Reference Identifier for this object
NameHash Integer
Read
Provides the hash value for the name of the object as a 32 bit integer.


Note: The value of "PressureExternal" and "PressureInternal" will be reset to the default when changing modes.

Note: If turned on, the vent will still consume energy when the target pressure is reached.