XingKongBeta

X.K.e-Paper —— 驱动电子墨水屏

简介

XingKong e-Paper 基于树莓派和微雪电子墨水屏实现，可以显示时间、天气、温度以及系统状态，支持编写APP扩展功能。

GitHub地址：https://github.com/XingKongSync/X.K.e-Paper

关键组件

目录结构

程序的目录结构示例如下：

└── X.K.e-Paper
    ├── AppBase.dll
    ├── AppForm.json
    ├── AppLoader.exe
    ├── AppLoader.exe.config
    ├── Apps
    │   ├── PhotoLibrary
    │   │   ├── test_image.jpg
    │   │   ├── MainForm.json
    │   ├── PhotoLibrary.dll
    │   ├── RemotePlayer
    │   │   ├── album.png
    │   │   └── RemotePlayerForm.json
    │   └── RemotePlayer.dll
    ├── asciiLogo.txt
    ├── Config.json
    ├── MainForm.json
    ├── Newtonsoft.Json.dll
    ├── Newtonsoft.Json.xml
    ├── ShutdownForm.json
    ├── StartingForm.json
    ├── SystemUI
    │   ├── APP.BMP
    │   └── 省略其他资源图片
    ├── SystemUI.dll
    ├── XingKongForm.dll
    └── XingKongUtils.dll

App 应当放入 Apps 文件夹中，dll 在 Apps 目录下，该 App 所要使用的资源放在 App 同名目录中

配置文件

程序的配置保存在 Config.json 中，示例如下：

{
    "PortName": "/dev/ttyUSB0",
    "BackupPortName": "/dev/ttyUSB1"
}

PortName 是程序连接屏幕所使用的串口名称，如果在 Windows 环境中则类似于 COM1

有些情况下，由于某些原因，串口号可能会变化（比如硬件性能不稳定导致断开后又自动连上），此时可以通过指定 BackupPortName 来设置一个备用串口名称，当主串口无法打开时，会自动切换到备用串口

远程调试

AppLoader 启动时可以远程连接另一台主机的 e-paper，这样方便开发和调试，具体步骤如下：

1. 在连接了 e-paper 的计算机中启动 RemoteSerialPort，命令行参数中传入串口名称
2. 在开发机上启动 AppLoader，命令行中传入 -ip xxx.xxx.xxx.xxx，其中 xxx.xxx.xxx.xxx 请替换为上一步中计算机中的 IP 地址

用户交互

目前程序仅支持模拟按键式的交互方式。在 XingKongForm 中提供的 Keyboard 对象会在本机监听 UDP 9849 端口，并接收长度为 4 个 byte 的消息，这 4 bytes 会被转换为 .Net 中的 System.Windows.Forms.Keys 枚举

App 开发者可以通过绑定 KeyPressed 事件来处理按键消息

注意：当 App 挂起时，需要开发者手动取消绑定 KeyPressed 事件

界面生成

1. 在 XingKongFormGenerator 中新建一个 Form，并继承于 XingKongFormBase

2. 借助 WinForm 的图形化界面设计器，使用 Label、Button、ListBox、PictureBox、Panel 来构建你的界面

3. 在 Program 中将 Form 替换为你的 Form

借助 WinForm 的图形化界面设计器，使用 Label、Button、ListBox、PictureBox、Panel 来构建你的界面

在 Program 中将 Form 替换为你的 Form

[STAThread]
static void Main(string[] args)
{
    Args = args;
    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);
    Application.Run(new YourForm());
}

4. 在你的 Form 的 Load 事件中执行如下代码

private void YourForm_Load(object sender, EventArgs e)
{
    PortName = "COM4";

    XingKongWindow window = GetXingKongWindow();
    LocalShow();//在 e-paper 上预览效果，支持远程调试，方法类似于 AppLoader
    ShowCode();
}

5. 运行 XingKongFormGenerator 后会生成界面的 json 代码，保存此 json 并在你的 App 中进行加载

效果演示

HiWiFiAPI —— 极路由后台API封装

简介 / Introduction

用C#代码模拟了极路由网页版登陆路由后台的过程，支持获取全局网速、设备网速、设备连线消息、设备断线消息

GitHub地址：https://github.com/XingKongSync/HiWiFiAPI

示例 / Usage

class Program
{
	static HiWiFiService service = null;
	static void Main(string[] args)
	{
		string ip = "192.168.199.1";
		string pwd = "123456";

		service = new HiWiFiService(ip, pwd);
		service.DeviceOnlineStatusChanged += Service_DeviceOnlineStatusChanged;

		while (true)
		{
			service.DoHeartBeat();
			Print(service.DeviceMap.Values);
			Task.Delay(2000).Wait();
		}
	}

	private static void Service_DeviceOnlineStatusChanged(DeviceInfo obj)
	{
		string _mesasge = "Device: " + obj.name + (obj.online == 1 ? " connected." : " disconnected.");
		Console.WriteLine("Recent Message: " + _mesasge);
	}

	static void Print(IEnumerable<DeviceInfoEx> devExList)
	{
		Console.Clear();
		//输出局域网整体速度
		string totalUploadSpeed = (int)(service.UploadSpeed / 8000f) + "KB/S";
		string totalDownloadSpeed = (int)(service.DownloadSpeed / 8000f) + "KB/S";
		Console.WriteLine($"Total Upload: {totalUploadSpeed}, Download: {totalDownloadSpeed}\r\n");

		//输出设备网速
		int lineLimit = 25;
		for (int i = 0; i < lineLimit && i < devExList.Count(); i++)
		{
			var devEx = devExList.ElementAt(i);

			string devName = string.IsNullOrWhiteSpace(devEx.Info.name) ? "<Unkown>" : devEx.Info.name;
			string txSpeed = (int)(devEx.UploadSpeed / 8000f) + "KB/S";
			string rxSpeed = (int)(devEx.DownloadSpeed / 8000f) + "KB/S";

			if (devName.Length > _padLeft) _padLeft = devEx.Info.name.Length;

			Console.WriteLine($"Device: {devName}\t up: {txSpeed}\t down: {rxSpeed.}");
		}
	}
}