當(dāng)前位置:首頁(yè) > 單片機(jī) > 單片機(jī)
[導(dǎo)讀]引言 I²C (內(nèi)置集成電路)是一種2線接口,實(shí)現(xiàn)集成電路之間的雙向通信。本應(yīng)用筆記介紹maxqi2c庫(kù),它是MAXQ2000微控制器(µC)的軟件I²C驅(qū)動(dòng)。maxqi2c庫(kù)采用擴(kuò)展C語(yǔ)言編寫(xiě),由MAXQ的IAR嵌入式平臺(tái)編譯

引言
I²C (內(nèi)置集成電路)是一種2線接口,實(shí)現(xiàn)集成電路之間的雙向通信。本應(yīng)用筆記介紹maxqi2c庫(kù),它是MAXQ2000微控制器(µC)的軟件I²C驅(qū)動(dòng)。

maxqi2c庫(kù)采用擴(kuò)展C語(yǔ)言編寫(xiě),由MAXQ的IAR嵌入式平臺(tái)編譯。它由兩個(gè)文件組成:maxqi2c.h和maxqi2c.c。當(dāng)這些文件包含在MAXQ2000固件工程時(shí),使用µC的任意GPIO引腳,便可實(shí)現(xiàn)100kHz或者400kHz靈活的I²C通信。

MAXQ系列的微控制器具有高速、靈活的GPIO模塊以及獨(dú)立的I/O供電,適用于位拆裂等應(yīng)用。

本應(yīng)用筆記討論的實(shí)例工程文件可以從Maxim Integrated Products網(wǎng)站下載。

配置maxqi2c庫(kù)

用戶應(yīng)將maxqi2c庫(kù)文件(maxqi2c.h和maxqi2c.c)復(fù)制到MAXQ2000工程目錄中,對(duì)文件進(jìn)行配置,建立所需的I2C接口。通過(guò)編輯以下代碼(清單1)實(shí)現(xiàn)所有的配置,該代碼位于maxqi2c.h源文件的開(kāi)始:

清單1. maxi2c.h用戶定義代碼。
/* USER MUST CUSTOMIZE THE FOLLOWING DEFINE STMTS - START */
  // Enter the port used for SDA and SCL
  #define SDA_PORT               0
  #define SCL_PORT               0

  // Enter the pin used for SDA and SCL
  #define SDA_PORT_BIT           0
  #define SCL_PORT_BIT           1

  // Uncomment one of these define statements to select I2C bus speed
  #define I2C_400_KHZ
  //#define I2C_100_KHZ
 
  // Comment out the following define statement to disable clock
  // stretching in i2cRecv()
  #define I2C_CLOCK_STRETCHING
/* USER MUST CUSTOMIZE THE FOLLOWING DEFINE STMTS - END   */

注釋?zhuān)河脩舳x代碼編譯時(shí)實(shí)現(xiàn),因此,運(yùn)行時(shí)間固定。

選擇SCL和SDA引腳

需選擇兩個(gè)GPIO引腳用作SCL和SDA。為SCL和SDA選擇了I/O之后,必須對(duì)SDA_PORT和SCL_PORT定義語(yǔ)句進(jìn)行編輯,以反映SDA和SCL所需的端口。也必須對(duì)SDA_PORT_BIT和SCL_PORT_BIT定義語(yǔ)句進(jìn)行編輯,以反映SDA和SCL所需的引腳(在所選端口上)。

上面清單1中的源代碼在I/O端口0分配引腳0,作為SDA,在I/O端口0分配引腳1,作為SCL。

選擇通信速率

通過(guò)注釋I2C_400_KHZ和I2C_100_KHZ兩個(gè)定義語(yǔ)句之一來(lái)選擇通信速率。

清單1的源代碼通過(guò)400kHz I²C總線初始化maxqi2c庫(kù),進(jìn)行通信。由于I²C接口是逐位控制,通信速率實(shí)際略低于400kHz (或者,另一種選擇100kHz)。為達(dá)到全速400kHz通信,固件設(shè)計(jì)人員必須學(xué)習(xí)maxi2c庫(kù),去掉某些源代碼,發(fā)揮庫(kù)的靈活性。

注釋?zhuān)簃axqi2c庫(kù)包括時(shí)延以滿足I²C規(guī)范。這些時(shí)延在maxqi2c.c文件的開(kāi)始,假設(shè)MAXQ2000具有20MHz系統(tǒng)時(shí)鐘;如果采用了速率較低的時(shí)鐘,可以減小時(shí)延。

使用時(shí)鐘擴(kuò)展

maxqi2c庫(kù)的時(shí)鐘擴(kuò)展僅在調(diào)用i2cRecv()函數(shù)開(kāi)始傳送時(shí)(地址傳輸完畢,經(jīng)過(guò)地址確認(rèn)后,或者在傳送開(kāi)始時(shí))使用。因此,I²C傳送可以采用以下格式的時(shí)鐘擴(kuò)展:
[S] [ADDR] [R] [A] [clock stretch] [DATA0] [A] ... [DATAN-1] [A]
or
[clock stretch] [DATA0] [A] ... [DATAN-1] [N] [P]
or
[clock stretch] [DATA0] [A] ... [DATAN-1] [A]

使用maxqi2c一節(jié)中的i2cRecv()說(shuō)明,maxqi2c庫(kù)使用實(shí)例一節(jié)中的代碼解釋了怎樣產(chǎn)生這些格式的I²C命令。

要使能時(shí)鐘擴(kuò)展,則不應(yīng)注釋掉I2C_CLOCK_STRETCHING定義聲明。如果不需要時(shí)鐘擴(kuò)展,通過(guò)注釋掉I2C_CLOCK_STRETCHING定義語(yǔ)句禁用它。禁用時(shí)鐘擴(kuò)展會(huì)稍微提高maxqi2c庫(kù)i2cRecv()函數(shù)的速率。

上面清單1的源代碼使能時(shí)鐘擴(kuò)展。

使用maxqi2c

由4個(gè)函數(shù)實(shí)現(xiàn)maxqi2c庫(kù)從軟件I²C驅(qū)動(dòng)發(fā)送和接收數(shù)據(jù):i2cInit()、i2cIsAddrPresent()、i2cSend()和i2cRecv()。這些函數(shù)的文檔也包含在maxqi2c.h文件中。

這些函數(shù)都不需要正式的參數(shù),而是采用4個(gè)全局變量為這些函數(shù)存儲(chǔ)參數(shù):i2cData (無(wú)符號(hào)字符 *)、i2cDataLen (無(wú)符號(hào)整數(shù))、i2cDataAddr (無(wú)符號(hào)字符)和i2cDataTerm (無(wú)符號(hào)字符)。該方法在函數(shù)調(diào)用時(shí)不進(jìn)行數(shù)據(jù)復(fù)制,從而支持固件以更快的速率運(yùn)行。4個(gè)用作maxqi2c庫(kù)參數(shù)的全局變量是:i2cData (無(wú)符號(hào)字符 *)、i2cDataLen (無(wú)符號(hào)整數(shù))、i2cDataAddr (無(wú)符號(hào)字符)和i2cDataTerm (無(wú)符號(hào)字符)。

i2cInit()

必須在調(diào)用任何其他maxqi2c函數(shù)之前調(diào)用該函數(shù)。它初始化maxqi2c.h文件中用戶定義代碼所選擇的端口引腳。該函數(shù)不需要參數(shù)(局部或者全局),不返回?cái)?shù)值。

i2cIsAddrPresent()

該函數(shù)使MAXQ2000能夠查詢I²C總線,以確定是否有特定地址的器件。該函數(shù)有一個(gè)參數(shù)――全局變量i2cDataAddr,它必須由器件地址裝入,查詢I²C總線是否有器件。該函數(shù)還返回一個(gè)數(shù)值(無(wú)符號(hào)字符類(lèi)型)。如果找到了給定地址的器件,該數(shù)值等于I2C_XMIT_OK,如果沒(méi)有找到給定地址的器件,則等于I2C_XMIT_FAILED。

為確定在I²C總線上是否有特定器件,i2cIsAddrPresent()按照下面的格式發(fā)送一個(gè)I²C命令:

[S] [ADDR] [W] [A] [P]

i2cSend()

該函數(shù)使MAXQ2000能夠通過(guò)軟件I2C驅(qū)動(dòng)向器件傳送數(shù)據(jù)。i2cSend()需要以下4個(gè)參數(shù)(均為全局變量)來(lái)初始化:

i2cData (無(wú)符號(hào)字符 *):被傳送字節(jié)陣列的第一個(gè)字節(jié)指針。

i2cDataLen (無(wú)符號(hào)整數(shù)):向I²C總線傳送的字節(jié)數(shù)(不包括器件地址)。

i2cDataAddr (無(wú)符號(hào)字符):數(shù)據(jù)將被傳送到的器件的地址。注意,如果該變量設(shè)置為0,將不發(fā)送地址,傳送I²C數(shù)據(jù)。

i2cDataTerm (無(wú)符號(hào)字符):I²C傳送如何結(jié)束。調(diào)用i2cSend(): I2C_TERM_NONE或者I2C_TERM_STOP時(shí),該變量可以取兩個(gè)值。

在I²C總線上向器件傳送數(shù)據(jù)的格式取決于4個(gè)全局變量的取值。表1列出了這些全局變量不同取值時(shí)的I²C命令格式。

表1. i2cSend()送出的I²C命令 i2cDataLen(hex) i2cDataAddr(hex) i2cDataTerm I²C Command Format
0x0002 0x7E I2C_TERM_STOP [S] [ADDR] [W] [A] [DATA0] [A] [DATA1] [P]
0x0002 0x7E I2C_TERM_NONE [S] [ADDR] [W] [A] [DATA0] [A] [DATA1] [A]
0x0002 0x00 I2C_TERM_NONE [DATA0] [A] [DATA1] [A]
0x0002 0x00 I2C_TERM_STOP [DATA0] [A] [DATA1] [A] [P]

注釋?zhuān)罕?中的最后3個(gè)格式顯示了i2cSend()怎樣向I²C總線上的同一個(gè)器件連續(xù)發(fā)送數(shù)據(jù)。

如果尋址器件每一字節(jié)作出應(yīng)答,i2cSend()函數(shù)返回一個(gè)等于I2C_XMIT_OK的數(shù)值(無(wú)符號(hào)字符類(lèi)型),如果尋址器件每字節(jié)沒(méi)有應(yīng)答,返回值則等于I2C_XMIT_FAILED。當(dāng)一個(gè)字節(jié)沒(méi)有得到應(yīng)答時(shí),函數(shù)將立即返回。

i2cRecv()

該函數(shù)使MAXQ2000能夠使用軟件I²C驅(qū)動(dòng)從器件接收數(shù)據(jù)。i2cRecv()函數(shù)需要以下4個(gè)參數(shù)(均為全局變量)來(lái)初始化:

i2cData (無(wú)符號(hào)字符 *):存儲(chǔ)接收數(shù)據(jù)陣列的第一個(gè)字節(jié)指針。

i2cDataLen (無(wú)符號(hào)整數(shù)):從I²>C總線上接收到的字節(jié)數(shù)(不包括器件地址)。

i2cDataAddr (無(wú)符號(hào)字符):將要接收數(shù)據(jù)的器件地址。注意,如果該變量設(shè)置為0,將不發(fā)送地址,接收I²C數(shù)據(jù)。

i2cDataTerm (無(wú)符號(hào)字符):I²C傳送如何結(jié)束。調(diào)用i2cRecv(): I2C_TERM_NONE、 I2C_TERM_ACK或者I2C_TERM_NACK_AND_STOP時(shí),該變量可以取三個(gè)值。

在I²C總線上從器件接收數(shù)據(jù)的格式取決于4個(gè)全局變量的取值。表2列出了這些全局變量不同取值時(shí)的I²C命令格式。

表2. 禁用時(shí)鐘擴(kuò)展,i2cRecv()發(fā)送的I²C命令 i2cDataLen(hex) i2cDataAddr(hex) i2cDataTerm I2C Command Format
0x0002 0x7E I2C_TERM_NACK_AND_STOP [S] [ADDR] [R] [A] [DATA0] [A] [DATA1] [N] [P]
0x0002 0x7E I2C_TERM_ACK [S] [ADDR] [R] [A] [DATA0] [A] [DATA1] [A]
0x0002 0x00 I2C_TERM_ACK [DATA0] [A] [DATA1] [A]
0x0002 0x00 I2C_TERM_NACK_AND_STOP [DATA0] [A] [DATA1] [N] [P]

注釋?zhuān)罕?中的最后3個(gè)格式顯示了i2cRecv()怎樣從I²C總線上的同一個(gè)器件連續(xù)接收數(shù)據(jù)。

如果地址作為I²C命令的一部分進(jìn)行發(fā)送,沒(méi)有得到應(yīng)答,i2cRecv()函數(shù)返回一個(gè)等于I2C_XMIT_FAILED的數(shù)值(無(wú)符號(hào)字符),否則,返回I2C_XMIT_OK。

帶有時(shí)鐘擴(kuò)展的maxqi2c庫(kù)使用實(shí)例

以下實(shí)例顯示了怎樣利用maxqi2c庫(kù)從MAX1169 ADC接收16位采樣,由MAXQ的RS-232端口,將這些數(shù)據(jù)傳送至PC。

原理

采用MAX1169 ADC評(píng)估板和MAXQ2000評(píng)估板(Rev B)實(shí)現(xiàn)了該實(shí)例。圖1顯示了兩塊評(píng)估板的連接。MAXQ2000 I/O端口的引腳0和引腳1 (分別在J2-30和J2-28)用作I2C總線上的主機(jī)SDA和SCL線。

圖1. MAX1169評(píng)估板和MAXQ2000評(píng)估板(Rev B)連接原理圖,將由maxqi2c庫(kù)使用。

注釋?zhuān)篗AXQ2000評(píng)估板上的MAXQ2000高頻晶振(Y1)以20MHz晶振替代。MAX1169評(píng)估板的跳接器設(shè)置和MAXQ2000評(píng)估板的開(kāi)關(guān)設(shè)置在表3和表4中:

表3:MAX1169評(píng)估板的跳接器設(shè)置 跳接器 短路器位置
JU1 引腳1和2之間安裝短路器
JU2 引腳1和2之間安裝短路器
JU3 引腳1和2之間安裝短路器
JU4 沒(méi)有短路器
JU5 沒(méi)有短路器

表4. MAXQ2000評(píng)估板(Rev B)開(kāi)關(guān)設(shè)置 開(kāi)關(guān) 位置
SW1-1 斷開(kāi)
SW1-2 斷開(kāi)
SW1-3 斷開(kāi)
SW1-4 打開(kāi)
SW1-5 斷開(kāi)
SW1-6 斷開(kāi)
SW1-7 打開(kāi)
SW1-8 斷開(kāi)
SW6-1 斷開(kāi)
SW6-2 斷開(kāi)
SW6-3 斷開(kāi)
SW6-4 斷開(kāi)
SW6-5 斷開(kāi)
SW6-6 斷開(kāi)
SW6-7 斷開(kāi)
SW6-8 打開(kāi)


固件

該實(shí)例(max1169.c)的固件文件在附錄A中給出。完整的工程資料可以在Maxim MAXQ2000網(wǎng)頁(yè)下載,采用MAXQ IAR嵌入式平臺(tái)編譯。該實(shí)例中,maxqi2c庫(kù)的用戶定義代碼(在maxqi2c.h文件的開(kāi)始)與清單1的源代碼完全相同。

max1169.c文件包括兩個(gè)頭文件:iomaxq200x.h和maxqi2c.h。注意,實(shí)例中的iomaxq200x.h文件將忽略MAXQ包含路徑IAR嵌入式平臺(tái)中的iomaxq200x.h文件。iomaxq200x.h文件為maxqi2c庫(kù)所需的每個(gè)端口引腳進(jìn)行定義。包含了maxqi2c.h文件,以支持固件調(diào)用maxqi2c庫(kù)函數(shù)。

固件分成5步,在max1169.c文件中標(biāo)出(參見(jiàn)附錄A)。

第1步初始化UART0,以19200bps進(jìn)行異步通信。注意,如果MAXQ2000系統(tǒng)時(shí)鐘不是20MHz,必須修改寄存器PR0的分配以獲得所需的波特率。

第2步調(diào)用i2cInit()函數(shù),以初始化I2C總線MAXQ2000所使用的引腳。

第3步初始化參數(shù),調(diào)用i2cRecv()函數(shù)。參數(shù)經(jīng)過(guò)初始化,按照下面的格式傳送I²C命令:
[S] [ADDR] [R] [A] [clock stretch] [DATA0] [A] [DATA1] [A (termination)] 第4步將地址參數(shù)設(shè)置為0。使i2cRecv()函數(shù)按照下面的格式傳送I²C命令:
[clock stretch] [DATA0] [A] [DATA1] [A (termination)] 第5步是周期不確定的循環(huán)。該循環(huán)調(diào)用i2cRecv() (按照第4步定義的格式),從MAX1169接收一個(gè)16位采樣。由UART0將該16位采樣傳送(MSB在前)至PC。由于匹配參數(shù)i2cDataTerm總是等于I2C_TERM_ACK,循環(huán)的周期不確定,MAX1169不會(huì)看到停止?fàn)顟B(tài)。
 

本站聲明: 本文章由作者或相關(guān)機(jī)構(gòu)授權(quán)發(fā)布,目的在于傳遞更多信息,并不代表本站贊同其觀點(diǎn),本站亦不保證或承諾內(nèi)容真實(shí)性等。需要轉(zhuǎn)載請(qǐng)聯(lián)系該專(zhuān)欄作者,如若文章內(nèi)容侵犯您的權(quán)益,請(qǐng)及時(shí)聯(lián)系本站刪除。
換一批
延伸閱讀

9月2日消息,不造車(chē)的華為或?qū)⒋呱龈蟮莫?dú)角獸公司,隨著阿維塔和賽力斯的入局,華為引望愈發(fā)顯得引人矚目。

關(guān)鍵字: 阿維塔 塞力斯 華為

倫敦2024年8月29日 /美通社/ -- 英國(guó)汽車(chē)技術(shù)公司SODA.Auto推出其旗艦產(chǎn)品SODA V,這是全球首款涵蓋汽車(chē)工程師從創(chuàng)意到認(rèn)證的所有需求的工具,可用于創(chuàng)建軟件定義汽車(chē)。 SODA V工具的開(kāi)發(fā)耗時(shí)1.5...

關(guān)鍵字: 汽車(chē) 人工智能 智能驅(qū)動(dòng) BSP

北京2024年8月28日 /美通社/ -- 越來(lái)越多用戶希望企業(yè)業(yè)務(wù)能7×24不間斷運(yùn)行,同時(shí)企業(yè)卻面臨越來(lái)越多業(yè)務(wù)中斷的風(fēng)險(xiǎn),如企業(yè)系統(tǒng)復(fù)雜性的增加,頻繁的功能更新和發(fā)布等。如何確保業(yè)務(wù)連續(xù)性,提升韌性,成...

關(guān)鍵字: 亞馬遜 解密 控制平面 BSP

8月30日消息,據(jù)媒體報(bào)道,騰訊和網(wǎng)易近期正在縮減他們對(duì)日本游戲市場(chǎng)的投資。

關(guān)鍵字: 騰訊 編碼器 CPU

8月28日消息,今天上午,2024中國(guó)國(guó)際大數(shù)據(jù)產(chǎn)業(yè)博覽會(huì)開(kāi)幕式在貴陽(yáng)舉行,華為董事、質(zhì)量流程IT總裁陶景文發(fā)表了演講。

關(guān)鍵字: 華為 12nm EDA 半導(dǎo)體

8月28日消息,在2024中國(guó)國(guó)際大數(shù)據(jù)產(chǎn)業(yè)博覽會(huì)上,華為常務(wù)董事、華為云CEO張平安發(fā)表演講稱,數(shù)字世界的話語(yǔ)權(quán)最終是由生態(tài)的繁榮決定的。

關(guān)鍵字: 華為 12nm 手機(jī) 衛(wèi)星通信

要點(diǎn): 有效應(yīng)對(duì)環(huán)境變化,經(jīng)營(yíng)業(yè)績(jī)穩(wěn)中有升 落實(shí)提質(zhì)增效舉措,毛利潤(rùn)率延續(xù)升勢(shì) 戰(zhàn)略布局成效顯著,戰(zhàn)新業(yè)務(wù)引領(lǐng)增長(zhǎng) 以科技創(chuàng)新為引領(lǐng),提升企業(yè)核心競(jìng)爭(zhēng)力 堅(jiān)持高質(zhì)量發(fā)展策略,塑強(qiáng)核心競(jìng)爭(zhēng)優(yōu)勢(shì)...

關(guān)鍵字: 通信 BSP 電信運(yùn)營(yíng)商 數(shù)字經(jīng)濟(jì)

北京2024年8月27日 /美通社/ -- 8月21日,由中央廣播電視總臺(tái)與中國(guó)電影電視技術(shù)學(xué)會(huì)聯(lián)合牽頭組建的NVI技術(shù)創(chuàng)新聯(lián)盟在BIRTV2024超高清全產(chǎn)業(yè)鏈發(fā)展研討會(huì)上宣布正式成立。 活動(dòng)現(xiàn)場(chǎng) NVI技術(shù)創(chuàng)新聯(lián)...

關(guān)鍵字: VI 傳輸協(xié)議 音頻 BSP

北京2024年8月27日 /美通社/ -- 在8月23日舉辦的2024年長(zhǎng)三角生態(tài)綠色一體化發(fā)展示范區(qū)聯(lián)合招商會(huì)上,軟通動(dòng)力信息技術(shù)(集團(tuán))股份有限公司(以下簡(jiǎn)稱"軟通動(dòng)力")與長(zhǎng)三角投資(上海)有限...

關(guān)鍵字: BSP 信息技術(shù)
關(guān)閉
關(guān)閉