forked from electro/esp-irblaster
add 1wire components
This commit is contained in:
@@ -0,0 +1,336 @@
|
||||
/*
|
||||
* MIT License
|
||||
*
|
||||
* Copyright (c) 2017 David Antliff
|
||||
* Copyright (c) 2017 Chris Morgan <chmorgan@gmail.com>
|
||||
*
|
||||
* 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.
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file
|
||||
* @brief Interface definitions for the 1-Wire bus component.
|
||||
*
|
||||
* This component provides structures and functions that are useful for communicating
|
||||
* with devices connected to a Maxim Integrated 1-Wire® bus via a single GPIO.
|
||||
*
|
||||
* Externally powered and "parasite-powered" devices are supported.
|
||||
* Please consult your device's datasheet for power requirements.
|
||||
*/
|
||||
|
||||
#ifndef ONE_WIRE_BUS_H
|
||||
#define ONE_WIRE_BUS_H
|
||||
|
||||
#include <stdint.h>
|
||||
#include <stdbool.h>
|
||||
#include <stddef.h>
|
||||
#include "driver/gpio.h"
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
|
||||
// ROM commands
|
||||
#define OWB_ROM_SEARCH 0xF0 ///< Perform Search ROM cycle to identify devices on the bus
|
||||
#define OWB_ROM_READ 0x33 ///< Read device ROM (single device on bus only)
|
||||
#define OWB_ROM_MATCH 0x55 ///< Address a specific device on the bus by ROM
|
||||
#define OWB_ROM_SKIP 0xCC ///< Address all devices on the bus simultaneously
|
||||
#define OWB_ROM_SEARCH_ALARM 0xEC ///< Address all devices on the bus with a set alarm flag
|
||||
|
||||
#define OWB_ROM_CODE_STRING_LENGTH (17) ///< Typical length of OneWire bus ROM ID as ASCII hex string, including null terminator
|
||||
|
||||
#ifndef GPIO_NUM_NC
|
||||
# define GPIO_NUM_NC (-1) ///< ESP-IDF prior to v4.x does not define GPIO_NUM_NC
|
||||
#endif
|
||||
|
||||
struct owb_driver;
|
||||
|
||||
/**
|
||||
* @brief Structure containing 1-Wire bus information relevant to a single instance.
|
||||
*/
|
||||
typedef struct
|
||||
{
|
||||
const struct _OneWireBus_Timing * timing; ///< Pointer to timing information
|
||||
bool use_crc; ///< True if CRC checks are to be used when retrieving information from a device on the bus
|
||||
bool use_parasitic_power; ///< True if parasitic-powered devices are expected on the bus
|
||||
gpio_num_t strong_pullup_gpio; ///< Set if an external strong pull-up circuit is required
|
||||
const struct owb_driver * driver; ///< Pointer to hardware driver instance
|
||||
} OneWireBus;
|
||||
|
||||
/**
|
||||
* @brief Represents a 1-Wire ROM Code. This is a sequence of eight bytes, where
|
||||
* the first byte is the family number, then the following 6 bytes form the
|
||||
* serial number. The final byte is the CRC8 check byte.
|
||||
*/
|
||||
typedef union
|
||||
{
|
||||
/// Provides access via field names
|
||||
struct fields
|
||||
{
|
||||
uint8_t family[1]; ///< family identifier (1 byte, LSB - read/write first)
|
||||
uint8_t serial_number[6]; ///< serial number (6 bytes)
|
||||
uint8_t crc[1]; ///< CRC check byte (1 byte, MSB - read/write last)
|
||||
} fields; ///< Provides access via field names
|
||||
|
||||
uint8_t bytes[8]; ///< Provides raw byte access
|
||||
|
||||
} OneWireBus_ROMCode;
|
||||
|
||||
/**
|
||||
* @brief Represents the state of a device search on the 1-Wire bus.
|
||||
*
|
||||
* Pass a pointer to this structure to owb_search_first() and
|
||||
* owb_search_next() to iterate through detected devices on the bus.
|
||||
*/
|
||||
typedef struct
|
||||
{
|
||||
OneWireBus_ROMCode rom_code; ///< Device ROM code
|
||||
int last_discrepancy; ///< Bit index that identifies from which bit the next search discrepancy check should start
|
||||
int last_family_discrepancy; ///< Bit index that identifies the last discrepancy within the first 8-bit family code of the ROM code
|
||||
int last_device_flag; ///< Flag to indicate previous search was the last device detected
|
||||
} OneWireBus_SearchState;
|
||||
|
||||
/**
|
||||
* @brief Represents the result of OWB API functions.
|
||||
*/
|
||||
typedef enum
|
||||
{
|
||||
OWB_STATUS_NOT_SET = -1, ///< A status value has not been set
|
||||
OWB_STATUS_OK = 0, ///< Operation succeeded
|
||||
OWB_STATUS_NOT_INITIALIZED, ///< Function was passed an uninitialised variable
|
||||
OWB_STATUS_PARAMETER_NULL, ///< Function was passed a null pointer
|
||||
OWB_STATUS_DEVICE_NOT_RESPONDING, ///< No response received from the addressed device or devices
|
||||
OWB_STATUS_CRC_FAILED, ///< CRC failed on data received from a device or devices
|
||||
OWB_STATUS_TOO_MANY_BITS, ///< Attempt to write an incorrect number of bits to the One Wire Bus
|
||||
OWB_STATUS_HW_ERROR ///< A hardware error occurred
|
||||
} owb_status;
|
||||
|
||||
/** NOTE: Driver assumes that (*init) was called prior to any other methods */
|
||||
struct owb_driver
|
||||
{
|
||||
/** Driver identification **/
|
||||
const char* name;
|
||||
|
||||
/** Pointer to driver uninitialization function **/
|
||||
owb_status (*uninitialize)(const OneWireBus * bus);
|
||||
|
||||
/** Pointer to driver reset functio **/
|
||||
owb_status (*reset)(const OneWireBus * bus, bool *is_present);
|
||||
|
||||
/** NOTE: The data is shifted out of the low bits, eg. it is written in the order of lsb to msb */
|
||||
owb_status (*write_bits)(const OneWireBus *bus, uint8_t out, int number_of_bits_to_write);
|
||||
|
||||
/** NOTE: Data is read into the high bits, eg. each bit read is shifted down before the next bit is read */
|
||||
owb_status (*read_bits)(const OneWireBus *bus, uint8_t *in, int number_of_bits_to_read);
|
||||
};
|
||||
|
||||
/// @cond ignore
|
||||
#define container_of(ptr, type, member) ({ \
|
||||
const typeof( ((type *)0)->member ) *__mptr = (ptr); \
|
||||
(type *)( (char *)__mptr - offsetof(type,member) );})
|
||||
/// @endcond
|
||||
|
||||
/**
|
||||
* @brief call to release resources after completing use of the OneWireBus
|
||||
* @param[in] bus Pointer to initialised bus instance.
|
||||
* @return status
|
||||
*/
|
||||
owb_status owb_uninitialize(OneWireBus * bus);
|
||||
|
||||
/**
|
||||
* @brief Enable or disable use of CRC checks on device communications.
|
||||
* @param[in] bus Pointer to initialised bus instance.
|
||||
* @param[in] use_crc True to enable CRC checks, false to disable.
|
||||
* @return status
|
||||
*/
|
||||
owb_status owb_use_crc(OneWireBus * bus, bool use_crc);
|
||||
|
||||
/**
|
||||
* @brief Enable or disable use of parasitic power on the One Wire Bus.
|
||||
* This affects how devices signal on the bus, as devices cannot
|
||||
* signal by pulling the bus low when it is pulled high.
|
||||
* @param[in] bus Pointer to initialised bus instance.
|
||||
* @param[in] use_parasitic_power True to enable parasitic power, false to disable.
|
||||
* @return status
|
||||
*/
|
||||
owb_status owb_use_parasitic_power(OneWireBus * bus, bool use_parasitic_power);
|
||||
|
||||
/**
|
||||
* @brief Enable or disable use of extra GPIO to activate strong pull-up circuit.
|
||||
* This only has effect if parasitic power mode is enabled.
|
||||
* signal by pulling the bus low when it is pulled high.
|
||||
* @param[in] bus Pointer to initialised bus instance.
|
||||
* @param[in] gpio Set to GPIO number to use, or GPIO_NUM_NC to disable.
|
||||
* @return status
|
||||
*/
|
||||
owb_status owb_use_strong_pullup_gpio(OneWireBus * bus, gpio_num_t gpio);
|
||||
|
||||
/**
|
||||
* @brief Read ROM code from device - only works when there is a single device on the bus.
|
||||
* @param[in] bus Pointer to initialised bus instance.
|
||||
* @param[out] rom_code the value read from the device's rom
|
||||
* @return status
|
||||
*/
|
||||
owb_status owb_read_rom(const OneWireBus * bus, OneWireBus_ROMCode * rom_code);
|
||||
|
||||
/**
|
||||
* @brief Verify the device specified by ROM code is present.
|
||||
* @param[in] bus Pointer to initialised bus instance.
|
||||
* @param[in] rom_code ROM code to verify.
|
||||
* @param[out] is_present Set to true if a device is present, false if not
|
||||
* @return status
|
||||
*/
|
||||
owb_status owb_verify_rom(const OneWireBus * bus, OneWireBus_ROMCode rom_code, bool * is_present);
|
||||
|
||||
/**
|
||||
* @brief Reset the 1-Wire bus.
|
||||
* @param[in] bus Pointer to initialised bus instance.
|
||||
* @param[out] is_present set to true if at least one device is present on the bus
|
||||
* @return status
|
||||
*/
|
||||
owb_status owb_reset(const OneWireBus * bus, bool * is_present);
|
||||
|
||||
/**
|
||||
* @brief Read a single bit from the 1-Wire bus.
|
||||
* @param[in] bus Pointer to initialised bus instance.
|
||||
* @param[out] out The bit value read from the bus.
|
||||
* @return status
|
||||
*/
|
||||
owb_status owb_read_bit(const OneWireBus * bus, uint8_t * out);
|
||||
|
||||
/**
|
||||
* @brief Read a single byte from the 1-Wire bus.
|
||||
* @param[in] bus Pointer to initialised bus instance.
|
||||
* @param[out] out The byte value read from the bus (lsb only).
|
||||
* @return status
|
||||
*/
|
||||
owb_status owb_read_byte(const OneWireBus * bus, uint8_t * out);
|
||||
|
||||
/**
|
||||
* @brief Read a number of bytes from the 1-Wire bus.
|
||||
* @param[in] bus Pointer to initialised bus instance.
|
||||
* @param[in, out] buffer Pointer to buffer to receive read data.
|
||||
* @param[in] len Number of bytes to read, must not exceed length of receive buffer.
|
||||
* @return status.
|
||||
*/
|
||||
owb_status owb_read_bytes(const OneWireBus * bus, uint8_t * buffer, unsigned int len);
|
||||
|
||||
/**
|
||||
* @brief Write a bit to the 1-Wire bus.
|
||||
* @param[in] bus Pointer to initialised bus instance.
|
||||
* @param[in] bit Value to write (lsb only).
|
||||
* @return status
|
||||
*/
|
||||
owb_status owb_write_bit(const OneWireBus * bus, uint8_t bit);
|
||||
|
||||
/**
|
||||
* @brief Write a single byte to the 1-Wire bus.
|
||||
* @param[in] bus Pointer to initialised bus instance.
|
||||
* @param[in] data Byte value to write to bus.
|
||||
* @return status
|
||||
*/
|
||||
owb_status owb_write_byte(const OneWireBus * bus, uint8_t data);
|
||||
|
||||
/**
|
||||
* @brief Write a number of bytes to the 1-Wire bus.
|
||||
* @param[in] bus Pointer to initialised bus instance.
|
||||
* @param[in] buffer Pointer to buffer to write data from.
|
||||
* @param[in] len Number of bytes to write.
|
||||
* @return status
|
||||
*/
|
||||
owb_status owb_write_bytes(const OneWireBus * bus, const uint8_t * buffer, size_t len);
|
||||
|
||||
/**
|
||||
* @brief Write a ROM code to the 1-Wire bus ensuring LSB is sent first.
|
||||
* @param[in] bus Pointer to initialised bus instance.
|
||||
* @param[in] rom_code ROM code to write to bus.
|
||||
* @return status
|
||||
*/
|
||||
owb_status owb_write_rom_code(const OneWireBus * bus, OneWireBus_ROMCode rom_code);
|
||||
|
||||
/**
|
||||
* @brief 1-Wire 8-bit CRC lookup.
|
||||
* @param[in] crc Starting CRC value. Pass in prior CRC to accumulate.
|
||||
* @param[in] data Byte to feed into CRC.
|
||||
* @return Resultant CRC value.
|
||||
* Should be zero if last byte was the CRC byte and the CRC matches.
|
||||
*/
|
||||
uint8_t owb_crc8_byte(uint8_t crc, uint8_t data);
|
||||
|
||||
/**
|
||||
* @brief 1-Wire 8-bit CRC lookup with accumulation over a block of bytes.
|
||||
* @param[in] crc Starting CRC value. Pass in prior CRC to accumulate.
|
||||
* @param[in] data Array of bytes to feed into CRC.
|
||||
* @param[in] len Length of data array in bytes.
|
||||
* @return Resultant CRC value.
|
||||
* Should be zero if last byte was the CRC byte and the CRC matches.
|
||||
*/
|
||||
uint8_t owb_crc8_bytes(uint8_t crc, const uint8_t * data, size_t len);
|
||||
|
||||
/**
|
||||
* @brief Locates the first device on the 1-Wire bus, if present.
|
||||
* @param[in] bus Pointer to initialised bus instance.
|
||||
* @param[in,out] state Pointer to an existing search state structure.
|
||||
* @param[out] found_device True if a device is found, false if no devices are found.
|
||||
* If a device is found, the ROM Code can be obtained from the state.
|
||||
* @return status
|
||||
*/
|
||||
owb_status owb_search_first(const OneWireBus * bus, OneWireBus_SearchState * state, bool *found_device);
|
||||
|
||||
/**
|
||||
* @brief Locates the next device on the 1-Wire bus, if present, starting from
|
||||
* the provided state. Further calls will yield additional devices, if present.
|
||||
* @param[in] bus Pointer to initialised bus instance.
|
||||
* @param[in,out] state Pointer to an existing search state structure.
|
||||
* @param[out] found_device True if a device is found, false if no devices are found.
|
||||
* If a device is found, the ROM Code can be obtained from the state.
|
||||
* @return status
|
||||
*/
|
||||
owb_status owb_search_next(const OneWireBus * bus, OneWireBus_SearchState * state, bool *found_device);
|
||||
|
||||
/**
|
||||
* @brief Create a string representation of a ROM code, most significant byte (CRC8) first.
|
||||
* @param[in] rom_code The ROM code to convert to string representation.
|
||||
* @param[out] buffer The destination for the string representation. It will be null terminated.
|
||||
* @param[in] len The length of the buffer in bytes. 64-bit ROM codes require 16 characters
|
||||
* to represent as a string, plus a null terminator, for 17 bytes.
|
||||
* See OWB_ROM_CODE_STRING_LENGTH.
|
||||
* @return pointer to the byte beyond the last byte written
|
||||
*/
|
||||
char * owb_string_from_rom_code(OneWireBus_ROMCode rom_code, char * buffer, size_t len);
|
||||
|
||||
/**
|
||||
* @brief Enable or disable the strong-pullup GPIO, if configured.
|
||||
* @param[in] bus Pointer to initialised bus instance.
|
||||
* @param[in] enable If true, enable the external strong pull-up by setting the GPIO high.
|
||||
* If false, disable the external strong pull-up by setting the GPIO low.
|
||||
* @return status
|
||||
*/
|
||||
owb_status owb_set_strong_pullup(const OneWireBus * bus, bool enable);
|
||||
|
||||
|
||||
#include "owb_gpio.h"
|
||||
#include "owb_rmt.h"
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif // ONE_WIRE_BUS_H
|
||||
@@ -0,0 +1,70 @@
|
||||
/*
|
||||
* MIT License
|
||||
*
|
||||
* Copyright (c) 2017 David Antliff
|
||||
* Copyright (c) 2017 Chris Morgan <chmorgan@gmail.com>
|
||||
*
|
||||
* 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.
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file
|
||||
* @brief Interface definitions for the ESP32 GPIO driver used to communicate with devices
|
||||
* on the One Wire Bus.
|
||||
*
|
||||
* @deprecated
|
||||
* This driver is deprecated and may be removed at some stage. It is not recommended for use
|
||||
* due to issues with imprecise timing.
|
||||
*/
|
||||
|
||||
#pragma once
|
||||
#ifndef OWB_GPIO_H
|
||||
#define OWB_GPIO_H
|
||||
|
||||
#include "owb.h"
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @brief GPIO driver information
|
||||
*/
|
||||
typedef struct
|
||||
{
|
||||
int gpio; ///< Value of the GPIO connected to the 1-Wire bus
|
||||
OneWireBus bus; ///< OneWireBus instance
|
||||
} owb_gpio_driver_info;
|
||||
|
||||
/**
|
||||
* @brief Initialise the GPIO driver.
|
||||
* @return OneWireBus*, pass this into the other OneWireBus public API functions
|
||||
*/
|
||||
OneWireBus * owb_gpio_initialize(owb_gpio_driver_info *driver_info, int gpio);
|
||||
|
||||
/**
|
||||
* @brief Clean up after a call to owb_gpio_initialize()
|
||||
*/
|
||||
void owb_gpio_uninitialize(owb_gpio_driver_info *driver_info);
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif // OWB_GPIO_H
|
||||
@@ -0,0 +1,75 @@
|
||||
/*
|
||||
* MIT License
|
||||
*
|
||||
* Copyright (c) 2017 David Antliff
|
||||
* Copyright (c) 2017 Chris Morgan <chmorgan@gmail.com>
|
||||
*
|
||||
* 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.
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file
|
||||
* @brief Interface definitions for ESP32 RMT driver used to communicate with devices
|
||||
* on the One Wire Bus.
|
||||
*
|
||||
* This is the recommended driver.
|
||||
*/
|
||||
|
||||
#pragma once
|
||||
#ifndef OWB_RMT_H
|
||||
#define OWB_RMT_H
|
||||
|
||||
#include "freertos/FreeRTOS.h"
|
||||
#include "freertos/queue.h"
|
||||
#include "freertos/ringbuf.h"
|
||||
#include "driver/rmt.h"
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @brief RMT driver information
|
||||
*/
|
||||
typedef struct
|
||||
{
|
||||
int tx_channel; ///< RMT channel to use for TX
|
||||
int rx_channel; ///< RMT channel to use for RX
|
||||
RingbufHandle_t rb; ///< Ring buffer handle
|
||||
int gpio; ///< OneWireBus GPIO
|
||||
OneWireBus bus; ///< OneWireBus instance
|
||||
} owb_rmt_driver_info;
|
||||
|
||||
/**
|
||||
* @brief Initialise the RMT driver.
|
||||
* @param[in] info Pointer to an uninitialized owb_rmt_driver_info structure.
|
||||
* Note: the structure must remain in scope for the lifetime of this component.
|
||||
* @param[in] gpio_num The GPIO number to use as the One Wire bus data line.
|
||||
* @param[in] tx_channel The RMT channel to use for transmitting data to bus devices.
|
||||
* @param[in] rx_channel the RMT channel to use for receiving data from bus devices.
|
||||
* @return OneWireBus *, pass this into the other OneWireBus public API functions
|
||||
*/
|
||||
OneWireBus* owb_rmt_initialize(owb_rmt_driver_info * info, gpio_num_t gpio_num,
|
||||
rmt_channel_t tx_channel, rmt_channel_t rx_channel);
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif // OWB_RMT_H
|
||||
Reference in New Issue
Block a user