README

PHP Serial 是在我不懂任何其他语言只有 PHP 的时候编写的，我开始对它的功能感到非常无聊。

我设法弄到了一个「Citizen C2202-PD」销售点显示设备，并想玩玩它。我还设法获得了它的文档，并创建了一个便利类，通过 Linux 文件来访问串口。

之后，我将它发布到了 PHP Classes，这可能就是它获得曝光的原因。

示例

<?php
include 'PhpSerial.php';

// Let's start the class
$serial = new PhpSerial;

// First we must specify the device. This works on both linux and windows (if
// your linux serial device is /dev/ttyS0 for COM1, etc)
$serial->deviceSet("COM1");

// We can change the baud rate, parity, length, stop bits, flow control
$serial->confBaudRate(2400);
$serial->confParity("none");
$serial->confCharacterLength(8);
$serial->confStopBits(1);
$serial->confFlowControl("none");

// Then we need to open it
$serial->deviceOpen();

// To write into
$serial->sendMessage("Hello !");

项目状态

有趣的是，这段代码自从创建以来就引起了很大的兴趣，尤其是在现在，每个人都在玩 Arduino 和 Raspberry Pi。我每个月大约会收到一封关于代码帮助或发送补丁/建议的邮件。

我认为是时候把这个项目从尘埃中清理出来，并在现代工具（即 GitHub）上提供全面曝光了。

错误

有很多错误。我知道有很多。我只是不知道它们是哪些。

平台支持

• Linux：最初支持的平台，我使用的平台。可能是最少错误的。
• MacOS：尽管我从未在 MacOS 上尝试过，它与 Linux 类似，有人向我提交了一些补丁，所以我认为它是好的。
• Windows：它似乎对一些人有效，对另一些人无效。理论上应该有办法让它工作。

担忧

我对这段代码的行为有一些担忧。

• 跨平台一致性。我严重怀疑所有操作在所有平台上都以相同的方式进行。
• 读取操作。在我的项目中从未需要读取，所以我在这方面所做的所有测试都是理论上的。我也相当天真，所以 API 可能不是最优的。我们需要从头开始重新思考读取。
• 通过调用函数进行配置。这太像 Java 了。最好能够一次性传递一个配置数组。此外，我怀疑调用顺序很重要，这是不好的。
• 自动关闭设备。有一个注册在 PHP 关闭时的自动关闭函数。这听起来相当荒谬，必须对此做些什么。
• 使用异常。目前错误系统被大量用于报告错误（2007 年的孩子），但这非常糟糕。它们必须被实际的异常所取代。

贡献呼吁

我没有时间来编写或测试这个项目。然而，显然有这个需求。

就像所有开源项目一样，我需要人们将其适应他们的需求，并贡献他们的代码。

在我看来，需要什么

• 解决上述问题，并找出新的问题。
• 为每个操作系统创建可复现的测试环境，并证明每个功能都有效（基本上，单元测试）。
• 使用案例、错误、缺少的功能等报告。

如果你愿意做任何这些，不要犹豫，创建一个问题或拉取请求，我会很高兴考虑它：）

许可

PHP Serial 版权 (C) 2007-2014 PHP Serial 贡献者（见 CONTRIBUTORS 文件）

本程序是自由软件；您可以在自由软件基金会发布的GNU通用公共许可证的条款下重新分发和/或修改它；许可证的第2版，或者（根据您的选择）任何更高版本。

本程序的发布是希望它是有用的，但没有任何保证；甚至没有关于适销性或适用于特定目的的暗示性保证。有关详细信息，请参阅GNU通用公共许可证。

您应已随本程序收到GNU通用公共许可证的一份副本；如果没有，请写信给自由软件基金会，Inc.，51 Franklin Street，第五层，波士顿，MA 02110-1301 美国。