刘氏

C99中的_Bool类型

2015-03-21T00:00:00+00:00

在读SDCC Compiler User Guide的时候读到下面一段：

bit and sbit types now consistently behave like the C99 _Bool type with respect to type conversion. The most common incompatibility resulting from this change is related to bit toggling idioms, e.g.:
bit b;
b = ~b; /* equivalent to b=1 instead of toggling b */
b = !b; /* toggles b */
In previous versions, both forms would have toggled the bit.

一直不明白说的什么意思，今天终于茅塞顿开。

首先，我们需要知道以下事实：

任何非零的值赋值给_Bool类型的变量b，b都会得到值1，而不会像其它unsigned类型的变量一样截取；
一元操作符~会对其操作数进行整数提升。

所以，即使b的值是1，~b首先会对b进行整数提升，再取反，结果肯定是一个非零值，在赋值给b，最终b的值还是1。

阅读笔记，2015年01月

2015-01-10T00:00:00+00:00

10 Jan

I. 配置PuTTY

原文：PuTTY configuration

由于历史的原因，PuTTY的默认配置不是很好用。上文提到了了几个最重要的配置，并介绍了其原理以及修改方法。

Emacs正则表达式中的换行

2015-01-10T00:00:00+00:00

在Emacs中，当时用正则表达式匹配换行的时候，发现输入\n是不行的，上网查了下，可以直接输入C-j。

参考网址：http://www.linuxsir.org/bbs/thread108556.html。

利用Ripple网络进行小额信用卡套现

2014-12-01T00:00:00+00:00

警告：实际操作前请仔细阅读你和发卡行签订的协议，笔者不为其背书。

本文有时效性（2014年12月）。

方法

在淘宝用信用卡向Ripple账户充值CNY；
从Ripple账户提现。

限额

500CNY/信用卡/月

总手续费

小于1%

Windows 64位配置Apache HTTPS服务器

2014-11-23T00:00:00+00:00

系统信息：Windows8.1 64位，Apache2.2。

Apache的配置文件写得还是很规范的，所以一开始改的时候就是跟着感觉走。

在conf/httpd.conf文件中分别找到下面两行，移除注释：

#LoadModule ssl_module modules/mod_ssl.so
#Include conf/extra/httpd-ssl.conf

如下面的示例所示，修改conf/extra/httpd-ssl.conf：

DocumentRoot "C:/Users/Jinchen/projects/github/ripple-client/build/bundle/web"
ServerName local.ripple.com:443
ServerAdmin jks@mrliu.org
SSLCertificateFile "C:/Program Files (x86)/Apache Software Foundation/Apache2.2/conf/server.crt"
SSLCertificateKeyFile "C:/Program Files (x86)/Apache Software Foundation/Apache2.2/conf/server.key"

这一步注意两点：

DocumentRoot配置的路径要和httpd.conf文件中的DocumentRoot和<Directory>一样；
默认配置下SSLcertificateKeyfile对应的文件是应该是未加密的。

如果使用加密的key，会出现类似如下的错误：

[Sun Nov 23 13:37:28 2014] [error] Init: SSLPassPhraseDialog builtin is not supported on Win32 (key file C:/Program Files (x86)/Apache Software Foundation/Apache2.2/conf/server.key)

还是httpd-ssl.conf：将

#SSLSessionCache         "dbm:C:/Program Files (x86)/Apache Software Foundation/Apache2.2/logs/ssl_scache"
SSLSessionCache        "shmcb:C:/Program Files (x86)/Apache Software Foundation/Apache2.2/logs/ssl_scache(512000)"

改为：

SSLSessionCache         "dbm:C:/Program Files (x86)/Apache Software Foundation/Apache2.2/logs/ssl_scache"
#SSLSessionCache        "shmcb:C:/Program Files (x86)/Apache Software Foundation/Apache2.2/logs/ssl_scache(512000)"

据说这是只有在64位机器上才需要的。如果不这样修改的话，Apache Service Monitor会显示如下错误：

The requested operation has failed!

直接运行httpd会出现类似如下的错误：

Syntax error on line 62 of C:/Program Files (x86)/Apache Software Foundation/Apache2.2/conf/extra/httpd-ssl.conf:
SSLSessionCache: Invalid argument: size has to be >= 8192 bytes

使用Goagent CA给你的证书签名

2014-11-08T00:00:00+00:00

直到2014年10月18号，GoAgent一直默认使用公开私钥的根证书。由于GoAgent的广泛使用，估计其还会广泛地存在很长一段时间。如果你能无障碍访问https://goagent-cert-test.bamsoftware.com/，请立即删除默认的CA.crt。

本文教你如何使用这个证书给你的网站颁发证书。例子中我会使用pi.mrliu.org这个域名。

我的系统信息

$ uname -a
Linux raspberrypi 3.12.31+ #720 PREEMPT Sat Nov 1 13:15:06 GMT 2014 armv6l GNU/Linux
$ openssl version
OpenSSL 1.0.1e 11 Feb 2013 (Library: OpenSSL 1.0.1j 15 Oct 2014)
$ python --version
Python 2.7.8

步骤

进入任意目录，并将CA.crt文件复制到这个目录。示例中，我用/openssl/path/代替这个目录。
为你的服务器生成密钥server.key：

$ openssl genrsa -des3 -out server.key 2048

生成签名请求文件server.csr：

$ openssl req -new -key server.key -out server.csr

填写信息时要注意Common Name这一项填你的域名，比如*.mrliu.org，*是通配符，表示签发给mrliu.org的所有子域名。还有你的邮件地址至少看上去合法。

生成一个序列号文件：

$ echo 01 > serial.txt

利用GoAgent CA为你的证书生成签名文件server.crt：

$ openssl x509 -req -days 1234 -in server.csr -CA CA.crt -out server.crt -CAserial serial.txt

将签名文件和私钥合并到一个server.pem文件中：

$ cat server.crt server.key > server.pem

测试

新建文件https-server.py，并写入如下内容：

#!/usr/bin/env python
## Jks Liu, https://mrliu.org/signing-certificate-with-goagent-ca/
## Take from https://gist.github.com/dergachev/7028596

## Change certfile path to yours.
## Root is required for port 443.

import BaseHTTPServer, SimpleHTTPServer
import ssl

httpd = BaseHTTPServer.HTTPServer(('', 443), SimpleHTTPServer.SimpleHTTPRequestHandler)
httpd.socket = ssl.wrap_socket (httpd.socket, certfile='/openssl/path/server.pem', server_side=True)
httpd.serve_forever()

注意修改其中的server.pem的地址。

运行测试服务器

$ sudo python https-server.py

修改你的hosts文件

注意是你客户端上的hosts文件。当然，客户端可以和你的服务器在同一个机器上。假设你服务器的ip为192.168.1.111。

在hosts中添加如下行：

192.168.1.111   pi.mrliu.org

打开你客户端的浏览器：

浏览：https://pi.mrliu.org。

阅读笔记，2014年11月

2014-11-05T00:00:00+00:00

05 Nov

I. 手工安装CTAN的宏包

参考文献：http://tex.stackexchange.com/a/73017/65422

我在使用Raspberry Pi的时候发现TeX Live的CTAN宏包版本都比较旧，并且软件源中也没有tlmgr工具，所以使用有些宏包时需要手动安装。

安装目录：

所有用户：使用kpsewhich -var-value TEXMFLOCAL可以得到为整个系统安装的路径，一般为/usr/local/share/texmf。
当前用户，使用kpsewhich -var-value TEXMFHOME可以得到为当前用户安装的路径，一般为~/texmf。
上面的路径我们称为<base dir>。

将下载的宏包解压到<base dir>/tex/latex/目录中，此时在<base dir>/tex/latex/<package name>目录中应该是相应的.sty和.cls文件；可选地，文档解压到<base dir>/doc/latex/。然后执行mktexlsr，为所有用户安装时需要sudo权限。

06 Nov

II. 在树莓派上WHEEZY上安装GCC 4.8

原文：GCC 4.8 ON RASPBERRY PI WHEEZY

树莓派当前源中的软件一般都比较旧，所以如果要使用较新版本的软件的话需要从测试版仓库中安装。目前，稳定版仓库代号叫WHEEZY，测试版仓库代号是JESSIE。我们可以将/etc/apt/sources.list中的wheezy全部改为jessie；也可以同时保留两个，然后再安装的时候选择。如保留两个，大致流程如下：

编辑/etc/apt/sources.list：

deb http://mirrordirector.raspbian.org/raspbian/ wheezy main contrib non-free rpi
deb http://archive.raspbian.org/raspbian wheezy main contrib non-free rpi
# Source repository to add
deb-src http://archive.raspbian.org/raspbian wheezy main contrib non-free rpi
deb http://mirrordirector.raspbian.org/raspbian/ jessie main contrib non-free rpi
deb http://archive.raspbian.org/raspbian jessie main contrib non-free rpi
# Source repository to add
deb-src http://archive.raspbian.org/raspbian jessie main contrib non-free rpi

编辑（新建）/etc/apt/preferences：

Package: *
Pin: release n=wheezy
Pin-Priority: 900
Package: *
Pin: release n=jessie
Pin-Priority: 300
Package: *
Pin: release o=Raspbian
Pin-Priority: -10

然后执行：

sudo apt-get update

以安装GCC 4.8 为例，执行：

sudo apt-get install -t jessie gcc-4.8 g++-4.8

安装完了之后默认的gcc版本并不是新安装的这个，所以还需执行如下命令以添加alternative configuration：

sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.6 20
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.8 50
sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-4.6 20
sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-4.8 50

如果你的gcc/g++已经有了alternative configuration（默认是没有的），在执行上面的命令之前应当先删除：

sudo update-alternatives --remove-all gcc 
sudo update-alternatives --remove-all g++

执行如下如下命令可以修改当前alternative configuration：

sudo update-alternatives --config gcc
sudo update-alternatives --config g++

09 Nov

III. 一个成功的Git分支模型

原文：A successful Git branching model
作者：Vincent Driessen，on Tuesday, January 05, 2010

本文介绍的版本控制系统Git的一种使用流程，值得一读。本文有多个中文翻译版本。

本文建议在开发中使用如下分支：master，develop，release，feature-xxx，hotfix。同时介绍了Bump Version脚本，以及在merge时使用--no-ff选项。

阅读笔记，2014年10月

2014-10-16T00:00:00+00:00

16 Oct

I. 什么样的软件值得信任

原文：Reflections on Trusting Trust

作者：Ken Thomps

本文通过self-reproducing程序引出编译器中的一种bug，通过某种方式可以让这个bug一直留在编译器中，即使我们在源代码中已经修改了这个错误。

所以，某个程序即使开放了源代码，也不应该完全信任它。除非其完全由你自己从头创建，包括其所有的构建工具，以及构建工具的构建工具，而在现实中这几乎是不可能的。

17 Oct

II. 构建Web应用

原文：The Twelve-Factor App

The twelve-factor app是一个构建SaaS（即Web应用）的方法论。

本文从1. 代码库，2. 依赖，3. 软件配置，4. 后端服务（如数据库），5. 构建，发布，运行，6. 进程，7. 端口绑定，8. 并发，9. 可处理性（稳健，快速运行，优雅地关闭），10. 开发与产品的等价，11. 日志，12. 管理过程，等十二个方面全面描述了构建SaaS的过程中应当注意的事项。

其主要有以下几个原则:

使用一个VCS
不用隐含地依赖一个系统的包（或库）
将配置储存在环境变量中
不管是使用本地服务还是第三方服务（如数据库），代码应该是一样的
严格分离构建，发布和运行
进程应该是无状态的，且不分享任何东西
应用应当是自包含的
应用以绑定到端口的服务导出HTTP
进程是一等公民
进程可以随时的开启和关闭
进程的开启时间应该尽量的短
进程应当在接受到SIGTERM时应该优雅地关闭
进程应当是健壮的，并努力避免突然的关闭
开发和产品之间的差距应尽可能地小，以使得应用是可持续部署的
反对在开发和产品中使用不同的后端服务
应用不该关心其Log存储形式

28 Oct

使用Clojure写Web应用

原文：Web Application Development with Clojure

作者：Vijay Kiran

全文分为5个部分：

第一部分讲解了如何建立新的工程。
第二部分介绍了数据库层。包括使用Lobos库莱建立数据库的Schema和Migrations。以及使用Korma来建立数据库的入口。
第三部分介绍了使用Fixture来建立数据库的测试数据，以及使用Enlive来建立Html模板。
第四部分结束了CSS的使用以及静态文件的部署。并结束了一个简单的认证逻辑。
第五部分简单介绍了管理员区域以及Session的使用。

单片机软件构架

2014-06-21T00:00:00+00:00

单片机程序相比于普通的程序有以下几个方面的不同。

中断程序
驱动程序
多任务

C语言发展至今已相当成熟，所以本文以C语言为基础，尽量避免汇编。

基本结构

大部分人学习单片机是从51开始的，并且好多人除了51也不会其他的单片机。

下面是一个单片机程序的基本结构。

int main(void) {
    Initialize();

    while (1) {
        DoSomething();
    }
}

驱动程序

由于单片机资源有限，所以在编写单片机驱动的时候不可能像Linux设备驱动那样考虑十分周全。面对具体的场景（Scenario），有时我们需要不同的决策。

可移植性

大部分的普通程序员都有一定的完美主义者倾向，这方面单片机程序员稍微好一点。

可移植性是一个大问题，单片机程序的可移植性更加是个问题。

当编写可移植程序的时候，你需要决定你的程序有多少的可移植性。有人看到这可能会觉得有些奇怪，程序要么可移植，要么不可移植，何来多少。但当你考虑到以下这些问题时候，你就可以明白我为什么要这么说。

你的驱动程序是只用在同一类单片机内可移植，还是要在不同的单片机之间可以移植？
你的驱动程序是只支持某一个特定的编译器还是想要支持所有的主流编译器？
你的驱动程序是否需要支持多任务操作系统？
你的驱动程序如何处理样硬件中断？

当你考虑到这些问题的时候，问题已经变得很复杂了。而这些，都是你在写之前需要决策的。当然，很少有人注意到这些问题，大部分人觉得不用汇编就不错了，C语言写得脏就脏一点，能跑起来就行。

如何使用

既然我们是在谈写好一个驱动程序，当然是希望一次编写，多次使用了。但当你的驱动程序用在不同的地方的时候，你是希望无需修改，通过正确的配置就可以直接使用，还是希望简单一点，把配置硬编码到代码中，每次使用都根据具体的应用修改？

不用修改直接使用当然是最好的，但有时我们会发现这几乎是不可能的。

多实例

你本来精心编写了一个驱动程序，并且运行得很好。但是突然出现了新的需求：在系统中添加一个相同的设备。然而这时你悲剧地发现，你的配置（比如引脚配置）是硬编码在程序中的。

这时，要么重写所有的驱动，要么把原来的代码复制粘贴一份，再将里面所有的全局函数和变量重命名。不管是哪种方法，都会让人感到沮丧。

多余的功能

由于单片机的资源往往是有限的，你准备如何处理不使用的功能。

说了这么多，还是动手实践吧。

所有程序都经过测试（实物或Proteus）。

比如我们现在要写一个LCD1602的程序，首先，我们来进行上面的决策。既然是说明，那我就挑选最难的。

支持多个编译器
支持多种体系结构
支持多实例
无需修改库程序，配置后直接使用
支持屏蔽多余的功能
支持多线程

你可以在LCD1602@GitHub下载完整的驱动程序代码；软件框架可以在SCM Software Architecture@GitHub下载。

首先新建两个文件：LCD1602.c和LCD1602.h（点击查看完整内容）。

在LCD1602.h中，首先找到下面这一句：

#include "software-config.h"

由于我们要让这个驱动库在所有的硬件框架下可用，所以我们没有包含特定于任何芯片的头文件，比如reg51.h。我们包含了一个software-config.h，库的使用者有责任创建这个头文件，我们把这当作库的作者和使用者的一个约定就好。

但是，让用户去实现这个software-config.h，就相当于把复杂性强加给了用户，所以我们在上面提供了一个框架代码。这个框架为常见的单片机提供模板，以使编写software-config.h更加容易。

一般来说和硬件有关的配置是将某一个GPIO置位或复位，对于不同的单片机，语法一般是不一样的。对于驱动的编写者，我们可以为每一个单片机都编写一遍代码，也可以将这个问题抛给用户，用户只需对其特定的单片机编写代码。从用户方便的角度来讲，驱动的作者完成所有的工作当然是最好的，但这几乎是不现实的，因为驱动作者不可能熟悉每中单片机，更何况每种单片机在不同的编译器下语法也是不一样的。所以，只给常见单片机和和常见编译器编写算是一个折中。

LCD1602液晶显示器一般使用HD44780驱动芯片，此芯片支持8位和4位数据总线。所以我们的驱动程序也支持这两种模式。使用何种模式在software-config.h中配置。对于这种二选一的配置，一般有两种方法。

两个define二选一要求在software-config.h中在#define HD44780_USE_8BIT和#define HD44780_USE_8BIT这两个宏定义中二选一。
有一个默认值当什么都没有定义的时候，默认使用8位模式。如果定义了HD44780_USE_4BIT，则使用4位的总线模式。

这两种方法各有优缺点，方法2相对来说比较简单，

SDCC 101

2013-05-09T00:00:00+00:00

前言

一般国内的51教科书讲的都是keil, 但是， keil是一个商业软件，于是便写了这样一个教程。

预备知识

假设你会C语言的基本语法和一些电学的基础知识。既然这是51的教程，自然假设你对51一点都不了解。

内容提要

先讲解单片机的基础知识，再讲解一个简单C语言的例子。简单讲讲协议和标准。然后讲sdcc的安装和使用。再讲讲中断和串口。接着是code::blocks和eclipse的使用。可能我还会讲讲模拟器，可能的话我会讲讲程序的下载。

刘氏