Struct GigeDevice 

pub struct GigeDevice { /* private fields */ }

GVCP device handle.

Implementations

impl GigeDevice

pub async fn open(addr: SocketAddr) -> Result<Self, GigeError>

Connect to a device GVCP endpoint.

The connection is ready for register read/write but does not claim control privilege. Call Self::claim_control before configuring streaming or starting acquisition.

pub async fn claim_control(&mut self) -> Result<(), GigeError>

Claim control channel privilege (CCP).

Required by the GigE Vision specification before the device accepts stream configuration or acquisition commands.

pub async fn release_control(&mut self) -> Result<(), GigeError>

Release control channel privilege.

pub fn remote_addr(&self) -> SocketAddr

Return the remote GVCP socket address associated with this device.

pub async fn read_register(&mut self, addr: u32) -> Result<u32, GigeError>

Read a single 32-bit bootstrap or device register.

Uses GVCP READREG format: 4-byte register address. The acknowledgement carries the 4-byte register value.

pub async fn write_register( &mut self, addr: u32, value: u32, ) -> Result<(), GigeError>

Write a single 32-bit bootstrap or device register.

Uses GVCP WRITEREG format: 4-byte register address + 4-byte value. The acknowledgement carries a 4-byte data index placeholder.

pub async fn read_mem( &mut self, addr: u64, len: usize, ) -> Result<Vec<u8>, GigeError>

Read a block of memory from the remote device with chunking and retries.

Uses GVCP READMEM format: 4-byte address + 2-byte reserved + 2-byte count. The acknowledgement carries: 4-byte address echo + data bytes.

pub async fn write_mem( &mut self, addr: u64, data: &[u8], ) -> Result<(), GigeError>

Write a block of memory to the remote device with chunking and retries.

Uses GVCP WRITEMEM format: 4-byte address + data bytes. The acknowledgement carries: 4-byte reserved (index).

pub async fn set_message_destination( &mut self, ip: Ipv4Addr, port: u16, ) -> Result<(), GigeError>

Configure the message channel destination address/port.

pub async fn set_stream_destination( &mut self, channel: u32, ip: Ipv4Addr, port: u16, ) -> Result<(), GigeError>

Configure the GVSP host destination for the provided channel.

pub async fn set_stream_packet_size( &mut self, channel: u32, packet_size: u32, ) -> Result<(), GigeError>

Configure the packet size for the stream channel.

pub async fn set_stream_packet_delay( &mut self, channel: u32, packet_delay: u32, ) -> Result<(), GigeError>

Configure the packet delay (GevSCPD).

pub async fn negotiate_stream( &mut self, channel: u32, iface: &Iface, port: u16, target_mtu: Option<u32>, ) -> Result<StreamParams, GigeError>

Negotiate GVSP parameters with the device given the host interface.

pub async fn enable_event_raw( &mut self, id: u16, on: bool, ) -> Result<(), GigeError>

Enable or disable delivery of the provided event identifier.

pub async fn read_persistent_ip( &mut self, ) -> Result<(Ipv4Addr, Ipv4Addr, Ipv4Addr), GigeError>

Read the persistent IP configuration from the device.

Returns (ip, subnet, gateway).

pub async fn write_persistent_ip( &mut self, ip: Ipv4Addr, subnet: Ipv4Addr, gateway: Ipv4Addr, ) -> Result<(), GigeError>

Write the persistent IP configuration to the device.

pub async fn enable_persistent_ip(&mut self) -> Result<(), GigeError>

Enable persistent IP mode in the device configuration flags.

Sets bit 1 (persistent IP) in the CurrentIPConfiguration register.

pub async fn request_resend( &mut self, block_id: u16, first_packet: u16, last_packet: u16, ) -> Result<(), GigeError>

Request resend of a packet range for the provided block identifier.