English
资源说明：platform independent C++ Client/Server software to communicate with serial (RS232) devices
Stepper Motor Control
=====================
(Copyright Thomas Hisch 2010-2011)
Overview:
---------
This is a FLOSS client/server software for controlling certain industrial
devices via a serial connection (rs232). At the moment it only
supports the commands of the PM381 controller from
[McLennan](http://www.mclennan.co.uk/) used for controlling 5
servo/stepper motors at the Applied Physics Institute (TU Vienna).
The software is written in C++, is platform independent and uses the
C++ [Boost library](http://www.boost.org). For the communication with
the rs232 interface the C++ ctb library is used to access the serial port
(this library currently only supports Windows and Linux).
The GUI (acting as the network client) uses the platform independent
[wxWidgets](http://www.wxwidgets.org) Toolkit, but does not depend on
Boost and on libctb.
The whole software is released under the GNU General Public License v3.
Requirements:
-------------
* wxWidgets 2.9.0
* boost 1.44
* libctb 0.16
Installation:
-------------
Linux (libctb specific):
if you use an USB-RS232 converter (usually such converters have
/dev/ttyUSB0 as linux device name) use the devicename as the first
argument to ctb::open instead of CTB::COM[1-9].
A nonpriviledged user (non root) needs to have permission to talk to
the UART. It needs to be in the same group as /dev/tty* (in the linux
distribution Fedora/Redhat this group is called dialout)
Download libctb from
https://iftools.com/download/ctb/0.16/libctb-0.16.tar.gz and install
it according to the Readme file!
MOVES:
---------
to compile the core program and the GUI (if wxWidgets devel files are
installed) for MOVES create a build directory
mkdir build && cd build
then start cmake
cmake -DCMAKE_BUILD_TYPE=Debug ..
and finally type
make
the configuration file for the hardware is located in the project root
directory and it contains the serial parameters which are parsed by
the server program *moves_server*, it also contains all the parameters
for each axis. To run the server (the port can be set in the XML file)
type
./src/core/moves_server -f ../parameters.xml
start the cli client from another terminal with
./src/core/moves_client_cli
to see all accepted program options use the -h or --help command line
option. *moves_client_cli* supports executing batch-files which are
parsed by the server and then sent to the hardware (Use *-b
batchfile*). The get a list of available commands start the client
without a batch-file and type at the prompt (*#>*) *help*.
Look at example.bat for a simple batch file.
Execute it with
./src/core/moves_client_cli -b ../example.bat
If you want to execute a PM381 command which is not supported by the
server, you can simply type in the command (with the address
specifier) in the cli. Example:
#> 1OC
MOVES GUI:
---------------
In addition to the cli client program a GUI was developed using
wxWidgets, which supports only a subset of the offered commands of the
PM381 controller. It was compiled in the previous step, to run it type
./src/gui/moves_gui
If you want the GUI to periodically ask the hardware about its current
motor position then you need to start the Position-update-thread under
Operations. The current position is displayed in the Statusbar then.
Under Operations-Batch Mode you can, like in the cli, send batchfiles
to the hardware.
Development:
------------
If you would like to see certain features implemented or support for
certain devices, please use
[githubs issue tracker](https://github.com/thisch/StepperController).
Debugging the software( without hardware):
-----------------------------
If you want to test the GUI without launching a server, you have to
comment out the
#add_definitions(-DDEBUG_STANDALONE)
line in src/gui/CMakeLists.txt and recompile your program. If you want
to test the server and the GUI without hardware, then you only need to
uncomment
#add_definitions(-DDEBUG_SERIAL)
in src/core/CMakeLists.txt.
TODO:
-----
* use Exceptions inside the IAPBoard and catch them inside the Server
* improve error handling in the C++ code
* implement wait command
* Windows build support
* generalize the client and server programs
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
