Author Archives: Claire

Building a Raspberry Pi robot with the Romi chassis

via Pololu Blog

This tutorial shows how to build a basic Raspberry Pi robot with the Romi chassis and the Romi 32U4 Control Board, our Arduino-compatible microcontroller board designed specifically for the Romi. With this setup, the powerful Raspberry Pi can take care of high-level tasks like motion planning, video processing, and network communication, while the Romi 32U4 Control Board takes care of low-level tasks that the Pi is incapable of, such as motor control and sensing.

As long as you have basic soldering skills, assembling the parts is straightforward, but this is not a beginner project: it is intended for people who are comfortable programming both the Raspberry Pi and Arduino-compatible controllers. The Romi 32U4 Control Board can also be used by itself (with no Pi) as a robot controller for the Romi Chassis, so you might consider starting there if you are not ready to work with all of these parts at the same time.

Note: this is based on an earlier project from our blog that used the A-Star Robot Controller.

Here are all the parts you will need; they all come in just three kits plus your Raspberry Pi!

Parts needed for a Romi Raspberry Pi robot in packaging.

Open up the bags and check that you have all of the pictured parts. (Note that both the chassis and control board kits come with battery contacts, so you will end up with four extra.)

Parts needed for a Romi Raspberry Pi robot.

Mechanical components

Electronics

To mount the Raspberry Pi on top of your controller, you will have to remove the LCD (or possibly build an extension cable), but you probably won’t need it anyway. I did find it useful for initial debugging, but it’s definitely an optional component.

Miscellaneous items that you probably have already

To assemble the Romi 32U4 Control Board, you will need a soldering iron and solder and to program it you will need a USB micro-B cable. You will also need a small screwdriver, six AA batteries, and a battery charger.

For the initial setup of the Raspberry Pi, you will need a way to power it: Usually powering it from a computer’s USB port will work, but if you have trouble or want to connect a lot of peripherals, I recommend a high-current USB adapter that can do more than 2 A, such as this one. You will also need a keyboard and an HDMI connection to a display. If you want to use a Pi Zero, you will probably also need a USB OTG cable and an HDMI to mini HDMI adapter.

Once you have all your parts, here is how to put them together:

Part 1: Set up the Raspberry Pi

You will need a working Linux distribution (such as Raspbian “Jessie”) on your Raspberry Pi as well as the ability to log in remotely over Wi-Fi, install software, and configure the system. At times you might find it easier to work directly with the Raspberry Pi using a mouse and keyboard, but it is not practical to use the fully assembled robot platform while those are connected. If you are just getting started with the Raspberry Pi, there are hundreds of tutorials available online, but here are links to a few useful resources:

With the Raspberry Pi 3 or Zero W, Wi-Fi is built-in, and you should not have to do anything to configure it other than selecting a Wi-Fi network. Otherwise, you’ll need a Wi-Fi dongle. If you are using an Edimax or similar Wi-Fi adapter with the 8192cu module, you will notice frustrating delays or dropped connections unless you disable power management. Create a module configuration file:

sudo nano /etc/modprobe.d/8192cu.conf

and add the following lines:

# Disable power management
options 8192cu rtw_power_mgnt=0 rtw_enusbss=0

After setting up Wi-Fi, enable I²C on your Raspberry Pi by running

sudo raspi-config

and selecting the option within the “Advanced” menu. By default, I²C runs at 100 kHz, but you can safely increase that rate to 400 kHz and get a much faster communications channel between the boards. To increase the speed, edit the configuration file:

sudo nano /boot/config.txt

At the end, add the line:

dtparam=i2c_arm_baudrate=400000

Note that the Raspberry Pi 3 performs frequency scaling (reducing the speed of the processor when there are no intensive computations running) that affects the I²C clock, so even when you increase the frequency to 400 kHz, it will not always run that fast. In our tests it usually ran at half of the specified speed, only jumping up to the full speed occasionally or when under significant CPU load.

If you want to log in as a user other than the default pi, give yourself access to the I²C devices with this command, replacing <user> with your username:

sudo usermod -a -G i2c,dialout <user>

One further configuration step that will come in handy is to allow your user to safely shut down or reboot the Pi without typing a password. On Raspbian Jessie, the user pi can already do this. To make this possible for another user, run visudo and add the following lines at the end, again replacing <user> with your username:

<user> ALL = (root) NOPASSWD: /sbin/halt
<user> ALL = (root) NOPASSWD: /sbin/shutdown
<user> ALL = (root) NOPASSWD: /sbin/reboot

Try it out now with sudo reboot. After the reboot you should see the device /dev/i2c-1 on your Raspberry Pi, indicating that I²C is available. Then shut down the Pi and remove the USB cable before going on to the next step.

Warning: you should always do a safe shutdown (by logging in and running halt) before removing power to the Raspberry Pi. As with a normal computer, if you remove power while the Raspberry Pi is running, its filesystem could possibly become corrupted.

Part 2: Try out your Romi 32U4 Control Board and test the I²C bridge

I recommend reading through the Romi 32U4 Control Board User’s Guide, particularly the sections on getting started and using the Romi Arduino library. Before putting your control board on the Romi chassis or connecting any other components to it, make sure you can successfully use the Arduino IDE to load the “BlinkLEDs” example from the Romi library.

Next, install the Pololu Raspberry Pi I2C Slave Arduino library. Assuming you are using version 1.6.2 or later of the Arduino software (IDE), you can use the Library Manager to install this library:

  1. In the Arduino IDE, open the “Sketch” menu, select “Include Library”, then “Manage Libraries…”.
  2. Search for “Pololu RPi Slave”.
  3. Click the “Pololu Raspberry Pi I2C Slave Arduino library” entry in the list.
  4. Click “Install”.

If this does not work, you can manually install the library:

  1. Download the latest release archive from GitHub and decompress it.
  2. Rename the folder “pololu-rpi-slave-arduino-library” to “PololuRPiSlave”.
  3. Move the “PololuRPiSlave” folder into the “libraries” directory inside your Arduino sketchbook directory. You can view your sketchbook location by opening the “File” menu and selecting “Preferences” in the Arduino IDE. If there is not already a “libraries” folder in that location, you should make the folder yourself.
  4. After installing the library, restart the Arduino IDE.

From the examples menu under PololuRPiSlave, select RomiRPiSlaveDemo, and load this example onto your control board. It is now ready to receive I²C commands from a Raspberry Pi.

At this point you will need to temporarily connect the Raspberry Pi to the Romi 32U4 Control Board. You don’t have to screw them all the way in, but install standoffs in at least a couple of the locations provided to prevent components from touching. (If you are using the Zero, you probably don’t need them at this point.)

The Romi 32U4 Control Board is configured to power the Raspberry Pi from its 5 V supply by default. This means that if you plug a power source into the control board’s USB port, you will turn on both boards. Do that now so you can install the Raspberry Pi software.

To run our Raspberry Pi example code, you should make sure Python 3 and a couple of required libraries are installed. Install them with:

sudo apt-get install python3 python3-flask python3-smbus

Next, download the pololu-rpi-slave-arduino-library code from our GitHub repository. You can do this a number of ways, but if you are unfamiliar with Git, the simplest is to do the following, replacing <version> with the version of the library that you installed for your Arduino IDE (e.g. “2.0.0”).

wget https://github.com/pololu/pololu-rpi-slave-arduino-library/archive/<version>.tar.gz
tar -xzf <version>.tar.gz
mv pololu-rpi-slave-arduino-library-master pololu-rpi-slave-arduino-library

In the folder pololu-rpi-slave-arduino-library/pi is some example Python code for controlling the Romi 32U4 Control Board. Since you loaded RomiRPiSlaveDemo earlier, the Romi 32U4 Control Board should be ready to respond to these commands. Try running

python3 pololu-rpi-slave-arduino-library/pi/blink.py

If everything goes well, you should see the LEDs on the Romi 32U4 Control Board flash a sequential pattern.

Part 3: Assemble the robot

Once you have gotten the control board and Raspberry Pi talking, disconnect the USB cable, take the Raspberry Pi off the control board, and remove the standoffs. Then solder the buzzer and encoder headers to the control board. I also chose to solder in the female LCD connector. You won’t need the LCD connector when using the control board with a Raspberry Pi, but if you think you might want it later, now is a good time to put it in as well. See the Assembling the Romi 32U4 Control Board section of the Romi 32U4 Control Board User’s Guide for details.

Recommended encoder header holes for use with Raspberry Pi.

There are two sets of holes for the female encoder headers on the Romi 32U4 Control Board. I recommend soldering the female headers into the set of holes closer to the middle of the board since it makes it easier to plug in the HDMI connector for a monitor while your Raspberry Pi is mounted on the control board. Even though you will usually be controlling the Raspberry Pi remotely, you will likely find it useful at some point to connect directly to the PI.

When the header is soldered into the inside holes, it is generally possible for only the metal portion of the HDMI connector to rest on top of the female encoder headers, and there is just enough room for that. With the header in the outside position, the plastic surrounding the connector also rests on the header, so the Raspberry Pi must tilt. The pictures below demonstrate how an HDMI cable fits with the encoder headers soldered in the two different positions. The control board on the blue chassis has the headers soldered into the recommended holes and the ones on the yellow chassis are soldered in the outside set of holes.

Tip: When soldering the buzzer and headers to the control board I found it easiest to tape each component in place, solder just one pin, check the alignment, and then solder the rest of its pins.

To begin assembling the chassis, insert the two double battery contacts into the underside of the battery holder, as shown below:

Installing the double-sided battery contacts in the Romi chassis.

Then, insert the four single contacts from the top. They should rest loosely on the slots inside the battery holder, so that after soldering they can be easily removed:

Installing the individual battery contacts on the Romi chassis.

Now screw down the PCB with #2-56 screws and solder the four battery tabs.

Snap in the motor brackets and assemble the ball caster (see detailed instructions in the Romi Chassis User’s Guide).

Note that the pictures in the Romi Chassis User’s Guide show a different orientation for the header pins on the encoder boards than what I recommended earlier for use with a Raspberry Pi, so follow the instructions below for soldering the encoder instead of the instructions in the chassis user’s guide.

Next, solder your encoder boards to the back of your motors. To get good alignment for the connections between the encoders and Romi 32U4 Control Board, it is important that the encoder boards are flat against the motor and that the top of the boards line up well with the top surface of the motor as shown in the picture below.

Mini Plastic Gearmotor with encoder board soldered flush against it.

When you prepare to push the motors into their brackets, insert the male encoder headers into the holes in the encoder board and push the other ends down into the female headers on the control board as you push on the motors.

Plugging the motor with encoder into the Romi before soldering the encoder header pins.

Then solder them in place from the component side of the encoder board. Doing it this way guarantees those connections will all line up just right. Do not put the encoder discs on until you are done soldering, so you do not accidentally melt them with the iron.

Soldering the header to the encoder board from the component side.

Insert your batteries, push the encoder discs onto the motors, install the LCD if you are using one, and connect USB so you can test the motors and encoders. Load the Encoders example from the Romi library and then open up the Arduino serial monitor. Lastly, turn on the robot by pressing the power pushbutton, and test out the example. Note that the motors will not be powered from USB, so you must turn on the control board’s power switch. Pushing the A and C buttons on the control board should drive both motors forward and backward, and encoder counts will be printed in the serial monitor. If you have an LCD connected, the encoder counts will also be displayed there.

Before moving on and connecting the Raspberry Pi, make sure you reload the RomiRPiSlaveDemo.

Part 4: Test the server

To mount the Raspberry Pi on the robot you will need to remove the batteries and install the standoffs for your Pi with the threaded ends pointing down through the chassis. Also remove the LCD if it was installed.

Mount the Raspberry Pi on the robot with the 20-pin connector and M2.5 screws. If you want to connect your Raspberry Pi to a monitor again, you will need to remove the left motor and then the motor bracket to give the HDMI cable room to plug in.

Now, try running the control panel server:

python3 pololu-rpi-slave-arduino-library/pi/server.py

The server starts up on port 5000, so you can access it at http://<ip>:5000/ where <ip> is the IP address of your Raspberry Pi. The server displays a simple control panel:

The upper part of the display allows you to interact with various parts of the Romi 32U4 Control Board: buttons, LEDs, buzzer, and analog voltage sensors, and you can touch or click within the gray square to command the robot to drive around. (The battery power switch must be ON for the motors to receive power from the batteries.) As you drive the motors, you should see the encoder counts updating.

Part 5: Start the server automatically

It’s annoying to have to log into the Raspberry Pi every time you start up your robot, so you will probably want to set up the server as a background service that starts automatically. With Raspbian Jessie and later, it’s easy to do this using systemd. Edit a file in the service directory:

sudo nano /lib/systemd/system/a_star_slave.service

Add the following lines (adjusting User and the path to server.py if necessary):

Description=Romi Slave Server
After=multi-user.target

[Service]
User=pi
Type=idle
ExecStart=/usr/bin/python3 /home/pi/pololu-rpi-slave-arduino-library/pi/server.py

[Install]
WantedBy=multi-user.target

There is also an included script that periodically pings the server to blink the LEDs as a heartbeat indicator. Edit a file for this service:

sudo nano /lib/systemd/system/a_star_heartbeat.service

Add the following lines, again adjusting User and the path if necessary:

Description=Romi Slave Heartbeat
After=multi-user.target

[Service]
User=pi
Type=idle
ExecStart=/usr/bin/python3 /home/pi/pololu-rpi-slave-arduino-library/pi/heartbeat.py

[Install]
WantedBy=multi-user.target

Enable and start these services:

sudo systemctl enable a_star_slave
sudo systemctl enable a_star_heartbeat
sudo systemctl start a_star_slave
sudo systemctl start a_star_heartbeat

Expansion Ideas

Now that you have the basics of controlling your Romi chassis from a Raspberry Pi down, here are a few fun project ideas that take advantage of the Raspberry Pi’s processing power and the Romi’s encoders:

  • Mapping a space with a camera and distance data from the encoders.
  • Looped maze solving or dead reckoning.
  • Calculating and driving a path based on a line processed from an image file.

If you try out one of those project ideas, or any other project with a Romi and Raspberry Pi, we would love to hear about it and see pictures of what you made. Please share in the comments below! If you have technical issues getting the project to work, however, and you need some help, it’s better to go through technical support.

“Knock knock unlock” puzzle box

via Pololu Blog

With the holiday season upon us, many are on the hunt for interesting projects that we can give as gifts. This year, why not make your project about unveiling your gift? You would still have to get an actual gift to put inside the box, but you’d win major style points. Forum member Bob Day’s knock knock unlock puzzle box has no visible way of opening it, but given the right combination of knocks will unlatch itself with the help of a servo and several other electronic components inside. The puzzle box is controlled by an A-Star Micro, which is powered by our S7V8F5 voltage regulator and a mini LV pushbutton power switch. The power switch is turned on by a mercury tilt switch and turned off by the A-Star if no knocks are received for about 30 seconds. This power switch circuit allows power to be completely turned off, which should extend the battery life tremendously over just leaving the A-Star on. (For advanced microcontroller programmers, another option would be to put the A-Star into a low-power mode.) A list of the parts and connections used and some example code for the box are given on Bob’s blog.

“Knock Knock Unlock” Puzzle Box outside view.

If you found this project interesting, you might also like a similar GPS puzzle box, also created by Bob, that we featured on our blog last year. That box unlocked when brought to a specific location and included a simpler toggle switch for power and an LCD screen.

New D24V150Fx 15A step-down voltage regulator family — our highest-power regulators yet!

via Pololu Blog

I am excited to announce that we just released our highest power regulators ever. The new D24V150Fx family of step-down regulators includes units with 3.3 V, 5 V, 6 V, 7.5 V, 9 V, and 12 V outputs and can output currents of around 15 A! With all of the output voltages available, the D24V150Fx family of regulators is great for a variety power-hungry projects like running servos or our metal gearmotors and supplying large LED displays.

Pololu Step-Down Voltage Regulator D24V150Fx in a breadboard, assembled with terminal blocks and male headers.

Pololu Step-Down Voltage Regulator D24V150Fx, bottom view with dimensions.

The maximum continuous output currents for all the members of the D24V150Fx family are shown in the graph below. You can see that the available output current is generally a little higher for the lower-voltage versions than it is for the higher-voltage versions, and it decreases as the input voltage increases.

These regulators accept input voltages up to 40 V and have typical efficiencies between 80% and 95%. Integrated reverse-voltage protection, over-current protection, over-temperature shutoff, undervoltage lockout, and soft-start features make these regulators robust, and a power good output can be used to monitor the output voltage.

See the product pages for any of the D24V150Fx regulators for more information on these new regulators, or visit our voltage regulator category to see all of our regulator options.

Remote control food

via Pololu Blog

With Halloween on its way, and trick-or-treating eminent, you might be asking yourself if there are any alternative uses for the mountain of candy bars your kids will soon be bringing home. Well, customer Mike Kohn, whose projects we previously blogged about, has a solution for giving new life to not just candy, but all sorts of unwanted food items: remote controlled food!

For this project, Mike ditched plastic and aluminum and tried out a sampling of more savory chassis materials like candy bars, a carrot, a bell pepper, a grapefruit, and a chicken sausage. The candy bars, carrot, and sausage were used for four-wheeled differential drive cars and the pepper and grapefruit were used for boats. All the vehicles were actuated by a pair of micro metal gearmotors and the cars also used our 32mm wheels. Below is a picture of one car made with a 3 Musketeers bar.

Mike also wrote his own firmware for decoding the IR signals from a Syma S107 controller. You can find out which foods made the best chassis and plenty more information about the vehicles, including a parts list, schematic, and several other videos, on Mike’s website.

Video: Smart lane changing Zumo robot

via Pololu Blog

Forum member WaterBoy23 recently shared his robot which expanded upon the line following capabilities of our Zumo Robot for Arduino by adding in lane changing capabilities. The robot changes lanes when it detects a vehicle ahead of it, and is programmed to either pass the vehicle or return quickly to its original lane if it detects oncoming traffic. His robot uses two Arduino Uno boards, one for following the line and the other for reading ultrasonic position sensors. More information about the robot can be found in WaterBoy23’s post on our forum.