atommann: 2017

2017年10月3日星期二

在 Docbook 中给源代码加语法高亮

想用 Docbook 写一篇编程方面的教程，并加上 syntax highlighting 方便代码阅读，没想到这个任务并不容易。

GNU/Linux
========
Fedora 24, dnf install saxon 安装的是 saxon-9.4.0.9-2.fc24.noarch
而 saxon 9 只支持 XLST 2 而不是以前的 version 1, 然后我试图安装 docbook xslt20-stylesheets 也不成功。

回到 Windows
=========
按照 [1] 中的方法，在 Windows 7 中实验成功。

回到 GNU/Linux
==========
1. 下载 docbook-xsl-1.79.1
https://sourceforge.net/projects/docbook/files/docbook-xsl/

2. 下载 XSLT 1.0 proccessor
http://saxon.sourceforge.net/#F6.5.5

3. 下载 XSLT syntax highlighting (Java based XSLT Processor extension for syntax highlighting)
https://sourceforge.net/projects/xslthl/

4. 把它们解压放在某个目录里，比如我放到 ~/docbook 目录里。

~/docbook/docbook-xsl-1.79.1
~/docbook/saxon6-5-5
~/xslthl-2.1.3

5. 然后就可以用 Gary 的文件来做测试了。

我把测试的文件放在了 github 上，见 [4].

本文基本是按照链接 [1] 中 Gary 的方法操作，只是他在 Windows 中，我是在 GNU/Linux 中。

另外，saxon 在我电脑上生成 html 的速度很慢，我估计是 java 的原因。要知道 xsltproc 的速度是很快的！

在 my_article.xsl 文件里我加了一句
<xsl:param name="use.extensions" select="1"></xsl:param>
这样在命令行就不需要再加 use.extensions=1 了。

参考
[1] DocBook 的 Line Numbering 和 Code Highlighting
http://garyliutw.blogspot.jp/2013/07/docbook-line-numbering-code-highlighting.html
很有用的文章，我是看了这篇文章才成功了。

[2] https://github.com/docbook/xslt20-stylesheets

[3] Installing an XSLT processor
http://www.sagehill.net/docbookxsl/InstallingAProcessor.html
docbook 的 xml 文件可以用各种处理器来处理，上面的文档讲了安装和使用方法。

[4] https://github.com/atommann/syntax-highlighting-line-no-test-docbook

[5] Show me your highlighted code
http://xmlguru.cz/2006/07/docbook-syntax-highlighting
最后讲了如何定制。

[6] 10.1. Syntax Highlighting
http://www.vogella.com/tutorials/DocBook/article.html
讲如何定制自己的高亮颜色。

2017年9月30日星期六

在 C 中把数组作为参数传递

这是一个老问题了，下面这篇文章用简单的实例做了解答。

https://www.cypherpunk.at/2016/01/passing-arrays-as-parameter-in-c/

2017年8月26日星期六

STM8 eforth 实验

在 W1209 温控板上(板上的 MCU 是 STM8S003F3P6)测试了 eForth，可以工作，还需做更多实验。

计算机收到的一些字符显示不正常，原因不明，难道是因为没有用外部晶振导致的 timing 问题？例如，从串口发送 1 out! 到 stm8 后，返回的字符是 b outB ok, 而下面发送的 0 out! 返回又正常。

上图是把串口和 USB to TTL 板连接起来做通讯。STM8 上的 UART 被 NTC 占用了。于是用连接按键的 IO 模拟了一个 UART. 软件里有个目录是 W1209-FD, FD 的意思是 Full-Duplex，就是模拟全双工通讯。

接线：

+--------------+-------------------+----------+
| TTY com port | W1209-FD          | comments |
+--------------+-------------------+----------+
| GND          | GND               |          |
+--------------+-------------------+----------+
| TXD          | key "+"(PC4, RXD) | 2nd key |
+--------------+-------------------+----------+
| RXD      | key "-"(PC5, TXD) | 3rd key |
+--------------+-------------------+----------+

上面是测试 Leo Brodie 的书 Starting Forth 第一章中的例子。

链接

eForth for STM8S Value Line and Access Line devices

2017年8月25日星期五

内置 STM8S003F3 的 ESP-14 WiFi 模块

ESP-14 WiFi 模块内置 STM8S003F3 MCU(20 Pin QFN 封装). 可以用 eforth 编程。

ESP8266-14 Shield Removed

照片取自 ESP8266 Community Wiki，右下角的 IC, marking 是 S033, 也就是 UFQFPN20 的 STM8S003F3U6.

想法
- 用在 SZDIY Hackspace 的 IoT 项目上，如电表项目 Duo.

参考

2017年8月22日星期二

CO2 传感器 MH-Z14A

一开始发现室内读数在1500到1800之间，这太高了。放到阳台上，让它运行超过 20 分钟，读数是 1470，而且数值稳定。

根据使用说明书，把 HD pin 和 GND 短接 7 秒，读数变成了 390 ppm.

孩子在卧室睡午觉，开空调，大概从 13:00PM 到 16:00PM，传感器离地面 15cm 左右，读数 710 ppm. 因为 CO2 比较重，我把传感器放到地上，读数很快变成 735 ppm.

用的 github 上的一份代码(链接 1)，通过 PWM 读值。

链接

2017年8月13日星期日

STM32F103 的 PB3, PB4 和 PA15

上周五给一块板子写代码，PB3 控制一个 BJT，始终没有输出，另一个工程师(赵工)告诉我说是 JTAG 默认使用 PB3，然后另了相应的代码，还是不工作，后来发现少了一行代码，也就是要打开 AFIO 模块的时钟。

RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);
GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);

还有一个函数是
GPIO_PinRemapConfig(GPIO_Remap_SWJ_Disable, ENABLE);
这会同时关闭 JTAG 和 SWD 功能。

(这是一个草稿，待更新)