BunyipsLib/au.edu.sa.mbhs.studentrobotics.bunyipslib.subsystems/Cannon

Cannon

Class for a generic servo switch that may switch between two known states. A whole new file is technically unnecessary, but we wanted to make a class named Cannon.

"Fire in the hole!"

This class is deprecated by Switch, which offers more functionality relating to single-servo subsystems, allowing movement beyond just two positions.

Author

Lachlan Paul, 2023

Lucas Bubner, 2023

Since

1.0.0-pre

Constructors

Cannon

constructor(@Nullable prolong: Servo, openPosition: Double, closePosition: Double)

Constructs a new Cannon.

constructor(@Nullable prolong: Servo)

Constructs a new Cannon.

Types

Tasks

open inner class Tasks

Tasks for Cannon, access through tasks.

Properties

tasks

val tasks: Cannon.Tasks

Tasks for Cannon.

Inherited properties

currentTask

@get:Nullable

open var currentTask: Task

name

@NonNull

protected open var name: String

Reference to the unmodified name of this subsystem.

opMode

@Nullable

protected val opMode: BunyipsOpMode

Get a reference to the currently running BunyipsOpMode.

Functions

fire

@NonNull

open fun fire(): Cannon

Fire in the hole!

isFired

open fun isFired(): Boolean

Query if the cannon is fired.

isReset

open fun isReset(): Boolean

Query if the cannon is reset.

periodic

protected open fun periodic()

To be updated periodically on every hardware loop.

reset

@NonNull

open fun reset(): Cannon

Reset the cannon to its initial position

Inherited functions

assertParamsNotNull

protected fun assertParamsNotNull(@NonNull parameters: Array<Any>): Boolean

Utility function to run NullSafety.assertComponentArgs() on the given parameters, usually on the motors/hardware/critical objects passed into the constructor.

cancelCurrentTask

fun cancelCurrentTask()

Cancel the current task immediately and return to the default task, if available.

default

infix fun BunyipsSubsystem.default(defaultTask: Task)

Default task setter extension for BunyipsSubsystem to set the default task of a subsystem.

delegate

protected fun delegate(@NonNull child: BunyipsSubsystem)

Call to delegate the update of this subsystem, usually a component of another subsystem, to this subsystem.

disable

fun disable()

Prevent a subsystem from running.

enable

fun enable()

Re-enable a subsystem if it was previously disabled via a disable() call.

isDefaultName

fun isDefaultName(): Boolean

isDisabled

fun isDisabled(): Boolean

isIdle

fun isIdle(): Boolean

Determine if the subsystem is idle, meaning an IdleTask is running.

onDisable

protected open fun onDisable()

User callback that runs once when this subsystem is disabled by a call to disable or by an assertion failure.

onEnable

protected open fun onEnable()

User callback that runs once when this subsystem is enabled by a call to enable or the first active call to periodic.

opMode

protected fun opMode(@NonNull ifRunning: Consumer<BunyipsOpMode>)

Null check consumer for the opMode field which will no-op the given consumer if an active BunyipsOpMode is not present (i.e.

require

@NonNull

protected fun require(@Nullable nullableOpMode: BunyipsOpMode): BunyipsOpMode

Null assertion for the opMode field which throws a NullPointerException if an active BunyipsOpMode is not present (i.e.

resetForOpMode

open fun resetForOpMode()

Reset stored static instances of BunyipsSubsystem.

setDefaultTask

fun setDefaultTask(@NonNull defaultTask: Task)

Set the default task for this subsystem, which will be run when no other task is running.

setHighPriorityCurrentTask

fun setHighPriorityCurrentTask(@NonNull currentTask: Task)

Set the current task to the given task, overriding any current task.

startThread

fun startThread()

fun startThread(@NonNull loopSleepDuration: Measure<Time>)

Call to delegate all updates of this subsystem to a thread that will begin execution on this method call.

stopThread

fun stopThread()

Call to stop delegating updates of this subsystem to a thread.

toString

@NonNull

fun toString(): String

toVerboseString

@NonNull

fun toVerboseString(): String

update

fun update()

Update the subsystem and run the current task, if tasks are not set up this will just call periodic.

updateAll

open fun updateAll()

Update all instances of BunyipsSubsystem that has been constructed since the last clearing.

withName

fun <T : BunyipsSubsystem?> withName(@NonNull subsystemName: String): T

Set the name of this subsystem that will be used in telemetry and references.