“Hello Kithara!” - 第一个项目

第一个Kithara RealTime Suite项目

---

---

在我们开始之前，让我们先来看看编程环境和操作方式。

支持的操作系统

该软件现在支持几乎所有现代Windows操作系统：

• Windows 11 (amd64)
• Windows 10 (IA-32/amd64)
• Windows Server 2019 (amd64)
• Windows Server 2016 (amd64)
  该软件还支持Windows 10和Windows 11的物联网版本（IA-32/amd64）。目前，Kithara RealTime Suite的所有模块都可以运行在32位和64位版本下。但是有部分功能需要你升级到支持的64位版本。有关特殊的32/64位处理的更多信息。

编程语言

目前，支持以下编程语言：

• C/C++（所有功能，包括实时功能）
  • Microsoft Visual Studio 2005及更高版本
  • Borland C++Builder 5及更高版本
  • Borland Developer Studio 2006及更高版本
  • Embarcadero RAD Studio XE3及更高版本
• Delphi（所有功能，包括实时功能）
• C#（所有模块，但仅限于应用程序级别）。

另外：还有Fortran的支持！

安装软件

安装分为以下两部分：

• 开发者安装（包括所有文件、示例和文档）
• 运行时安装（仅限SYS、DLL和INF文件）
  对于开发者安装，需要许可密钥。成功进行开发者安装后，在“Runtime-Installation”子目录中找到运行时的安装文件。

Kithara如何运行的？

实时和依赖硬件的工作大部分是在KrtsDemo.sys文件中完成的，该文件可以通过KrtsDemo.dll访问。开发者不需要直接操作它们，您可以通过我们提供的编程语言的头文件中的所有函数、结构和常量进行操作。请参见以下图片：

程序和驱动程序的协同工作

应用程序如何使用Kithara RealTime Suite？

这取决于功能模块。有时你希望调用Kithara RealTime Suite的函数，有时它希望回调你。如果是你调用一个函数，多数情况下可以使用你开发的语言直接调用。如果它想要回调您的代码，需要您提供了一个“回调”，你写的回调将决定在哪个上下文中运行。由于实时执行只能在内核级别上进行，因此对于实时回调，您需要生成真正的机器代码的语言（目前只能是C/C++或Delphi）。应用级别的回调也可以使用其他语言（例如：C#）。另一方面，一些回调需要实时反应，因此它们只在内核级别上才有意义。

C/C++与Microsoft Visual C++

• 包含KrtsDemo.h
• 将KrtsDemo_vci.lib（静态）或KrtsDemo_dyn.cpp（动态）添加到项目中。

C/C++与Embarcadero C++Builder（例如Borland）

• 包含KrtsDemo.h
• 将KrtsDemo_bci.lib（静态）或KrtsDemo_dyn.cpp（动态）添加到项目中。

Delphi

• 将KrtsDemo.pas（静态）或KrtsDemo_dyn.pas（动态）添加到项目中。

C#

• 将KrtsDemo.cs添加到项目中。

最简单的项目

所有项目必须首先调用的第一个函数是KS_openDriver。

const char* pCustomerNumber = "012345"; // <= 使用你自己CustomerNumber
// 如果你使用的是Demo版本, 请替换成"DEMO"   
  
int error = KS_openDriver(pCustomerNumber);  
if (error)  
  ... 

现在，Kithara RealTime Suite的驱动已成功打开，您可以使用所有模块功能。如果没有成功打开，函数会返回一个错误代码，就像几乎所有的函数一样（参见错误处理）。

现在您可以使用功能模块了。最后，必须使用KS_closeDriver关闭驱动程序：

int error = KS_closeDriver();  
if (error)  
  outputErr(error, "KS_closeDriver", "Unable to close the driver!");

---

项目创建实例

1. 使用 Visual Studio 2022 创建一个空项目 （Visual Studio 2022 C++ 开发环境安装）
   
2. 添加一个main.cpp 文件
3. 项目-属性-C++ - 常规-附件包含目录 -添加 Kithara安装路径的头文件路径，默认路径为： C:\Program Files\Kithara\RealTime Suite Demo\dev
4. 项目-属性-链接器-常规- 附件库目录- 添加 Kithara安装路径的库文件路径，默认路径为： C:\Program Files\Kithara\RealTime Suite Demo\dev
5. 项目-属性-链接器-输入-附加依赖项 - 添加 Kithara安装路径的库文件
   
   PS: 正式版路径和名称会有所差异。

相关代码：

#include <KrtsDemo.h>  // 正式版名称会有所差异

const char customerNumber[256]  = "DEMO";  // 正式版需要使用客户号并配合加密狗

int main()
{
	KSError error;
	error = KS_openDriver(customerNumber);
	if (error == KS_OK)
	{
		// Todo
		// ...
	}

	KS_closeDriver();

	return 0;
}

创建完成！