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 can't find the relevant page, double check the 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
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 also several places online 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 a number of parts of CSS in our GUI (Alarms, Databrowser etc.). Most of these resources require little developer interaction apart from creating Operator Interfaces (OPIs - GUIs, essentially) for the instrument controllers. Here's an overview and get started guide.
As a new starter you should add your name and picture to the training slides.
- IBEX Project 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