Add USB ports to emitters/temperature pumps/temperature machines (#95497)

## About The Pull Request

This PR adds USB functionality to temperature pumps, emitters and
temperature control unit machines.

<img width="1082" height="340" alt="working"
src="https://github.com/user-attachments/assets/25e40c17-33ab-4159-b431-b3ccbe83626d"
/>

### New USB Components

<img width="139" height="101" alt="emitter"
src="https://github.com/user-attachments/assets/66580351-6cca-4dfe-9de4-3813cf62678c"
/>

* Emitter
New exposed controls allow you to manually fire a single beam, and get
signals whenever it is toggled on/off/fired.
It doesn't allow a player to toggle it on/off (must be done physically).
ID locking the emitter will also lock out the ability to fire the
emitter via USB.

<img width="303" height="226" alt="temp pump"
src="https://github.com/user-attachments/assets/4d0e6758-d653-4ac1-a080-d8e31d64408d"
/>

* Temperature Pump
This works exactly the same as the other USB controlled pumps, with the
addition of setting the heat rate.

<img width="267" height="151" alt="temperature control"
src="https://github.com/user-attachments/assets/6fff5148-bd70-4a1c-9899-10c997279669"
/>

* Temperature Control Unit
The USB interface now allows this to be remotely turned off and on like
the other USB pump interfaces.

## Why It's Good For The Game

These three parts are crucial to engineering/atmos projects, and gives
experienced players more depth to toy with circuits.

## Changelog

🆑
add: Added USB interface to emitters, temperature pumps and temperature
control unit machines
/🆑
This commit is contained in:
tmyqlfpir
2026-04-29 16:52:55 +02:00
committed by GitHub
parent 8858f1c3d5
commit 901a1d4450
8 changed files with 278 additions and 0 deletions
@@ -14,6 +14,7 @@
/obj/machinery/atmospherics/components/binary/temperature_pump/Initialize(mapload)
. = ..()
AddComponent(/datum/component/usb_port, typecacheof(list(/obj/item/circuit_component/atmos_temperature_pump), only_root_path = TRUE))
register_context()
/obj/machinery/atmospherics/components/binary/temperature_pump/add_context(atom/source, list/context, obj/item/held_item, mob/user)
@@ -43,6 +43,8 @@
/obj/machinery/atmospherics/components/unary/thermomachine/Initialize(mapload)
. = ..()
update_appearance(UPDATE_ICON)
if(interactive)
AddComponent(/datum/component/usb_port, typecacheof(list(/obj/item/circuit_component/thermomachine), only_root_path = TRUE))
register_context()
/obj/machinery/atmospherics/components/unary/thermomachine/add_context(atom/source, list/context, obj/item/held_item, mob/user)
@@ -78,6 +78,7 @@
sparks.attach(src)
AddElement(/datum/element/simple_rotation)
AddElement(/datum/element/empprotection, EMP_PROTECT_SELF | EMP_PROTECT_WIRES)
AddComponent(/datum/component/usb_port, typecacheof(list(/obj/item/circuit_component/emitter), only_root_path = TRUE))
/obj/machinery/power/emitter/welded/Initialize(mapload)
welded = TRUE
@@ -190,6 +191,7 @@
log_game("[src] turned [active ? "ON" : "OFF"] by [key_name(user)] in [AREACOORD(src)]")
investigate_log("turned [active ? "ON" : "OFF"] by [key_name(user)] at [AREACOORD(src)]", INVESTIGATE_ENGINE)
update_appearance()
SEND_SIGNAL(src, COMSIG_EMITTER_MACHINE_SET_ON, active ? TRUE : FALSE)
/obj/machinery/power/emitter/attack_animal(mob/living/simple_animal/user, list/modifiers)
if(ismegafauna(user) && anchored)
@@ -268,6 +270,7 @@
else
fire_delay = rand(minimum_fire_delay,maximum_fire_delay) * fire_rate_mod
shot_number = 0
SEND_SIGNAL(src, COMSIG_EMITTER_MACHINE_ON_FIRE)
return projectile
/obj/machinery/power/emitter/can_be_unfasten_wrench(mob/user, silent)
@@ -0,0 +1,58 @@
/**
* USB wiremod interface for emitter machines
*/
/obj/item/circuit_component/emitter
display_name = "Emitter"
desc = "Allows you to manually fire and get the ready status of an emitter. Must be unlocked to use fired signal."
///Manually trigger the emitter
var/datum/port/input/fire
///Send a signal when the emitter is turned on
var/datum/port/output/turned_on
///Send a signal when the emitter is turned off
var/datum/port/output/turned_off
///Send a signal when the emitter has fired
var/datum/port/output/has_fired
///The component parent object
var/obj/machinery/power/emitter/attached_emitter
/obj/item/circuit_component/emitter/populate_ports()
fire = add_input_port("Fire", PORT_TYPE_SIGNAL, trigger = PROC_REF(fire_emitter))
turned_on = add_output_port("Turned On", PORT_TYPE_SIGNAL)
turned_off = add_output_port("Turned Off", PORT_TYPE_SIGNAL)
has_fired = add_output_port("Has Fired", PORT_TYPE_SIGNAL)
/obj/item/circuit_component/emitter/register_usb_parent(atom/movable/parent)
. = ..()
if(istype(parent, /obj/machinery/power/emitter))
attached_emitter = parent
RegisterSignal(attached_emitter, COMSIG_EMITTER_MACHINE_SET_ON, PROC_REF(handle_emitter_activation))
RegisterSignal(attached_emitter, COMSIG_EMITTER_MACHINE_ON_FIRE, PROC_REF(handle_emitter_on_fire))
/obj/item/circuit_component/emitter/unregister_usb_parent(atom/movable/parent)
UnregisterSignal(attached_emitter, COMSIG_EMITTER_MACHINE_SET_ON)
UnregisterSignal(attached_emitter, COMSIG_EMITTER_MACHINE_ON_FIRE)
attached_emitter = null
return ..()
/obj/item/circuit_component/emitter/proc/handle_emitter_activation(datum/source, active)
SIGNAL_HANDLER
if(active)
turned_on.set_output(COMPONENT_SIGNAL)
else
turned_off.set_output(COMPONENT_SIGNAL)
/obj/item/circuit_component/emitter/proc/handle_emitter_on_fire(datum/source, active)
SIGNAL_HANDLER
has_fired.set_output(COMPONENT_SIGNAL)
/obj/item/circuit_component/emitter/proc/fire_emitter()
CIRCUIT_TRIGGER
if(!attached_emitter)
return
if(attached_emitter.locked) // do not fire if emitter is locked
return
attached_emitter.fire_beam_pulse()
@@ -0,0 +1,105 @@
/**
* USB wiremod interface for temperature pumps
*/
/obj/item/circuit_component/atmos_temperature_pump
display_name = "Atmospheric Temperature Pump"
desc = "The interface for communicating with a temperature pump."
///Set the percent of the heat delta to transfer
var/datum/port/input/heat_transfer_rate
///Activate the pump
var/datum/port/input/on
///Deactivate the pump
var/datum/port/input/off
///Signals the circuit to retrieve the pump's current percent and temperature
var/datum/port/input/request_data
///Current status of the percent
var/datum/port/output/heat_transfer_rate_state
///Pressure of the input port
var/datum/port/output/input_pressure
///Pressure of the output port
var/datum/port/output/output_pressure
///Temperature of the input port
var/datum/port/output/input_temperature
///Temperature of the output port
var/datum/port/output/output_temperature
///Whether the pump is currently active
var/datum/port/output/is_active
///Send a signal when the pump is turned on
var/datum/port/output/turned_on
///Send a signal when the pump is turned off
var/datum/port/output/turned_off
///The component parent object
var/obj/machinery/atmospherics/components/binary/temperature_pump/connected_pump
/obj/item/circuit_component/atmos_temperature_pump/populate_ports()
heat_transfer_rate = add_input_port("Set Heat Transfer Rate", PORT_TYPE_NUMBER, trigger = PROC_REF(set_pump_heat_rate))
on = add_input_port("Turn On", PORT_TYPE_SIGNAL, trigger = PROC_REF(set_pump_on))
off = add_input_port("Turn Off", PORT_TYPE_SIGNAL, trigger = PROC_REF(set_pump_off))
request_data = add_input_port("Request Port Data", PORT_TYPE_SIGNAL, trigger = PROC_REF(request_pump_data))
heat_transfer_rate_state = add_output_port("Heat Transfer Rate", PORT_TYPE_NUMBER)
input_pressure = add_output_port("Input Pressure", PORT_TYPE_NUMBER)
output_pressure = add_output_port("Output Pressure", PORT_TYPE_NUMBER)
input_temperature = add_output_port("Input Temperature", PORT_TYPE_NUMBER)
output_temperature = add_output_port("Output Temperature", PORT_TYPE_NUMBER)
is_active = add_output_port("Active", PORT_TYPE_NUMBER)
turned_on = add_output_port("Turned On", PORT_TYPE_SIGNAL)
turned_off = add_output_port("Turned Off", PORT_TYPE_SIGNAL)
/obj/item/circuit_component/atmos_temperature_pump/register_usb_parent(atom/movable/shell)
. = ..()
if(istype(shell, /obj/machinery/atmospherics/components/binary/temperature_pump))
connected_pump = shell
RegisterSignal(connected_pump, COMSIG_ATMOS_MACHINE_SET_ON, PROC_REF(handle_pump_activation))
/obj/item/circuit_component/atmos_temperature_pump/unregister_usb_parent(atom/movable/shell)
UnregisterSignal(connected_pump, COMSIG_ATMOS_MACHINE_SET_ON)
connected_pump = null
return ..()
/obj/item/circuit_component/atmos_temperature_pump/pre_input_received(datum/port/input/port)
heat_transfer_rate.set_value(clamp(heat_transfer_rate.value, 0, connected_pump ? connected_pump.max_heat_transfer_rate : 100))
/obj/item/circuit_component/atmos_temperature_pump/proc/handle_pump_activation(datum/source, active)
SIGNAL_HANDLER
is_active.set_output(active)
if(active)
turned_on.set_output(COMPONENT_SIGNAL)
else
turned_off.set_output(COMPONENT_SIGNAL)
/obj/item/circuit_component/atmos_temperature_pump/proc/set_pump_heat_rate()
CIRCUIT_TRIGGER
if(!connected_pump)
return
connected_pump.heat_transfer_rate = heat_transfer_rate.value
/obj/item/circuit_component/atmos_temperature_pump/proc/set_pump_on()
CIRCUIT_TRIGGER
if(!connected_pump)
return
connected_pump.set_on(TRUE)
/obj/item/circuit_component/atmos_temperature_pump/proc/set_pump_off()
CIRCUIT_TRIGGER
if(!connected_pump)
return
connected_pump.set_on(FALSE)
connected_pump.update_appearance(UPDATE_ICON)
/obj/item/circuit_component/atmos_temperature_pump/proc/request_pump_data()
CIRCUIT_TRIGGER
if(!connected_pump)
return
var/datum/gas_mixture/air_input = connected_pump.airs[1]
var/datum/gas_mixture/air_output = connected_pump.airs[2]
heat_transfer_rate_state.set_output(connected_pump.heat_transfer_rate)
input_pressure.set_output(air_input.return_pressure())
output_pressure.set_output(air_output.return_pressure())
input_temperature.set_output(air_input.return_temperature())
output_temperature.set_output(air_output.return_temperature())
@@ -0,0 +1,100 @@
/**
* USB wiremod interface for temperature control unit machines
*/
/obj/item/circuit_component/thermomachine
display_name = "Temperature Control Unit"
desc = "The interface for communicating with a temperature control unit."
///Set the target temperature
var/datum/port/input/temperature
///Activate the machine
var/datum/port/input/on
///Deactivate the machine
var/datum/port/input/off
///Signals the circuit to retrieve the machine's current pressure and temperature
var/datum/port/input/request_data
///Pressure of the port
var/datum/port/output/port_pressure
///Temperature of the port port
var/datum/port/output/port_temperature
///Whether the machine is currently active
var/datum/port/output/is_active
///Send a signal when the machine is turned on
var/datum/port/output/turned_on
///Send a signal when the machine is turned off
var/datum/port/output/turned_off
///The component parent object
var/obj/machinery/atmospherics/components/unary/thermomachine/connected_machine
/obj/item/circuit_component/thermomachine/populate_ports()
temperature = add_input_port("Set Temperature", PORT_TYPE_NUMBER, trigger = PROC_REF(set_temperature))
on = add_input_port("Turn On", PORT_TYPE_SIGNAL, trigger = PROC_REF(set_machine_on))
off = add_input_port("Turn Off", PORT_TYPE_SIGNAL, trigger = PROC_REF(set_machine_off))
request_data = add_input_port("Request Port Data", PORT_TYPE_SIGNAL, trigger = PROC_REF(request_pump_data))
port_pressure = add_output_port("Pressure", PORT_TYPE_NUMBER)
port_temperature = add_output_port("Temperature", PORT_TYPE_NUMBER)
is_active = add_output_port("Active", PORT_TYPE_NUMBER)
turned_on = add_output_port("Turned On", PORT_TYPE_SIGNAL)
turned_off = add_output_port("Turned Off", PORT_TYPE_SIGNAL)
/obj/item/circuit_component/thermomachine/register_usb_parent(atom/movable/shell)
. = ..()
if(istype(shell, /obj/machinery/atmospherics/components/unary/thermomachine))
connected_machine = shell
RegisterSignal(connected_machine, COMSIG_ATMOS_MACHINE_SET_ON, PROC_REF(handle_pump_activation))
/obj/item/circuit_component/thermomachine/unregister_usb_parent(atom/movable/shell)
UnregisterSignal(connected_machine, COMSIG_ATMOS_MACHINE_SET_ON)
connected_machine = null
return ..()
/obj/item/circuit_component/thermomachine/pre_input_received(datum/port/input/port)
if(connected_machine)
var/min = connected_machine.min_temperature
var/max = connected_machine.max_temperature
temperature.set_value(clamp(temperature.value, min, max))
/obj/item/circuit_component/thermomachine/proc/handle_pump_activation(datum/source, active)
SIGNAL_HANDLER
is_active.set_output(active)
if(active)
turned_on.set_output(COMPONENT_SIGNAL)
else
turned_off.set_output(COMPONENT_SIGNAL)
/obj/item/circuit_component/thermomachine/proc/set_temperature()
CIRCUIT_TRIGGER
if(!connected_machine)
return
var/min = connected_machine.min_temperature
var/max = connected_machine.max_temperature
connected_machine.target_temperature = clamp(temperature.value, min, max)
connected_machine.update_icon_state()
/obj/item/circuit_component/thermomachine/proc/set_machine_on()
CIRCUIT_TRIGGER
if(!connected_machine)
return
connected_machine.set_on(TRUE)
connected_machine.update_use_power(ACTIVE_POWER_USE)
/obj/item/circuit_component/thermomachine/proc/set_machine_off()
CIRCUIT_TRIGGER
if(!connected_machine)
return
connected_machine.set_on(FALSE)
connected_machine.update_use_power(IDLE_POWER_USE)
connected_machine.update_appearance(UPDATE_ICON)
/obj/item/circuit_component/thermomachine/proc/request_pump_data()
CIRCUIT_TRIGGER
if(!connected_machine)
return
var/datum/gas_mixture/port = connected_machine.airs[1]
port_pressure.set_output(port.return_pressure())
port_temperature.set_output(port.return_temperature())