FRC TEAMS, BE AWARE THAT THE 2019 KICKOFF RELEASE IMAGE (v12) BREAKS COMPATIBILITY WITH ADI GYROS and IMUs! NI HAS RELEASED AN UPDATE SUITE (2019.1.0) ALONG WITH A NEW ROBORIO IMAGE (v13) THAT FIXES THE ISSUE. THE UPDATED INSTALLER CAN BE FOUND HERE.
This example library was written to give mentors, students, and engineers a starting point for using a very high-performance 6 Degree-of-Freedom (DoF), calibrated Inertial Measurement Unit (IMU). This sensor packages multiple gyroscopes and accelerometers in a tiny, robust package perfect for high-performance robotics (such as FRC).
These software libraries provide the user (you) with:
- Raw sensor outputs - X-Y-Z Gyroscope and Accelerometer
- X-Y-Z gyroscope angles calculated using loop integration
- Offset compensation calculated at runtime
Tutorial videos, how-to guides, and additional resources can be found on the ADI FIRST Robotics Wiki Page.
A bug was introduced in the 2019 kickoff RoboRIO image which broke "Auto SPI." All ADI sensors currently offered to FRC teams rely on this feature to synchronously capture IMU data and feed it to the Zynq CPU for processing. The source of the bug was traced back to a RoboRIO image packaging issue and could be temporarily resolved on a v12 image by connecting to the serial/SSH terminal on the RoboRIO and executing the command "updateNIDrivers". This command forces the RoboRIO to re-compile the affected kernel module and fully resolves the issue. As of 01/17/2019, NI has released an updated installer (2019.1.0) that includes a pre-patched RoboRIO image (v13).
The IMU driver currently supports all three official FRC languages (C++, Java, and LabVIEW). Raw sensor rate outputs and accumulated sensor outputs are supported for all languages.
To use the software, you need access to a RoboRIO and the ADIS16470 RoboRIO Breakout Board. This software is based on the FRC 2019 software distribution and relies on the WPILib libraries to interface with the IMU. Previous (pre-2019) versions of LabVIEW and WPILib libraries are not supported.
Plug in the expansion board as shown below. Be careful not to offset the connector!! If installed correctly, the Power LED should turn on once the RoboRIO is powered on.
Your RoboRIO should be imaged to match the version of the NI Update Suite installed on your PC. For example, if you have the latest (of this writing) update suite installed (2019.0.0), then you must also have the FRC_roboRIO_2019_v12 image and roboRIO_6.0.0 firmware installed. This driver relies heavily on the FPGA image loaded in the RoboRIO and will not work on older versions. The most current NI Update Suite can be found here.
Click on the language you're looking to use above. Each folder includes instructions specific to the language specified. If you're looking for more information on using the sensor, be sure to check out the ADI FIRST Robotics Wiki Page.
The schematic, layout, and manufacturing files can be found in this repository under Reference/PCB Reference Files/.
Copies of this board may be purchased from OSH Park using this link.