Your first steps in Choregraphe

How to make NAO do something

To make NAO do something with Choregraphe:

  1. Connect NAO to Choregraphe. See How to connect.
  2. Create a behavior. See How to create a behavior.
  3. Play the behavior! See How to play a behavior.

If you follow these three steps, NAO should obey you, congratulations! Now you may want to jump to more advanced thing, see Choregraphe Tutorials, or have a deeper look, see Menus, Panels and Toolbar in a glance.

How to create a behavior

To create a behavior, you have to drag and drop boxes from a box library to the flow diagram, and connect them so as to make the robot do what you actually want.

Here is a short example, if you want to make your robot say “Hello!”:

  1. Select the Audio > Voice > Say box from the box library.

  2. Drag and drop it onto the flow diagram located in the center of Choregraphe.

  3. Use your mouse to connect the input, located at the upper left of the flow diagram, to the input of the box as illustrated on the diagram below.

    ../../_images/beginning_hello.png

And this is it, your behavior is finished.

Note

It is also possible to create your own boxes (see How to create boxes).

How to play a behavior

From the main window of Choregraphe, click on Connection > Play or on the following button in the toolbar:

../../_images/beginning_play_button.png

Note

Make sure you are connected to a robot, otherwise this icon will be disabled!

The behavior of your root diagram is now executed by the NAO you are connected to.

Note

You can also launch unconnected boxes alone by double-clicking on their ‘onStart’ input, once the behavior has been played.

How to stiffen NAO

Note

In Choregraphe, set the stiffness or “enslave” is the action to provide power to the motors of your robot. When your NAO is not stiffened, its limbs are soft like a puppet, its motors do not have power. To execute behaviors and see the result on your connected NAO, you have to stiffen it, giving power to the motors.

In Choregraphe, an icon gives the current Stiffness state of your robot. There are 3 different icons color:

Icon Description
../../_images/beginning_enslave.png NAO is not stiffened. NAO will not move during the behavior.
../../_images/beginning_intermediate.png Intermediate state. Stiffness of each joint can be customized when executing particular movements.
../../_images/beginning_unenslave.png

NAO is stiffened. It is able to execute any move you are working on.

Warning

Do not try to move its limbs manually as its motors are geared up.

To stiffen NAO, just click on the icon in the toolbar. The icon should turn red, meaning your robot is stiffened.

How to make NAO walk

Walking is very complicated movement that can’t be designed by keyframe animation.

This is why we have developed other tools that should help you.

One of the main modules of the robot is ALMotion.

This module has been designed to understand simple orders such as “move this motor to this position in that amount of time”, but also walking orders: “head straight for one meter”.

Well in fact, the orders may be a lot more complex, as you can define all the walking patterns parameters, but we are not going into the specifics now.

  1. Drag and drop the Motion > WalkTo box.

  2. Click on the adjustable wrench to edit the box parameters.

    The first two parameters define the target position of the robot, relative to its position and orientation when the box is triggered.

    X=1 and Y=0 is one meter in front of the robot.

    X=0 and Y=1 is one meter to the left of the robot.

    The third parameter is the desired orientation of the robot, still relative to its orientation when the box is triggered.

    Two checkboxes enable the arm movement during the walk.

  3. Come back to the root level and connect the behavior entry to your box.

  4. Click on Play.

    Your robot walks.

Go on and test the various parameters for the walk box.

For further details on the trajectories you can have look at the “Walking” section of the Motion documentation, in the “Destination Control” sub-section.

How to make NAO say something

This section will show you how to make NAO say something different than hello.

  1. Drag and drop the Audio > Voice > Say box onto your diagram.

  2. Link it to the beginning of the root behavior. Your diagram should look like that:

    ../../_images/beginning_hello1.png

    If you start the behavior, NAO will say Hello, here is the way to change what NAO will say:

  3. Double click on the Say box in order to get into it.

    Your diagram should look like that:

    ../../_images/chore_flow_diagram_inside_say_box.png

    The Say box has an intern flow diagram gathering two box, the first one is a Localized Text box and the second one is the script box that handles the speaking process.

  4. Change the text in the Localized Text box to make NAO say what you want. If you want to change NAO language see How to change NAO language section.

How to change NAO language

< For real NAO only > < Not available on virtual robot >

The only way to change NAO language in Choregraphe is to use the Audio > Voice > Set Speech Lang. box:

  1. Drag and drop the Audio > Voice > Set Speech Lang. box onto your diagram.

  2. Link the box to the beginning of the root behavior.

    Your diagram should look like that:

    ../../_images/change_language.png
  3. Open the parameter menu of the box by clicking on the adjustable wrench.

  4. Set the language to whatever language you want.

    Note

    The chosen language must be installed on the robot. Another way to change the language of the robot is to use the robot web page.

How to change NAO’s active camera

< For real NAO only > < Not available on virtual robot >

The only way to switch camera with Choregraphe is to use the Select Camera box:

  1. Drag and drop the Vision > Select Camera box onto your diagram.

  2. Play the behavior by clicking on the play button:

    ../../_images/beginning_play_button1.png
  3. Wait until Choregraphe has finished sending the behavior to the robot.

  4. Double click on one or the other input of the box.

    You can see in the video monitor that the camera has changed.

    To display the Video monitor panel, see How to display/hide panels section.

How to set NAO’s volume

< For real NAO only > < Not available on virtual robot >

In Choregraphe, you have different possibilities to set the volume of your robot.

  1. You can click on the volume button in the menu bar, described in the Interface: description and user’s guide section.

    This button displays a slider that allows you to set the volume.

    ../../_images/volume.png
  2. You can also use the Set Speaker Volume box.