如何在 KEIL C51（v6.21） 中調用彙編函數的一個示例

如何在 KEIL C51（v6.21） 中調用彙編函數的一個示例 [ycong_kuang]

有關c51調用彙編的方法已經有很多帖子講到，但是一般只講要點，很少有對整個過程作詳細描述，對於初學者是不夠的，這裡筆者
通過一個簡單例子對這個過程進行描述，希望能對初學者有所幫助。幾年來，在這個論壇里筆者得到很多熱心人指導，因此也希望
藉此盡一點綿薄之力。

在這個例子里，闡述了編寫c51程序調用彙編函數的一種方法，這個外部函數的入口參數是一個字元型變數和一個位變數，返回值是
一個整型變數。例中，先用c51寫出這個函數的主體，然後用SRC控制指令編譯產生asm文件，進一步修改這個asm文件就得到我們所
要的彙編函數。該方法讓編譯器自動完成各種段的安排，提高了彙編程序的編寫效率。

step1. 按寫普通c51程序方法，建立工程，在裡面導入main.c文件和CFUNC.c文件。

相關文件如下：
//main.c文件
#include < reg51.h >

#define uchar unsigned char
#define uint unsigned int

extern uint AFUNC(uchar v_achr,bit v_bflag);

void main()
{
    bit BFLAG;
    uchar mav_chr;
    uint    mvintrslt;

    mav_chr=0xd4; BFLAG=1;
    mvintrslt=AFUNC(mav_chr,BFLAG);
}

//CFUNC.c文件

#define uchar unsigned char
#define uint unsigned int

uint AFUNC(uchar v_achr,bit v_bflag)
{
    uchar tmp_vchr;
    uint  tp_vint;

    tmp_vchr=v_achr;
    tp_vint=(uint)v_bflag;
    return tmp_vchr+(tp_vint<<8);
}

step2. 在 Project 窗口中包含彙編代碼的 C 文件上右鍵，選擇“Options for ...”，點擊右邊的“Generate Assembler SRC
        File”和“Assemble SRC File”，使檢查框由灰色變成黑色(有效)狀態;

step3. 根據選擇的編譯模式，把相應的庫文件（如 Small 模式時，是 Keil\C51\Lib\C51S.Lib）加入工程中，該文件必須作為工
       程的最後文件；

step4. build這個工程后將會產生一個CFUNC.SRC的文件，將這個文件改名為CFUNC.A51（也可以通過編譯選項直接產生CFUNC.A51文
       件），然後在工程里去掉庫文件（如C51S.Lib)和CFUNC.c,而將CFUNC.A51添加到工程里。

//CFUNC.SRC文件如下
.\CFUNC.SRC generated from: CFUNC.c
NAME CFUNC

?PR?_AFUNC?CFUNC     SEGMENT CODE
?BI?_AFUNC?CFUNC     SEGMENT BIT OVERLAYABLE
    PUBLIC    ?_AFUNC?BIT
    PUBLIC    _AFUNC

    RSEG  ?BI?_AFUNC?CFUNC
?_AFUNC?BIT:
    v_bflag?041:   DBIT   1
; #define uchar unsigned char
; #define uint unsigned int
;
; uint AFUNC(uchar v_achr,bit v_bflag)

    RSEG  ?PR?_AFUNC?CFUNC
_AFUNC:
    USING    0
            ; SOURCE LINE # 5
;---- Variable 'v_achr?040' assigned to Register 'R7' ----
; {
            ; SOURCE LINE # 6
;     uchar tmp_vchr;
;     uint    tp_vint;
;
;     tmp_vchr=v_achr;
            ; SOURCE LINE # 10
;---- Variable 'tmp_vchr?042' assigned to Register 'R5' ----
    MOV      R5,AR7
;     tp_vint=(uint)v_bflag;
            ; SOURCE LINE # 11
    MOV      C,v_bflag?041
    CLR      A
    RLC      A
;---- Variable 'tp_vint?043' assigned to Register 'R6/R7' ----
;     return tmp_vchr+(tp_vint<<8);
            ; SOURCE LINE # 12
    MOV      R6,A
    MOV      R4,#00H
    CLR      A
    ADD      A,R5
    MOV      R7,A
    MOV      A,R4
    ADDC     A,R6
    MOV      R6,A
; }
            ; SOURCE LINE # 13
?C0001:
    RET
; END OF _AFUNC

    END

step5. 檢查main.c的“Generate Assembler SRC File”和“Assemble SRC File”是否有效，若是有效則點擊使檢查框變成無效狀
       態；再次build這個工程，到此你已經得到彙編函數的主體，修改函數裡面的彙編代碼就得到你所需的彙編函數了。

參考文獻：
  1.徐愛鈞，彭秀華。單片機高級語言C51windows環境編程與應用，電子工業出版社
  2.www.c51bbs.com,  C51編程:關於在 KEIL C51 中直接嵌入彙編。。。帖子編號： 83838 發表用戶:Youth
  .................................................................................................................
                                 keil中彙編函數調用c51函數 [ycong_kuang]

在keil的寫法可參考89852帖子，具體如下：
與89852帖子相比，第一步在工程里多了一個被彙編調用的c51的函數文件（c51func.c），至於彙編函數還是先用c51編寫出主體
(a51func.c)，這樣彙編程序介面和段都交給編譯器處理，你只管在編譯成彙編代碼后按你的要求改寫彙編代碼就行了。

常式如下：
//main.c
#include < reg51.h >

#define uchar unsigned char
#define uint unsigned int

extern uint AFUNC(uchar v_achr,bit v_bflag);

void main()
{
    bit BFLAG;
    uchar mav_chr;
    uint    mvintrslt;

    mav_chr=0xd4; BFLAG=1;
    mvintrslt=AFUNC(mav_chr,BFLAG);
}

//a51FUNC.c

#define uchar unsigned char
#define uint unsigned int

extern uint CFUNC(uint);

uint AFUNC(uchar v_achr,bit v_bflag)    //c51寫的彙編函數，最終要變成彙編代碼
{
    uchar tmp_vchr;
    uint  tp_vint;

    tmp_vchr=v_achr;
    tp_vint=(uint)v_bflag;

    return CFUNC(tp_vint);             //這裡調用一個c51函數
}

//c51FUNC.c

#define uchar unsigned char
#define uint unsigned int

uint CFUNC(uint v_int)                //被彙編函數調用c51函數
{
    return v_int<<2;
}

第二步是按89852帖子的step2,3,4把用c51寫的(彙編)函數變成a51文件(今天我試了一下step3可以不要)常式編譯結果如
下：
; .\a51func.SRC generated from: a51func.c
NAME    A51FUNC

?PR?_AFUNC?A51FUNC   SEGMENT CODE
?DT?_AFUNC?A51FUNC   SEGMENT DATA OVERLAYABLE
?BI?_AFUNC?A51FUNC   SEGMENT BIT OVERLAYABLE
    EXTRN    CODE (_CFUNC)
    PUBLIC    ?_AFUNC?BIT
    PUBLIC    _AFUNC

    RSEG  ?DT?_AFUNC?A51FUNC
?_AFUNC?BYTE:
   tmp_vchr?042:   DS   1

    RSEG  ?BI?_AFUNC?A51FUNC
?_AFUNC?BIT:
    v_bflag?041:   DBIT   1
; //a51FUNC.c
;
; #define uchar unsigned char
; #define uint unsigned int
;
; extern uint CFUNC(uint);
;
; uint AFUNC(uchar v_achr,bit v_bflag)

    RSEG  ?PR?_AFUNC?A51FUNC
_AFUNC:        ;c51所寫的函數產生的彙編代碼從這裡開始
    USING    0
            ; SOURCE LINE # 8
;---- Variable 'v_achr?040' assigned to Register 'R7' ----
; {
            ; SOURCE LINE # 9
;     uchar tmp_vchr;
;     uint  tp_vint;
;
;     tmp_vchr=v_achr;
            ; SOURCE LINE # 13
    MOV      tmp_vchr?042,R7
;     tp_vint=(uint)v_bflag;
            ; SOURCE LINE # 14
    MOV      C,v_bflag?041
    CLR      A
    MOV      R6,A
    RLC      A
    MOV      R7,A
;---- Variable 'tp_vint?043' assigned to Register 'R6/R7' ----
;      這裡說明R6,R7內容就是tp_vint
;     return CFUNC(tp_vint);
            ; SOURCE LINE # 16
    LCALL    _CFUNC    ;這裡調用了用c51寫的函數
; }
            ; SOURCE LINE # 17
?C0001:
    RET
; END OF _AFUNC

    END

這個文件就是你的彙編函數所在文件，把函數裡面的彙編代碼修改成你所需的彙編函數就ok了。

建議參考 徐愛鈞，彭秀華所寫的《單片機高級語言C51windows環境編程與應用》或馬忠梅所寫的
《單片機的c語言應用程序設計》有關混合語言編程有關章節

  .................................................................................................................
                                關於在 KEIL C51 中直接嵌入彙編。。。 [Youth]
有時在C51程序中需要嵌入一些彙編代碼，這時當然可以用通常的作法：
按照 C51 與彙編的介面寫一個彙編函數，然後在 C51 程序中調用該函數。(此種方法可在論壇里搜索，以前有很多帖子講到，不再
重複)

下面介紹直接嵌入彙編代碼的方法：

1、在 C 文件中要嵌入彙編代碼片以如下方式加入彙編代碼：
#pragma ASM
 ; Assembler Code Here
#pragma ENDASM

2、在 Project 窗口中包含彙編代碼的 C 文件上右鍵，選擇“Options for ...”，點擊右邊的“Generate Assembler SRC File”
和“Assemble SRC File”，使檢查框由灰色變成黑色(有效)狀態；

3、根據選擇的編譯模式，把相應的庫文件(如 Small 模式時，是 Keil\C51\Lib\C51S.Lib)加入工程中, 該文件必須作為工程的最
後文件；

4、編譯，即可生成目標代碼。