# yuge_cat4_opencpu

**Repository Path**: jackeron/yuge_cat4_opencpu

## Basic Information

- **Project Name**: yuge_cat4_opencpu
- **Description**: 域格CAT4模块通用openCPU
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2025-07-16
- **Last Updated**: 2025-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ASR1803S SDK

ASR1803S SDK is openCPU SDK for ASR1803S module, include JC3,JD3,JR3

## SDK layout

- core: OpenCPU core library,header
- doc: document for SDK
- sample: API sample
- tools: makefile tool, compiler tool
- build.bat: build command

## How to use

1. Install gcc-arm-none-eabi

    The following link is recommended.  
    <https://developer.arm.com/-/media/Files/downloads/gnu-rm/10.3-2021.10/gcc-arm-none-eabi-10.3-2021.10-win32.zip>  
    Unzip and Put it in tools directory, change path name to "gcc-arm-none-eabi".

2. In SDK root directory, run following command line to build 00_basic sample:

 ```bat
 > build.bat sample\00_basic
 
 The Result output image is sample\00_basic\build\OemData.bin
 ```

3. Replace OemData.bin file in official openCPU supported firmware.

## User guide

- App available memory

 For 16M flash version product, ROM:256KB, RAM:768KB  
 For 8M flash version product, ROM:128KB, RAM:768KB

- C LIB

 By enable USE_LIBC=yes in Makefile, app can call C standard LIB API except memory management API, malloc()/free() is always available and called from system side.  
 If enable LIBC, the final binary is bigger.  
 note: if USE_LIBC=yes is enabled, USE_NANO=yes should enabled together.

- Debug

 By define `__LOG_UART__` in Makefile, app print log to UART.  
 By define `__LOG_ACAT__` in Makefile, app print log to CATStudio.  
 Check debug.h for more detail.

- Startup

 main() is the entry of app, it is called at system boot in a separate task, the task name is "sdkapp", priority is 150, stack is 16KB.  
 After main() return, the "sdkapp" task will exit.  
 Usually, app should create it's own task.

## API introduce

- OS API

 API define: os_api.h  
 API sample: sample\01_task

- File API

 API define: file_api.h  
 API sample: sample\03_file

- ATCmd API

 API define: atclient.h  
 API sample: sample\04_atcmd

- HW API, include GPIO,UART

 API define: hal\gpio.h hal\uart.h  
 API sample: sample\05_gpio, sample\06_uart

- BSD style socket API

 API define: lwip\socket.h  
 API sample: sample\10_socket