capod Code
EPICS Channel Access high level library for iOS and related apps
Brought to you by:
tapsns
Menu
▾
▴
Tree [ef0450] master / History
Read Me
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<title></title>
<style type="text/css">
.description {}
.section { margin-top: 1em; }
.section .heading { font-size: large; font-weight: bold; }
.procedure { text-indent: 4em; }
.procedure .step { display: list-item; font-family: monospace; }
.instruction { font-family: monospace; color: green; }
.placeholder { font-style: italic; color: #777; }
.literal { font-family: monospace; color: gray; }
.warning { color: brown; }
</style>
</head>
<body>
<div><span style="font-weight: bold; font-size: xx-large;">CA Pod Project</span></div>
<div class="section"><span class="heading">Introduction</span>
<div class="description">
This workspace contains two Xcode projects: CA Probe and CA Touch. These projects require Xcode 4 or later.
</div>
</div>
<div class="section"><span class="heading">License</span>
<div class="description">
This project is provided open source under the <a href="http://www.opensource.org/licenses/bsd-license.php" target="_blank">BSD license</a>. It is built against <a href="http://www.aps.anl.gov/epics/" target="_blank">EPICS</a> Channel Access client libraries which are provided under the <a href="http://www.aps.anl.gov/epics/license/open.php" target="_blank">EPICS Open Source license</a>.
</div>
</div>
<div class="section"><span class="heading">CA Touch</span>
<div class="description">
The CA Touch project is an Objective-C based project for building an iOS static library for EPICS Channel Access.
</div>
</div>
<div class="section"><span class="heading">CA Probe</span>
<div class="description">
The CA Probe project is an iOS project for building a sample EPICS Channel Access application for monitoring process variables and displaying information about them.
</div>
</div>
<div class="section"><span class="heading">Installing EPICS Channel Access</span>
<div class="description">
<ul>
<li><a href="http://www.aps.anl.gov/epics/download/base/index.php" target="_blank">Download</a> and install EPICS Channel Access 3.14.12.2 or later. You are free to install it wherever you want, but it is recommended to install it (or a soft link to it) in <span class="literal">/Library/EPICS/Base</span> otherwise you will have to make some minor changes.</li>
<li>Edit the <span class="literal">${EPICS_BASE}/configure/os/CONFIG_SITE.darwin-x86.Common</span> file and uncomment the line specifying the cross compiler target architectures for iOS.</li>
<li>Verify and if necessary edit the <span class="literal">${EPICS_BASE}/configure/os/CONFIG_SITE.Common.iosCommon</span> file so the <span class="literal">IOS_VERSION</span> variable matches the version of iOS SDK that is installed.</li>
<li>Verify and if necessary edit the <span class="literal">${EPICS_BASE}/configure/os/CONFIG_SITE.Common.ios-arm</span> file so the <span class="literal">ARCH_CLASS</span> variable matches the desired architecture (armv7 is preferred for iPad and iPhone 3GS and later, but won't run on earlier versions).</li>
<li>Open Terminal and change directory to <span class="literal">${EPICS_BASE}</span> and initialize your EPICS environment for darwin as usual.</li>
<li>Build EPICS Base for darwin: <span class="instruction">make darwin-x86</span> </li>
<li>Build EPICS Base libraries for iOS: <span class="instruction">make -C src libCom ca</span></li>
</ul>
</div>
</div>
<div class="section"><span class="heading">Configuring the Projects</span>
<div class="description">
<ul>
<li>In the CA Touch project, edit the user defined <span class="literal">EPICS_BASE</span> property to be the file path of your EPICS base installation. The default file path is <span class="literal">/Library/EPICS/Base</span>.</li>
<li>In the CA Touch project, the paths for the EPICS libCom and libcA libraries are specified relative to the <span class="literal">/Library/EPICS/Base</span>, so you need to make sure you have placed a soft link at this path to your EPICS Base (recommended) or you will need to change the path to the libraries explicitly.</li>
<li>Verify and edit the <span class="literal">Base SDK</span> build setting for the projects to match the availible version.</li>
</ul>
<div class="warning">References to the EPICS iOS config files are in a group called "CA Config" in the CA Touch project. These files are in the project as a matter of convenience and are not needed for building the CA Touch project. If you install EPICS Base in a directory other than the default and you don't provide a soft link to it at the default file path then the config references from the project will be broken, but it won't affect the build.
</div>
</div>
</div>
</body>
</html>
