浅谈Verilog HDL代码编写风格

       
 消失了长久,没有写篇,也不曾做速记,因为近来再度等到一个斗,时间非常拮据,昨天星期六到底终止了,所以随着周末这有日,写点东西,记录下来。首先我就学FPGA才同年多,我理解自己没有身份谈论一些较大层次的题材,对于这行当以来恐怕本身才是直脚踩在门外面。所以这首稿子是描写为有恰巧开头读书FPGA、Verilog
HDL的同校,我看罢一些大神写的代码,然后尽量模仿大神写法,经过好几单大神的熏陶与协调之惯搜索,最终算是总结发生了同样效仿自己之代码书写风格,当然我的代码风格或者直接于发展中。现在用好的一对经验总结出来,希望对刚刚起读书FPGA的爱人有所助。

SAPI:在逐一服务器抽象层之间遵守在同等的预定,这里我们称之为SAPI接口。例如命令行程序的落实,Apache的mod_php模块实现同fastcgi的兑现等等

        
首先,第一自或者如强调的是编辑器的来意,工欲善其事,必先利其器。之前整理了相同首,如何快速的修Verilog
HDL——菜鸟篇,点击查看。其中自介绍了利用notepad++的片段稍技巧,当然还有为数不少网友用gvim编辑器,对gVim编辑器,我吗询问了成千上万,虽然左侧比较累,但是同劳永逸,我事后为是打算上该编辑器的采用的,目前,时间较困难,所以尽管临时还先用notepad++吧。熟悉verilog的食指犹知晓,Verilog
HDL设计其实以20%底语法就好设计出90%以上的电路,其中最丰富用之饶是always块了,用软件自带的IDE的言辞编写效率其实是深不同之。所以说一个吓的随手的编辑器至关重要,对于咱们这些苦逼的艺工作者来说,经常看电脑屏幕一看便是一整天,然后还随时看,所以用Notepad++更换主题可以更好之啊革命保护视力,

1.结构体:
运用结构体(Struct)来存放在一组不同品种的数额
struct 结构体名{
结构体所包含的变量或数组
};
struct 结构体名 结构体变量名

  点击设置——语言格式设置,可安装编辑器主题图片 1

2.分子的获与赋值
结构体变量名.成员叫;

  这里我选的凡如图所示的主题,我较好是于暗的水彩,图片 2

3.结构体指针
struct 结构体名 *结构体变量名=&结构体变量名
动用结构体指针 ==> (*结构体变量名).成员名 ; 结构体变量名->成员叫

  最终呈现的机能就是如下图所示,是勿是圈起老舒适啊!图片 3

PHP源码:

        
第二、代码的端口命名、内部寄存器的命名。下图是咱近年来举行的品种,可以看出在端口多底景况下,端口的命名有多要,基本上由信号的命名就好直接联想到该信号的打算,同理,内部采用寄存器的命名为是如此。对于使用的网时钟命令最好是为此clk+后缀,加上时钟的频率。这样不仅自己扣起方便,别人看起为造福。因为不少情下,不同开发板的晶振是未等同的,但是编写者知道,其他人就不至于知道了。我还真的展现了always@(posedge
A or negedge B)这样勾画的总人口之,当然他呢是正开念了。

struct _sapi_module_struct {
    char *name;         //  名字(标识用)
    char *pretty_name;  //  更好理解的名字(自己翻译的)

    int (*startup)(struct _sapi_module_struct *sapi_module);    //  启动函数
    int (*shutdown)(struct _sapi_module_struct *sapi_module);   //  关闭方法

    int (*activate)(TSRMLS_D);  // 激活
    int (*deactivate)(TSRMLS_D);    //  停用

    int (*ub_write)(const char *str, unsigned int str_length TSRMLS_DC);
     //  不缓存的写操作(unbuffered write)
    void (*flush)(void *server_context);    //  flush
    struct stat *(*get_stat)(TSRMLS_D);     //  get uid
    char *(*getenv)(char *name, size_t name_len TSRMLS_DC); //  getenv

    void (*sapi_error)(int type, const char *error_msg, ...);   /* error handler */

    int (*header_handler)(sapi_header_struct *sapi_header, sapi_header_op_enum op,
        sapi_headers_struct *sapi_headers TSRMLS_DC);   /* header handler */

     /* send headers handler */
    int (*send_headers)(sapi_headers_struct *sapi_headers TSRMLS_DC);

    void (*send_header)(sapi_header_struct *sapi_header,
            void *server_context TSRMLS_DC);   /* send header handler */

    int (*read_post)(char *buffer, uint count_bytes TSRMLS_DC); /* read POST data */
    char *(*read_cookies)(TSRMLS_D);    /* read Cookies */

    /* register server variables */
    void (*register_server_variables)(zval *track_vars_array TSRMLS_DC);

    void (*log_message)(char *message);     /* Log message */
    time_t (*get_request_time)(TSRMLS_D);   /* Request Time */
    void (*terminate_process)(TSRMLS_D);    /* Child Terminate */

    char *php_ini_path_override;    //  覆盖的ini路径

    ...
    ...
};
cgi_sapi_module.startup(&cgi_sapi_module)   //  cgi模式 cgi/cgi_main.c文件

apache2_sapi_module.startup(&apache2_sapi_module);
 //  apache2服务器  apache2handler/sapi_apache2.c文件

static sapi_module_struct apache2_sapi_module = {
    "apache2handler",
    "Apache 2.0 Handler",

    php_apache2_startup,                /* startup */
    php_module_shutdown_wrapper,            /* shutdown */

    ...
}

        
复位信号吧直观只要,我习惯及勾的而是rst+后缀,高电平有效还是不及电平有效,rst_n(低电平有效negedge),rst_p(高电平有效posedge),我看罢局部题上的复位信号命名的是clr,其实这片种命名的办法向没区分,一般情况下,我们复位都是拿寄存器置数为0,也相当给清零,但也未拔除,复位是为置数的状况,所以我习惯及利用rst_n来复位,及低电平复位。

startup
当SAPI初始化时,首先会调用该函数。如果服务器处理多个请求时,该函数不过见面调用一糟糕。
比如Apache的SAPI,它是因mod_php5的Apache模块的花样加载到Apache中的,
在斯SAPI中,startup函数只于大进程中创造同坏,在其fork的子进程中莫会见调用。
activate
此函数会当每个请求开始经常调用,它见面另行初始化每个请求前的数据结构。
deactivate
此函数会于每个请求了时调用,它因此来管有的数额还,以及自由于activate中初始化的数据结构。
shutdown 关闭函数,它用来释放具有的SAPI的数据结构、内存等。
ub_write 不缓存的状操作(unbuffered
write),它是因此来用PHP的多少输出为客户端,
如在CLI模式下,其最后是调整用fwrite实现为专业输出输出内容;在Apache模块中,它说到底是调用Apache提供的办法rwrite。
sapi_error
报告错误用,大多数之SAPI都是使用的PHP的默认实现php_error。
flush
刷新输出,在CLI模式下通过利用C语言的库函数fflush实现,在php_mode5模式下,使用Apache的供的函数函数rflush实现。
read_cookie
以SAPI激活时,程序会调用此函数,并且用之函数获取的价赋值给SG(request_info).cookie_data。
在CLI模式下,此函数会回来NULL。
read_post
此函数和read_cookie一样啊是当SAPI激活时调用,它跟请求的法门有关,当求的章程是POST时,程序会操作$_POST、$HTTP_RAW_POST_DATA等变量。
send_header
发送头部信息,此道一般的SAPI都见面定制,其所不同之是,有些的会调服务器自带的(如Apache),有些的待你自己实现(如
FastCGI)。

  其他的信号吧即象是的,总结下上便是,给信号于一目了然的名,尽量使用缩写,不要信号的讳太长,信号的名字以及职能作用中间用生划线隔开,要习惯性的于信号后面编写注释,给你编的代码块做注解,给您编的模块做注解,请记住你的代码不是为您一个丁写的。图片 4

 

        
第三、代码的工。从高达图备受可以看出,我于概念端口的时是直接定义在module内部的,很多人口之写法是先期在module内部定义一全副端口,然后再度module下面再写一一体input/output定义,其实就半栽方式都可,那么我为什么选择直接写在module内部也,,,因为我懒啊。在编制代码的当儿差不多用空格和TAB,把定义之信号对伙同,这样描绘有代码是十分可观的,每一样段代码之间应该用分隔线隔开,这样整体看起老鲜明。图片 5

自家之习:

        
模块端口的实例化也是,这样的代码自己拘留在精彩,别人看在也痛快淋漓,而且打到往生看都见面十分懂得了。图片 6

#include <stdio.h>
int hello(int a){
        return a+100;
}
int main(){
        //定义结构体
        struct stu{
                char *name;
                int age;
                int (*sum)(int);
        };
        //1.赋值结构体
        struct stu student;
        student.age=10;
        student.name="taoshihan";
        student.sum=hello;
        //使用结构体成员
        printf("%d \n",student.sum(20));

        //2.另一种赋值结构体方式
        struct stu lstudent={
                "taoshihan",
                10,
                .sum=hello
        };
        printf("%s \n",lstudent.name);
        printf("%d \n",lstudent.sum(30));

        //3.结构体指针
        struct stu *rstudent=&student;
        //使用结构体指针
        printf("%s \n",(*rstudent).name);
        printf("%s \n",rstudent->name);


        //定义函数指针
        int (*h)(int)=hello;
        //使用函数指针
        printf("%d \n",(*h)(20));
}

       
第四、在筹划中大多实用时序逻辑,尤其是直用输出的端口。在自己近年开的不得了型里,我使用了有重组逻辑来做决定,但是后来意识这么会生出一个弊,每次系统上电的早晚会有一致段落非稳定时,在当下段时日里,我的那么几单操模块就无规则之当乱启动,即使是当复位的气象下,这样可能会见滋生部分劳神造成系统的不稳定,如果运用是时序逻辑的话,就全可免此题材了,在系统及电的当儿,复位低行,等及电稳定后,将复位键变为高电平。

 

     
 第五、如果一个工里,同一个宏定义需要在多个公文里调用的话,建议下调用文件。比如自己在描写VGA驱动之早晚,行扫描、场扫描以及各种颜色的定义参数需要以差不多个模块中动用,所以只是在模块内部一直写如下图所展示部分,把”`define”定义在一个独立的文件之中,”parameter”参数定义肯定得是于模块内部了,检查再定义。图片 7

图片 8

  第六、使用异步复位、同步置数的宏图思想(可以了解一下异步复位、同步释放),而且一个always块里,尽量值操作一个寄存器。一个模块的代码不要写的最好多,使用模块化设计,而且以顶层文件里尽量不了写代码,为了当检查RTL图的时候比较方便明了底视各个模块之间的连线图。模块内部不该运用中以,同一个模块内之钟表应该是暨一个钟驱动下之,如果要动别的时钟进行驱动的话,必须使时钟使能使无是时钟触发,保持所有always块是跟一个钟上升沿触发,如果确实要利用中时钟
门控时钟 或内部的复位信号
将它们位于顶层将这些信号的发生在顶层的一个单身模块
这样所有的子模块分别采取单一的钟和复位信号。对于下if——else
if——else或case语句必须将装有的情事都写上,避免生成锁存器。最根本的率先接触,寄存器类型的数码应来复位,我不习惯使用initial语句进行初始化,一般都是故异步复位来吧保全系统的稳定性。还有平时勾勒代码的早晚尽量不要采用for循环,当然有些必要之时光吗是可以为此的。

第七、如果您碰到实在糟糕解决的宏图,那么这个时,你虽可考虑一下状态机了。

        
我能够想到的当下就是只有这么多矣,还有啊是自我从来不想到了与自身举行的可以留言告知我。

图片 9

 

转载请注明出处:NingHeChuan(宁河川)

私家微信订阅号:开源FPGANingHeChuan

一经您想及时收到个人做的博文推送,可以扫描左边二维码(或者添加准识别二维码)关注个人微信订阅号

知乎ID:NingHeChuan

微博ID:NingHeChuan

原文地址:http://www.cnblogs.com/ninghechuan/p/7859690.html 

发表评论

电子邮件地址不会被公开。 必填项已用*标注

网站地图xml地图