原文地址：https://github.com/Hamlib/Hamlib/blob/3.3/README
Hamlib - (C) Frank Singleton 2000 ([email protected])
(C) Stephane Fillod 2000-2011
(C) The Hamlib Group 2000-2012
The purpose of this project is to provide stable, flexible, shared libraries
that enable quicker development of Amateur Radio Equipment Control
Applications.
这个项目的目的是提供一个稳定、灵活、共享的调用库，从而使更快地促进业余无线电设备控制方面的应用开发。
Many Amateur Radio Transceivers come with serial interfaces that allows
software to control the radio. This project will endeavour to provide shared
libraries that greatly simplify the application programmer's interaction
with radio equipment and other controllable devices such as rotators,
switches, etc.
许多业余无线电收发信机都配有串行接口，允许软件控制无线电。该项目将努力提供一个共享库，大大简化开发者操作无线电设备及其他可控设备（如旋转器、开关等）的交互控制。
Supported Radios
支持的电台
----------------
The Hamlib Wiki page, Supported Radios, contains a snapshot of the supported
radios at the time of the last Hamlib release. Go to http://www.hamlib.org
to reach the Wiki.
Hamlib Wiki页面“支持的电台（ Supported Radios）”包含最新Hamlib发行时支持的电台的列表。打开http://www.hamlib.org访问Wiki。
Hamlib Design
Hamlib 开发
-------------
The library provides functions for both radio and rotator control,
and data retrieval from the radio or rotator. A number of functions useful
for calculating distance and bearing and grid square conversion are included.
该库提供了操作无线电和旋转器控制以及从无线电或旋转器读取数据的功能。包括许多用于距离、方向角和方格计算转换的函数。
libhamlib.so - library that provides generic API for all RIG types.
This is what Application programmers will "see". Will have different
names on other platforms, e.g. libhamlib-2.dll on MS windows. Also
contains all radio and rotator "backends" (formerly in their own
dlopen'ed libraries) provided by Hamlib.
ibhamlib.so-为所有设备类型提供通用应用程序接口（API）库。
这就是应用开发员要“看到”的东西。将在其他平台上使用不同的名称，例如Windows上的名称libhamlib-2.dll。还包含由Hamlib提供的所有电台和旋转器的“后端”（以前存放在它自己的dlopen’ed库中）。
Backend Examples are:
后端举例如下：
---------------------
1. yaesu will provide connectivity to Yaesu FT 747GX Transceiver, FT 847
"Earth Station", etc. via a standard API.
yaesu通过标准应用程序接口（API）库提供与yaesu FT 747GX收发器、FT 847“地球站”等的连接。
- xxxx. will provide connectivity to the Wiz-bang moon-melter 101A (yikes..)
xxxx. 提供与Wiz bang moon melter 101A的连接。
Hamlib will also enable developers to develop professional looking GUI's
towards a standard control library API, and they would not have to worry
about the underlying connection towards physical hardware.
Hamlib还能让开发人员能够利用标准控制库API开发面向专业的界面（GUI），而且不必担心底层与物理硬件的连接。
Initially serial (RS232) connectivity will be handled, but we expect that IP
(and other) connectivity will follow afterwards. Connection via a USB port
is accomplished via the Linux kernel support. USB to serial converters are
well supported. Other such devices may be supported as long as they present
a serial (RS-232) interface to Hamlib.
初始的串行（RS232）连接将被处理，但我们希望物理接口IP（以及其他）连接将随后进行。通过USB端口的连接是在Linux内核很容易实现的。USB到串行转换器得到了很好的支持。只要它们向Hamlib提供串行（RS-232）接口，其他类似的设备也可以被支持。
Availability
可用性
------------
Most distributions have the latest Hamlib release in their testing or alpha
versions of their distribution. Check your package manager for the Hamlib
version included in your distribution.
大多数发行版系统中测试（ testing ）和alpha版本中都会包含最新的Hamlib。请检查包管理器中包含的Hamlib版本。
Developing with Hamlib API
使用Hamlib应用程序接口（API）开发
--------------------------
C language API documentation is at:
http://www.hamlib.org/index.php?title=Documentation
C语言的应用程序接口（API）开发文档：
http://www.hamlib.org/index.php?title=Documentation
Take a look at tests/README for more info on simple programming examples and
test programs.
查看tests/README以获取有关简单编程示例和测试程序的更多信息。
C++ programming is supported and language bindings are available for Perl,
Python, and TCL. A network daemon utility is also available for any
programming language that supports network sockets (even netcat!).
支持C++编程，Perl、Python和Tcl语言都可以绑定该库。任何支持网络套接字（甚至netcat！）的编程语言都可以使用该库的网络守护程序。
Recompiling
重新编译
-----------
Hamlib is entirely developed using GNU tools, under various Linux systems.
The library may be recompiled by the familiar "three step":
Hamlib完全是在各种Linux系统下使用GNU工具开发的。
该库可以通过经典的“三步”重新编译：
./configure
make
sudo make install
See the INSTALL file for more information.
查看INSTALL文件已获得更多帮助。
Contributing
建设
------------
Consult the README.betatester and README.developer files in this directory
if you feel like testing or helping with Hamlib development.
如果您想测试或帮助开发Hamlib，请参考此目录中的README.betatester和README.developer文件。
Contributions of rig specifications and protocol documentation are highly
encouraged. Do keep in mind that in some cases the manufacturer may not
provide complete control information or it is only available under a
Non-Disclosure Agreement (NDA). Any documentation *must* be publicly
available so we can legally write and distribute Free Software supporting a
given device.
强烈建议您提供设备规范和协议文档。 请记住，在某些情况下，制造商可能不会提供完整的控制信息，或者仅在保密协议（NDA）下提供。 任何文档*必须*公开可用，因此我们可以合法地编写和分发支持给定设备的免费软件。
The Hamlib team is very interested to hear from you, how Hamlib builds and
works on your system, especially on non-Linux system or non-PC systems. We
try to make Hamlib as portable as possible.
Hamlib团队非常乐意听到Hamlib如何在您的系统上构建和工作的情况，尤其是在非Linux系统或非PC的系统上。我们试图使Hamlib尽可能便携。
Please report in case of problems at [email protected]
Git email formatted patches or in unified diff format are welcome!
Also, take a look at http://sourceforge.net/projects/hamlib/ Here you will
find a mail list, link to the Wiki, and the latest releases. Feedback,
questions, etc. about Hamlib are very welcome at the mail list:
如果有问题，请报告hamlib- [email protected]欢迎使用Git电子邮件格式的补丁或统一的diff格式！ 另外，请访问http://sourceforge.net/projects/hamlib/。在这里，您将找到一个邮件列表，到Wiki的链接以及最新版本。 在邮件列表中，非常欢迎您提供有关Hamlib的反馈，问题等：
<[email protected]>
Hamlib Version Numbers
Hamlibe 版本序号
----------------------
Like other software projects, Hamlib uses a version numbering scheme to help
program authors and users understand which releases are compatible and which
are not. Hamlib releases now follow the format of:
与其他软件项目一样，Hamlib使用版本编号方案来帮助程序作者和用户了解哪些版本兼容，哪些版本不兼容。 Hamlib版本现在遵循以下格式：
Major.minor.incremental
大版本号.小版本号.增量号
Where
位置解释
Major: Currently at 3, but can be advanced when changes to the API require
client programs to be rewritten to take advantage of new features of
Hamlib. This number has advanced a couple of times throughout the life of
Hamlib. Advancement of the major number is only for frontend API changes
that require modification of client source. ABI compatibility is presently
maintained to prior releases so that a program linked to an earlier
1.2.Y.[Z] release will work with a later 3.Y[.Z] release without
recompiling. Itis our intention to maintain such ABI compatibility as long
as practical.
大版本号：当前为3，但是当对API的更改要求重写客户端程序以利用Hamlib的新功能时可以进行改进。 在Hamlib的整个生命周期中，这个数字已经提高了两倍。 大版本号的增加仅适用于需要修改客户端源的前端API更改。 目前，ABI与以前的版本保持兼容性，因此链接到早期版本1.2.Y. [Z]的程序可以与更高版本3.Y [.Z]一起使用，而无需重新编译。 我们的意图是在实际可行的范围内保持这种ABI兼容性。
Minor: This number advances when either new backend(s) or new rig
model(s) to existing backend(s) are added. Advancing this number informs
client program authors (and users of those programs) that new model/backend
support has been added. Will also include bug fixes since the last
Incremental release.
小版本号：当向现有后端添加新后端或新装备模型时，此数字会增加。 将此数字增加会通知客户端程序作者（和那些程序的用户）已添加了新的模型/后端支持。 自上一个增量版本以来，还将包括错误修复。
Incremental: May be undefined (e.g. Hamlib 3.0) and would advance to 1
(e.g. Hamlib 3.0.1) for any bug fixes or feature additions to existing
model(s) or backend(s), then to 2, etc. New rig models or backends are not
included in Incremental. When Release is advanced, Incremental will reset
to undefined and will not be included as part of the version number.
增量号：可能未定义（例如Hamlib 3.0），对于现有模型或后端的任何错误修复或功能添加，可能会升至1（例如Hamlib 3.0.1），然后升至2等。 或后端不包括在增量中。 提前发布时，增量将重置为未定义，并且将不包含在版本号中。
Release schedule
更新计划
----------------
Hamlib has in the past maintained a "ready when it's ready" philosophy.
However, given that much of the Linux user base is now influenced by the
Ubuntu distribution and its timed six month release schedule, Hamlib
releases will be scheduled in advance of Ubuntu releases. Planned release
dates for Hamlib are now 1 February and 1 August of each calendar year.
Between those dates various Incremental releases will occur as development
warrants.
Hamlib过去一直保持“准备就绪”的理念。 但是，考虑到现在大多数Linux用户群都受Ubuntu发行版及其六个月的定时发布时间表的影响，Hamlib的发布将在Ubuntu版本之前进行。 Hamlib的计划发布日期现在是每个日历年的2月1日和8月1日。 在这些日期之间，将作为开发保证书发行各种增量版本。
Have Fun / Frank S / Stephane F / The Hamlib Group
玩得开心/ Frank S / Stephane F / Hamlib开发组
73's de vk3fcs/km5ws / f8cfe
vk3fcs/km5ws / f8cfe送上73
![HPatches A benchmark and evaluation of handcrafted and learned local descriptors——2017.04[图]](data:image/gif;base64,R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs=)