SIC
SIC is a framework for quickly getting started with social robotics by making it simple to combine complex devices such as Nao’s and powerful services such as Google Dialogflow.
Getting started with SIC consists of a few basic steps:
Installing SIC on your device
Installing SIC on your robot
Starting Redis and SIC on your device
Starting SIC on your robot
Start your program to control the robot
Installation
You can find the instructions on how to install the framework here: Install.
Setup
Once installed to all devices you want to use, we can start the framework.
This consists of two (or three) steps:
Start Redis
(Optional) Start a service, such as face detection
Run your program
Starting Redis on your laptop
To enable communication between all your devices, we have to start Redis on some device.
This can be done in two ways: By starting redis yourself or using docker.
In a (WSL) terminal, start redis using
Code Block |
---|
# in the `framework` folder:
redis-server conf/redis/redis.conf |
Expand | |||||
---|---|---|---|---|---|
| |||||
Start it on your laptop in the root framework
This should start print |
Optionally, you can now start other services on your laptop, such as text to speech, by starting the service in a terminal. For example:
Code Block |
---|
cd framework/sic_framework/services/text2speech
python3 text2speech_service.py |
or with docker
Code Block |
---|
docker compose up text2speech |
Running a demo
To start a demo, for example to show pepper’s camera output on your screen, simply execute a python script. Some demos are available in the framework/sic_framework/tests
folder.
For example, to show the This guide assumes you already followed the steps here Getting started.
For example, to show the camera feed of the robot:
...
To start the camera demo from the terminal, use the following commands.Note: This demo requires you to have the OpenCV module installed, as well as have the framework installed.
...
it might take some time to start the demo file if the SIC has never been installed on the robot.
Ubuntu / Debian / macOS
Code Block |
---|
# Activate the same virtual environment where you pip installed
# social-interaction-cloud in the installation steps
source venv_sic/bin/activate
# Go to sic_applications and the demo script
cd sic_applications/demos
python demo_nao_camera.py |
Windows
Code Block |
---|
# Activate the same virtual environment where you pip installed
# social-interaction-cloud in the installation steps
.\.venv_sic\Scripts\activate
# Go to sic_applications and the demo script
cd sic_applications\demos
python demo_nao_camera.py |
And, you should get the following output:
Code Block |
---|
Starting SIC on /data/home/nao/.venv_sic/lib/python2.7/site-packages/sic_framework/devices/nao with redis ip 192.168.2.6
[SICComponentManager 192.168.2.7]: INFO: - NaoqiSpeakerComponent
[SICComponentManager 192.168.2.7]: INFO: - NaoqiButtonSensor
[SICComponentManager 192.168.2.7]: INFO: - NaoqiAutonomousActuator
[SICComponentManager 192.168.2.7]: INFO: - NaoqiMicrophoneSensor
[SICComponentManager 192.168.2.7]: INFO: - NaoqiMotionActuator
|
...
[SICComponentManager 192.168.2.7]: INFO: - NaoqiBottomCameraSensor
[SICComponentManager 192.168.2.7]: INFO: - NaoqiStiffnessActuator
[SICComponentManager 192.168.2.7]: INFO: - NaoqiMotionRecorderActuator
[SICComponentManager 192.168.2.7]: INFO: - NaoqiTextToSpeechActuator
[SICComponentManager 192.168.2.7]: INFO: - NaoqiTrackerActuator
[SICComponentManager 192.168.2.7]: INFO: - NaoqiTopCameraSensor
[SICComponentManager 192.168.2.7]: INFO: - NaoqiLookAtComponent |
If all goes well, a display should pop up showing you the camera output of your robot!
API
The goal of SIC is to provide easy to use high level access to devices and services. For example, to make a NAO robot say something, run the following python script on your laptop! To see more functionality check out the framework/sic_frameworkapplications /testsdemos folder!
Code Block | ||
---|---|---|
| ||
from sic_framework.devices import Nao from sic_framework.devices.common_naoqi.naoqi_text_to_speech import NaoqiTextToSpeechRequest nao = Nao(ip='192.168.0.151') # adjust this to the IP adress of your robot. nao.tts.request(NaoqiTextToSpeechRequest("Hello!")) |