资讯专栏INFORMATION COLUMN

NAO机器人学习小计

zzzmh / 1411人阅读

摘要:性能和约束只在机器人端可用。机器人的中心在脚上,并且机器人的躯干是笔直向上的的。相对速度,范围从一个布尔值,表明目标姿势是否正确达到。在操控机器人时,使用这个方法以达到显示出动作的效果。机器人可能需要使用者的帮助以达到这个姿势。

NAO APIs

nao的接口全部以AL开头,全部继承自ALModule,它被包含在中。
下面是ALModule的主要methods。

ALModule APIs

namespace : AL

#include 

任务调度

ALModule::isRunning()
bool ALModule::isRunning(const int& id);
确定被一个‘post’创建的方法是否还在运行。(注:post可能类似于一个线程池管理员,方法的编号可能类似于线程号)。

params: id - 被post所返回的函数的编号
return: true表示该方法正在被执行,false表示该方法没有被执行。

ALModule::wait()
bool ALModule::wait(const int& id, const int& timeour);
等待编号为id的方法执行完毕。

params: id - 被post所返回的函数的编号
        timeout - ms为单位,表示
return: true表示该方法正在被执行,false表示该方法没有被执行。

ALModule::stop()
void ALModule::stop(const int& id);
根据id停止相应方法。比较提倡模块开发人员实现这个接口,当模块内包含长时间执行的方法,而又希望允许用户打断。

params: id - 被post返回的方法的编号
return:

ALModule::exit()
void ALModule::exit();
将这个模块从父经纪人(parent broker)中注销。一旦这个方法被调用,这个模块将不再可用。开发人员应该在希望执行彻底的关机任务时重写这个方法。


——warning:
不建议在核心模块(例如 ALMemory 或者 ALMotion)中存在别的模块或者方法正在调用它们时使用。


Bound Methods - Introspection
(↑不太理解,字面翻译是:绑定的方法-反思)

ALModule::getBrokerName()
std::string ALModule::getBrokerName();
获取父经纪人的名称

return: 父经纪人的名称。

ALModule::getMethodList()
std::vectore ALModule::getMethodList();
获取当前模块的方法名称列表。

return: 包含方法名称的向量。

ALModule::getMethodHelp()
AL::ALValue ALModule::getMethodHelp(const std::string& methodName);
获取一个方法的描述文档。

params: methodName - 方法的名称
return: 一个包含了方法的描述内容的结构体

注:
AL::ALValue [
    std::string methodName, 
    [ parameter, ... ]
    std::string returnName,
    std::string returnDescription
]

parameter:
[
    std::string parameterName,
    std::string parameterDescription
]

ALModule::getModuleHelp()
AL::ALValue ALModule::getModuleHelp();
获取当前模块的描述。

return: 一个包含模块描述的结构体。

注:
AL::ALValue
[
    std::string moduleDescription,
    [ moduleExample, ... ]
]

moduleExample:
[
    std::string language,
    std::string example
]

ALModule::getUsage()
std::string ALModule::stop(const std::string& methodName);
根据函数名称返回该函数的用法。

params: methodName - 函数名称。
return: 总结了该函数用法的字符串。

ALModule::ping()
bool ALModule::ping();
单纯为了测试连接的ping。永远返回true

return: true

ALModule::version()
std::string ALModule::version();
返回模块的版本

return: 模块的版本信息字符串。

以上接口将作为公共接口存在于所有模块中。


由于我们的项目以通信为主,因此我们优先关注通信模块ALConnectionManagerProxy

概览:
ALConnectionManager提供管理网络连接的方法。它包含了一些允许你连接或配置一个网络的命令,并且也可以获取网络的属性或者创建一个网络。
ALConnectionManager支持的网络包括:以太网、无线网和蓝牙。
主要的特性包括:

列举出所有可用的网路服务。

连接到一个网络服务。

创建一个网络服务(包括WiFi热点以及蓝牙个人局域网(Bluetooth PAN))。

列举可用的网络技术(WiFi、蓝牙、以太网)。

对一个网络服务进行配置。

这个模块提供网络服务的一些有用的信息,比如WiFi连接的强度、现在的状态、以及安全要求。

这个模块通过事件机制来通知网络的变化。

性能和约束:

ALConnectionManager只在机器人端可用。

暂时不支持WPA安全加密。

搜索可用wifi热点的功能在热点模式下不可用。

ALConnectionManager不处理蓝牙设备的配对过程。

ALConnectionManager APIs

namespace : AL

#include 

连接管理模块继承自ALModule API。它也有自有的下列方法:

ALConnectionManagerProxy::state()
ALConnectionManagerProxy::services()
ALConnectionManagerProxy::technologies()
ALConnectionManagerProxy::service()
ALConnectionManagerProxy::connect()
ALConnectionManagerProxy::disconnect()
ALConnectionManagerProxy::forget()
ALConnectionManagerProxy::setServiceConfiguration()
ALConnectionManagerProxy::setServiceInput()
ALConnectionManagerProxy::scan()
ALConnectionManagerProxy::enableTethering()
ALConnectionManagerProxy::disableTethering()
ALConnectionManagerProxy::getTetheringEnable()
ALConnectionManagerProxy::tetheringName()
ALConnectionManagerProxy::tetheringPassphrase()
ALConnectionManagerProxy::countries()
ALConnectionManagerProxy::country()
ALConnectionManagerProxy::setCountry()
ALConnectionManagerProxy::interfaces()

ALConnectionManagerProxy::state()
std::string ALConnectionManagerProxy::state();
返回网络连接的状态(全局)。可能的值包括:
· "online" - 当有互联网连接可用时。
· "ready" - 至少有一个设备被成功地连接
· "offline" - 目前没有设备连接到nao

return: 全局的连接管理器状态。

示例代码:

#python 2.7
 
from naoqi import ALProxy

NAO_IP = "127.0.0.1"

alConnectionManager = ALProxy("ALConnectionManager", NAO_IP, 9559)

print "network state: " + alConnectionManager.state()

ALConnectionManagerProxy::scan()
std::string ALConnectionManagerProxy::state();
搜索临近的网络服务(包括所有可用的网络技术)。可用服务的列表会被刷新,并在稍后被显示,这很有用。

ALConnectionManagerProxy::services()
AL::ALValue ALConnectionManagerProxy::services();
返回包含所有可用网络服务的名称以及属性的列表。在此之前调用`ALConnectionManagerProxy::scan()`会更有用。

return: 一个ALValueNetworkInfo的数组。

示例代码:

#列出所有可用的网络服务

#coding=utf-8

from naoqi       import ALProxy

NAO_IP = "127.0.0.1"

alconnman = ALProxy("ALConnectionManager", NAO_IP, 9559)

#Scanning is required to update the services list
alconnman.scan()
services = alconnman.services()

for service in services:
    network = dict(service)
    if network["Name"] == "":
        print "{hidden} " + network["ServiceId"]
    else:
        print network["Name"] + " " + network["ServiceId"]

ALConnectionManagerProxy::service()
AL::ALValue ALConnectionManagerProxy::service(const std::string& serviceId);
返回一个指定的服务名称的服务的网络属性。网络信息NetworkInfo通过ALValue来表示。

params: serviceId - 希望获得属性的网络服务名称
return: 指定的服务名称网络的属性。
throws: 该网络服务不可用时,抛出ALError

示例代码:

#获得一个网络服务的属性
#coding=utf-8
from naoqi import ALProxy
import sys

NAO_IP = "127.0.0.1"

if len(sys.argv) != 2:
    print sys.argv[0] + " "
    sys.exit(1)

alconnman = ALProxy("ALConnectionManager", NAO_IP, 9559)

try:
  service = alconnman.service(sys.argv[1])
except Exception as e:
    print e.what()
    sys.exit(1)

service = dict(service)
print "Network Service: " + sys.argv[1]
for key, value in service.iteritems():
    print "	" + key + ": " + str(value)

ALConnectionManagerProxy::connect()
void ALConnectionManagerProxy::connect(const std::string& serviceId);
连接到一个网络服务。

params: serviceId - 将要连接到的网络的名称
throws: 该网络服务不可用时,抛出ALError

注意:

如果在连接到这个网络时需要别的信息(比如需要登录密码,或者登录隐藏网络需要网络名称时),将会产生一个event。

See also

NetworkServiceInputRequired(), NetworkConnectStatus()

示例代码:

#连接到一个网络
from naoqi import ALProxy
import sys

NAO_IP = "127.0.0.1"

if len(sys.argv) != 2:
    print sys.argv[0] + " "
    sys.exit(1)

alconnman = ALProxy("ALConnectionManager", NAO_IP, 9559)

try:
    alconnman.connect(sys.argv[1])
except Exception as e:
    print e.what()
    sys.exit(1)

ALConnectionManagerProxy::disconnect()
void ALConnectionManagerProxy::disconnect(const std::string& serviceId);
断开到一个网络服务的连接。

params: serviceId - 将要断开的网络的名称
throws: 该网络服务不可用时,抛出ALError

示例代码:

#断开一个网络连接
from naoqi import ALProxy
import sys

NAO_IP = "127.0.0.1"

if len(sys.argv) != 2:
    print sys.argv[0] + " "
    sys.exit(1)

alconnman = ALProxy("ALConnectionManager", NAO_IP, 9559)

try:
  alconnman.disconnect(sys.argv[1])
except Exception as e:
    print e.what()
    sys.exit(1)
ALConnectionManagerProxy::disconnect()
void ALConnectionManagerProxy::forget(const std::string& serviceId);
忘记一个偏好网络。需要获得网络服务的名称来忘记相关联的信息。这还会使得这个网络不再是偏好网络,并且不会被自动连接。

params: serviceId - 将要忘记的网络的名称
throws: 该网络服务不可用时,抛出ALError

示例代码:

#忘记一个网络
from naoqi import ALProxy
import sys

NAO_IP = "127.0.0.1"

if len(sys.argv) != 2:
    print sys.argv[0] + " "
    sys.exit(1)

alconnman = ALProxy("ALConnectionManager", NAO_IP, 9559)

try:
  service = alconnman.forget(sys.argv[1])
except Exception as e:
    print e.what()
    sys.exit(1)

ALConnectionManagerProxy::setServiceConfiguration()
void ALConnectionManagerProxy::setServiceConfiguration(const AL::ALValue& configuration)
给定需要应用的静态网络配置。以下属性在静态配置中是可用的:
· 是否自动连接
· 域名
· 域名服务器
· IPv4
· IPv6(实验性的)

params: configuration - 一个将要被应用网络配置的包含了NetWorkInfo的ALValue。
throws: 当网络服务不可用的时候抛出ALError
        当配置信息不合法时抛出ALError
        当网络服务不需要配置时抛出ALError

See also
NetworkInfo

(未完)




ALRobotPosture模块 概览

暂时现在看看motion部分的模块。ALRobotPosture模块允许用户将机器人定位到已经定义好的姿势。
可以选择使用ALRobotPostureProxy::goToPosture()或者ALRobotPosture::applyPosture.

如果想要创建一个自动化的应用,务必选择ALRobotPostureProxy::goToPosture().

如果你仅仅希望在操控机器人时,迅速达到某个姿势,可以选择ALRobotPostureProxy::applyPosture,(你必须要协助机器人)。

这如何工作?

机器人会侦测到现在它正处于那种姿势,然后计算出一个路径,使得它可以从现在的姿势变换到目标姿势,然后执行这条线路。

可能允许选择姿势变换的速度。

定义 姿势

机器人的姿势是一个独特的,对他的关节和惯性传感器的配置。
由于姿势是由一组实数(比如说float)定义的,所以会有无数种姿势。

预定义的姿势

下面是预定义的姿势列表:

蹲伏(Crouch)

仰面躺(LyingBack)

面向下趴着(LyingBelly)

正坐(Sit)

箕踞(SitRelax)

站立(Stand)

预行走站立(StandInit)

向前看齐(StandZero)

有一些姿势(比如Sit或Lying)并不是对所有机器人都是可用的。

使用ALRobotPostureProxy::getPostureList()来获取你的机器人上可用的预定义的姿势列表。

姿势族

由于姿势的种类有无数种,姿势被划分为姿势族,以是的姿势更加容易理解。
以下是姿势族列表:

使用ALRobotPostureProxy::getPostureFamilyList(),就可以知道你的机器人上有哪些可用的姿势族。它一定是下面这个列表的子集。

Posture Family Description
Standing 机器人的中心在脚上,并且机器人的躯干是笔直向上的的。
Sitting 机器人的尾部接触地面,并且躯干是笔直向上的。
SittingOnChair 机器人的尾部接触一个高约10cm的椅子,并且躯干是笔直向上的。
LyingBelly 身体平展,并且面向下
LyingBack 身体平展,并且面向上
LyingLeft 身体平展,并且面向右侧
LyingRight 身体平展,并且面向左侧
Belly 面向下并且躯干悬空
Back 面向后并且躯干悬空
Left 膝盖跪向左侧,并且手部着地
Right 膝盖跪向右侧,并且手部着地

namespace:AL

方法列表

和别的模块一样,这个模块继承自ALModule API。它也有自有的下列方法。

class ALRobotPostureProxy

ALRobotPostureProxy::getPostureList()

ALRobotPostureProxy::getPosture()

ALRobotPostureProxy::goToPosture()

ALRobotPostureProxy::applyPosture()

ALRobotPostureProxy::stopMove()

ALRobotPostureProxy::getPostureFamily()

ALRobotPostureProxy::getPostureFamilyList()

ALRobotPostureProxy::setMaxTryNumber()

事件

PostureFamilyChanged()

PostureChanged()

方法 ALRobotPostureProxy::getPostureList()
std::vector ALRobotPostureProxy::getPostureList();
返回一个包含所有已经定义姿势的列表。

return: 包含所有已定义姿势的向量

ALRobotPostureProxy::getPosture()
std::string ALRobotPostureProxy::getPosture()
返回现在的**预定义姿势**名称。如果现在的姿势不是预定义姿势,就会返回"Unknown".
return: 一个包含现在姿势的名称的字符串。
ALRobotPostureProxy::goToPoture()
bool ALRobotPostureProxy::gotoPosture(const std::string postureName, const float speed);
让机器人变换到预定义的姿势。速度可能是可以调节的。这个变化是“智能的”,它会从现在已有的开始姿势,自动选择每一步,以变换到目标姿势。
这是一个会阻塞的函数调用。如果希望它不会阻塞线程,使用post。
params: postureName - 预定义的姿势名称字符串。
        speed - 相对速度,范围从0.0 - 1.0
return: 一个布尔值,表明目标姿势是否正确达到。

ALRobotPostureProxy::applyPosture()
bool ALRobotPostureProxy::applyPosture(const std::string& postureName, const float& speed);
将所有的预定义姿势中提到的关节设置到定义中的状态。
在操控机器人时,使用这个方法以达到显示出动作的效果。请将他想象成一条姿势变换的捷径,假设这是你想要快速达到某一个姿势。机器人可能需要使用者的帮助以达到这个姿势。
这个方法的效果是立即的,并且其中没有只能因素在里面。所以在设置姿势时,请小心。比方说,如果机器人现在正坐着,你调用了applyPosture("StandInit", 1.0)。这对于机器人可能是非常危险的,如果你不帮助机器人站起来的话,它就会跌倒。
如果你想要机器人独立地站起来,调用goToPosture().
这是一个会阻塞的函数调用。如果希望它不会阻塞线程,使用post。

params: postureName - 预定义的姿势名称字符串。
        speed - 相对速度,范围从0.0 - 1.0
return: 一个布尔值,表明目标姿势是否正确达到。

ALRobotPostureProxy::stopMove()
void ALRobotPostureProxy::stopMove();
停止当前的姿势插补动作。

ALRobotPostureProxy::getPostureFamily()
std::string ALRobotPostureProxy::getPostureFamily();
返回姿势族。

return: 返回当前的姿势族名称。

ALRobotPostureProxy::getPostureFamilyList()
std::vector ALRobotPostureProxy::getPostureFamilyList();
返回一个包含了所有预定义的姿势族名称的向量。

return: 一个包含了所有预定义姿势族名称的vector.

ALRobotPostureProxy::setMaxTryNumber(const int& maxTryNumber)
void ALRobotPostureProxy::setMaxTryNumber(const int& maxTryNumber);
设置当调用`ALRobotPostureProxy::goToPosture()`返回失败之前,最大的尝试次数。

params: maxTryNumber - 尝试的次数,默认值是3.
Event: "PostureFamilyChanged"
callback(std::string eventName, std::string PostureFamily, std::string subscriberIdentifier);
当姿势族发生改变时,传递出姿势族的名称。
这个事件的更新频率大约是一秒钟。

Event: "PostureChanged"
callback(std::string eventName, std::string Posture, std::string subscriberIdentifier):
当姿势发生改变时,传递出姿势的名称。
这个事件的更新频率大约是一秒钟。

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/44181.html

相关文章

  • 神经架构优化(NAO):新的神经架构搜索(NAS)算法

    摘要:有了我们的新方法,叫做神经架构优化,我们利用基于梯度的方法在更紧密的空间中做优化。表如下展示了不同卷积神经网络架构在图片分类数据集上的表现,这些架构由不同算法生成。 如果你是一名深度学习实践者,你可能发现自己经常会遇到同一个关键问题:我应该为现在的任务选择哪种神经网络架构?这个决定取决于多种因素以及很多其他问题的答案。我应该给这一层选择什么操作----卷积,深度可分卷积,或者较大池化?卷积层...

    ThreeWords 评论0 收藏0
  • 小计算大能量,新技术促使数据中心体量变小

    摘要:如今,数据中心是计算领域最大的参与者,为了能够跟上互联网经济指数增长,人们有必要了解未来的数据中心会是什么样子。随着技术发展允许小型计算单元处理大量的工作,因此这些规模较小的数据中心分布更广泛的动机将变得非常明显。如今,数据中心是计算领域最大的参与者,为了能够跟上互联网经济指数增长,人们有必要了解未来的数据中心会是什么样子。多年来,人们一直认为大量的服务器将被安置在类似科幻小说的摩天大楼中。...

    Flink_China 评论0 收藏0
  • 12.16前端无障碍学习小计

    摘要:屏幕阅读器的两种方式读角色名轻松识别的声音一般,如果配置正确,屏幕阅读器一般会有,,,控件的文字绑定放入标签或标签加入目标绑定目标交互控件的属性是图片的替代文本将图片不需要的代替文本设置为空,将会从无障碍树移除,从而跳过在合适的情况下,应该 屏幕阅读器的两种方式:1.读角色名;2.轻松识别的声音 一般,如果配置正确,屏幕阅读器一般会有Role,Name(lable),State,Val...

    Kerr1Gan 评论0 收藏0
  • 2019.1.21 canvas学习小计

    var c = document.querySelector(#drawing); var ctx = c.getContext(2d); var image = new Image(); image.onload = function() { ctx.drawImage(image, 0, 0); } image.src = images/palette.jpg; var makePixe...

    MangoGoing 评论0 收藏0
  • 2018.12.24 无障碍学习小计

    摘要:在中的规范,包括关于角色可以使用哪些元素和不使用哪些元素的指导英不启用将网页某个部分标记为,以便及时向用户显示更新内容,而不是用户浏览这部分网站时更新可能位于初始页面加载中不同的屏幕阅读器和辅助技术对不同更改的响应不同,如果辅助技术不 ARIA 在 HTML 中的规范,包括关于 ARIA 角色可以使用哪些 HTML 元素和不使用哪些 HTML 元素的指导 https://www.w3....

    Fundebug 评论0 收藏0

发表评论

0条评论

zzzmh

|高级讲师

TA的文章

阅读更多
最新活动
阅读需要支付1元查看
<