sharpxcb的笔记 https://bbs.21ic.com/?321853 [收藏] [复制] [RSS]

日志

软件设计规范

已有 567 次阅读2010-9-30 05:35 |系统分类:单片机| 规范, 软件设计

以下是之前工作的公司firmware中个人认为较好的一套规范,权且与各位分享:
  所有分位,若旗标及缓存器用途相同,则用同一种名称,若之前尚未定议使用过之名称,则需提出申请!并依照此规范所订定之准则命名,名称皆需与该缓存器之用法有关!不得使用无关之名称!

(
)CPU定义 IO脚规范
□□□_□□□□□□□□
第一个字符代表PORT 的简写,即是I/O PIN与旗标的分别
第二个字符为PORTA PORTB PORTC A B C,用来区分哪一组IO
第三个字符为INPUT OUTPUT A/D …………用来区分那一种功能
第四个字符为_用来区隔名称
后面八个空格为名称 最小以三个字符,最多到八个字符

(
)CPU 定义旗标
□_□□□□□□□□
第一个字符为F,代表旗标
第二个字符为_,用来区隔名称
后面八个空格为名称 最小以三个字符,最多到八个字符

(
) CPU缓存器定义
□□□□□□□□_□□□□
以十三个字符为限,最后四个字符为型别加数字,倒数第五个字符为底线;若同类型缓存器(例接收缓存器)则最后一个字符为数字0依次排列;前面八个字符为名称定义.
(1)
公用缓存器定义
中断子程序为I_BANK0_WRK0 BANK00代表BNK0,BANK1 则为BANK1 WRK1则为名称数字,数字可依次累加,主程序为M_BANK0_WRK0,B00 代表BANK0, BANK1则为BAN1,WRK1则为名称数字,数字可依次累加
(2)
计数器以CNT结尾 A/D采样的值以DAT结尾,备份上一次的值以BAK结尾,实时使用以REG 结尾,指针式缓存器以PTR做结尾,只有短时间的存在有效则为TMP结尾,定时器以TIM结尾,在一个周期到达之后才需放到指定的地方以BUF结尾,FLAGFLG结尾
(3)
A/D值的电压回授为直流则以V为称,若为链波则以AV , LINE_AV_DAT 
LINE_V_DAT

(
)常数定义

□_□□□□□□□□
第一个字符为C,底线用来区分名称,后面为八个字符,主程序及中断程序里,不可有数字出现!

(
)子程序及卷标定义
□□□□_□□□□□□□□
以十三个字符为限,初始程序设定以 INIT_ 开头,中断才用到之子程序以中断名称为开头例 CCP2_□□□□□□□□ 后面八个字符为名称,主程序则不用开头命名!但仍以十三个字符为最大字数

路过

鸡蛋

鲜花

握手

雷人

评论 (0 个评论)