introduction
When the project team does a relatively complex project , It means you don't work alone anymore . It's working with team members , This requires the team members to be responsible for part of the project . For example, you may only be responsible for communication or display .
At this time , You should write your own program into a module , Separate commissioning , Set aside interfaces for other modules to call .
/// Insert a message ： At the beginning of this year, I recorded a set of systematic introductory single chip microcomputer tutorial , If you want, just ask me for it. It's free , I can send a private message ~ You can also get it by clicking my avatar in black font and adding my earth . I've been relatively idle recently , Lead to finish setting , Take students to provincial or above competitions ///
Start of text ：
last , After the team members have written and debugged the modules they are responsible for , The project team leader shall carry out combined commissioning .
Such occasions require that the program must be modular . The benefits of modularity are many , Not just to facilitate division of labor , It also helps to debug the program , It is conducive to the division of program structure , It can also increase the readability and portability of the program .
What to say
Beginners often don't understand how to program modularity , In fact, it is easy to learn , And it is one of the effective methods of well-organized program structure .
This article will first talk about the modular methods and precautions , Finally, it will be the most widely used for beginners keil c Compiler as an example , The detailed steps of modular programming are given .
Modular programming should understand the following overview :
A module is a .c File and one .h Combination of documents , Header file (.h) Is the declaration of the module interface ;
This article summarizes the implementation method and essence of modularity ： Write the code of a functional module into a .c file , Then put the interface function of the module in .h In the file . give an example : If you use LCD , Then you may write a LCD driver module , To implement characters , The reality of Chinese characters and images , Named :
led_device.c, Of this module .c The document can be roughly written as :
#include…
…
// Define variables
unsigned char value;// global variable
…
// Define function
// This is the first function in this module , Play the role of delay , Only for function calls of this module , So use static Keyword modification
/******************** Delay subroutine ************************/
static void delay (uint us) //delay time
{}
// This is the second function in this module , To call in another module
/********************* Character writing program **************************
** function ： towards LCD Write character
** parameter ：dat_comm by 1 What is written is data , by 0 What is written is an instruction
content Number or instruction written for
******************************************************/
void wr_lcd (uchar dat_comm,uchar content)
{}
……
……
/***************************** END Files***********************************/
notes ： Only these two functions are written here , The scope of the first delay function is within the module , the second , It is required by other modules . To simplify , The function body is not written here .
.h The interface of the module is given in the document . In the above example , towards LCD Write character function ：wr_lcd (uchar dat_comm,uchar
content) Is an interface function , Because other modules will call it , that .h This function must be declared as an external function in the file （ use extrun Keyword modification ）, Another delay function ：void
delay (uint us) Only used in this module （ Local function , use static Keyword modification ）, So it doesn't need to be put .h In the file .
.h The file format is as follows ：
// Declare global variables
extern unsigned char value;
// Declare interface functions
extern void wr_lcd (uchar dat_comm,uchar content); // towards LCD Write character
……
/***************************** END Files***********************************/
Here are three points to note :
. stay keil In compiler ,extern Even if this keyword is not declared , The compiler will not report an error , And the program runs well , But there is no guarantee that other compilers will be used as well . It is strongly recommended to add , Develop good programming practices .
..c The functions in the file will only appear in other modules when they are used .h In the file , Like local delay function static void delay (uint
us) Even if it appears in .h The document is also doing useless work , Because other modules don't call it at all , You can't actually call it (static Restrictive effect of keywords ).
. Be sure to add a semicolon at the end of this sentence ”;”, I believe many students have encountered this strange compiler error : error C132: 'xxxx': not in formal
parameter list, This mistake is actually .h The last semicolon of the function is declared less .
Application of module ： If necessary LCD Menu module lcd_menu.c LCD driver module used in lcd_device.c Functions in void wr_lcd (uchar
dat_comm,uchar content), Just LCD Menu module lcd_menu.c Add the header file of LCD driver module to the file lcd_device.h that will do .
#include“lcd_device.h
// Contains the LCD driver header file , Then you can .c Call in file //lcd_device.h Global functions in , Using the global in the LCD driver // variable （ If any ）.
…
// Call to LCD Write character function
wr_lcd (0x01,0x30);
…
// Assign values to global variables
value=0xff;
…
The external functions and data provided by a module to other modules need to be .h In the middle of the document extern Keyword declaration ;
This sentence has been reflected in the above example , That is, the external functions and global variables provided by a module to other modules need to be .h In the middle of the document extern Keyword declaration .
Let's focus on the use of global variables . A difficulty in using modular programming （ Relative to novices ） Is the setting of global variables , It is often difficult for beginners to figure out how to realize the variables shared by modules and modules , The conventional practice is mentioned in this sentence , stay .h The external data in the document is preceded by extern Keyword declaration .
For example, the variables in the above example value Is a global variable , If a module also uses this variable , It is the same as using external functions , Just use the module .c File contains #include“lcd_device.h” that will do .
Another way to deal with global variables between modules comes from embedded operating system uCOS-II, This operating system handles global variables in a special way , It's also difficult to understand , But after learning, it can be used infinitely , This method only needs to be defined once in the header file . The method is ：
When defining all global variables （uCOS-II Define all global variables in one .h Within the document ） of .h In header file ：
#ifdef xxx_GLOBALS
#define xxx_EXT
#else
#define xxx_EXT extern
#endif
.H Every global variable in the file is added xxx_EXT Prefix of .xxx Represents the name of the module .
Of this module .C The file has the following definitions ：
#define xxx_GLOBALS
#include "includes.h"
When the compiler processes .C File time , It forces xxx_EXT（ In corresponding .H It can be found in the file ） Empty ,（ because xxx_GLOBALS Already defined ）.
So the compiler allocates memory space to each global variable , And when the compiler handles other .C File time ,xxx_GLOBAL No definition ,xxx_EXT Defined as extern, This allows the user to call external global variables . To illustrate this concept , See uC/OS_II.H, This includes the following definitions ：
#ifdef OS_GLOBALS
#define OS_EXT
#else
#define OS_EXT extern
#endif
OS_EXT INT32U OSIdleCtr;
OS_EXT INT32U OSIdleCtrRun;
OS_EXT INT32U OSIdleCtrMax;
meanwhile ,uCOS_II.H There are the following definitions in ：
#define OS_GLOBALS
#include“includes.h”
When the compiler processes uCOS_II.C Time , It makes the header file as follows , because OS_EXT Is set to null .
INT32U OSIdleCtr;
INT32U OSIdleCtrRun;
INT32U OSIdleCtrMax;
In this way, the compiler will allocate these global variables in memory . When the compiler handles other .C File time , The header file looks like this , because OS_GLOBAL No definition , therefore OS_EXT Defined as extern.
extern INT32U OSIdleCtr;
extern INT32U OSIdleCtrRun;
extern INT32U OSIdleCtrMax;
under these circumstances , No memory allocation , And any .C Files can use these variables . In this way, you just need to .H Just define it once in the file .
The functions and global variables in the module need to be .c File begins with static Keyword declaration ;
This sentence is mainly about keywords static Role of .Static Is a very important keyword , He can make some constraints on functions and variables , And it can convey some information .
For example, in the above example LCD Drive module .c Delay function defined in file static void delay (uint
us), This function is preceded by static modification , On the one hand, it limits the scope of the function and only plays a role in this module , On the other hand, it also conveys such a message to people ： This function will not be called by other modules .
Let's talk about the function of this keyword in detail , stay C In language , keyword static There are three obvious effects ：
. In function body , A variable declared static maintains its value during the call of this function .
. In module （ But outside the function ）, A variable declared static can be accessed by functions used in the module , But it cannot be accessed by other functions outside the module . It is a local global variable .
. In module , A function declared as static can only be called by other functions in this module . That's it , This function is restricted to the local scope of the module that declares it .
The first two are easier to understand , The last function is the delay function just mentioned in the example （static void delay (uint us)）, Localization functions are quite useful .
Never in .h Variables defined in the file !
Compare the code ：
Code one ：
/*module1.h*/
int a = 5; /* In module 1 of .h Defined in file int a */
/*module1 .c*/
#include "module1.h" /* In module 1 Contains modules 1 of .h file */
/*module2 .c*/
#include "module1.h" /* In module 2 Contains modules 1 of .h file */
/*module3 .c*/
#include "module1.h" /* In module 3 Contains modules 1 of .h file */
The result of the above procedure is in the module 1,2,3 Integer variables are defined in a,a Corresponding to different address elements in different modules , There has never been a need for such a program in this world . The right thing to do is ：
Code two ：
/*module1.h*/
extern int a; /* In module 1 of .h Stated in the document int a */
/*module1 .c*/
#include "module1.h" /* In module 1 Contains modules 1 of .h file */
int a = 5; /* In module 1 of .c Defined in file int a */
/*module2 .c*/
#include "module1.h" /* In module 2 Contains modules 1 of .h file */
/*module3 .c*/
#include "module1.h" /* In module 3 Contains modules 1 of .h file */
So if the module 1,2,3 operation a Words , It corresponds to the same memory unit .
notes ： An embedded system usually includes two types （ Note that there are two types , Not two ） modular ：
· Hardware driver module , A specific hardware corresponds to a module ;
· Software function module , The division of modules shall meet the requirements of low coupling , High cohesion requirements .
Technology