Struct Address 

pub struct Address {
    pub high: u8,
    pub mid: u8,
    pub low: u8,
}

SysEx address (3 bytes)

Fields

high: u8

High byte

mid: u8

Mid byte

low: u8

Low byte

Implementations

impl Address

pub fn new(high: u8, mid: u8, low: u8) -> Self

Create a new address from three bytes

pub fn from_hex(hex: &str) -> Result<Self, RolandError>

Create an address from a hex string (6 hex digits)

Example

use roland_core::Address;
let addr = Address::from_hex("123456").unwrap();
assert_eq!(addr.high, 0x12);
assert_eq!(addr.mid, 0x34);
assert_eq!(addr.low, 0x56);

Examples found in repository

examples/telnet_client.rs (line 141)

    pub fn write_parameter(&mut self, address: &str, value: u8) -> Result<(), TelnetError> {
        let addr = Address::from_hex(address)?;
        let cmd = Command::WriteParameter {
            address: addr,
            value,
        };
        let response = self.send_command(&cmd)?;

        match response {
            Response::Acknowledge => Ok(()),
            Response::Error(e) => Err(TelnetError::Protocol(e)),
            _ => Err(TelnetError::Protocol(RolandError::InvalidResponse)),
        }
    }

    /// Read a parameter value
    ///
    /// # Arguments
    /// * `address` - SysEx address (3 bytes as hex string, e.g., "123456")
    /// * `size` - Size to read (typically 1 for single byte)
    ///
    /// # Returns
    /// * `Result<u8, TelnetError>` - Parameter value or error
    pub fn read_parameter(&mut self, address: &str, size: u32) -> Result<u8, TelnetError> {
        let addr = Address::from_hex(address)?;
        let cmd = Command::ReadParameter {
            address: addr,
            size,
        };
        let response = self.send_command(&cmd)?;

        match response {
            Response::Data { value, .. } => Ok(value),
            Response::Error(e) => Err(TelnetError::Protocol(e)),
            _ => Err(TelnetError::Protocol(RolandError::InvalidResponse)),
        }
    }

pub fn to_hex(&self) -> String

Convert address to hex string (6 hex digits, uppercase)

Requires alloc for String allocation.

pub fn write_hex<W: Write>(&self, w: &mut W) -> Result

Write address as hex to a formatter

This method doesn’t require alloc and can be used in no_std environments without heap allocation.

Trait Implementations

impl Clone for Address

fn clone(&self) -> Address

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Address

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for Address

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Address

fn eq(&self, other: &Address) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Address

impl Eq for Address

impl StructuralPartialEq for Address