neser 1.1.0

NESER - Nintendo Emulation Systems Engine (Rust). Desktop and WebAssembly frontends.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

//! RAM initialization utilities for configurable power-on behavior.
//!
//! This module provides helper functions to initialize RAM with different patterns
//! based on the configured RAM initialization mode.

use crate::platform::config::RamInitMode;
use rand::rngs::StdRng;
use rand::{Rng, SeedableRng};

/// Initialize a RAM buffer based on the configured RAM initialization mode.
///
/// # Arguments
/// * `buffer` - Mutable slice to initialize
/// * `mode` - RAM initialization mode (zero, random, or seeded-random)
///
/// # Examples
/// ```
/// use neser::console::{initialize_ram, RamInitMode};
///
/// let mut ram = vec![0u8; 2048];
/// initialize_ram(&mut ram, RamInitMode::Zero);
/// assert!(ram.iter().all(|&b| b == 0x00));
/// ```
pub fn initialize_ram(buffer: &mut [u8], mode: RamInitMode) {
    match mode {
        RamInitMode::Zero => {
            // Initialize all bytes to 0x00
            buffer.fill(0x00);
        }
        RamInitMode::Random => {
            // Initialize with pseudo-random values
            let mut rng = rand::rng();
            rng.fill(buffer);
        }
        RamInitMode::SeededRandom(seed) => {
            // Initialize with pseudo-random values from a fixed seed
            let mut rng = StdRng::seed_from_u64(seed);
            rng.fill(buffer);
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_zero_mode_initializes_to_zero() {
        let mut buffer = vec![0xFF; 1024];
        initialize_ram(&mut buffer, RamInitMode::Zero);
        assert!(buffer.iter().all(|&b| b == 0x00));
    }

    #[test]
    fn test_seeded_random_is_deterministic() {
        let mut buffer1 = vec![0; 1024];
        let mut buffer2 = vec![0; 1024];

        initialize_ram(&mut buffer1, RamInitMode::SeededRandom(42));
        initialize_ram(&mut buffer2, RamInitMode::SeededRandom(42));

        assert_eq!(
            buffer1, buffer2,
            "Same seed should produce identical results"
        );
    }

    #[test]
    fn test_seeded_random_different_seeds_produce_different_values() {
        let mut buffer1 = vec![0; 1024];
        let mut buffer2 = vec![0; 1024];

        initialize_ram(&mut buffer1, RamInitMode::SeededRandom(42));
        initialize_ram(&mut buffer2, RamInitMode::SeededRandom(43));

        assert_ne!(
            buffer1, buffer2,
            "Different seeds should produce different results"
        );
    }

    #[test]
    fn test_seeded_random_produces_nonzero_values() {
        let mut buffer = vec![0; 1024];
        initialize_ram(&mut buffer, RamInitMode::SeededRandom(42));

        // At least some bytes should be non-zero
        assert!(buffer.iter().any(|&b| b != 0x00));
    }

    #[test]
    fn test_random_mode_produces_nonzero_values() {
        let mut buffer = vec![0; 1024];
        initialize_ram(&mut buffer, RamInitMode::Random);

        // At least some bytes should be non-zero with high probability
        assert!(buffer.iter().any(|&b| b != 0x00));
    }
}