Struct spectrusty::chip::ay_player::AyPlayer

pub struct AyPlayer<P> {
    pub frames: Wrapping<u64>,
    pub tsc: TsCounter<FTs>,
    pub memory: Memory64k,
    pub ay_sound: Ay3_891xAudio,
    pub ay_io: Ay3_8913Io<FTs>,
    pub earmic_changes: Vec<FTsData2>,
    pub last_earmic: u8,
    pub prev_earmic: u8,
    /* private fields */
}

Fields

frames: Wrapping<u64>

tsc: TsCounter<FTs>

memory: Memory64k

ay_sound: Ay3_891xAudio

ay_io: Ay3_8913Io<FTs>

earmic_changes: Vec<FTsData2>

last_earmic: u8

prev_earmic: u8

Implementations

impl<P: AyPortDecode> AyPlayer<P>

pub fn cpu_clock_rate(&self) -> u32

pub fn frame_cycle_count(&self) -> FTs

pub fn frame_duration_nanos(&self) -> u32

pub fn ensure_audio_frame_time<B: Blep>(&self, blep: &mut B, sample_rate: u32)

pub fn set_host_config<H: HostConfig>(&mut self)

Changes the cpu clock frequency and the duration of frames.

pub fn set_config(&mut self, cpu_rate: u32, frame_tstates: FTs)

Changes the cpu clock frequency and the duration of frames.

pub fn reset_frames(&mut self)

Resets the frames counter.

pub fn write_ay(&mut self, timestamp: FTs, reg: u8, val: u8)

Writes data directly into the AY registers, recording changes and advancing the clock counter.

Sets the clock counter to timestamp.

Panics

The timestamp must be larger than or equal to the current clock counter value.

Trait Implementations

impl<P, A: Blep> AudioFrame<A> for AyPlayer<P>

fn ensure_audio_frame_time(&self, blep: &mut A, sample_rate: u32, cpu_hz: f64)

Sets up the Blep time rate and ensures there is enough room for the single frame’s audio data.

fn get_audio_frame_end_time(&self) -> FTs

Returns a timestamp to be passed to Blep to end the frame.

fn end_audio_frame(&self, blep: &mut B) -> usize

Calls Blep::end_frame to finalize the frame and prepare it for rendition.

impl<P, A> AyAudioFrame<A> for AyPlayer<P>where
    A: Blep,

fn render_ay_audio_frame<V: AmpLevels<A::SampleDelta>>(
    &mut self,
    blep: &mut A,
    chans: [usize; 3]
)

Renders square-wave pulses via Blep interface.

impl<P: Clone> Clone for AyPlayer<P>

fn clone(&self) -> AyPlayer<P>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<P: AyPortDecode> ControlUnit for AyPlayer<P>

type BusDevice = NullDevice<i32>

A type of a chain of emulated peripheral devices should be declared here.

fn bus_device_mut(&mut self) -> &mut Self::BusDevice

Returns a mutable reference to the instance of the first bus device in the device chain.

fn bus_device_ref(&self) -> &Self::BusDevice

Returns a reference to the the instance of the first bus device in the device chain.

fn into_bus_device(self) -> Self::BusDevice

Destructs self and returns the instance of the bus device.

fn reset<C: Cpu>(&mut self, cpu: &mut C, hard: bool)

Performs a system reset.

fn nmi<C: Cpu>(&mut self, cpu: &mut C) -> bool

Triggers a non-maskable interrupt. Returns true if NMI was accepted.

fn execute_next_frame<C: Cpu>(&mut self, cpu: &mut C)

Conditionally prepares the internal state for the next frame and executes instructions on the cpu as fast as possible, until the near end of that frame.

fn ensure_next_frame(&mut self)

Conditionally prepares the internal state for the next frame, advances the frame counter, and wraps the T-state counter if it is near the end of a frame.

fn execute_single_step<C: Cpu, F>(
    &mut self,
    cpu: &mut C,
    debug: Option<F>
) -> Result<(), ()>where
    F: FnOnce(CpuDebug),

Executes a single instruction on the cpu with the option to pass a debugging function.

impl<P> Default for AyPlayer<P>

fn default() -> Self

Returns the “default value” for a type.

impl<'de, P> Deserialize<'de> for AyPlayer<P>

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
    __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<P, A, L> EarMicOutAudioFrame<A> for AyPlayer<P>where
    A: Blep<SampleDelta = L>,
    L: SampleDelta,

fn render_earmic_out_audio_frame<V: AmpLevels<L>>(
    &self,
    blep: &mut A,
    channel: usize
)

Renders EAR/MIC output as square-wave pulses via Blep interface.

impl<P: AyPortDecode> FrameState for AyPlayer<P>

fn current_frame(&self) -> u64

Returns the value of the current execution frame counter. The FrameState implementation should count passing frames infinitely wrapping at 2^64.

fn set_frame_counter(&mut self, fc: u64)

Sets the frame counter to the specified value.

fn frame_tstate(&self) -> (u64, FTs)

Returns a normalized frame counter and a T-state counter as a tuple.

fn current_tstate(&self) -> FTs

Returns the current value of the T-state counter.

fn set_frame_tstate(&mut self, ts: FTs)

Sets the T-state counter to the specified value modulo <Self as Video>::FRAME_TSTATES_COUNT.

fn is_frame_over(&self) -> bool

Returns true if the value of the current T-state counter has reached a certain arbitrary limit which is very close to the maximum number of T-states per frame.

impl<P> Io for AyPlayer<P>where
    P: AyPortDecode,

type Timestamp = i32

This type is being used for timestamping I/O operations. See also [Clock::Timestamp].

type WrIoBreak = ()

A value of this type is returned when a break is being requested by [Io::write_io].

type RetiBreak = ()

A value of this type is returned when a break is being requested by [Io::reti].

fn is_irq(&mut self, ts: FTs) -> bool

Should return true if the interrupt request signal - the INT line - is active.

fn read_io(&mut self, port: u16, ts: FTs) -> (u8, Option<NonZeroU16>)

Called during the IO_IORQ cycle when executing one of the IN instructions.

fn write_io(
    &mut self,
    port: u16,
    data: u8,
    ts: FTs
) -> (Option<()>, Option<NonZeroU16>)

Called during the IO_IORQ cycle when executing one of the OUT instructions.

fn irq_data(
    &mut self,
    pc: u16,
    timestamp: Self::Timestamp
) -> (u8, Option<NonZeroU16>)

Called during the INT_IORQ cycle when the maskable interrupt has been requested and accepted.

fn reti(
    &mut self,
    address: u16,
    timestamp: Self::Timestamp
) -> Option<Self::RetiBreak>

When RETI instruction is being executed this method is being called to update the device implementation instance, so another interrupt signal can be set up if necessary.

impl<P> Memory for AyPlayer<P>

type Timestamp = i32

This type is being used for timestamping memory operations. See also [Clock::Timestamp].

fn read_debug(&self, addr: u16) -> u8

Should return a single byte read from the memory present at the given address.

fn read_mem(&self, addr: u16, _ts: FTs) -> u8

Should return a single byte read from the memory present at the given address.

fn read_mem16(&self, addr: u16, _ts: FTs) -> u16

Should return the unaligned, 2 consecutive bytes from the memory present at the given address as a 16-bit unsigned integer in a LE (least significant byte first) order.

fn read_opcode(&mut self, pc: u16, _ir: u16, _ts: FTs) -> u8

Should return a single byte read from the memory present at the given pc address.

fn write_mem(&mut self, addr: u16, val: u8, _ts: FTs)

Should write a byte value into the memory at the given address.

impl<P> Serialize for AyPlayer<P>

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where
    __S: Serializer,

Serialize this value into the given Serde serializer.