Volatile的陷阱(转)

retome · 发表于 2012-9-16 11:08:14

本帖最后由 retome 于 2012-9-16 18:29 编辑

最近写的关于在嵌入式开发中常遇到的关于volatile关键字使用的短文，都是些通用的技术，贴上来share。
对于volatile关键字，大部分的C语言教材都是一笔带过，并没有做太过深入的分析，所以这里简单整理了一些关于volatile的使用注意事项。实际上从语法上来看volatile和const是一样的，但是如果const用错，几乎不会有什么问题；而volatile用错，后果可能很严重。所以在volatile的使用上，建议大家还是尽量求稳，少用一些没有切实把握的技巧。
注意volatile修饰的是谁
首先来看下面两个定义的区别：

uchar * volatile reg;这行代码里volatile修饰的是reg这个变量。所以这里实际上是定义了一个uchar类型的指针，并且这个指针变量本身是volatile 的。但是指针所指的内容并不是volatile的！在实际使用的时候，编译器对代码中指针变量reg本身的操作不会进行优化，但是对reg所指的内容 *reg却会作为non-volatile内容处理，对*reg的操作还是会被优化。通常这种写法一般用在对共享指针的声明上，即这个指针变量有可能会被中断等函数修改。将其定义为volatile以后，编译器每次取指针变量的值的时候都会从内存中载入，这样即使这个变量已经被别的程序修改了当前函数用的时候也能得到修改后的值（否则通常只在函数开始取一次放在寄存器里，以后就一直使用寄存器内的副本）。

volatile uchar *reg;这行代码里volatile修饰的是指针所指的内容。所以这里定义了一个uchar类型的指针，并且这个指针指向的是一个volatile的对象。但是指针变量本身并不是volatile的。如果对指针变量reg本身进行计算或者赋值等操作，是可能会被编译器优化的。但是对reg所指向的内容 *reg的引用却禁止编译器优化。因为这个指针所指的是一个volatile的对象，所以编译器必须保证对*reg的操作都不被优化。通常在驱动程序的开发中，对硬件寄存器指针的定义，都应该采用这种形式。

volatile uchar * volatile reg;这样定义出来的指针就本身是个volatile的变量，又指向了volatile的数据内容。

volatile与const的合用
从字面上看，volatile和const似乎是一个对象的两个对立属性，是互斥的。但是实际上，两者是有可能一起修饰同一个对象的。看看下面这行声明：

extern const volatile unsigned int rt_clock;这是在RTOS系统内核中常见的一种声明：rt_clock通常是指系统时钟，它经常被时钟中断进行更新。所以它是volatile，易变的。因此在用的时候，要让编译器每次从内存里面取值。而rt_clock通常只有一个写者（时钟中断），其他地方对其的使用通常都是只读的。所以将其声明为 const，表示这里不应该修改这个变量。所以volatile和const是两个不矛盾的东西，并且一个对象同时具备这两种属性也是有实际意义的。

  注意
在上面这个例子里面，要注意声明和定义时对const的使用：

在需要读写rt_clock变量的中断处理程序里面，应该如下定义（define）此变量：

volatile unsigned int rt_clock;而在提供给外部用户使用的头文件里面，可以将此变量声明（declare）为：

extern const volatile unsigned int rt_clock;这样是没有问题的。但是切记一定不能反过来，即定义一个const的变量：

const unsigned int a;但是却声明为非const变量：

extern unsigned int a;这样万一在用户函数里面对a进行了写操作，结果是Undefined。

再看另一个例子：

volatile struct devregs * const dvp = DEVADDR;这里的volatile和const实际上是分别修饰了两个不同的对象：volatile修饰的是指针dvp所指的类型为struct devregs的数据结构，这个结构对应者设备的硬件寄存器，所以是易变的，不能被优化的；而后面的const修饰的是指针变量dvp。因为硬件寄存器的地址是一个常量，所以将这个指针变量定义成const的，不能被修改。

危险的volatile用法
下面将列举几种对volatile的不当使用和可能导致的非预期的结果。

例：定义为volatile的结构体成员

考察下面对一个设备硬件寄存器结构类型的定义：

struct devregs{
unsigned short volatile csr;
unsigned short const volatile data;
};我们的原意是希望声明一个设备的硬件寄存器组。其中有一个16bit的CSR控制/状态寄存器，这个寄存器可以由程序向设备写入控制字，也可以由硬件设备设置反映其工作状态。另外还有一个16bit的DATA数据寄存器，这个寄存器只会由硬件来设置，由程序进行读入。

看起来，这个结构的定义没有什么问题，也相当符合实际情况。但是如果执行下面这样的代码时，会发生什么情况呢？

struct devregs * const dvp = DEVADDR;

while ((dvp->csr & (READY | ERROR)) == 0)
; /* NULL - wait till done */通过一个non-volatile的结构体指针，去访问被定义为volatile的结构体成员，编译器将如何处理？答案是：Undefined！C99 标准没有对编译器在这种情况下的行为做规定。所以编译器有可能正确地将dvp->csr作为volatile的变量来处理，使程序运行正常；也有可能就将dvp->csr作为普通的non-volatile变量来处理，在while当中优化为只有开始的时候取值一次，以后每次循环始终使用第一次取来的值而不再从硬件寄存器里读取，这样上面的代码就有可能陷入死循环！！

如果你使用一个volatile的指针来指向一个非volatile的对象。比如将一个non-volatile的结构体地址赋给一个 volatile的指针，这样对volatile指针所指结构体的使用都会被编译器认为是volatile的，即使原本那个对象没有被声明为 volatile。然而反过来，如果将一个volatile对象的地址赋给一个non-volatile的普通指针，通过这个指针访问volatile对象的结果是undefined，是危险的。

所以对于本例中的代码，我们应该修改成这样：

struct devregs {
unsigned short csr;
unsigned short data;
};

volatile struct devregs * const dvp = DEVADDR;这样我们才能保证通过dvp指针去访问结构体成员的时候，都是作为volatile来处理的。

例：定义为volatile的结构体类型

考察如下代码：

volatile struct devregs {
/* stuff */
} dev1;
......;
struct devregs dev2;作者的目的也许是希望定义一个volatile的结构体类型，然后顺便定义一个这样的volatile结构体变量dev1。后来又需要一个这种类型的变量，因此又定义了一个dev2。然而，第二次所定义的dev2变量实际上是non-volatile的！！因为实际上在定义结构体类型时的那个 volatile关键字，修饰的是dev1这个变量而不是struct devregs类型的结构体！！

所以这个代码应该改写成这样：

typedef volatile struct devregs {
/* stuff */
} devregs_t;

devregs_t dev1;
......;
devregs_t dev2;这样我们才能得到两个volatile的结构体变量。

例：多次的间接指针引用

考察如下代码：

/* DMA buffer descriptor */
struct bd {
unsigned int state;
unsigned char *data_buff;
};

struct devregs {
unsigned int csr;
struct bd *tx_bd;
struct bd *rx_bd;
};

volatile struct devregs * const dvp = DEVADDR;

/* send buffer */
dvp->tx_bd->state = READY;
while ((dvp->tx_bd->state & (EMPTY | ERROR)) == 0)
; /* NULL - wait till done */这样的代码常用在对一些DMA设备的发送Buffer处理上。通常这些Buffer Descriptor（BD）当中的状态会由硬件进行设置以告诉软件Buffer是否完成发送或接收。但是请注意，上面的代码中对dvp->tx_bd->state的操作实际上是non-volatile的！这样的操作有可能因为编译器对其读取的优化而导致后面陷入死循环。

因为虽然dvp已经被定义为volatile的指针了，但是也只有其指向的devregs结构才属于volatile object的范围。也就是说，将dvp声明为指向volatile数据的指针可以保障其所指的volatile object之内的tx_bd这个结构体成员自身是volatile变量，但是并不能保障这个指针变量所指的数据也是volatile的（因为这个指针并没有被声明为指向volatile数据的指针）。

要让上面的代码正常工作，可以将数据结构的定义修改成这样：

struct devregs {
unsigned int csr;
volatile struct bd *tx_bd;
volatile struct bd *rx_bd;
};这样可以保证对state成员的处理也是volatile的。不过最为稳妥和清晰的办法还是这样：

volatile struct devregs * const dvp = DEVADDR;
volatile struct bd *tx_bd = dvp->tx_bd;

tx_bd->state = READY;
while ((tx_bd->state & (EMPTY | ERROR)) == 0)
; /* NULL - wait till done */这样在代码里面能绝对保证数据结构的易变性，即使数据结构里面没有定义好也不会有关系。而且对于日后的维护也有好处：因为这样从代码里一眼就能看出哪些数据结构的访问是必须保证volatile的。

例：到底哪个volatile可能无效

就在你看过前面几个例子，感觉自己可能已经都弄明白了的时候，请看最后这个例子：

struct hw_bd {
......;
volatile unsigned char * volatile buffer;
};

struct hw_bd *bdp;

......;
bdp->buffer = ...; ①
bdp->buffer = ...; ②请问上面标记了①和②的两行代码，哪个是确实在访问volatile对象，而哪个又是undefined的结果？

答案是：②是volatile的，①是undefined。来看本例的数据结构示意图：

      (non-volatile)
bdp -->+-------------+
      |          |
      | ... ... |
      |          |
      +-------------+ (volatile)
      | buffer |-->+------------+
      +-------------+ |          |
                        |          |
                        |          |
                        +------------+
                        |  buffer |
                        +------------+
                        |          |
                        |          |
                        +------------+buffer成员本身是通过一个non-volatile的指针bdp访问的，按照C99标准的定义，这就属于undefined的情况，因此对bdp->buffer的访问编译器不一定能保证是volatile的；
虽然buffer成员本身可能不是volatile的变量，但是buffer成员是一个指向volatile对象的指针。因此对buffer成员所指对象的访问编译器可以保证是volatile的，所以bdp->buffer是volatile的。

所以，看似简单的volatile关键字，用起来还是有非常多的讲究在里面的，大家一定要引起重视。

js200300953 · 发表于 2012-9-16 11:55:27

禁止转载

retome · 发表于 2012-9-16 18:30:13

js200300953 发表于 2012-9-16 11:55

totest2 · 发表于 2012-9-16 20:11:15

不错的总结

farmerzhangdl · 发表于 2012-9-16 21:28:11

总觉得C语言把volatile这个搞得太复杂了，上位机开发的时候从来没用过这个关键字

bangbangji · 发表于 2012-9-16 22:10:25

讲的很细。呵呵。。。
不过实际这么用的不多啊。一般自己写程序，有几个变量需要volatile就差不多了，实在要用指针的参考寄存器定义的方法，基本就够用了。

x11223y · 发表于 2012-9-16 22:18:00

这个写的很好

fshunj · 发表于 2012-9-16 22:24:34

struct hw_bd {
......;
volatile unsigned char * volatile buffer;
};

struct hw_bd *bdp;

......;
bdp->buffer = ...; ①
bdp->buffer = ...; ②请问上面标记了①和②的两行代码，哪个是确实在访问volatile对象，而哪个又是undefined的结果？

答案是：②是volatile的，①是undefined。

fshunj · 发表于 2012-9-16 22:25:09

这里写错了吧

ideality0214 · 发表于 2012-9-16 23:06:17

学习一下

xizi · 发表于 2012-9-16 23:12:16

同问：

bdp->buffer = ...; ①
bdp->buffer = ...; ②

仔细地按标点、字母对比，也没发现这两行有啥不同？（只是后面的注释不同而已）

xizi · 发表于 2012-9-16 23:13:03

请lz提供链接。

xizi · 发表于 2012-9-16 23:15:14

我猜应该是：
bdp->buffer = ...; ①
*（bdp->buffer） = ...; ②
这样答案就对了：
②是volatile的，①是undefined。

tangguanglun · 发表于 2012-9-16 23:27:48

讲得细，学些了

uzufk · 发表于 2012-9-17 09:43:49

学习了！

edkaifa · 发表于 2013-1-25 16:34:37

很值得看谢谢分享

Elec_Ramble · 发表于 2013-1-26 09:39:15

学习了……
来自：amoBBS 阿莫电子论坛 Windows Phone 7 客户端

mysunmax · 发表于 2013-1-26 10:15:33

学习学习，有链接么?

Xplain · 发表于 2013-1-26 22:25:54

值得一看

lu976046395 · 发表于 2013-8-7 13:24:41

学习了

zlpvch · 发表于 2013-8-7 13:28:02

写得很好啊

zlpvch · 发表于 2013-8-7 13:28:25

平时都没有注意

xranger · 发表于 2014-3-3 09:39:17

博大精深的C

zt_ustb · 发表于 2014-3-5 11:57:17

有时间再来看

Xplain · 发表于 2014-3-6 22:12:44

mark,不错的文章(volatile, const)

xCamel · 发表于 2014-3-7 00:01:11

学习一下

kevin_me · 发表于 2014-3-7 00:51:15

留名备用

kingqb · 发表于 2014-3-7 08:48:52

mark 学习了

chinaboy25 · 发表于 2014-3-7 09:03:56

感觉加深了了

木君之上 · 发表于 2014-3-7 10:17:52

挺好的的，学习了，

dushanwu522 · 发表于 2014-3-7 11:50:08

总结的真好，学习了！！！

LVmcu · 发表于 2014-3-7 13:01:47

谢谢楼主总结！

myxiaonia · 发表于 2014-3-7 16:15:49

哈哈，转自猪哥的博客，转载要注明出处嘛

wangle315065 · 发表于 2014-3-7 16:21:09

经典。。。。。。。

hzsky412 · 发表于 2014-3-9 22:02:07

很好，涨知识了。我简单试验了一下，volatile数据的地址复制给没有volatile的指针时，IAR最新的会报错误，而MDK会有警告。

mqhrzy09 · 发表于 2014-3-14 21:29:08

bdp->buffer = ...; (1)
bdp->buffer [ i ] = ...; (2)
原文出处：http://blog.163.com/zhaojie_ding ... 8952007925115019663

ggchao · 发表于 2014-3-31 16:08:38

不涉及操作系统的话，硬件寄存器要用volatile，中断中修改的变量要用volatile；设计到操作系统的话，多任务的共享变量也要用volatile，太复杂了反而不易懂

prozmx · 发表于 2014-3-31 16:21:01

654705188 · 发表于 2014-4-9 10:24:42

好东西啊

jiwx2011 · 发表于 2014-4-9 11:02:28

不错的总结

jiwx2011 · 发表于 2014-4-9 11:02:59

不错的总结。。

prow · 发表于 2014-4-9 12:38:32

Volatile mark

565715470 · 发表于 2014-4-9 17:13:59

很好，讲的清楚，发现了自己C语言很菜

andmain999 · 发表于 2014-6-11 10:23:04

学习学习。。

hcf83098 · 发表于 2014-6-11 17:38:06

记号

lingdianhao · 发表于 2014-6-14 22:33:34

以前就一直在直接用，没想到还有这么多陷阱啊！

gancai · 发表于 2014-6-19 11:44:43

mark!!!!!!!!

wkong501 · 发表于 2014-6-30 18:15:08

谢谢分享，先收藏了，希望还记得回头看

unnormal · 发表于 2014-7-10 15:37:17

rockyyangyang · 发表于 2014-7-10 18:30:13

mark

成就与价值 · 发表于 2014-7-10 20:38:35

学习了，谢谢楼主！

bjdfdh271006 · 发表于 2014-8-4 07:00:05

写的不错，谢谢。

tigerman520 · 发表于 2014-8-4 07:38:11

值得，学习啦。

zhongjp85 · 发表于 2014-8-4 08:43:00

volatile 注意 mark

songjie · 发表于 2014-8-27 23:46:06

Volatile的陷阱(转)

bondxie3 · 发表于 2014-9-5 17:59:47

volatile总结,标记学习.

bli19 · 发表于 2014-9-7 01:28:52

本帖最后由 bli19 于 2014-9-7 01:52 编辑

哦。。。对啊，volatile 在用来修饰指针变量确实很有用。

我细看了下，也提到了并用const的问题。

ccje · 发表于 2014-9-7 08:40:45

挺好的的，学习下，

LiuCH · 发表于 2014-9-7 08:44:44

比较复杂，慢慢看看！！

ddz123abcdef · 发表于 2014-9-7 18:02:14

学习了+10086

baoqi · 发表于 2014-9-7 18:50:29

很少用这个，学习一下

cjc2010 · 发表于 2014-9-9 08:18:55

好啊

www378660084 · 发表于 2014-9-9 09:25:02

很实用

iqxt88 · 发表于 2014-9-12 13:23:42

顶，支持，谢了！

易尘 · 发表于 2014-9-12 13:44:55

支持一下

sitply · 发表于 2014-9-14 13:57:29

正好是我需的，谢谢！

s1j2h3 · 发表于 2014-9-28 12:43:10

高深莫测

domt · 发表于 2014-9-28 12:58:21

确实不错

7nian · 发表于 2014-9-28 14:54:36

mark

zhouq3132 · 发表于 2014-9-28 15:47:31

谢谢楼主

lj11hy · 发表于 2014-9-28 18:37:52

gouxiong · 发表于 2014-9-28 18:58:52

收藏了先以后会用到

qumei · 发表于 2014-9-28 21:08:31

总结不错，收藏先

songdalong · 发表于 2014-10-24 16:10:51

初学C，对后面的一些描述还看不懂，先收藏。

retome · 发表于 2014-10-25 16:36:24

retome · 发表于 2014-10-25 16:36:40

一起努力

风云天 · 发表于 2014-10-26 23:04:57

很好，不错

GodHunter · 发表于 2014-10-27 08:23:31

学习了，以前只要是易变的量我都加它。

zyjbcnmdb · 发表于 2014-10-27 08:38:23

学习了，楼主辛苦了。

qiushui_007 · 发表于 2014-10-27 08:44:18

很详细很仔细

重庆酱油仔 · 发表于 2014-10-27 08:46:01

MARK住了，volatile陷阱。

linux-0405209 · 发表于 2014-10-27 08:49:46

赞一个~~~很好的总结

蓝蓝的恋 · 发表于 2014-10-27 08:57:50

这个必须先顶在看~

xuxueliang · 发表于 2014-10-27 09:10:41

有点太复杂，容易用错的东西尽量少用，系统才稳定

比特 · 发表于 2014-10-27 09:16:05

有空再细细看。。。

LiuCA · 发表于 2014-10-27 09:32:12

感谢楼主分享，学习了

qqfirer · 发表于 2014-12-12 18:52:22

C语言果然常看常新

yzh · 发表于 2014-12-12 20:35:41

不错，看完这个，对volatile有了更进一步的认识，谢谢分享！

vmalloc · 发表于 2014-12-12 21:24:14

第一次用这个是在arm9上，总结得不错

0957 · 发表于 2014-12-19 14:13:39

讲的太详细了。
以前用volatile，只是告诉编译器不优化这个变量。

乌托青年 · 发表于 2014-12-19 15:01:44

学习，3Q

niu14789 · 发表于 2014-12-19 16:00:08

讲的很细，受益良多 thanx

moxue10 · 发表于 2014-12-19 21:38:36

谢谢楼主

mk_avatar · 发表于 2014-12-19 22:59:34

nice 的总结啊~~~~~~

unnormal · 发表于 2014-12-20 08:45:20

学习了不错

蓝蓝的恋 · 发表于 2014-12-20 09:17:14

再看一遍，从细节做起~

zhongsandaoren · 发表于 2014-12-20 09:39:35

平时没有这么仔细总结过

helloforworld · 发表于 2015-1-19 17:10:01

瞬间豁然开朗了，谢谢楼主

SealedGhost · 发表于 2015-1-26 11:29:41

讲了很多没注意过的东西

tjcf · 发表于 2015-1-26 12:29:27

学习一下！！！！

Volatile的陷阱(转)

阿莫论坛20周年了！感谢大家的支持与爱护！！