Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
package com.diozero.internal.spi;
/*
* #%L
* Organisation: diozero
* Project: Device I/O Zero - Core
* Filename: SerialDeviceFactoryInterface.java
*
* This file is part of the diozero project. More information about this project
* can be found at http://www.diozero.com/
* %%
* Copyright (C) 2016 - 2021 diozero
* %%
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
* #L%
*/
import com.diozero.api.DeviceAlreadyOpenedException;
import com.diozero.api.RuntimeIOException;
import com.diozero.api.SerialDevice;
import com.diozero.api.SerialDeviceInterface;
public interface SerialDeviceFactoryInterface extends DeviceFactoryInterface {
static final String SERIAL_PREFIX = "-Serial-";
/**
* Provision a serial device.
* @param deviceFile The O/S name of the device, e.g. "/dev/ttyUSB0"
* @param baud Baud rate
* @param dataBits Number of data bits
* @param stopBits Number of stop bits
* @param parity Parity option
* @param readBlocking Do read operations block?
* @param minReadChars The minimum number of characters to read
* @param readTimeoutMillis How long a read operation waits for data before timing out. 0 == no timeout
* @return Serial device instance
* @throws RuntimeIOException
*/
default SerialDeviceInterface provisionSerialDevice(String deviceFile, int baud, SerialDevice.DataBits dataBits,
SerialDevice.StopBits stopBits, SerialDevice.Parity parity, boolean readBlocking, int minReadChars,
int readTimeoutMillis)
throws RuntimeIOException {
String key = createSerialKey(deviceFile);
// Check if this pin is already provisioned
if (isDeviceOpened(key)) {
throw new DeviceAlreadyOpenedException("Device " + key + " is already in use");
}
SerialDeviceInterface device = createSerialDevice(key, deviceFile, baud, dataBits, stopBits, parity, readBlocking,
minReadChars, readTimeoutMillis);
deviceOpened(device);
return device;
}
SerialDeviceInterface createSerialDevice(String key, String deviceFile, int baud, SerialDevice.DataBits dataBits,
SerialDevice.StopBits stopBits, SerialDevice.Parity parity, boolean readBlocking, int minReadChars,
int readTimeoutMillis)
throws RuntimeIOException;
static String createSerialKey(String keyPrefix, String deviceFile) {
return keyPrefix + SERIAL_PREFIX + deviceFile;
}
}
