Device interface library for multiple platforms including Mbed.
Dependents: DeepCover Embedded Security in IoT MaximInterface MAXREFDES155#
Maxim Interface is a library framework focused on providing flexible and expressive hardware interfaces. Both communication interfaces such as I2C and 1-Wire and device interfaces such as DS18B20 are supported. Modern C++ concepts are used extensively while keeping compatibility with C++98/C++03 and requiring no external dependencies. The embedded-friendly design does not depend on exceptions or RTTI.
The full version of the project is hosted on GitLab: https://gitlab.com/iabenz/MaximInterface
MaximInterfaceDevices/DS2482_DS2484.hpp
- Committer:
- IanBenzMaxim
- Date:
- 2020-05-29
- Revision:
- 12:7eb41621ba22
- Parent:
- 8:5ea891c7d1a1
File content as of revision 12:7eb41621ba22:
/******************************************************************************* * Copyright (C) Maxim Integrated Products, Inc., All Rights Reserved. * * 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 MAXIM INTEGRATED 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. * * Except as contained in this notice, the name of Maxim Integrated * Products, Inc. shall not be used except as stated in the Maxim Integrated * Products, Inc. Branding Policy. * * The mere transfer of this software does not imply any licenses * of trade secrets, proprietary technology, copyrights, patents, * trademarks, maskwork rights, or any other form of intellectual * property whatsoever. Maxim Integrated Products, Inc. retains all * ownership rights. *******************************************************************************/ #ifndef MaximInterfaceDevices_DS2482_DS2484_hpp #define MaximInterfaceDevices_DS2482_DS2484_hpp #include <MaximInterfaceCore/I2CMaster.hpp> #include <MaximInterfaceCore/OneWireMaster.hpp> #include "Config.hpp" namespace MaximInterfaceDevices { /// Interface to the DS2484, DS2482-100, DS2482-101, DS2482-800 1-Wire masters. class DS2482_DS2484 : public Core::OneWireMaster { public: enum ErrorValue { HardwareError = 1, ArgumentOutOfRangeError }; /// Represents a device configuration. class Config { public: /// Default construct with power-on config. explicit Config(uint_least8_t readByte = optionAPU) : readByte_(readByte & 0xF) {} /// @name 1WS /// @brief 1-Wire Speed /// @{ /// Get 1WS bit. bool get1WS() const { return (readByte_ & option1WS) == option1WS; } /// Set 1WS bit. Config & set1WS(bool new1WS) { if (new1WS) { readByte_ |= option1WS; } else { readByte_ &= ~option1WS; } return *this; } /// @} /// @name SPU /// @brief Strong Pullup /// @{ /// Get SPU bit. bool getSPU() const { return (readByte_ & optionSPU) == optionSPU; } /// Set SPU bit. Config & setSPU(bool newSPU) { if (newSPU) { readByte_ |= optionSPU; } else { readByte_ &= ~optionSPU; } return *this; } /// @} /// @name PDN /// @brief 1-Wire Power Down /// @{ /// Get PDN bit. bool getPDN() const { return (readByte_ & optionPDN) == optionPDN; } /// Set PDN bit. Config & setPDN(bool newPDN) { if (newPDN) { readByte_ |= optionPDN; } else { readByte_ &= ~optionPDN; } return *this; } /// @} /// @name APU /// @brief Active Pullup /// @{ /// Get APU bit. bool getAPU() const { return (readByte_ & optionAPU) == optionAPU; } /// Set APU bit. Config & setAPU(bool newAPU) { if (newAPU) { readByte_ |= optionAPU; } else { readByte_ &= ~optionAPU; } return *this; } /// @} /// Byte representation that is read from the device. uint_least8_t readByte() const { return readByte_; } private: static const unsigned int option1WS = 0x8; static const unsigned int optionSPU = 0x4; static const unsigned int optionPDN = 0x2; static const unsigned int optionAPU = 0x1; uint_least8_t readByte_; }; void setMaster(Core::I2CMaster & master) { this->master = &master; } uint_least8_t address() const { return address_; } void setAddress(uint_least8_t address) { address_ = address; } /// Initialize hardware for use. MaximInterfaceDevices_EXPORT Core::Result<void> initialize(Config config = Config()); /// @brief Write a new configuration to the device. /// @param[in] config New configuration to write. MaximInterfaceDevices_EXPORT Core::Result<void> writeConfig(Config config); MaximInterfaceDevices_EXPORT virtual Core::Result<TripletData> triplet(bool sendBit); MaximInterfaceDevices_EXPORT virtual Core::Result<void> reset(); MaximInterfaceDevices_EXPORT virtual Core::Result<bool> touchBitSetLevel(bool sendBit, Level afterLevel); MaximInterfaceDevices_EXPORT virtual Core::Result<uint_least8_t> readByteSetLevel(Level afterLevel); MaximInterfaceDevices_EXPORT virtual Core::Result<void> writeByteSetLevel(uint_least8_t sendByte, Level afterLevel); MaximInterfaceDevices_EXPORT virtual Core::Result<void> setSpeed(Speed newSpeed); MaximInterfaceDevices_EXPORT virtual Core::Result<void> setLevel(Level newLevel); MaximInterfaceDevices_EXPORT static const Core::error_category & errorCategory(); protected: DS2482_DS2484(Core::I2CMaster & master, uint_least8_t address) : master(&master), address_(address) {} /// @note Allow marking const since not public. Core::Result<void> sendCommand(uint_least8_t cmd) const; /// @note Allow marking const since not public. Core::Result<void> sendCommand(uint_least8_t cmd, uint_least8_t param) const; /// @brief Reads a register from the device. /// @param reg Register to read from. /// @returns Read data from register. Core::Result<uint_least8_t> readRegister(uint_least8_t reg) const; /// @brief Reads the current register from the device. /// @returns Read data from register. Core::Result<uint_least8_t> readRegister() const; private: /// @brief Performs a soft reset on the device. /// @note This is not a 1-Wire Reset. Core::Result<void> resetDevice(); /// @brief /// Polls the device status waiting for the 1-Wire Busy bit (1WB) to be cleared. /// @returns Status byte or TimeoutError if poll limit reached. Core::Result<uint_least8_t> pollBusy(); /// @brief Ensure that the desired 1-Wire level is set in the configuration. /// @param level Desired 1-Wire level. Core::Result<void> configureLevel(Level level); Core::I2CMaster * master; uint_least8_t address_; Config curConfig; }; } // namespace MaximInterfaceDevices namespace MaximInterfaceCore { template <> struct is_error_code_enum<MaximInterfaceDevices::DS2482_DS2484::ErrorValue> : true_type {}; } // namespace MaximInterfaceCore namespace MaximInterfaceDevices { inline Core::error_code make_error_code(DS2482_DS2484::ErrorValue e) { return Core::error_code(e, DS2482_DS2484::errorCategory()); } class DS2482_100 : public DS2482_DS2484 { public: DS2482_100(Core::I2CMaster & i2c_bus, uint_least8_t adrs) : DS2482_DS2484(i2c_bus, adrs) {} }; /// DS2482-800 I2C to 1-Wire Master class DS2482_800 : public DS2482_DS2484 { public: DS2482_800(Core::I2CMaster & i2c_bus, uint_least8_t adrs) : DS2482_DS2484(i2c_bus, adrs) {} /// @brief Select the active 1-Wire channel. /// @param channel Channel number to select from 0 to 7. MaximInterfaceDevices_EXPORT Core::Result<void> selectChannel(int channel); }; /// DS2484 I2C to 1-Wire Master class DS2484 : public DS2482_DS2484 { public: /// @brief 1-Wire port adjustment parameters. /// @note See datasheet page 13. enum PortParameter { tRSTL = 0, tRSTL_OD, tMSP, tMSP_OD, tW0L, tW0L_OD, tREC0, // OD N/A RWPU = 8 // OD N/A }; explicit DS2484(Core::I2CMaster & i2c_bus, uint_least8_t adrs = 0x30) : DS2482_DS2484(i2c_bus, adrs) {} /// @brief Adjust 1-Wire port parameters. /// @param param Parameter to adjust. /// @param val New parameter value to set. Consult datasheet for value mappings. MaximInterfaceDevices_EXPORT Core::Result<void> adjustPort(PortParameter param, int val); }; } // namespace MaximInterfaceDevices #endif