摘要：本應(yīng)用筆記提供了一些利用Maxim API控制DS1WM 1-Wire總線主機的C語言例程。本文討論的內(nèi)容基于DS1WM已經(jīng)設(shè)計到FPGA或ASIC內(nèi)，主控CPU通過API調(diào)用控制DS1WM。DS1WM通過兩個文件(DS1WM.c和DS1WM.h)進行通信，這兩個文件構(gòu)成了API。本文討論的例程包括：初始化、1-Wire復(fù)位、ROM搜索算法，說明了1-Wire常見功能的使用。假設(shè)讀者已經(jīng)了解1-Wire器件、DS1WM 1-Wire主機以及1-Wire總線協(xié)議。

引言

DS1WM1-Wire總線主機內(nèi)部生成1-Wire時序和控制信號，無需CPU產(chǎn)生逐位控制時序。該控制功能使系統(tǒng)程序設(shè)計人員能夠使用API函數(shù)進行程序開發(fā)。DS1WM API采用ANSI C語言編寫，可以為多種支持ANSI C的微處理器平臺所用。以下例程介紹了如何在網(wǎng)絡(luò)中識別、選擇1-Wire從設(shè)備，并與其進行通信。


圖1. 1-Wire網(wǎng)絡(luò)總線示例電路

圖1所示的電路配置適用于以下所有示例程序。主機CPU利用DS1WM與帶有鏈路模式和GPIO的1-Wire數(shù)字溫度傳感器DS28EA00以及1-Wire 1Kb EEPROM DS2431進行通信。示例程序重點演示API，而非從設(shè)備功能。16MHz的系統(tǒng)時鐘通過CLK引腳提供1-Wire主機時序。1-Wire主機的端口引腳需要映射到應(yīng)用微處理器的引腳。API文件DS1WM.h中包含了引腳映射功能。API頭文件中的MaxNumberDevices宏必須更改為實際可能的最大器件數(shù)。DS1WM.c API文件中的ReadByteFromRegister和WriteByte2Register函數(shù)也需要進行修改，以便正確觸發(fā)微處理器端口。VPUP電壓典型值為5.0V，RPUP不大于2.2kΩ。

概述

通過Maxim支持中心，可以申請免費的DS1WM和API。下面討論了初始化和1-Wire復(fù)位控制的DS1WM代碼。此外還提供了一個示例，用于演示如何使用DS1WM ROM搜索引擎確定每個器件的唯一注冊碼(ROM ID)。使用存儲的注冊碼以及家族碼，可以識別每個1-Wire從設(shè)備，并通過匹配ROM命令進行訪問。家族碼列表，請參見應(yīng)用筆記155：“1-Wire?軟件資源指南”。DS28EA00示例演示了如何進行溫度轉(zhuǎn)換。第二個示例給出了高速讀寫DS2431暫存器的兩種方法。

總線主機基本操作

微處理器通過觸發(fā)復(fù)位引腳初始化DS1WM，API接口執(zhí)行所有1-Wire通信。示例程序通過調(diào)用DS1WM API函數(shù)進行工作。由于響應(yīng)中斷時會改變微處理器代碼，因此后續(xù)示例中采用輪詢方式替代中斷方式通信。

后續(xù)的示例程序中用到了表1所示的1-Wire操作。

表1. 1-Wire操作

Operation*	Description
OWReset	Sends the 1-Wire reset stimulus and checks for the pulses of 1-Wire slave devices that are present on the bus.
OWWriteByte/OWReadByte	Sends or receives a single byte of data from the 1-Wire bus.
OWWriteBytes/OWReadBytes	Sends or receives multiple bytes of data from the 1-Wire bus.
OWSearch	Performs the 1-Wire Search Algorithm (see application note 187, "1-Wire Search Algorithm").
OverdriveEnable	Sets the 1-Wire communication speed for the DS1WM to overdrive. Note that this only changes the communication speed of the DS1WM; the 1-Wire slave device must be instructed to make the switch when going from normal to overdrive. The 1-Wire slave will always revert to standard speed when it encounters a standard-speed 1-Wire reset.
OverdriveDisable	Sets the 1-Wire communication speed for the DS1WM to standard. Note that this only changes the communication speed of the DS1WM; a standard-speed 1-Wire reset is required for slave devices to exit overdrive.
MatchROM	Selects device by issuing the Match ROM command followed by the 64-bit ROM ID selected.
SetClockFrequency	Sets the clock frequency for the DS1WM.
InterruptEnableRegisterWrite	Writes a single byte of data to the DS1WM Interrupt Enable register.
InterruptRegisterRead	Reads a single byte of data from the DS1WM Interrupt register.
ReceiveBufferRead	Reads a single byte of data from the DS1WM Receive Buffer register.

*該表涵蓋了示例中用到的子程序，詳細說明請參見DS1WM.c文件。

初始化

通過初始化DS1WM，啟動主機，提供正確的1-Wire總線時序。主機將數(shù)值16 (代表頻率值)傳遞至SetClockFrequency函數(shù)，將0x90h寫入時鐘分頻寄存器(請參見DS1WM數(shù)據(jù)資料)。中斷使能寄存器設(shè)置為0x00h，防止INTR引腳產(chǎn)生中斷。上電時，接收緩存可能包含無效值，因此在發(fā)送1-Wire命令之前，最好對接收緩存進行清理。啟動時對中斷寄存器和接收緩存器的讀操作將清除其中的各個位。

//----------------------------------------------------------------------------------------------------
//Start of initialization example

SetClockFrequency(16);                  //Set clock frequency to 16MHz (power-on default)
InterruptEnableRegisterWrite(0x00);     //Clear interrupts

//Flush receive buffer
InterruptRegisterData = InterruptRegisterRead();
ReceiveBufferRead();

//End of initialization example
//----------------------------------------------------------------------------------------------------

1-Wire復(fù)位(OWReset API函數(shù))

初始化完成后，主機必須確定1-Wire總線上是否接有設(shè)備。主機調(diào)用OWReset函數(shù)，以實現(xiàn)該目的。如果檢測到器件存在脈沖，該函數(shù)返回1；如果沒有檢測到器件或發(fā)送錯誤，則函數(shù)返回0。如果返回值為0，需要檢查ErrorStatus變量，以確定故障狀態(tài)。1-Wire復(fù)位的優(yōu)先級高于所有1-Wire命令(例如，Match ROM、Skip ROM、Read ROM)，但調(diào)用OWSearch函數(shù)時除外，該函數(shù)自身帶有復(fù)位。軟件設(shè)計人員應(yīng)當(dāng)在程序中加入適當(dāng)?shù)墓收咸幚泶a，在發(fā)生故障時能夠觸發(fā)執(zhí)行這些代碼。ErrorStatus值意味著發(fā)生了如下錯誤中的一種：沒有進行在線檢測；沒有檢測到器件；存在1-Wire短路；1-Wire總線始終處于低電平狀態(tài)。

        Result = OWReset();
        if(!Result){
                switch(ErrorStatus){
                        case -1:        //DS1WM did not recognize 1-Wire reset (PD=0)
                                //To d add your error code here
                                break;
                        case -2:        //No device found (PDR=1)
                                //To d add your error code here
                                break;
                        case -7:        //1-Wire IO is shorted (OW_SHORT=1)
                                //To d add your error code here
                                break;
                        case -8:        //1-Wire IO is shorted (OW_LOW=1)
                                //To d add your error code here
                                break;
                }
        }
        

利用ROM搜索引擎確定ROM ID

總線上的每個1-Wire設(shè)備都必須進行識別。存儲在每個1-Wire器件中的唯一64位ROM ID用于選擇各個器件，并根據(jù)家族碼識別器件類型。為降低例程的復(fù)雜度，采用8位家族碼識別DS28EA00和DS2431。

注意：如果1-Wire總線上連接了不止一種器件類型(例如，具有相同的家族碼)，則后續(xù)的方法無法對器件進行識別。不對總線上的多個1-Wire器件進行識別，則無法對特定的1-Wire器件發(fā)送功能命令。如果使用了兩個或更多的類似器件，則必須通過查找表才能正確訪問特定器件。

調(diào)用OWSearch函數(shù)可以識別總線上所有的1-Wire器件，該函數(shù)將8字節(jié)ROM ID排成一列。這期間無需調(diào)用OWReset函數(shù)，因為該函數(shù)已經(jīng)包含在OWSearch函數(shù)中。OWSearch函數(shù)例外的包含了OWReset函數(shù)，是因為其搜索算法具有迭代過程。OWSearch函數(shù)的返回值為搜索到的1-Wire器件個數(shù)，并將每個64位ROM ID寫入一個名為ROMCodes的二維數(shù)組。

下列例程僅演示了調(diào)用一次OWSearch的情況，因此后續(xù)連接至該1-Wire總線的器件將無法通過該代碼進行識別。OWSearch函數(shù)成功執(zhí)行后將返回搜索到的器件個數(shù)。如果搜索失敗，ErrorStatus變量將返回錯誤值，其中包括產(chǎn)生OWReset的故障條件。搜索成功后，對ROMCodes數(shù)組進行了遍歷，并保存每個器件的數(shù)組索引。這種器件索引方式是通過比較搜索到的每個器件的家族碼實現(xiàn)的。隨后調(diào)用數(shù)組索引，可以實現(xiàn)與搜索到的特定1-Wire器件進行通信。這相當(dāng)于創(chuàng)建了一個簡單的鏈表(注：可以通過指針進行操作)。

//----------------------------------------------------------------------------------------------------
//Start of DS1WM search ROM accelerator example

//Devices on the 1-Wire IO are:
//DS28EA00      Family Code = 42h (6900000004E8C842)
//DS2431        Famliy Code = 2Dh (5A0000000FDE052D)

//Find all devices on 1-Wire line and populate ROMCodes array
Result = OWSearch(ROMCodes);    //Returns number of devices found if successful

//Set number of 1-Wire devices found
if(Result)
        NumberOfDevices = Result;

if(!Result){
        switch(ErrorStatus){
                case -1:        //DS1WM did not recognize 1-Wire Reset (PD=0)
                        //To d add your error code here
                        break;
                case -2:        //No device found (PDR=1)
                        //To d add your error code here
                        break;
                case -7:        //1-Wire IO is shorted (OW_SHORT=1)
                        //To d add your error code here
                        break;
                case -8:        //1-Wire IO is shorted (OW_LOW=1)
                        //To d add your error code here
                        break;
                case -9:        //Invalid CRC for device
                        //To d add your error code here
                        break;
                case -10:       //ROMCodes array too small (Edit MaxNumberDevices in DS1WM.h)
                        //To d add your error code here
                        break;
        }
}

//Note: This function is intended to be used when there is only one device with the same
//Family Code present on the line
for(i=0;i

	利用DS1WM API函數(shù)控制DS28EA00
該示例利用之前搜索到的ROM ID與DS28EA00進行通信。OWReset之后發(fā)送Match ROM命令。ROM碼數(shù)組連同被訪問的器件索引一起，傳遞到Match ROM函數(shù)。1-Wire總線上的器件會在Match ROM命令0x55h之后收到一個64位ROM碼，可以使總線主機在多點總線上尋址到特定的DS28EA00。只有與64位ROM序列完全匹配的DS28EA00才能響應(yīng)接下來的命令，其它的從器件將等待下一個復(fù)位脈沖。



OWWriteByte和OWReadByte API函數(shù)用來產(chǎn)生存儲器命令(例如，Write/Copy/Read Scratchpad命令)。DS1WM通過發(fā)送Write Scratchpad命令(0x4Eh)以及隨后的高溫、低溫和配置寄存器設(shè)置值，來設(shè)定溫度報警以及分辨率。上述操作完成后，發(fā)送OWReset以及Match ROM命令、ROM ID和Copy Scratchpad命令(0x48h) (將暫存器的內(nèi)容復(fù)制到寄存器存儲器)，完成溫度分辨率設(shè)置。必須為CPU主機增加10ms的延時，以完成復(fù)制操作?？紤]到微處理器延時子程序的差異，API僅提供了注釋偽碼。



復(fù)制操作完成后，再次執(zhí)行OWReset，然后發(fā)送Match ROM、ROM ID和轉(zhuǎn)換溫度命令(0x44h)。需要增加100ms的延時，以完成溫度轉(zhuǎn)換。最后，發(fā)送OWReset和Match ROM、ROM ID和Read Scratchpad命令(0xBEh)，讀取兩字節(jié)溫度數(shù)據(jù)。需要注意的是，選擇DS28EA00時，必須始終遵循OWReset之后發(fā)送Match ROM命令和ROM ID的命令格式。當(dāng)總線上僅有一個器件時，才能夠使用Skip ROM命令(即無需Search ROM)。



//----------------------------------------------------------------------------------------------------
//Start of DS28EA00 example

Result = OWReset();
        if(!Result){
                switch(ErrorStatus){
                        case -1:        //DS1WM did not recognize 1-Wire reset(PD=0)
                                //To d add your error code here
                                break;
                        case -2:        //No device found(PDR=1)
                                //To d add your error code here
                                break;
                        case -7:        //1-Wire IO is shorted(OW_SHORT=1)
                                //To d add your error code here
                                break;
                        case -8:        //1-Wire IO is shorted(OW_LOW=1)
                                //To d add your error code here
                                break;
                }
        }

        //Set temperature resolution
        Result = MatchROM(ROMCodes,DS28EA00);           //Select device
        Result = OWWriteByte(0x4E);                     //Issue Write Scratchpad command
        Result = OWWriteByte(0x00);                     //TH register data
        Result = OWWriteByte(0x00);                     //TL degister data
        Result = OWWriteByte(0x1F);                     //Config. reg. data (set 9-bit temp. resolution)

        OWReset();                                      //Error code removed for conciseness
        MatchROM(ROMCodes,DS28EA00);                    //Select device
        OWWriteByte(0x48);                              //Issue Copy Scratchpad command

        //To d add microprocessor-specific code delay to allow copy to complete
        //Delay(10MS);
//Psuedo code

        OWReset();                                      //1-Wire reset
        MatchROM(ROMCodes,DS28EA00);                    //Select device
        OWWriteByte(0x44);                              //Issue Convert Temperature command

        //To d add microprocessor-specific code delay to allow temperature conversion to complete
        //Delay(100MS);
//Psuedo code

        //Read temperature results from scratchpad
        OWReset();                                      //1-Wire reset
        MatchROM(ROMCodes,DS28EA00);                    //Select device
        OWWriteByte(0xBE);                              //Issue Read Scratchpad command
        TempLSB = OWReadByte();                 	 //Read byte
        TempMSB = OWReadByte();                 	 //Read byte
//End of DS28EA00 example
//----------------------------------------------------------------------------------------------------


	利用DS1WM API函數(shù)控制高速模式下的DS2431
該示例利用之前搜索到的ROM ID與DS2431進行通信。OWReset之后發(fā)送Overdrive Skip ROM命令(0x3Ch)，將所有支持高速模式的1-Wire器件置于高速模式。調(diào)用OverdriveEnable函數(shù)激活DS1WM高速時序。此時所有1-Wire器件工作在高速模式。標(biāo)準速率模式和高速模式下的1-Wire時序請參見應(yīng)用筆記126：“用軟件實現(xiàn)1-Wire?通信”。




	使用目標(biāo)地址TA1和TA2變量
在第一個示例方法中，變量TA1和TA2設(shè)置為DS2431期望的存儲器地址。發(fā)送OWReset，之后是Match ROM、DS2431 ROM ID、Write Scratchpad命令(0x0Fh)、目標(biāo)地址1 & 2以及要寫入DS2431 64位暫存器的8字節(jié)數(shù)據(jù)。推薦進行回讀及CRC16校驗操作。關(guān)于CRC16的詳細討論，請參考應(yīng)用筆記27：“理解和運用Maxim iButton?產(chǎn)品中的循環(huán)冗余校驗(CRC)”。




	OWWriteBytes和OWReadBytes
在第二個示例方法中，調(diào)用了兩個新的API函數(shù)：OWWriteBytes和OWReadBytes。這兩個API函數(shù)簡化了大量數(shù)據(jù)至?xí)捍嫫鞯淖x寫操作。



寫暫存器的方法是：設(shè)置目標(biāo)地址1 & 2、將數(shù)據(jù)寫入WriteBytes數(shù)組、執(zhí)行OWReset、然后發(fā)送Match ROM、DS2431 ROM ID、Write Scratchpad命令(0x0Fh)、目標(biāo)地址1 & 2、利用OWWriteBytes函數(shù)寫入保存在WriteBytes的所有10個字節(jié)、回讀CRC16并對CRC16進行校驗。



讀暫存器的方法是：執(zhí)行OWReset、發(fā)送Match ROM、DS2431 ROM ID、Read Scratchpad命令(0xAAh)、利用OWReadBytes函數(shù)讀取所有13個字節(jié)(TA1、TA2、ES、CRC16 & 8字節(jié)數(shù)據(jù))并保存到ReadBytes。



調(diào)用API函數(shù)OverdriveDisable，并隨后發(fā)送標(biāo)準OWReset，可以退出高速模數(shù)，使所有器件返回至標(biāo)準速率。



//----------------------------------------------------------------------------------------------------
//Start of DS2431 example

        Result = OWReset();                     //Error code removed for conciseness
        Result = OWWriteByte(0x3C);             //Overdrive Skip ROM (all devices are now in overdrive)
        OverdriveEnable();                      //Enable Overdrive Mode

        //Write scratchpad with data
        //First method
        TA1 = 0x00;
        TA2 = 0x00;
        Result = OWReset();                     //1-Wire reset
        Result = MatchROM(ROMCodes,DS2431);     //Select device
        Result = OWWriteByte(0x0F);             //Issue Write Scratchpad command
        Result = OWWriteByte(TA1);              //Send target address 1 (TA1)
        Result = OWWriteByte(TA2);              //Send target address 2 (TA2)

        //Write 8 Bytes of Data
        Result = OWWriteByte(0x11);             //Send Data Byte for all
        Result = OWWriteByte(0x22);
        Result = OWWriteByte(0x33);
        Result = OWWriteByte(0x44);
        Result = OWWriteByte(0x55);
        Result = OWWriteByte(0x66);
        Result = OWWriteByte(0x77);
        Result = OWWriteByte(0x88);

        //It is recommended that the CRC16 be read back and verified
        //CRC16 code was left out for conciseness

        Result = OWReset();                     //1-Wire Reset
        Result = MatchROM(ROMCodes,DS2431);     //Select device
        Result = OWWriteByte(0xAA);             //Issue Read Scratchpad command
        Result = OWReadByte();                  //Read TA1
        if(Result != TA1){
                //To d Add your error code here
        }
        Result = OWReadByte();                  //Read TA2
        if(Result != TA2){
                //To d Add your error code here
        }

        ES = OWReadByte();                      //Read ES

        //To d add your error code after reads
        Result = OWReadByte();                  //Read Data Byte (0x11)
        Result = OWReadByte();                  //Read Data Byte (0x22)
        Result = OWReadByte();                  //Read Data Byte (0x33)
        Result = OWReadByte();                  //Read Data Byte (0x44)
        Result = OWReadByte();                  //Read Data Byte (0x55)
        Result = OWReadByte();                  //Read Data Byte (0x66)
        Result = OWReadByte();                  //Read Data Byte (0x77)
        Result = OWReadByte();                  //Read Data Byte (0x88)

        //It is recommended that the CRC16 be read back and verified
        //CRC16 code was left out for conciseness

        //Second method
        TA1 = 0x00;
        TA2 = 0x00;

        WriteBytes[0] = TA1;
        WriteBytes[1] = TA2;

        for(i=2;i<10;i++){
                WriteBytes[i] = i;
        }

        Result = OWReset();                     //1-Wire reset
        Result = MatchROM(ROMCodes,DS2431);     //Select device
        Result = OWWriteByte(0x0F);             //Issue Write Scratchpad command

        //Write 10 bytes of data (TA1, TA2 & 8 bytes of data)
        OWWriteBytes(WriteBytes,10);            //Write data bytes

        //It is recommended that the CRC16 be read back and verified
        //CRC16 code was left out for conciseness

        Result = OWReset();                     //1-Wire reset
        Result = MatchROM(ROMCodes,DS2431);     //Select device
        Result = OWWriteByte(0xAA);             //Issue Read Scratchpad command

        //Read 13 bytes of data (TA1, TA2, ES, CRC16 & 8 bytes of data)
        OWReadBytes(ReadBytes,13);              //Read data bytes

        //It is recommended that the CRC16 be read back and verified
        //CRC16 code was left out for conciseness

        //Exit overdrive
        OverdriveDisable();
        Result = OWReset();                     //Std. reset issued (all devices are now in standard speed)

//End of DS2431 example
//----------------------------------------------------------------------------------------------------


	結(jié)論
本應(yīng)用筆記給出了使用API函數(shù)控制DS1WM的示例，無需主機CPU產(chǎn)生1-Wire時序。用戶現(xiàn)在應(yīng)該對選擇和訪問總線上多個1-Wire器件的通用API函數(shù)有了一定的了解。本文給出了DS28EA00和DS2431總線示例器件的控制和訪問示例，此外還演示了高速模式以及單字節(jié)/多字節(jié)數(shù)據(jù)的讀寫操作。