close-circle
Close

Workshop Details: Roboto

A event log for Hackaday Munich

Workshop and Party to award the 2014 Hackaday Prize

Mike Szczys 10/29/2014 at 21:173 Comments

You choose between a robot arm or a two-wheeled rover, then pair it up with a development board for a microcontroller that is new to you.

The challenge is to connect the bot to the board and then write the firmware to accomplish a simple task. For the robot arm you'll need to pick up a small object and place it in a box. The rover uses an ultrasonic distance senor as its only input. Will you be able to navigate the maze using this crude level of sensing?

Before you arrive:

Both of these robots use servo motors. To succeed at these workshops you will need to use properly timed PWM signals to drive them.

Make sure you hit the ground running on the day of the workshop. Before you arrive do as much research as you can about the boards listed below. Look for servo libraries or research implementing the servo timing yourself. At the very least, set up the toolchains on your computer so that you'll be ready to start coding as soon as you sit down.

If you do not have a workshop ticket:

It's okay, you can still come and have a fun time in several ways. First off, head over to the Hackaday Munich page and get an "All Day" ticket. Now here are your options:

For those that already have Robot Workshop tickets:

Get those embedded programming chops ready, this is going to be a ton of fun! Pull out the laptop you plan to bring with you to the workshop and load up the toolchain you would like to use. This will save you a ton of time the day-of the event. Here are details on the development boards we have lined up so far:

Texas Instruments Tiva C Launchpad

TI has committed 20 of their Tiva C Launchpad boards which features the TM4C123GH6PM which is a 32-bit ARM Cortex-M4 running up to 80MHz with 256 KB of flash and 32KB of SRAM. This chip includes hardware-PWM generators which will come in handy for these challenges.

Resources:

  1. Product page: http://www.ti.com/tool/ek-tm4c123gxl
  2. Development tools:
    1. Code Composer Studio is available for free (code-limited): http://www.ti.com/lsds/ti/microcontrollers_16-bit_32-bit/c2000_performance/tools_software.page#ccstudio
    2. Development using a Linux machine is possible.
      1. You will need to install an arm-none-eabi-xxx toolschain.
        1. We asked on Twitter about this and the pre-compiled toolchain maintained by Pebble (the smartwatch company) was suggested: https://developer.getpebble.com/download-sdk/linux/
        2. It has been suggested the the arm-none-eabi-gcc package in the Ubuntu 14.04 repos is not up to day. You may consider trying this PPA: https://launchpad.net/~terry.guo/+archive/ubuntu/gcc-arm-embedded
      2. Install OpenOCD (to flash the binary to the board)
      3. A template for compiling your code is found here: https://github.com/szczys/tiva-c-launchpad-template
      4. Don't forget the TivaWare Package which includes header files and peripheral libraries: http://www.ti.com/tool/sw-tm4c

TI has also committed 20 SimpleLink WiFi Boosterpacks and 20 Sensor Hub BoosterPacks.

Atmel SAM D20 Xplained Pro Evaluation Kit

Atmel has committed 20 of their SAM D20 Xplained Pro evaluation kits. These feature a ATSAMD20J18 which is an ARM Cortex-M0+ running up to 48 Mhz with 256 KB of Flash and 32 KB of SRAM.

Resources:

  1. Product page: http://www.atmel.com/tools/atsamd20-xpro.aspx
  2. Development Tools:
    1. Atmel Studio: http://www.atmel.com/microsite/atmel_studio6/default.aspx
    2. Development using a Linux machine is possible:
      1. Guide: https://plus.google.com/+AndreyYurovsky/posts/5JTehC7ngTq
        1. I used this PPA for the toolchain: https://launchpad.net/~terry.guo/+archive/ubuntu/gcc-arm-embedded
        2. There are some typos (remove the '4' in the OpenOCD config file name, etc.)
        3. I had to explicitly enable cmsis-dap when configuring OpenOCD: ./configure --enable-maintainer-mode --enable-cmsis-dap --enable-hidapi-libusb
        4. If you get an error finding the libhidapi-redraw.so.0 see here: http://karibe.co.ke/2013/08/setting-up-linux-opensource-build-and-debug-tools-for-freescale-freedom-board-frdm-kl25z/

Examples:

  1. Atmel's API for PWM: http://www.atmel.com/Images/Atmel-42123-SAM-D20-D21-Timer-Counter-Driver-TC_Application-Note_AT03263.pdf

Freescale FRDM-KL25Z Freedom Board

Freescale is sending their FRDM-KL25Z Freedom Board to the Hackaday Munch Embedded Hardware Workshop. This board features the MKL25Z128VLK4 which is an ARM Cortex-M0+ chip that runs at up to 48MHz with 128KB Flash and 16KB SRAM.

Resources:

  1. Product Page: http://www.freescale.com/webapp/sps/site/prod_summary.jsp?code=FRDM-KL25Z#
  2. Development Tools:
    1. Evaluation versions of IDE include CodeWarrior and Keil: http://www.freescale.com/webapp/sps/site/prod_summary.jsp?code=FRDM-KL25Z&fpsp=1&tab=Design_Tools_Tab
    2. You can use the mBed environment: http://developer.mbed.org/handbook/mbed-FRDM-KL25Z-Getting-Started
      1. Requires a simple firmware upgrade: http://developer.mbed.org/handbook/mbed-FRDM-KL25z-Upgrade
    3. Linux Bare Metal template: https://github.com/payne92/bare-metal-arm
      1. We haven't tested this yet
      2. It has been suggested the the arm-none-eabi-gcc package in the Ubuntu 14.04 repos is not up to day. You may consider trying this PPA: https://launchpad.net/~terry.guo/+archive/ubuntu/gcc-arm-embedded
    4. Mega-resource for GNU ARM tools for these Kinetis boards: http://mcuoneclipse.com/2013/07/20/dyi-free-toolchain-for-kinetis-part-1-gnu-arm-build-tools/

Examples:

  1. mbed PWM api: http://developer.mbed.org/users/mbed_official/code/mbed/docs/031413cf7a89/classmbed_1_1PwmOut.html#ae90809b159b1af641a257b3505c56c41

Microchip TCHIP010 Fubarino SD Board

Microchip has offered up 20 of their Fubarino SD Boards. These Open Hardware boards host a PIC32MX795F512H chip which runs at up to 80 MHz, boasts 512KB of Flash and 128KB of RAM.

Resources:

  1. Product page: http://www.microchip.com/DevelopmentTools/ProductDetails.aspx?PartNO=TCHIP010&utm_source=MicroSolutions&utm_medium=&utm_term=&utm_content=&utm_campaign=Fubarino+SD+Dev+Board
  2. Fubarino website: http://fubarino.org/
  3. Program using MPIDE (a fork of the Arduino IDE): http://chipkit.net/started/install-chipkit-software/

Hobby Servos and Ultrasonic Sensors

The Challenge in this workshop isn't merely to get a toolchain for an unfamiliar chip architecture working. We actually need to so something with the hardware. Blinking LEDs is always a good proof that everything is working, but we want to go further. Let's drive some robots using servo motors. If you're awesome at that you can also try your hand at reading from an ultrasonic distance sensor.

Controlling Servo Motors

Servo motors are a great step beyond driving an LED because they require precise timing. Here's the workflow I would recommend for developing a servo motor driver:

  1. Blink an LED
    1. This shows that you know how to control the GPIO pins. If you blink at 1 second intervals it is also a simple check to let you know that you are (probably) correctly calculating a delay based on the system clock
  2. Dim an LED using PWM
    1. Whether you're using hardware or software based PWM, dimming an LED gives you simple visual feedback that you've got it working
  3. Figure out your servo timings
    1. Now alter your LED dimming code to use a period of 20ms with a pulse width of 1ms and 2ms. I like to use a delay function to change the duty cycle between the two values. If you look closely you should still be able to see a change in the brightness of the LED
  4. Testing and troubleshooting
    1. Connect it to one of the servo motors
      1. Make sure you are using an in-line resistor to protect the logic circuitry inside the servo in case you've connected it incorrectly
      2. If the servo isn't moving, don't leave it plugged in. Instead, head on over to the oscilloscope and measure your signal to get feedback on the timing problem

Reading an Ultrasonic Distance Sensor

US-100 Datasheet (kind of)

There is a quick tutorial on reading this sensor using an Arduino and the NewPing library: http://arduino-info.wikispaces.com/UltraSonicDistance

The New Ping library itself shows just how easy it is to read from this sensor. You can read the sensor using as UART if the jumper on the back side is in place. But it is very easy to read it without the jumper in place by measuring the pulse-width. You pull the trigger pin high-then-low to signal the start of a reading, then measure the echo pin. Start counting system cycles when that pin goes high, stop counting when it goes low, and use the difference to calculate distance.

Here is the code from the NewPing library that performs the measurement I just described:

// ---------------------------------------------------------------------------
// Standard ping methods
// ---------------------------------------------------------------------------

unsigned int NewPing::ping() {
    // Trigger a ping, if it returns false, return NO_ECHO to the calling function.
    if (!ping_trigger()) return NO_ECHO;
    // Wait for the ping echo.              
    while (*_echoInput & _echoBit)
                // Stop the loop and return NO_ECHO (false) if we're beyond the set maximum distance.                     
        if (micros() > _max_time) return NO_ECHO;
    // Calculate ping time, 5uS of overhead.      
    return (micros() - (_max_time - _maxEchoTime) - 5); 
}
// ---------------------------------------------------------------------------
// Standard ping method support functions (not called directly)
// ---------------------------------------------------------------------------

boolean NewPing::ping_trigger() {
#if DISABLE_ONE_PIN != true
    // Set trigger pin to output.
    *_triggerMode |= _triggerBit;    
#endif
    // Set the trigger pin low, should already be low, but this will make sure it is.
    *_triggerOutput &= ~_triggerBit;
    // Wait for pin to go low, testing shows it needs 4uS to work every time. 
    delayMicroseconds(4); 
    // Set trigger pin high, this tells the sensor to send out a ping.           
    *_triggerOutput |= _triggerBit;  
    // Wait long enough for the sensor to realize the trigger pin is high. Sensor specs say to wait 10uS.
    delayMicroseconds(10);   
    // Set trigger pin back to low.        
    *_triggerOutput &= ~_triggerBit; 
#if DISABLE_ONE_PIN != true
    // Set trigger pin to input (when using one Arduino pin this is technically setting the echo pin to input as both are tied to the same Arduino pin).
    *_triggerMode &= ~_triggerBit;   
#endif

    // Set a timeout for the ping to trigger.
    _max_time =  micros() + MAX_SENSOR_DELAY;
    // Wait for echo pin to clear.                  
    while (*_echoInput & _echoBit && micros() <= _max_time) {}
    // Wait for ping to start. 
    while (!(*_echoInput & _echoBit))
        // Something went wrong, abort.                          
        if (micros() > _max_time) return false;                

    _max_time = micros() + _maxEchoTime; // Ping started, set the timeout.
    return true;                         // Ping started successfully.
}

Discussions

Jasmine Brackett wrote 11/20/2014 at 15:28 point
Don't forget - if you attended Hackaday Munich and picked up a swag envelope, there was a code for 30% off the store. That means you can get 30% off a MeArm - http://store.hackaday.com/products/mearm-pocket-sized-robot-arm

  Are you sure? yes | no

mc wrote 11/11/2014 at 13:01 point
Questions about Tiva C Launchpad on mac OS X ?
1. Is it compatible?
2. IDE : Energia, embedXcode or other?
thanks!

  Are you sure? yes | no

Mike Szczys wrote 10/29/2014 at 21:19 point
I need help fleshing out Linux development resources. If you have a favorite template for programming any of these boards with GCC and other open tools please leave a comment here. Thanks!

  Are you sure? yes | no