ProCon说明   快速入门   运动控制   EtherCAT   实时程序   API函数   控件库   硬件说明   问题排查   示例代码  
  

Notime

获取内部版本号

 函数  NO_API NOS_GetVersion(int* ver)
 功能  获取内部版本号
 参数  ver
 [IN] 内部版本号
 返回值  错误代码
 说明  调用后立即生效
 注意事项  

获取系统时钟

 函数  NO_API NOS_GetUsTick(UINT64* tick)
 功能  获取系统时钟(微秒单位)
 参数  tick  [IN] 系统时钟(微秒单位)
 返回值  错误代码
 说明  调用后立即生效
 注意事项  

微秒延时

 函数  NO_API NOS_SleepUs(UINT32 us)
 功能  微秒延时,分辨率为实时系统的最小调度周期,实时系统的最小周期为实时系统节点配置时设置的Kernel Clock Rate(us)。其精度依据当前核的负载率的情况,在YouKong>ProCon>doc> example>notime >SchedulingCycleThread例子上可以测试实际精度
 参数  us  [IN]  微秒延时
 返回值  错误代码
 说明  调用后立即生效
 注意事项  

选中节点

 函数  NO_API NOS_SetNode(int index)
 功能  选中节点
 参数  index  [IN] 0:NodeA 1:NodeB 2:NodeC 3:NodeD
 返回值  错误代码
 说明  调用后立即生效
 注意事项  

创建共享内存

 函数  NO_API NOS_CreateShareMemory(char* name, UINT32 size, UINT64* handle, UINT32 notime)
 功能  创建共享内存
 参数  name
 size
 handle
 notime
 [IN] 共享内存名称
 [IN] 尺寸,字节单位
 [IN] 返回内存地址
 [IN] 0:windows 1:notime
 返回值  错误代码
 说明  调用后立即生效
 注意事项  

打开共享内存

 函数  NO_API NOS_OpenShareMemory(UINT32 nodeIndex, char* memName, UINT64* oHandle, UINT32 notime)
 功能  打开共享内存
 参数  nodeIndex
 memName
 oHandle
 notime
 [IN] 节点选择 0=NodeA 1=NodeB 2=NodeC 3=NodeD
 [IN] 共享内存名称
 [IN] 首地址
 [IN] 0:windows创建的内容 1:notime创建的内存
 返回值  错误代码
 说明  调用后立即生效
 注意事项  

读写共享内存数据

 函数  NO_API NOS_ReadShareMemory(UINT64 oHandle, int offset, unsigned char* data, int num)
 NO_API NOS_WriteShareMemory(UINT64 oHandle, int offset, unsigned char* data, int num)
 功能  读写共享内存数据
 参数  oHandle
 offset
 data
 num
 [IN] 共享内存首地址
 [IN] 偏移量,字节单位
 [IN] 缓冲区,存放读写数据
 [IN] 读写数量,字节单位
 返回值  错误代码
 说明  调用后立即生效
 注意事项  

创建事件

 函数  UINT64 NOS_CreateEvent(UINT32 ManualReset, UINT32 bInitialState, char* lpName, int lengthName)
 功能  创建事件
 参数  ManualReset
 bInitialState
 lpName
 lengthName
 [IN]0:当一个等待线程被释放后,系统自动重置事件 1:使用ResetEvent手动将事件重置为无信号状态
 [IN] 指定初始状态 0:无信号 1:有信号
 [IN] 事件名称,仅限于英文字符
 [IN] 名称长度,字节单位
 返回值  返回事件句柄
 说明  调用后立即生效
 注意事项  

打开由NOS_CreateEvent创建的事件

 函数  UINT64 NOS_OpenEvent(char* lpName, int lengthName)
 功能  打开由NOS_CreateEvent创建的事件
 参数  lpName
 lengthName
 [IN] 事件名称
 [IN] 名称长度,字节单位
 返回值  返回事件句柄
 说明  调用后立即生效
 注意事项  

将指定的事件对象设置为有信号,然后在释放适当数量的等待线程后将其重置为无信号

 函数  UINT64 NOS_PulseEvent(UINT64 handle)
 功能  将指定的事件对象设置为有信号,然后在释放适当数量的等待线程后将其重置为无信号
 参数  handle  [IN] 事件句柄
 返回值  0:失败 非0:成功
 说明  调用后立即生效
 注意事项  

将事件置为无信号状态

 函数  UINT64 NOS_ResetEvent(UINT64 handle)
 功能  将事件置为无信号状态
 参数  handle  [IN] 事件句柄
 返回值  0:失败 非0:成功
 说明  调用后立即生效
 注意事项  

将事件置为有信号状态

 函数  UINT64 NOS_SetEvent(UINT64 handle)
 功能  将事件置为有信号状态
 参数  handle  [IN] 事件句柄
 返回值  0:失败 非0:成功
 说明  调用后立即生效
 注意事项  

等待单个事件

 函数  UINT64 NOS_WaitForSingleObject(UINT64 hHandle, UINT32 dwMilliseconds)
 功能  等待单个事件
 参数  hHandle
 dwMilliseconds
 [IN] 事件句柄
 [IN] 超时时间(毫秒单位), INFINITE(0xFFFFFFFF)为永不超时
 返回值  NOS_WAIT_OBJECT_0:成功,指定事件被激活
 NOS_WAIT_ABANDONED_0:成功,指定事件被删除
 NOS_WAIT_TIMEOUT:成功,超时时间已到
 NOS_WAIT_FAILED:失败,无效的句柄
 说明  调用后立即生效
 注意事项  

等待多个事件

 函数  UINT64 NOS_WaitForMultipleObjects(UINT32 nCount, UINT64* lpHandles, UINT32 dwMillisecond)
 功能  等待多个事件
 参数  nCount
 lpHandles
 dwMillisecond
 [IN] 事件数量
 [IN] 事件句柄
 [IN] 超时时间(毫秒单位), INFINITE(0xFFFFFFFF)为永不超时
 返回值  NOS_WAIT_OBJECT_0 to (WAIT_OBJECT_0 + nCount - 1) :成功,表示满足等待的对象的lpHandles数组索引。
 NOS_WAIT_ABANDONED_0 to (WAIT_ABANDONED_0 + nCount - 1):成功,指定事件被删除
 NOS_WAIT_TIMEOUT:成功,超时时间已到
 NOS_WAIT_FAILED:失败,无效的句柄
 说明  调用后立即生效
 注意事项  

加载控制台类型的.net应用程序到实时系统中运行

 函数  YK_API YKM_LoadNotimeApp(char* exe_name)
 YK_API YKM_LoadNotimeAppEx(YKM_NODE master, char* exe_name);
 功能  加载控制台类型的.net应用程序到实时系统中运行
 参数  master
 exe_name
 [IN] 主站选择
 [IN] 文件名及路径
 返回值  错误代码
 说明  调用后立即生效
 注意事项  带UI的应用程序不支持

检查Notime程序状态

 函数  YK_API YKM_CheckNotimeApp(YKM_NODE master, char* exe_name, UINT32* status);
 功能  检查Notime程序状态
 参数  master
 exe_name
 status
 [IN] 主站选择
 [IN] 文件名及路径
 [IN] 返回状态 0=已启动 1=未启动
 返回值  错误代码
 说明  调用后立即生效
 注意事项  

加载控制台类型的.rta应用程序到实时系统中运行

 函数  YK_API YKM_LoadRtaApp(YKM_NODE master, Byte[] rta_name, Byte[ ] rta_para);
 功能  检查Notime程序状态
 参数  master
 exe_name
 rta_para
 [IN] 主站选择
 [IN] 文件名及路径
 [IN] 程序参数
 返回值  错误代码
 说明  调用后立即生效
 注意事项  

检查RTA程序状态

 函数  YK_API YKM_CheckRtaApp(YKM_NODE, Byte[] rta_name, out UInt32 status);
 功能  检查Notime程序状态
 参数  master
 rta_name
 status
 [IN] 主站选择
 [IN] 文件名,不包含路径
 [IN] 返回状态 0=已启动 1=未启动
 返回值  错误代码
 说明  调用后立即生效
 注意事项  

 

  
Copyright © 2015 深圳市优易控软件有限公司 www.proutech.com