matrix65 0.2.0

Matrix Mode Serial Communicator for MEGA65
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

use crate::filehost;
use crate::textui;
use matrix65::io;
use matrix65::serial;
use parse_int::parse;
use serialport::SerialPort;
use std::io::{Read, Write};

pub fn reset<T: Read + Write>(port: &mut T, c64: bool) -> Result<(), anyhow::Error> {
    serial::reset(port)?;
    if c64 {
        serial::go64(port)?
    };
    Ok(())
}

pub fn peek<T: Read + Write>(
    port: &mut T,
    address: String,
    length: usize,
    outfile: Option<String>,
    disassemble: bool,
) -> Result<(), anyhow::Error> {
    let start_address = parse::<u32>(&address)?;
    let bytes = serial::read_memory(port, start_address, length)?;
    match outfile {
        Some(name) => io::save_binary(&name, &bytes)?,
        None => {
            if disassemble {
                matrix65::io::disassemble(&bytes, start_address);
            } else {
                matrix65::io::hexdump(&bytes, 8);
            }
        }
    };
    Ok(())
}

pub fn poke<T: Read + Write>(
    file: Option<String>,
    value: Option<u8>,
    address: String,
    port: &mut T,
) -> Result<(), anyhow::Error> {
    let bytes = match file {
        Some(f) => matrix65::io::load_bytes(&f)?,
        None => vec![value.ok_or_else(|| anyhow::Error::msg("VALUE required for poking"))?],
    };
    let parsed_address = parse::<u16>(&address)?;
    if parsed_address.checked_add(bytes.len() as u16 - 1).is_none() {
        // Merely a safety measure. Is this needed?
        return Err(anyhow::Error::msg(
            "poking outside the 16-bit address space is currently unsupported",
        ));
    }
    matrix65::serial::write_memory(port, parsed_address, &bytes)?;
    Ok(())
}

pub fn filehost(port: &mut Box<dyn SerialPort>) -> Result<(), anyhow::Error> {
    let mut entries: Vec<_> = filehost::get_file_list()?
        .iter()
        .cloned()
        .filter(|item| {
            item.filename.to_lowercase().ends_with(".prg")
                | item.filename.to_lowercase().ends_with(".d81")
        })
        .collect();
    entries.sort_by_key(|i| i.title.clone());
    textui::terminal::start_tui(port, &entries)?;
    Ok(())
}