【2024.2.26更新】基于SANE实现OpenWrt打印服务器的移动扫描功能

本文链接：https://blog.csdn.net/Theirsky/article/details/136303215

0. 前言

最近春节放假回家时，感觉之前实现用路由器实现的移动扫描功能界面有点太难看了.......因此重新覆写了代码，在此做一总结。

【2024.1.2更新】windows10环境下vscode配置go开发环境及热加载Air框架设置记录

实现openwrt打印扫描服务器移动端扫描的配置服务文件

TP-LINK-TL-WR703N（原装）制作打印服务器过程记录整理

2. SANE协议简介

为了让新读者更快了解本篇文章的作用及意义，这里引用一下博主FDWMin对SANE协议的简要介绍：

Linux下通用扫描仪API——SANE（ Scanner Access Now Easy）

SANE（ Scanner Access Now Easy），是一个应用程序编程接口（API），它提供给任何光栅图像扫描仪硬件标准化的访问（平板扫描仪，手持式扫描仪，视频和静止相机，图像采集卡等。）。该api是公共领域，它的讨论和发展，对所有人开放。目前的源代码是UNIX（包括GNU / Linux）的和GNU通用公共许可证（下可用SANE API可用于专有应用程序和后端为好）。

SANE是一种通用扫描仪接口。这样的通用接口的价值在于，它允许写入每个图像采集装置，而不是为每个设备和应用的一个驱动器只有一个驱动器。所以，如果你有三个应用程序和四个设备，传统上你不得不写12次不同的程序（3*4种驱动程序）; 有了 SANE，这个数字减少到7（3+4种驱动程序）。当然，储蓄获得的越来越多的驱动程序和/或应用程序被添加更大。

不仅SANE减少开发时间和代码重复，这也引发了在哪些应用程序可以工作的水平。这样，就会使这在以前是闻所未闻的，在UNIX世界的应用。虽然SANE主要是针对UNIX环境中，该标准已被精心设计，使之可以实现在几乎任何硬件或操作系统的API。

虽然SANE是“Scanner Access Now Easy”的首字母缩写的希望当然是SANE在某种意义上确实是明智的，这将是很容易实现的API，同时适应今天的扫描仪硬件和应用程序所需的所有功能。具体而言，SANE应足够宽，以适应装置，例如扫描仪，数码相机和摄像机，以及如图像文件的过滤器的虚拟设备。

关于SANE更详细的介绍和使用建议直接参考SANE官网：

SANE - Scanner Access Now Easy

简介中的重点是SANE支持Unix系统，Unix系统在我的认知中与嵌入式系统相近（非该专业，个人观点），这意味着SANE可以在路由器这样的小型设备中运行。

3. 代码重构

之前扫描服务器的移动端实现是通过对github上gyscos编写的RemoteScanViewer项目进行修改后实现的。

修改后实现的移动扫描端界面：

尽管项目能够正常运行，但是界面确实有点太难看了，而且HTML前端采用的CDN 是外网链接，如果采用本地引入js文件会莫名其妙报错，导致页面没有办法显示，虽然后面采用国内BootCDN替换了原来的CDN链接，但这并不能解决网络问题，意味着每次运行服务必须处于联网状态。

BootCDN - Bootstrap 中文网开源项目免费 CDN 加速服务

除此之外，该项目对移动端的支持也存在问题，使用移动端进行访问时，会出现页面组件混乱的现象。

鉴于此，我决定对该项目进行重写。

3.1 代码结构（或者说技术栈，不知道这么说对不对）

前端——由于不打算采用Node.js（因为这意味着又得在OpenWrt上装包），所以没法使用Vue，尝试过在原生HTML上通过本地文件引入Vue.js，可以使用部分Vue方法，但UI组件库使用时有问题，遂放弃，采用原生HTML。

后端——采用Golang编写，具体Web框架采用gin框架，相比gframe的庞大繁杂，gin简单上手快，更符合项目需求。

通信——采用本地文件引入的方式引入axios.js，使用axios进行请求和响应。

3.2 部分代码展示及解释

执行扫描的主要函数

// 执行SANE扫描cmd命令并返回实时扫描进度
func ScanProgress(device string, dpi string, mode string, fileName string) (float64, error) {
	ScanEnd = "0"
	//声明TIF_DEST变量
	TIF_DEST := DEST_DIR + "/" + fileName + ".tiff"
	//声明PDF_DEST变量
	PDF_DEST := DEST_DIR + "/" + fileName + ".pdf"
	//声明TBN_DEST变量
	TBN_DEST := DEST_DIR + "/thumb/" + fileName + ".png"
	cmdName := "scanimage"
	cmdArgs := []string{"--progress", "--device-name", device, "--resolution", dpi, "--mode", mode, "--format", "tiff", "--output-file", TIF_DEST} // --device-name设备名称 --resolution分辨率 --mode扫描模式 --progress命令用于显示扫描的进度

	// 打印即将执行的命令
	fmt.Printf("将要执行的命令：%s %s\n", cmdName, strings.Join(cmdArgs, " "))
	ScanProgressValue = 60.00
	cmd := exec.Command(cmdName, cmdArgs...)
	var stderr bytes.Buffer
	cmd.Stderr = &stderr
	stdout, err := cmd.StdoutPipe()
	if err != nil {
		fmt.Printf("执行cmd.StdoutPipe()出错:%s\n", err)
		fmt.Println(fmt.Sprint(err) + ": " + stderr.String())
		return 0, err
	}

	if err := cmd.Start(); err != nil {
		fmt.Printf("执行cmd.Start()出错:%s\n", err)
		fmt.Println(fmt.Sprint(err) + ": " + stderr.String())
		return 0, err
	}

	go func() {
		reader := bufio.NewReader(stdout)
		for {
			line, err := reader.ReadString('\n')
			fmt.Printf("当前行内容：%s\n", line) // 添加调试输出

			if err != nil || err == io.EOF {
				break
			}

			if strings.Contains(line, "Progress:") {
				fmt.Printf("发现进度信息：%s\n", line) // 添加调试输出

				progressStr := strings.Split(line, ":")[1]
				// 去除百分号
				progressStr = strings.TrimSpace(progressStr[:len(progressStr)-1])

				progress, err := strconv.ParseFloat(progressStr, 64)
				if err != nil {
					fmt.Println("解析进度信息时出现错误:", err) // 添加调试输出
					// 如果解析出错，可以尝试打印 progressStr 看看原始内容
					continue
				}

				fmt.Printf("当前 ScanProgressValue：%f\n", progress)
				// 将进度保存到全局变量
				ScanProgressValue = progress
			}
		}
	}()

	if err := cmd.Wait(); err != nil {
		fmt.Printf("执行cmd.Wait()出错:%s\n", err)
		fmt.Println(fmt.Sprint(err) + ": " + stderr.String())
		return 0, err
	}
	ScanProgressValue = 100.00
	fmt.Printf("tiff格式转换...")
	//将获得的tiff转换
	//转为pdf
	command1 := "convert"
	args1 := []string{TIF_DEST, PDF_DEST}
	cmd1 := exec.Command(command1, args1...)
	err1 := cmd1.Run()
	if err1 != nil {
		fmt.Printf("执行tiff转pdf出错: %s", err1)
		fmt.Println("尝试使用golang转换pdf...")
		// 读取 TIF 文件
		tifData, err := os.ReadFile(TIF_DEST)
		if err != nil {
			fmt.Println("Error reading TIF file:", err)

		}

		// 解码 TIF 数据
		img, err := tiff.Decode(bytes.NewReader(tifData))
		if err != nil {
			fmt.Println("Error decoding TIF image:", err)

		}

		// 获取 TIF 图像的宽度和高度
		bounds := img.Bounds()
		imageWidth := float64(bounds.Dx())
		imageHeight := float64(bounds.Dy())

		// 创建 PDF 文件
		pdf := gofpdf.New("P", "mm", "A4", "")
		pdf.AddPage()

		// 将 TIF 图像转换为 PDF 图像
		imageIndex := pdf.RegisterImageOptions(TIF_DEST, gofpdf.ImageOptions{ImageType: "TIFF", ReadDpi: true})
		if imageIndex == nil {
			fmt.Println("Error registering image for PDF:", pdf.Error())

		}

		pdf.ImageOptions(TIF_DEST, 0, 0, imageWidth, imageHeight, false, gofpdf.ImageOptions{ImageType: "TIFF"}, 0, "")

		// 保存 PDF 文件
		err = pdf.OutputFileAndClose(PDF_DEST)
		if err != nil {
			fmt.Println("Error saving PDF file:", err)

		}

		fmt.Println("Conversion from TIF to PDF successful!")
	}
	//转为png
	command2 := "convert"
	args2 := []string{TIF_DEST, TBN_DEST}
	cmd2 := exec.Command(command2, args2...)
	err2 := cmd2.Run()
	if err2 != nil {
		fmt.Printf("执行tiff转png出错: %s\n", err2)
		fmt.Println("尝试使用golang转png...")
		// 读取 TIF 文件
		tifData, err := os.ReadFile(TIF_DEST)
		if err != nil {
			fmt.Println("Error reading TIF file:", err)
		}

		// 解码 TIF 数据
		img, err := tiff.Decode(bytes.NewReader(tifData))
		if err != nil {
			fmt.Println("Error decoding TIF image:", err)
		}

		// 创建输出 PNG 文件
		outfile, err := os.Create(TBN_DEST)
		if err != nil {
			fmt.Println("Error creating PNG file:", err)
		}
		defer outfile.Close()

		// 将图像以 PNG 格式写入文件
		if err := png.Encode(outfile, img); err != nil {
			fmt.Println("Error encoding PNG image:", err)
		}

		fmt.Println("Conversion from TIF to PNG successful!")
	}
	fmt.Printf("tiff转换完成")
	ScanEnd = "1"
	return 0, nil
}

这里采用了和之前gyscos那个项目的同样方法，即采用SANE的命令行工具scanimage，通过Go执行scanimage命令，实现扫描功能的控制。

scanimage - flexible command-line-frontend including support for pnm and tiff output (included in sane-backends).