feat: time mode

Author: Julusian

src/atem.ts

@@ -439,6 +439,11 @@ export class Atem extends BasicAtem {
 		return this.sendCommand(command)
 	}
 
+	public async setTimeMode(mode: Enums.TimeMode): Promise<void> {
+		const command = new Commands.TimeConfigCommand(mode)
+		return this.sendCommand(command)
+	}
+
 	public async requestTime(): Promise<void> {
 		const command = new Commands.TimeRequestCommand()
 		return this.sendCommand(command)

src/commands/TimeConfigCommand.ts

@@ -0,0 +1,40 @@
+import * as Enums from '../enums'
+import { BasicWritableCommand } from '.'
+import { DeserializedCommand } from './CommandBase'
+import { AtemState } from '../state'
+
+export class TimeConfigCommand extends BasicWritableCommand<{ mode: Enums.TimeMode }> {
+	public static readonly rawName = 'CTCC'
+	public static readonly minimumVersion = Enums.ProtocolVersion.V8_1_1
+
+	constructor(mode: Enums.TimeMode) {
+		super({ mode })
+	}
+
+	public serialize(): Buffer {
+		const buffer = Buffer.alloc(4)
+		buffer.writeUInt8(this.properties.mode, 0)
+
+		return buffer
+	}
+}
+
+export class TimeConfigUpdateCommand extends DeserializedCommand<{ mode: Enums.TimeMode }> {
+	public static readonly rawName = 'TCCc'
+	public static readonly minimumVersion = Enums.ProtocolVersion.V8_1_1
+
+	constructor(mode: Enums.TimeMode) {
+		super({ mode })
+	}
+
+	public static deserialize(rawCommand: Buffer): TimeConfigUpdateCommand {
+		const mode = rawCommand.readUInt8(0)
+
+		return new TimeConfigUpdateCommand(mode)
+	}
+
+	public applyToState(state: AtemState): string {
+		state.settings.timeMode = this.properties.mode
+		return 'settings.timeMode'
+	}
+}

src/commands/index.ts

@@ -22,3 +22,4 @@ export * from './PowerStatusCommand'
 export * from './StartupStateCommand'
 export * from './TallyBySourceCommand'
 export * from './TimeCommand'
+export * from './TimeConfigCommand'

src/enums/index.ts

@@ -412,3 +412,8 @@ export enum AudioInternalPortType {
 	AuxOut = 10,
 	AudioAuxOut = 11, // TODO - verify
 }
+
+export enum TimeMode {
+	FreeRun = 0,
+	TimeOfDay = 1,
+}

src/state/settings.ts

@@ -1,4 +1,4 @@
-import { VideoMode, MultiViewerLayout } from '../enums'
+import { VideoMode, MultiViewerLayout, TimeMode } from '../enums'
 
 export interface MultiViewerSourceState {
 	source: number
@@ -33,4 +33,5 @@ export interface SettingsState {
 	readonly multiViewers: Array<MultiViewer | undefined>
 	videoMode: VideoMode
 	mediaPool?: MediaPool
+	timeMode?: TimeMode
 }