Getting to know your Romi
Directional Conventions
The front of the Romi is where the Raspberry Pi USB ports, GPIO pins and suspended caster wheel are.
In all Romi documentation, references to driving forward use the above definition of ”front“.
Hardware, Sensors, and GPIO
The Romi has the following built-in hardware/peripherals:
2x geared motors with encoders
1x Inertial Measurement Unit (IMU)
3x LEDs (green, yellow, red)
3x pushbuttons (marked A, B, and C)
5x configurable GPIO channels (EXT)
Buzzer
הערה
The Buzzer is currently not supported by WPILib.
Motors, Wheels, and Encoders
The motors used on the Romi have a 120:1 gear reduction, and a no-load output speed of 150 RPM at 4.5V. The free current is 0.13 amps and the stall current is 1.25 amps. Stall torque is 25 oz-in (0.1765 N-m) but the built-in safety clutch might start slipping at lower torques.
The wheels have a diameter of 70mm (2.75“). They have a trackwidth of 141mm (5.55“).
The encoders are connected directly to the motor output shaft and have 12 Counts Per Revolution (CPR). With the provided gear ratio, this nets 1440 counts per wheel revolution.
The motor PWM channels are listed in the table below.
Channel |
רכיבי התוכנה של Romi |
---|---|
PWM 0 |
Left Motor |
PWM 1 |
Right Motor |
הערה
The right motor will spin in a backward direction when positive output is applied. Thus, the corresponding motor controller needs to be inverted in robot code.
The encoder channels are listed in the table below.
Channel |
רכיבי התוכנה של Romi |
---|---|
DIO 4 |
Left Encoder Quadrature Channel A |
DIO 5 |
Left Encoder Quadrature Channel B |
DIO 6 |
Right Encoder Quadrature Channel A |
DIO 7 |
Right Encoder Quadrature Channel B |
הערה
By default, the encoders count up when the Romi moves forward.
Inertial Measurement Unit
The Romi includes an STMicroelectronics LSM6DS33 Inertial Measurement Unit (IMU) which contains a 3-axis gyro and a 3-axis accelerometer.
The accelerometer has selectable sensitivity of 2G, 4G, 8G, and 16G. The gyro has selectable sensitivity of 125 Degrees Per Second (DPS), 250 DPS, 500 DPS, 1000 DPS, and 2000 DPS.
The Romi Web UI also provides a means to calibrate the gyro and measure its zero-offsets before use with robot code.
Configurable GPIO Pins
The control board has 5 configurable GPIO pins (named EXT0 through EXT4) that allow a user to connect external sensors and actuators to the Romi.
All 5 pins support the following modes: Digital IO, Analog In, and PWM (with the exception of EXT 0, which only supports Digital IO and PWM). The mode of the ports can be configured with The Romi Web UI.
The GPIO channels are exposed via a 3-pin, servo style interface, with connections for Ground, Power and Signal (with the Ground connection being closest to the edge of the board, and the signal being closest to the inside of the board).
The power connections for the GPIO pins are initially left unconnected but can be hooked into the Romi’s on-board 5V supply by using a jumper to connect the 5V pin to the power bus (as seen in the image above). Additionally, if more power than the Romi can provide is needed, the user can provide their own 5V power supply and connect it directly to power bus and ground pins.
GPIO Default Configuration
The table below shows the default configuration of the GPIO pins (EXT0 through EXT4). The Romi Web UI allows the user to customize the functions of the 5 configurable GPIO pins. The UI will also provide the appropriate WPILib channel/device mappings on screen once the IO configuration is complete.
Channel |
Ext Pin |
---|---|
DIO 8 |
EXT0 |
Analog In 0 |
EXT1 |
Analog In 1 |
EXT2 |
PWM 2 |
EXT3 |
PWM 3 |
EXT4 |