HML_FwLib_8051 is the first member component of HML firmware library, providing a group of interface functions for users to operate on-chip resource of MCS-51 MCUs, including GPIO, external interrupt, timer and UART modules. The 8051 MCUs have been one of the most widely used MCUs since it was produced by Intel in 1981. As amateurs with some experience of 8051 development, we intend to develop a lite and easy-use tool that can help future developers to complete projects based on 8051 MCUs more easily and quickly.
The source codes are written in C language and for SDCC compiler, i.e., it can only be compiled by SDCC. This choice is motivated by the fact that SDCC is free and highly efficient, while there are very few examples of application about SDCC on the Internet. We hope that, as one of the early attempts to develop MCU projects using SDCC, this work will make SDCC become more popular among MCU developers.
Please visit detail page for more information to get started it!
- 🎯Based on SDCC compiler.
- Cover all on-chip resource of 8051 MCUs.
- Open all source code on Github and licensed under the WTPL2.
- Readable code and provide examples to help you get started it.
- GNU Make(recommend)
- SDCC compiler
- [for Windows] Unix shell tools(msys, Cygwin, GNUwin32) needed by makefile for SDCC
HML_FwLib_8051
├─doc # store related documents about HML_FwLib_8051
├─example # provide some example files with *.c format to help users learn about HML_FwLib_8051
├─inc # include all header files(*.h) of HML_FwLib_8051
├─obj # store all output files, including *.hex,*.ihx,*.lk,*.rel and others during compilation
├─src # store all source files(*.c) of HML_FwLib_8051
├─usr # store makefile and a source file which includes main function
├─AUTHORS # authors & contributors
├─LICENSE # license of HML_FwLib_8051
└─VERSION # version code of HML_FwLib_8051There are several parameters need to be configured before using HML_FwLib_8051 by user manually. It's noticed that the name of following macros is different with previous version.
In order to ensure projects based on HML_FwLib_8051 can be downloaded into the limited on-chip memory space of 8051 MCUs,
developers can modify compile macros which are with format of __CONF_COMPILE_xxx in hml/conf.h to specify which piece of
code will take part in compilation, then it will reduce size of final .hex file. For instance, if user only use GPIO module,
then user just need to enable __CONF_COMPILE_GPIO macro in hml/conf.h. Some macros for conditional compilation depend on others. For example, before you enable macro __CONF_COMPILE_UART, macro __CONF_COMPILE_TIM should be enable at the same
time. Otherwise, build works will be failed.
A macro marks frequency of clock source and it's defined in hml/conf.h. The default value is 11059200UL. This value can be
configured via make command line interface variable or config Makefile(refer to usr/Makefile.config)
When the macro is defined and mark value 1, it means current MCU has register T2MOD. Besides, if you enable this macro, please
make sure macro __CONF_HAVE_TIM2 is enabled firstly.
When the macro is defined and mark value 1, it means current MCU has timer-2.
There is a source file named test.c under usr directory, we put code includes a main function inside it. User can add and modify own code here, then enter make -j in terminal, the Makefile will work and complete compilation. Besides, our Makefile provides some interface variable to config build works via make command line interface variable or config Makefile. From version V0R3, you can enter make help to get all usages, and former version makefile only support make, make clean, make mostlyclean(change into make distclean now)
Certainly, you can just add inc and src directory into your project, and write your own makefile to build a custom project.
Welcome suggestions and contribution from you! You can fork it and make a pull request or contact us via mcu@zhishan-iot.tk.
HML_FwLib_8051 is licensed under the WTFPL2.
This is a one-man project....
| member | role | |
|---|---|---|
| Weilun Fong | Developer | wlf@zhishan-iot.tk |