ARM Technical Support Knowledge Articles


Applies to: C51 C Compiler


Information in this article applies to:


In the C51 compiler manual, there is example of an assembly module calling a C function. Is there any example of a C program calling an assembly routine?


There are no examples in the book, but it is easy to create your own. The asm routine must know how parameters are passed, values returned, and the naming conventions of segments. The steps you must follow to create an example are outlined below:

  1. Write a simple function in C that passes parameters and returns values the way you want your assembly routine to.
  2. Use the SRC directive (#PRAGMA SRC at the top of the file) so that the C compiler generates a .SRC file instead of a .OBJ file.
  3. Compile the C file. Since the SRC directive was specified, the .SRC file is generated. The .SRC file contains the assembly code generated for the C code you wrote.
  4. Rename the .SRC file to a .A51 file.
  5. Edit the .A51 file and insert the assembly code you want to execute into the body of the assembly function shell included in the .A51 file.

For example, the following code

#pragma SRC
unsigned char my_assembly_func (
  unsigned int argument)
return (argument + 1);   // Insert dummy lines to access all args and retvals

when compiled generates the following assembly SRC file.


?PR?_my_assembly_func?TESTCODE                SEGMENT CODE
        PUBLIC  _my_assembly_func
; #pragma SRC
; unsigned char my_assembly_func (

        RSEG  ?PR?_my_assembly_func?TESTCODE
        USING   0
;---- Variable 'argument?040' assigned to Register 'R6/R7' ----
                        ; SOURCE LINE # 2
;   unsigned int argument)
; {
                        ; SOURCE LINE # 4
; return (argument + 1);   // Insert dummy lines to access all args and retvals
                        ; SOURCE LINE # 5
        MOV     A,R7
        INC     A
        MOV     R7,A
; }
                        ; SOURCE LINE # 6
; END OF _my_assembly_func




Article last edited on: 2010-03-23 09:01:44

Rate this article

Disagree? Move your mouse over the bar and click

Did you find this article helpful? Yes No

How can we improve this article?

Link to this article
Copyright © 2011 ARM Limited. All rights reserved. External (Open), Non-Confidential