https://github.com/mgoblin/stc15lib
This C-library contains the code for interaction with STC15W408AS
https://github.com/mgoblin/stc15lib
mcs8051 stc15w408as
Last synced: 3 months ago
JSON representation
This C-library contains the code for interaction with STC15W408AS
- Host: GitHub
- URL: https://github.com/mgoblin/stc15lib
- Owner: mgoblin
- License: apache-2.0
- Created: 2024-08-28T05:30:52.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-09-13T04:19:59.000Z (9 months ago)
- Last Synced: 2024-09-14T10:37:00.747Z (9 months ago)
- Topics: mcs8051, stc15w408as
- Language: C
- Homepage:
- Size: 627 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# What it is
This C-library contains hardware abstraction layer (HAL) for STC15W408AS.
STC15W408AS is a micro chip compatible with 8051 architecture.
# How to use it
This code is published as [Platformio](https://platformio.org/) library named STC15 hardware.
## Add library to your project
After create Platformio project for STC15408AS add to platformio.ini line with library depandency
```ini
[env:STC15W408AS]
platform = intel_mcs51
board = STC15W408AS
lib_deps = mgoblin/STC15 hardware@^0.8.0
```
Where is 0.7.0 STC15 hardware library version.
As alternative in lib_deps line github link could be used.
```ini
[env:STC15W408AS]
platform = intel_mcs51
board = STC15W408AS
lib_deps = https://github.com/mgoblin/STC15lib#0.8.0
```
Where is 0.8.0 STC15 hardware library github tag version.
Each released library version has the tag in github repository.
## Low level STC15 prorgamming
You can directly manipulate to MCU registers from C-code.
STC15Fxx.h should be included.
```C
#include // MCU SFR declarations
void main()
{
// Use SFR declaration to change MCU state here
P10 = 0; // As example put LED on. Pin P1.0 connected to onboard LED
}
```
## Use STC15 HAL functions
This library provides hardware astraction laywer (HAL) for high level development tasks.
Please read the docs for library modules in Library documentation section (see the docs link).
Most of HAL functionality is C-macros.
The advantage is small firmware code size because
macroses are expanded into application.
C-Macroses have some drawbacks.
1. No compiler typechecks
2. No function call optimizations. Macroses code inlined.
If you need to use one HAL macros many times the good idea is to wrap macros by C-function.
```C
#include
#define LED P10
#define ON 0
#define OFF 1
// Wrap delay_ms HAL macros call to C-function
void f_delay_ms(uint16_t ms)
{
delay_ms(ms); // This is a macros
}
void main()
{
while(1)
{
LED = ON;
f_delay_ms(500);
LED = OFF;
f_delay_ms(1000);
}
}
```
# Library modules maturity
| Module name | Description | Maturity |
|------------- |----------------------------------|--------------------|
| ChipID | Get chip id from ROM | READY |
| Delay | CPU cycles based delay | READY |
| CPU frequency| CPU frequency slowdown | READY |
| Interrupt | Enable and disable interrupts | READY |
| Power management | idle, powerdown and wakeup timer | READY |
| Reset | Software reset | READY |
| Timer | Timer control routines | READY |
| UART | Serial port routines | INITIAL SUPPORT |
| Watchdog timer | Watchdog timer routines | READY |
| Pin | Pin as digital in/out routines | READY |
Other modules does not implemented yet.
See examples in [https://github.com/mgoblin/STC15lib/tree/main/examples](https://github.com/mgoblin/STC15lib/tree/main/examples)
# Library documentation
[Docs](https://mgoblin.github.io/STC15lib/docs/html/modules.html)
# Version history
[Version history](https://mgoblin.github.io/STC15lib/VERSION_HISTORY.html)
# References
* STC datasheets: [http://stcmicro.com/sjsc.html](http://stcmicro.com/sjsc.html)
* SDCC User Guide (PDF): [http://sdcc.sourceforge.net/doc/sdccman.pdf](http://sdcc.sourceforge.net/doc/sdccman.pdf)
* STC programmator [https://github.com/mgoblin/STC-programmatorhttps://github.com/mgoblin/STC-programmator](https://github.com/mgoblin/STC-programmatorhttps://github.com/mgoblin/STC-programmator)