OrgZephyr/zephyr
OrgZephyr
/
zephyr
mirror of https://github.com/zephyrproject-rtos/zephyr.git
1
0
Fork 0
Code Issues Releases Wiki Activity
zephyr/drivers/w1/Kconfig.zephyr_serial

31 lines
917 B
Plaintext
Raw Normal View History

drivers: w1: add zephyr-serial driver The zephyr-serial w1 driver introduced in this commit implements all routines for the w1 api on top of the zephyr serial driver. W1 bit read, write, and reset operations are executed by issuing polling zephyr serial byte read and write operations. The driver should be usable on most platforms in zephyr that have implemented support for the polling procedures of the serial driver. As not all serial drivers are implemented exactly the same minor additional quirks may be needed on some platforms. The most notable difference of polling serial driver implementations seems to be that some return immediately from poll_out after the transmission was started(e.g. STM32) and others wait until the transmission was completed before returning from poll_out (e.g. NRF). While this has influence on the timeout, both types are supported by this driver because the driver waits for a configurable time period until it terminates the read. The driver needs an appropriate open drain interface to be able to communicate with slaves. In the simpliest case this might be achived by configuring the mcu pins in open-drain configuration with a (sufficiently small) pull-up to 3V3/5V. Otherwise an external circuit needs to provide this interface. Overdrive and Standard Speed modes are supported by this driver. Signed-off-by: Thomas Stranger <thomas.stranger@outlook.com>
2021-07-19 00:41:20 +08:00
# Configuration options for the Zephyr serial 1-Wire Master driver
# Copyright (c) 2022 Thomas Stranger
# SPDX-License-Identifier: Apache-2.0
config W1_ZEPHYR_SERIAL
bool "1-wire Serial"
drivers: w1: use select SERIAL in Kconfig for w1-zephyr-serial driver Use 'select SERIAL', as a serial driver is supported by practically all boards, and avoids using extra overlays in samples and tests. The pattern of using select was introduced for SENSORS in df81fef944, and the only 1-wire I2C sensor was converted in 465b7615a9. Signed-off-by: Thomas Stranger <thomas.stranger@outlook.com>
2022-08-13 05:57:07 +08:00
select SERIAL
drivers: w1: Update drivers to use devicetree Kconfig symbol Update w1 drivers to use DT_HAS_<compat>_ENABLED Kconfig symbol to expose the driver and enable it by default based on devicetree. Signed-off-by: Kumar Gala <galak@kernel.org>
2022-07-22 20:22:15 +08:00
default y
depends on DT_HAS_ZEPHYR_W1_SERIAL_ENABLED
drivers: w1: Add dependency to UART runtime configuration Force enabling of the UART runtime configuration for 1-wire serial driver. Signed-off-by: Krzysztof Chruściński <krzysztof.chruscinski@nordicsemi.no>
2023-11-13 16:42:40 +08:00
select UART_USE_RUNTIME_CONFIGURE
drivers: w1: add zephyr-serial driver The zephyr-serial w1 driver introduced in this commit implements all routines for the w1 api on top of the zephyr serial driver. W1 bit read, write, and reset operations are executed by issuing polling zephyr serial byte read and write operations. The driver should be usable on most platforms in zephyr that have implemented support for the polling procedures of the serial driver. As not all serial drivers are implemented exactly the same minor additional quirks may be needed on some platforms. The most notable difference of polling serial driver implementations seems to be that some return immediately from poll_out after the transmission was started(e.g. STM32) and others wait until the transmission was completed before returning from poll_out (e.g. NRF). While this has influence on the timeout, both types are supported by this driver because the driver waits for a configurable time period until it terminates the read. The driver needs an appropriate open drain interface to be able to communicate with slaves. In the simpliest case this might be achived by configuring the mcu pins in open-drain configuration with a (sufficiently small) pull-up to 3V3/5V. Otherwise an external circuit needs to provide this interface. Overdrive and Standard Speed modes are supported by this driver. Signed-off-by: Thomas Stranger <thomas.stranger@outlook.com>
2021-07-19 00:41:20 +08:00
help
This option enables the Zephyr serial 1-Wire master driver.
The bus reset, and bit read and write operations are executed
via bytes read and write operations on top of the Zephyr
serial driver interface.
if W1_ZEPHYR_SERIAL
config W1_ZEPHYR_SERIAL_BIT_TIMEOUT
int "Bit read timeout in us"
default 380
help
The bit read timeout specifies how long the driver tries to read the
uart byte (1-wire standard speed data bit).
For serial drivers where poll_out does not block until the transfer is
complete, it must at least be greater than 87us (10bits / 115.2 kBd).
endif # W1_ZEPHYR_SERIAL