标题: Interfacing the DS2760 1-Wire [打印本页] 作者: liyf 时间: 2011-4-29 22:15 标题: Interfacing the DS2760 1-Wire Abstract: This application note provides the reader with information concerning how to interface the Maxim DS2760 Battery Monitor and Protector IC to a microcontroller. The DS5000 microcontroller module is used for example purposes. Both hardware and software concerns are addressed, including block diagrams and sample C code to enable communication between the DS2760 and the microcontroller over the Maxim 1-Wire? communication protocol. Software routines for all common 1-Wire commands are provided and therefore can be used on any Maxim device that communicates using the 1-Wire protocol. Also, routines for common battery monitor functions are also provided which can be used with any of the other Maxim battery monitors such as the DS2761.
IntroductionInterfacing a 1-Wire device to a microcontroller can be a very simple procedure. This application note will introduce source code in C to provide the user with a simple 1-Wire solution for embedded controller applications.
In the following example, we will demonstrate a method for connecting a 1-Wire interface from a microcontroller to the DS2760K evaluation board to read the voltage, current, accumulated current and temperature registers. The DS2760K hardware is used to simplify the communication because it is a complete circuit to easily verify the source code.
Hardware configurationA DS5000 (8051-compatible) microcontroller running at 11.059MHz was used in this example. The host microcontroller uses a single wire, which is pulled up to VCC through a 4.7k resistor to connect to the DQ input/output pin of the DS2760. Other microcontrollers could very easily be substituted, once timing considerations have been taken into consideration. A delay line might be needed for some of the faster microprocessors.
Interface timingEach communication sequence with the DS2760 must begin with a 1-Wire Reset. A reset pulse is defined as the bus master pulling the 1-Wire bus (or DQ line) low from the inactive high state for between 480μs to 960μs and then releasing it. If a 1-Wire device is on the bus, it will respond by pulling the DQ line low to indicate its presence on the 1-Wire bus. The 1-Wire Reset Timing is shown in Figure 1.
A write time slot is initiated when the bus master pulls DQ low. All write and read time slots must be 60μs to 120μs in duration with a 1μs minimum recovery time between cycles. During the write "0" time slot, the bus master will pull the line low for the duration of the time slot. However, during the write "1" time slot, the bus master will pull the line low for a maximum of 15μs and then release if for the duration of the time slot.
A read time slot is initiated when the bus master pulls the 1-Wire bus line low. The line must be kept low for 1μs and then released so that the DS2760 can take control of the line and present valid data. If a '0' is to be placed on the bus, the DS2760 will hold the DQ line low when the master releases the line. If the DS2760 is to place a "1", the DQ will be allowed to go high when the bus master releases the bus. The master will then sample the DQ line to determine if a "0" or a "1" is read from the device. The 1-Wire write and read time slots are shown in Figure 2.
Figure 1. 1-Wire Reset and Presence Pulse.
Figure 2. 1-Wire Write and Read Time Slot.
Software controlIn order to accurately control the timing requirements the 1-Wire interface, certain key functions must first be established. The first function created must be the "delay" function which is integral to all read and write control. This function will be entirely dependent the speed of the microcontroller. For this example, a DS5000 (8051-compatible) microcontroller running at 11.059MHz was used. The example below illustrates the C prototype function for creating the timing delay. Calling this routine takes 24μs and then each count takes another 16μs.
// DELAY - with an 11.059MHz crystal.
// Calling the routine takes about 24μs, and then each count takes another 16μs.
void delay(int μseconds)
{
int s;
for (s=0; sThe reset time slot is 480μs and is described in C below. The DQ line is pulled low and held low for a delay of "29" which is actually a 488μs delay. The DQ line is then released to a high state. After a delay of "3", which is 72μs, the master samples the DQ line to see if a device has responded by pulling the DQ line low to indicate the device "presence."
// OW_RESET - performs a reset on the one-wire bus and returns the presence detect.
// Reset is 480μs, so delay value is (480-24)/16 = 28.5 - we use 29.
// Presence checked another 70μs later, so delay is (70-24)/16 = 2.875 - we use 3.
//
unsigned char ow_reset(void)
{
unsigned char presence;
DQ = 0; //pull DQ line low
delay(29); // leave it low for 480μs
DQ = 1; // allow line to return high
delay(3); // wait for presence
presence = DQ; // get presence signal
delay(25); // wait for end of timeslot
return(presence); // presence signal returned
} // 0=presence, 1 = no part
Each bit that is read follows a similar sequence as the 1-Wire Reset, but without the delays. The DQ line is pulled low and then released and then the master samples the DQ line and then returns the value.
//////////////////////////////////////////////////////////////////////////////
// READ_BIT - reads a bit from the one-wire bus. The delay
// required for a read is 15μs, so the DELAY routine won't work.
// We put our own delay function in this routine in the form of a
// for() loop.
//
unsigned char read_bit(void)
{
unsigned char i;
DQ = 0; // pull DQ low to start timeslot
DQ = 1; // then return high
for (i=0; iWhen a bit is written, the master pulls the line low for 1μs for a write "1" or 104μs, in this case, for a write "0".
//////////////////////////////////////////////////////////////////////////////
// WRITE_BIT - writes a bit to the one-wire bus, passed in bitval.
void write_bit(char bitval)
{
DQ = 0; // pull DQ low to start timeslot
if(bitval==1) DQ =1; // return DQ high if write 1
delay(5); // hold value for remainder of timeslot
DQ = 1;
}// Delay provides 16μs per loop, plus 24μs. Therefore delay(5) = 104μs
Reading and writing a byte is simply reading or writing 8 bits one after another starting with the least significant bit.
//////////////////////////////////////////////////////////////////////////////
// READ_BYTE - reads a byte from the one-wire bus.
//
unsigned char read_byte(void)
{
unsigned char i;
unsigned char value = 0;
for (i=0;i//////////////////////////////////////////////////////////////////////////////
// WRITE_BYTE - writes a byte to the one-wire bus.
//
void write_byte(char val)
{
unsigned char i;
unsigned char temp;
for (i=0; i>i; // shifts val right 'i' spaces
temp &= 0x01; // copy that bit to temp
write_bit(temp); // write bit in temp into
}
delay(5);
}
Reading the net AddressEvery DS2760 has a unique 64 bit Net Address. The Read Net Address command is used to find the 64- bit Net Address when only a single device is on the 1-Wire bus. Multiple devices require the use of the Search Net Address functions not shown here. The DS2760 can be configured to use the Read Net Address of 0x33h or 0x39h.
unsigned char Read_NetAddress(void)
{
int n;
char dat[9];
if(ow_reset()==0) //If a presence is detected, continue to read
{
write_byte(0x33); //Read Net Address Command (0x33h)
for (n=0;n
Reading Real Time DataIf there is a single device on the 1 Wire bus, then the real time readings of voltage, current, accumulated current and temperature can be used directly as shown below. If more than 1 device is present, a Match Net Address routine must be used. All of these functions could be combined into a single routine by simply starting with the Voltage Register Address and then continuing to issue the read_byte() command until all desired bytes are read.
unsigned char Read_ Voltage (void)
{
int lsb, msb, temp;
float Voltage; //This value may be declared globally
if(ow_reset()==0) //If a presence is detected, continue to read
{
write_byte(0xCC); // Skip Net Address Command
write_byte(0x69); // Read Registers Command
write_byte(0x0C); // Voltage Register Address
msb = read_byte(); // Read msb
lsb = read_byte() & 0xE0; // Read lsb and mask off lower 5 bits
if((msb & 0x80) == 0x80) //if sign bit is set
temp = (msb>5) * 0.00488; //Voltage in Volts
printf("\nVoltage = &d", Voltage);
return(0); //Return 0 if no error
}
return(1); //Return 1 if no presence detected
}
unsigned char Read_NetAddress(void)
{
int n;
char dat[9];
if(ow_reset()==0) //If a presence is detected, continue to read
{
write_byte(0x33); //Read Net Address Command (0x33h)
for (n=0;nunsigned char Read_Current (void)
{
int lsb, msb, temp;
float Current; //This value may be declared globally
if(ow_reset()==0) //If a presence is detected, continue to read
{
write_byte(0xCC); // Skip Net Address Command
write_byte(0x69); // Read Registers Command
write_byte(0x0E); //Current Register Address
msb = read_byte(); // Read msb
lsb = read_byte() & 0xF8; // Read lsb and mask off lower 3 bits
if((msb & 0x80) == 0x80) //if sign bit is set
temp = (msb>3) * 0.000015625 / .025; //Current in mAmps
//assuming a 25mOhm Sense Resistor
printf("\nCurrent = &d", Current);
return(0); //Return 0 if no error
}
return(1); //Return 1 if no presence detected
}
unsigned char Read_ACR(void)
{
int lsb, msb, temp;
float ACR; //This value may be declared globally
if(ow_reset()==0) //If a presence is detected, continue to read
{
write_byte(0xCC); // Skip Net Address Command
write_byte(0x69); // Read Registers Command
write_byte(0x10); //ACR Register Address
msb = read_byte(); // Read msb
lsb = read_byte(); // Read lsb
if((msb & 0x80) == 0x80) //if sign bit is set
temp = (msbunsigned char Read_Temperature(void)
{
int lsb, msb,temp;
float temp_f,temp_c; //These values may be declared globally
if(ow_reset()==0) //If a presence is detected, continue to read
{
write_byte(0xCC); // Skip Net Address Command
write_byte(0x69); // Read Registers Command
write_byte(0x18); //Temperature Register Address
msb = read_byte(); // Read msb
lsb = (read_byte() & 0xE0); // Read lsb, mask off lower 5 bits
if((msb & 0x80) == 0x80) //if sign bit is set
temp = (msb>5) * 0.125; //temperature in Degrees C
temp_f = ((temp_c)* 9)/5 + 32; //temperature in Degrees F
printf("\nTemp C = &d", temp_c);
printf("\nTemp F = &d", temp_f);
return(0); //Return 0 if no error
}
return(1); //Return 1 if no presence detected
}
unsigned char Read_UserMemory(void)
{
int j;
int Memory[32]; //This value may be declared globally
if(ow_reset()==0) //If a presence is detected, continue to read
{
write_byte(0xCC); // Skip Net Address Command
write_byte(0x69); // Read Registers Command
write_byte(0x20); // Block 0 Address
for (j=0;j
Reading User MemoryThe DS2760 contains 32 bytes of user EEPROM that can be read using the following code.
unsigned char Read_UserMemory(void)
{
int j;
int Memory[32]; //This value may be declared globally
if(ow_reset()==0) //If a presence is detected, continue to read
{
write_byte(0xCC); // Skip Net Address Command
write_byte(0x69); // Read Registers Command
write_byte(0x20); // Block 0 Address
for (j=0;j
Appendix A
DS5000 (8051 SOURCE CODE)// ds2760k.c -- Functions for the Dallas Semiconductor DS2760K
// Li-Ion Battery Monitor 1-Wire Kit Module
// Designed for 8051 microcontrollers
// This code was developed using the DS5000/DS2250-64-16
// and the Keil version 6.1 DS5000T source code Compiler
//----------------------------------------------------------------------
//#pragma CODE SMALL OPTIMIZE(3)
// command line directives
#include // absolute addressing modes
#include // character types
#include // standard math
#include // standard I/O
#include // string functions
#include "ds50001w.h" // DS5000 series 8052 registers
// Configuration parameters
#define XtalFreq (11059490) // main crystal frequency
#define CntrFreq (XtalFreq/12) // main counter frequency
#define BaudRate (9600) // baud rate
#define CntrTime (8) // number of cycles for counter
#define Ft (32768.0) // target crystal frequency
//////////////////////////////////////////////////////////////////////////////
// DELAY - with an 11.059MHz crystal.
// Calling the routine takes about 24μs, and then
// each count takes another 16μs.
//
void delay(int μseconds)
{
int s;
for (s=0; s//////////////////////////////////////////////////////////////////////////////
// READ_BIT - reads a bit from the one-wire bus. The delay
// required for a read is 15μs, so the DELAY routine won't work.
// We put our own delay function in this routine in the form of a
// for() loop.
unsigned char read_bit(void)
{
unsigned char i;
DQ = 0; // pull DQ low to start timeslot
DQ = 1; // then return high
for (i=0; i>i; // shifts val right 'i' spaces
temp &= 0x01; // copy that bit to temp
write_bit(temp); // write bit in temp into
}
delay(5);
}
//////////////////////////PROTOTYPE FUNCTIONS////////////////////////////
unsigned char Read_NetAddress(void);
unsigned char Read_Temperature(void);
unsigned char Read_Current(void);
unsigned char Read_Voltage(void);
unsigned char Read_ACR(void);
unsigned char Read_UserMemory(void);
/////////////////////////BEGIN MAIN PROGRAM//////////////////////////////
main()
{
unsigned char Select_Type; // Function variable
// Inhibit the watchdog timer and set up memory
TA = 0xAA; // timed access
TA = 0x55;
PCON = 0x00; // inhibit watchdog timer
// Set up the serial port
SCON = 0x50; // SCON: mode 1, 8-bit UART, enable rcvr
TMOD = 0x21; // TMOD: timer 1, mode 2, 8-bit reload
// TMOD: timer 0, mode 1, 16-bit
PCON |= 0x80; // SMOD = 1 Double Baud Rate for TH1 load
TH0=TL0 = 0;
TH1=TL0 = (unsigned int)(256 - ( (XtalFreq / BaudRate) / 192));
TR0 = 1; // TR0: timer 0 run
TR1 = 1; // TR1: timer 1 run
TI = 1; // TI: set TI to send first char of UART
//----------------------------------------------------------------------
// Display DS2760 1-Wire Device banner
//----------------------------------------------------------------------
printf ("\n");
printf (" Dallas Semiconductor – Battery Management\n");
printf (" Source for DS2760K Li-Ion Battery Monitor \n");
printf (" Updated Code September 3, 2002 \n");
printf (" [C Program for DS500x/DS2250 or 8051 Compatible Microcontroller]");
printf("\n\n");
printf("\n********************************************************************\n");
printf (" Select Menu Option\n");
printf (" 1. One-Wire Reset\n");
printf (" 2. Read Net Address of Single Device\n");
printf (" 3. Read Temperature\n");
printf (" 4. Read Current\n");
printf (" 5. Read Current Accumulator (ACR)\n");
printf (" 7. Read Voltage\n");
printf (" 7. Read User Memory\n");
printf ("\n\n");
printf (" Note: This program represents an example only.\n");
printf (" No warranties or technical support is provided with this program.\n");
do {
// Enable CE2
EA = 0; // Inhibit interrupts
TA = 0xAA; // timed access
TA = 0x55;
MCON = MCON |= 0x04; // Enable topside CE 0xCC
// Disable CE2
TA = 0xAA; // timed access
TA = 0x55;
MCON = 0xC8; // Disable topside CE
EA = 1; // Enable interrupts
Select_Type = getchar(); // get variable to start
switch(Select_Type)
{
case '1': printf ("\n 1. Sent 1-Wire Reset\n");
if(ow_reset()==0);
printf ("\n Presence Detected");
else
printf ("\n No Presence Detected");
break;
case '2': printf (" 2. Read Net Address of Single Device\n");
if (Read_NetAddress()0);
printf ("\n Error Reading DS2760");
break;
case '3': printf ("\n 5. Read Temperature\n");
if (Read_Temperature()0);
printf ("\n Error Reading DS2760");
break;
case '4': printf ("\n 6. Read Current\n");
if (Read_Current ()0);
printf ("\n Error Reading DS2760");Read_Current();
break;
case '5': printf ("\n 7. Read Current Accumulator (ACR)\n");
if (Read_ACR ()0);
printf ("\n Error Reading DS2760");Read_Current();
break;
case '6': printf ("\n 8. Read Voltage\n");
if (Read_Voltage ()0);
printf ("\n Error Reading DS2760");Read_Current();
break;
case '7': printf ("\n 8. Read User Memory\n");
if (Read_UserMemory ()0);
printf ("\n Error Reading DS2760");Read_Current();
break;
default: printf ("\n Typ Select Another Menu Option\n");
break;
}; // end switch
} while (1); // Loop forever
}