-
Notifications
You must be signed in to change notification settings - Fork 2
Expand file tree
/
Copy pathindex.html
More file actions
104 lines (104 loc) · 5.49 KB
/
index.html
File metadata and controls
104 lines (104 loc) · 5.49 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>OpenLCB C/C++ Prototypes</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 3.4.1 (Unix)">
<META NAME="AUTHOR" CONTENT="Bob Jacobsen">
<META NAME="CREATED" CONTENT="20090816;10132800">
<META NAME="CHANGEDBY" CONTENT="Bob Jacobsen">
<META NAME="CHANGED" CONTENT="20130323;210000">
<META NAME="CHANGEDBY" CONTENT="Bob Jacobsen">
<STYLE TYPE="text/css">
<!--
H2.cjk { font-family: "SimSun" }
H2.ctl { font-family: "Arial Unicode MS" }
H3.cjk { font-family: "SimSun" }
H3.ctl { font-family: "Lucida Sans" }
-->
</STYLE>
</HEAD>
<BODY LANG="en-US" BGCOLOR="#e6e6ff" DIR="LTR">
<H1><FONT COLOR="#000000"><IMG SRC="../../web/logo-ajs-dph.png" NAME="OpenLCB" ALIGN=RIGHT WIDTH=337 HEIGHT=135 BORDER=2></FONT>OpenLCB
C/C++ Prototypes</H1>
<P>This is the index page of the OpenLCB™ C/C++ prototypes
directory. This directory contains two OpenLCB prototype library
implementations, and a number of projects that use one or the other
of them. These are intended to run on a range of systems, from small
stand-alone devices through PC-class machines.</P>
<P>Because of the requirements of the Arduino IDE, which doesn't have
a “project” concept, we're forced into a somewhat odd directory
structure. This directory contains three separate things:</P>
<UL>
<LI><P>In the <A HREF="OlcbStarLibraries/index.html">OlcbStarLibraries
subdirectory</A> is a low-level OpenLCB implementation meant for
small, Arduino-class processors. This includes both libraries and
sample programs that can be used with the Arduino IDE or
independently. For more information, see that <A HREF="OlcbStarLibraries/index.html">overview
page</A>.</P>
<LI><P>This directory also contains C++ OpenLCB implementation in
the libraries/OpenLCB directory, along with several sample programs.
For more information, see that <A HREF="OpenLCBlib.html">overview
page</A>.</P>
<LI><P>This directory also contains several useful Arduino sketches
that OpenLCB experimenters may find useful. These are described
below.</P>
</UL>
<H2 CLASS="western">Useful Sketches</H2>
<P><FONT FACE="Times New Roman, serif"><FONT SIZE=3>The Arduino is a
convenient hardware platform for OpenLCB <A HREF="../Hobbyists.html">hobbyists</A>.
We provide a number of Arduino “sketches”, complete software
loads for the Arduino hardware for various kinds of OpenLCB nodes.
These require release 1.0 or later of the Arduino IDE.</FONT></FONT></P>
<UL>
<LI><P><FONT FACE="Times New Roman, serif"><FONT SIZE=3>CAN2USBuino
– lets you use an Arduino with CAN and USB hardware as a CAN-USB
adapter with the GridConnect protocol.</FONT></FONT></P>
<LI><P><FONT FACE="Times New Roman, serif"><FONT SIZE=3>CAN2EtherNetServer
– lets you use an Arduino with CAN and Ethernet hardware as a
CAN-Ethernet adapter with the GridConnect protocol.</FONT></FONT></P>
<LI><P><FONT FACE="Times New Roman, serif"><FONT SIZE=3>IoBlink –
tests a RailStars Io board, as in the OpenLCB Developer Kit, by
flashing its LEDs</FONT></FONT></P>
<LI><P><FONT FACE="Times New Roman, serif"><FONT SIZE=3>IoIoTesting1
– test and initialize a RailStars Io board, as in the OpenLCB
Developer Kit</FONT></FONT></P>
</UL>
<P><FONT FACE="Times New Roman, serif"><FONT SIZE=3><FONT COLOR="#000000">To
use these, start the Arduino IDE and open 'Arduino-->Preferences'.
Change the sketch directory to be </FONT><FONT COLOR="#000000">'OpenLCB/trunk/prototypes/C'
or wherever you have placed this directory. Close the IDE and reopen
it. You should now be able to see the sketches in
'Files-->Sketchbook'.</FONT></FONT></FONT></P>
<H2 CLASS="western">Standalone Compilation</H2>
<P>This directory contains Makefiles and test scaffolding to directly
compile (some of) the prototype code, run it, and compare it to
expected results. Over time, this set of tests is growing into an
important regression test of all the implementations. To compile and
run, do:</P>
<P STYLE="margin-left: 2cm"><CODE><B>make</B></CODE></P>
<P>on the command line. This builds (some of) the example Arduino
sketches in the current directory, thereby ensuring they compile. It
then compiles the OpenLCB library. Finally, it tests the Olcb*
library by invoking make in the OlcbStarLibraries directory, which in
turn builds all the sample sketches and runs test routines on the
code.</P>
<H3 CLASS="western">Getting the Code</H3>
<P>The content of this development area, including code, documents
and web pages, is kept in the <A HREF="https://sourceforge.net/projects/openlcb/develop">OpenLCB</A>
<A HREF="https://sourceforge.net/">SourceForge.net</A> <A HREF="http://sourceforge.net/p/openlcb/svn/HEAD/tree/trunk/">SVN
repository</A> in the “trunk/prototypes/C” directory. To check it
out, please do:</P>
<PRE STYLE="margin-left: 2cm; margin-bottom: 0.5cm"><B>svn co http://svn.code.sf.net/p/openlcb/svn/trunk/prototypes/C C</B></PRE><P STYLE="margin-bottom: 0cm">
For more information on the SVN source code management tool, please
see the <A HREF="http://subversion.tigris.org/">SVN website</A> and
the <A HREF="http://svnbook.red-bean.com/">online SVN book</A>.</P>
<P STYLE="margin-bottom: 0cm"><BR>
</P>
<HR>
<P STYLE="margin-bottom: 0cm">This web site contains trademarks and
copyrighted information. Please see the <A HREF="/Licensing.html">Licensing</A>
page.</P>
<P STYLE="margin-bottom: 0cm">This is SVN $Revision$ of <SDFIELD TYPE=DATETIME SDVAL="40041.4309143519" SDNUM="1033;1033;MM/DD/YY">08/16/09</SDFIELD>.</P>
</BODY>
</HTML>