Maxim Integrated / OneWire

1-Wire® library for mbed. Complete 1-Wire library that supports our silicon masters along with a bit-bang master on the MAX32600MBED platform with one common interface for mbed. Slave support has also been included and more slaves will be added as time permits.

Dependents:   MAXREFDES131_Qt_Demo MAX32630FTHR_iButton_uSD_Logger MAX32630FTHR_DS18B20_uSD_Logger MAXREFDES130_131_Demo ... more

Superseded by MaximInterface.

Masters/DS2480B/DS2480B.h@74:23be10c32fa3, 2016-05-13 (annotated)

Committer:
IanBenzMaxim
Date:
Fri May 13 07:48:35 2016 -0500
Revision:
74:23be10c32fa3
Parent:
73:2cecc1372acc
Child:
75:8b627804927c
Assimilated indentation and braces.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
j3 3:644fc630f958 1 /******************************************************************//**
j3 3:644fc630f958 2 * Copyright (C) 2016 Maxim Integrated Products, Inc., All Rights Reserved.
j3 3:644fc630f958 3 *
j3 3:644fc630f958 4 * Permission is hereby granted, free of charge, to any person obtaining a
j3 3:644fc630f958 5 * copy of this software and associated documentation files (the "Software"),
j3 3:644fc630f958 6 * to deal in the Software without restriction, including without limitation
j3 3:644fc630f958 7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
j3 3:644fc630f958 8 * and/or sell copies of the Software, and to permit persons to whom the
j3 3:644fc630f958 9 * Software is furnished to do so, subject to the following conditions:
j3 3:644fc630f958 10 *
j3 3:644fc630f958 11 * The above copyright notice and this permission notice shall be included
j3 3:644fc630f958 12 * in all copies or substantial portions of the Software.
j3 3:644fc630f958 13 *
j3 3:644fc630f958 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
j3 3:644fc630f958 15 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
j3 3:644fc630f958 16 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
j3 3:644fc630f958 17 * IN NO EVENT SHALL MAXIM INTEGRATED BE LIABLE FOR ANY CLAIM, DAMAGES
j3 3:644fc630f958 18 * OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
j3 3:644fc630f958 19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
j3 3:644fc630f958 20 * OTHER DEALINGS IN THE SOFTWARE.
j3 3:644fc630f958 21 *
j3 3:644fc630f958 22 * Except as contained in this notice, the name of Maxim Integrated
j3 3:644fc630f958 23 * Products, Inc. shall not be used except as stated in the Maxim Integrated
j3 3:644fc630f958 24 * Products, Inc. Branding Policy.
j3 3:644fc630f958 25 *
j3 3:644fc630f958 26 * The mere transfer of this software does not imply any licenses
j3 3:644fc630f958 27 * of trade secrets, proprietary technology, copyrights, patents,
j3 3:644fc630f958 28 * trademarks, maskwork rights, or any other form of intellectual
j3 3:644fc630f958 29 * property whatsoever. Maxim Integrated Products, Inc. retains all
j3 3:644fc630f958 30 * ownership rights.
j3 3:644fc630f958 31 **********************************************************************/
j3 3:644fc630f958 32
IanBenzMaxim 73:2cecc1372acc 33 #ifndef OneWire_Masters_DS2480B
IanBenzMaxim 73:2cecc1372acc 34 #define OneWire_Masters_DS2480B
j3 3:644fc630f958 35
IanBenzMaxim 73:2cecc1372acc 36 #include "PinNames.h"
IanBenzMaxim 73:2cecc1372acc 37 #include "Masters/OneWireMaster.h"
j3 3:644fc630f958 38
IanBenzMaxim 73:2cecc1372acc 39 namespace mbed { class Serial; }
j3 3:644fc630f958 40
IanBenzMaxim 73:2cecc1372acc 41 namespace OneWire
j3 3:644fc630f958 42 {
IanBenzMaxim 73:2cecc1372acc 43 namespace Masters
j3 63:422be898443a 44 {
IanBenzMaxim 73:2cecc1372acc 45 class DS2480B : public OneWireMaster
IanBenzMaxim 73:2cecc1372acc 46 {
IanBenzMaxim 73:2cecc1372acc 47 public:
IanBenzMaxim 73:2cecc1372acc 48 enum DS2480B_BPS
IanBenzMaxim 73:2cecc1372acc 49 {
IanBenzMaxim 73:2cecc1372acc 50 BPS_9600 = 0,
IanBenzMaxim 73:2cecc1372acc 51 BPS_19200 = 2,
IanBenzMaxim 73:2cecc1372acc 52 BPS_57600 = 4,
IanBenzMaxim 73:2cecc1372acc 53 BPS_115200 = 6
IanBenzMaxim 73:2cecc1372acc 54 };
IanBenzMaxim 74:23be10c32fa3 55
IanBenzMaxim 73:2cecc1372acc 56 /**********************************************************//**
IanBenzMaxim 73:2cecc1372acc 57 * @brief DS2480B constructor
IanBenzMaxim 74:23be10c32fa3 58 *
IanBenzMaxim 73:2cecc1372acc 59 * @details allows user to use existing Serial object
IanBenzMaxim 73:2cecc1372acc 60 *
IanBenzMaxim 73:2cecc1372acc 61 * On Entry:
IanBenzMaxim 73:2cecc1372acc 62 * @param[in] p_serial - pointer to existing serial object
IanBenzMaxim 73:2cecc1372acc 63 *
IanBenzMaxim 73:2cecc1372acc 64 * On Exit:
IanBenzMaxim 74:23be10c32fa3 65 * @return
IanBenzMaxim 73:2cecc1372acc 66 **************************************************************/
IanBenzMaxim 73:2cecc1372acc 67 DS2480B(mbed::Serial &p_serial);
IanBenzMaxim 74:23be10c32fa3 68
IanBenzMaxim 74:23be10c32fa3 69
IanBenzMaxim 73:2cecc1372acc 70 /**********************************************************//**
IanBenzMaxim 73:2cecc1372acc 71 * @brief DS2480B constructor
IanBenzMaxim 74:23be10c32fa3 72 *
IanBenzMaxim 74:23be10c32fa3 73 * @details Object instantiates a new serial object with no
IanBenzMaxim 73:2cecc1372acc 74 * public access
IanBenzMaxim 73:2cecc1372acc 75 *
IanBenzMaxim 73:2cecc1372acc 76 * On Entry:
IanBenzMaxim 73:2cecc1372acc 77 * @param[in] tx - tx pin of uart to be used
IanBenzMaxim 73:2cecc1372acc 78 * @param[in] rx - rx pin of uart to be used
IanBenzMaxim 73:2cecc1372acc 79 * @param[in] baud - baudrate for uart
IanBenzMaxim 73:2cecc1372acc 80 *
IanBenzMaxim 73:2cecc1372acc 81 * On Exit:
IanBenzMaxim 74:23be10c32fa3 82 * @return
IanBenzMaxim 73:2cecc1372acc 83 **************************************************************/
IanBenzMaxim 73:2cecc1372acc 84 DS2480B(PinName tx, PinName rx);
IanBenzMaxim 74:23be10c32fa3 85
IanBenzMaxim 74:23be10c32fa3 86
IanBenzMaxim 73:2cecc1372acc 87 /**********************************************************//**
IanBenzMaxim 74:23be10c32fa3 88 * @brief DS2480B destructor
IanBenzMaxim 74:23be10c32fa3 89 *
IanBenzMaxim 74:23be10c32fa3 90 * @details deletes serial object if owner
IanBenzMaxim 73:2cecc1372acc 91 *
IanBenzMaxim 73:2cecc1372acc 92 * On Entry:
IanBenzMaxim 73:2cecc1372acc 93 *
IanBenzMaxim 73:2cecc1372acc 94 * On Exit:
IanBenzMaxim 74:23be10c32fa3 95 * @return
IanBenzMaxim 73:2cecc1372acc 96 **************************************************************/
IanBenzMaxim 73:2cecc1372acc 97 virtual ~DS2480B();
IanBenzMaxim 74:23be10c32fa3 98
IanBenzMaxim 74:23be10c32fa3 99
IanBenzMaxim 73:2cecc1372acc 100 OneWireMaster::CmdResult DS2480B_ChangeBaud(DS2480B_BPS newbaud);
j3 17:b646b1e3970b 101
IanBenzMaxim 74:23be10c32fa3 102 virtual OneWireMaster::CmdResult OWInitMaster(void);
IanBenzMaxim 74:23be10c32fa3 103 virtual OneWireMaster::CmdResult OWReset(void);
IanBenzMaxim 74:23be10c32fa3 104 virtual OneWireMaster::CmdResult OWTouchBitSetLevel(uint8_t & sendrecvbit, OWLevel after_level);
IanBenzMaxim 73:2cecc1372acc 105 virtual OneWireMaster::CmdResult OWWriteByteSetLevel(uint8_t sendbyte, OWLevel after_level);
IanBenzMaxim 73:2cecc1372acc 106 virtual OneWireMaster::CmdResult OWReadByteSetLevel(uint8_t & recvbyte, OWLevel after_level);
IanBenzMaxim 73:2cecc1372acc 107 virtual OneWireMaster::CmdResult OWSetSpeed(OWSpeed new_speed);
IanBenzMaxim 74:23be10c32fa3 108 virtual OneWireMaster::CmdResult OWSetLevel(OWLevel new_level);
j3 3:644fc630f958 109
IanBenzMaxim 73:2cecc1372acc 110 private:
IanBenzMaxim 73:2cecc1372acc 111 void rx_callback(void);
IanBenzMaxim 74:23be10c32fa3 112
IanBenzMaxim 73:2cecc1372acc 113 OneWireMaster::CmdResult DS2480B_Detect(void);
IanBenzMaxim 73:2cecc1372acc 114 OneWireMaster::CmdResult WriteCOM(uint32_t outlen, uint8_t *outbuf);
IanBenzMaxim 73:2cecc1372acc 115 OneWireMaster::CmdResult ReadCOM(uint32_t inlen, uint8_t *inbuf);
IanBenzMaxim 73:2cecc1372acc 116 void BreakCOM(void);
IanBenzMaxim 73:2cecc1372acc 117 void FlushCOM(void);
IanBenzMaxim 73:2cecc1372acc 118 void SetBaudCOM(uint8_t new_baud);
IanBenzMaxim 73:2cecc1372acc 119 int32_t bitacc(uint32_t op, uint32_t state, uint32_t loc, uint8_t *buf);
IanBenzMaxim 74:23be10c32fa3 120
IanBenzMaxim 73:2cecc1372acc 121 mbed::Serial *_p_serial;
IanBenzMaxim 73:2cecc1372acc 122 bool _serial_owner;
IanBenzMaxim 74:23be10c32fa3 123
IanBenzMaxim 73:2cecc1372acc 124 // DS2480B state
IanBenzMaxim 73:2cecc1372acc 125 OWLevel _ULevel; // 1-Wire level
IanBenzMaxim 73:2cecc1372acc 126 DS2480B_BPS _UBaud; // baud rate
IanBenzMaxim 73:2cecc1372acc 127 uint8_t _UMode; // command or data mode state
IanBenzMaxim 73:2cecc1372acc 128 uint8_t _USpeed; // 1-Wire communication speed
IanBenzMaxim 74:23be10c32fa3 129
IanBenzMaxim 73:2cecc1372acc 130 static const size_t MAX_RX_BUFFER_LEN = 256;
IanBenzMaxim 73:2cecc1372acc 131 volatile struct ds2480b_circular_buff_s
IanBenzMaxim 73:2cecc1372acc 132 {
IanBenzMaxim 73:2cecc1372acc 133 uint8_t w_idx;
IanBenzMaxim 73:2cecc1372acc 134 uint8_t r_idx;
IanBenzMaxim 73:2cecc1372acc 135 uint8_t rx_bytes_available;
IanBenzMaxim 73:2cecc1372acc 136 bool wrap_error;
IanBenzMaxim 73:2cecc1372acc 137 uint8_t buff[MAX_RX_BUFFER_LEN];
IanBenzMaxim 73:2cecc1372acc 138 }rx_buffer;
IanBenzMaxim 73:2cecc1372acc 139 };
IanBenzMaxim 73:2cecc1372acc 140 }
IanBenzMaxim 73:2cecc1372acc 141 }
j3 3:644fc630f958 142
IanBenzMaxim 74:23be10c32fa3 143 #endif
j3 3:644fc630f958 144