New Starters
- Using the Developer Wiki
- Getting Set Up
- Familiarising IBEX
- EPICS Introduction
- Input/Output Controller (IOC) Resources
- Control System Studio
- Office Admin Links
This page is designed to be used as a comprehensive reference to getting started in the Instrument Controls team. Written by new-ish starters, for the newest starters. It's a collection of useful resources which will speed up your onboarding and get you developing.
There are many how-to guides in the Developer's manual. If you're searching for a particular nugget of information and there doesn't seem to be any information on it, double check results in the 'Wikis' tab:
First off you're going to need all the developer tools we use, a copy of the existing codebase, and the Eclipse GUI for IBEX*.
We use Git for version control of the codebase. If you're not familiar with it, learn it!
It's handy to create desktop shortcuts for frequently used links:
- EPICSTerm (The terminal window where IOCs are built and run)
- start_ibex_server
- stop_ibex_server
These are found in C:\Instrument\Apps\EPICS
*it's just a goat.
While that's installing, get to know the IBEX components. Get to know EPICS. It's the software environment that IBEX uses to control the ISIS instruments.
There is much to learn about EPICS and it can be difficult to know what you're looking for. Here are some overviews:
- Powerpoint EPICS overview
- Training Course
- Database Principles (what's a record? And more)
- Database Principles II (with examples)
- State Notation Language 1 State Notation Language 2
- ASYN/Stream Device overview
- YouTube Videos covering the epics.gov.anl slideshows
When building an IOC, emulator, or writing tests, much can be learned by looking at existing IOCs. However, there are several places to find good sources for learning and referencing.
- Protocol Files and Record Types - Excellent reference for when you're mixing up your %d's and %f's. Bookmark this one!
- Sequencer - State Notation in IOCs - All about implementing a state machine into an IOC, if needed.
We use CSS to create Operator Interfaces (OPIs - GUIs, essentially) for the instrument controllers. Here's an overview and get started guide.
- Waffle Board - Work tickets
- Slack Channel - Office-related chat
- ISIS Sharepoint - Shared ISIS documents, manuals, meeting minutes etc
- Oracle Login - Book leave, create timesheets
- Flexi Time - If you're on Flexi time and need to view/edit your work history