适用于AYANEO Pocket S2的linux发行版

用户信息

• 默认用户: gamer
• 密码: passwd

如果任何情况下，出现了黑屏，短按音量键、电源键无反应，请长按电源键至少18s强制重启设备。

概述

注意事项

1. 系统存在不稳定性，如果进Linux黑屏/自动重启的话，尝试多进几次。
2. 如果刷写到UFS，虽然不会占用安卓空间，但是Linux系统下可用存储极小。
3. 重新分区会分配安卓存储空间到Linux，但是安卓会丢失全部数据。

支持状态

功能	状态	注释
GPU	✅	最高频率1.05Ghz
USB/DP	✅	支持4K@60FPS，不兼容部分带DP的USB拓展坞
扬声器	✅
麦克风	❌	WIP
3.5mm插座	✅
游戏控制器	✅
亮度调节	✅	睡眠已禁用
风扇	✅
SD卡	✅
触摸	✅
WiFi	⚠️	5G Wifi 暂时无法扫描
蓝牙	✅	部分蓝牙鼠标存在兼容性问题
指纹	❌	Planned
控制器LED	❌	Planned
传感器	❌	Not planned

Debian 13

Ubuntu 24.04

Arch Linux ARM

WIP

教程

操作有风险，请在操作前备份掌机数据

配置ADB环境

安装ADB/Fastboot

如果已经配置过，可跳过此步骤。

检测是否已经安装的方法是：打开终端/Terminal，分别输入adb回车和fastboot回车，显示的内容不是不是内部或外部命令，也不是可运行的程序或批处理文件或者Command Not Found。

• Windows:

1. 前往谷歌官网下载Android Platform Tools。下载完成后，解压到一个文件夹中，此处假定为E:\PlatformTools。
   

2. 打开开始菜单，搜索环境变量，选择编辑账户的环境变量。
   

3. 选择当前用户下的PATH，点击编辑按钮
   

4. 点击弹出窗口右边的新建按钮，在左边列表中填入你刚才解压的路径，这里是指向E:\PlatformTools。
   

5. 打开一个终端，输入adb。如果显示一整页的英文帮助信息，那就是安装好了，否则如果显示adb不是内部或外部命令就是失败了，请仔细检查步骤。
   

• MacOS:

  brew install fastboot adb

• Linux/Termux

  apt install fastboot adb

在UFS上安装

如果要在SD卡上安装，请参考下文中的在SD卡上安装章节。

可以单机安装，也可以在有电脑的环境下安装。这里介绍使用电脑安装的方法。

准备

• 电脑
• AYANEO Pocket S2(下文简称APS2)
• 数据线，最好是3.0的

下载资料

• 下载并解压Android BootLoader
• 在系统发布页，二选一下载Debian13系统或Ubuntu24.04系统，需要下载所有分卷，并且请在下载完成后对比Hash值，确定无误后再进行解压。
• 在系统发布页，下载文件esp.img.7z并解压。

刷写

以下操作，如果没有严格按照教程操作，会导致设备直接变砖或数据丢失。

命令中标注path/to/xxx的部分，可以通过将文件从文件管理器拖入终端窗口来自动填充。
如果没有办法拖进去，可以右键文件，选择复制文件地址。
如果没有复制文件地址，

• 用数据线将手机插到电脑的USB接口上。
• 在电脑上打开一个终端，输入以下命令(下文中adb命令默认为在电脑端执行)，敲回车之后，掌机会重启到fastbootd模式。

注意，fastbootd模式和bootloader模式虽然都提供fastboot协议，但是两者功能并不完全相同。

adb reboot fastboot

• 输入下面命令并回车，刷入abl文件

  fastboot flash abl path/to/abl_pineapple_testsigned.elf

• 输入下面命令并回车重启到Bootloader

  fastboot reboot bootloader

• 输入下面命令并回车写入引导程序

  fastboot flash logfs path/to/esp-aps2.img

• 输入下面命令并回车写入Linux系统

  对于Debian

  fastboot flash rawdump debian-13-arm64-rootfs.img

  对于Ubuntu

  fastboot flash rawdump ubuntu-24.04-arm64-rootfs.img

  对于Alarm

  WIP

• 输入下面命令重启到Bootloader

  fastboot reboot bootloader

• 在掌机上，按音量-，此时屏幕上应该显示蓝色的Boot to ESP，按电源键确认，进入Linux系统。

至此在UFS上的安装已经完成，下面的是扩容教程。

UFS 分区教程

请不要乱动分区表的其他分区，否则会导致直接变砖。

重新分区会导致安卓所有数据丢失且无法找回。

请不要盲目复制粘贴，否则会导致不可预知的后果。

下文假设已经进入系统。

启动Linux

参考#双系统切换章节进入Linux。

使用Parted工具进行分区

如果你没有USB键盘，需要在设置=>键盘=>虚拟键盘中启用屏幕键盘Maliit，并点击应用。

1. 打开Konsole或其他终端软件，输入：

   sudo parted /dev/sda

   此时会要求你输入密码，默认密码为passwd。
   如果一切正常，此时应该会出现如下信息

   gamer@trixie:~$ sudo parted /dev/sda
   [sudo] gamer 的密码：
   GNU Parted 3.6
   Using /dev/sda
   Welcome to GNU Parted! Type 'help' to view a list of commands.
   (parted) 

2. 查看分区表详情，按键输入p，然后回车，正确结果如下所示

   (parted) p
   Model: SKhynix HN8T374ZJKX141 (scsi)
   Disk /dev/sda: 1011GB
   Sector size (logical/physical): 4096B/4096B
   Partition Table: gpt
   Disk Flags:
   
   Number  Start   End     Size    File system  Name             Flags
    1      24.6kB  32.8kB  8192B                ssd
    2      32.8kB  33.6MB  33.6MB  ext4         persist
    3      33.6MB  34.6MB  1049kB               misc
    4      34.6MB  35.2MB  524kB                keystore
    5      35.2MB  35.7MB  524kB                frp
    6      35.7MB  6478MB  6442MB               super
    7      6478MB  6478MB  65.5kB               vbmeta_system_a
    8      6478MB  6478MB  65.5kB               vbmeta_system_b
    9      6478MB  6545MB  67.1MB               metadata
   10      6545MB  19.6GB  13.1GB  ext4         rawdump
   11      19.6GB  1011GB  991GB                userdata
   
   (parted)

3. 计算rawdump和userdata大小。由上文的日志可以得知，rawdump分区的当前大小为13.1GB，userdata分区大小为991GB。

   序号    起始     结束    大小    文件系统      名称             标志
   10      6545MB  19.6GB  13.1GB  ext4         rawdump
   11      19.6GB  1011GB  991GB                userdata

   拿出纸和笔和我一起算，假设我需要把Linux扩容到200GB，那么需要给当前rawdump大小增加186.9GB。

   200GB - 13.1GB = 186.9GB

   那这样一来，rawdump分区的结束就从19.6GB变为了106.5GB。

   186.9GB + 19.6GB = 206.5GB

   相应的，userdata分区的起始就从19.6GB变为了106.5GB。

   186.9GB + 19.6GB = 206.5GB

因为硬盘总共就那么大，所以userdata的结束不需要变。
OK，至此计算部分结束。

4. 删除重建userdata分区。因为这里要扩展rawdump分区，所以需要把userdata分区往后挪。

• 删除userdata

  (parted) rm                                                               
  分区编号？ 11                                                             

• 建立userdata

  (parted) mkpart                                                           
  分区名称？  []? userdata                                                  
  文件系统类型？  [ext2]?                                                   
  起始点？ 206.5GB                                                          
  结束点？ 1011GB                                                           

  这里依次输入
  分区名称，userdata
  起始，刚才算出来的userdata起始地址106.5GB
  结束，按照默认的即可

• 检查分区表

  (parted) p                                                                
  型号：SKhynix HN8T374ZJKX141 (scsi)
  磁盘 /dev/sda: 1011GB
  扇区大小 (逻辑/物理)：4096B/4096B
  分区表：gpt
  磁盘标志：
  
  编号  起始点  结束点  大小    文件系统  名称             标志
  1    24.6kB  32.8kB  8192B             ssd
  2    32.8kB  33.6MB  33.6MB  ext4      persist
  3    33.6MB  34.6MB  1049kB            misc
  4    34.6MB  35.2MB  524kB             keystore
  5    35.2MB  35.7MB  524kB             frp
  6    35.7MB  6478MB  6442MB            super
  7    6478MB  6478MB  65.5kB            vbmeta_system_a
  8    6478MB  6478MB  65.5kB            vbmeta_system_b
  9    6478MB  6545MB  67.1MB            metadata
  10    6545MB  207GB   200GB   ext4      rawdump
  11    207GB   1011GB  804GB             userdata

5. 扩大rawdump分区大小

   (parted) resizepart
   分区编号？ 10                                                             
   结束点？  [19.6GB]? 206.5GB                                               
   (parted) q                                                                
   信息: 你可能需要 /etc/fstab。

6. 扩容文件系统大小，注意上文中的q是退出parted，现在parted退出了。

   gamer@noble:~$ sudo resize2fs /dev/sda10
   resize2fs 1.47.0 (5-Feb-2023)
   /dev/sda10 上的文件系统已被挂载于 /；需要进行在线调整大小
   old_desc_blocks = 2, new_desc_blocks = 24
   /dev/sda10 上的文件系统大小已经调整为 48817048 个块（每块 4k）。

   检查根文件系统大小已经从13G变成184G了。（由于不同工具单位换算原因这里实际不是200G）

   gamer@noble:~$ df -h
   文件系统        大小  已用  可用 已用% 挂载点
   /dev/root       184G   11G  166G    6% /
   tmpfs           7.2G     0  7.2G    0% /dev/shm
   tmpfs           2.9G  2.2M  2.9G    1% /run
   tmpfs           5.0M     0  5.0M    0% /run/lock
   tmpfs           7.2G     0  7.2G    0% /run/qemu
   tmpfs           1.5G   72K  1.5G    1% /run/user/1000

   如果要删除Linux，并且恢复安卓的存储空间大小，可以通过上文的计算方法反推rawdump的结束位置和userdata的结束位置。
   这里给出一种方法，注意，会丢失所有数据：

   • 先删除userdata分区，使用parted中的resize命令修改rawdump的End到19.6GB
   • 使用mkpart创建userdata分区，Start是19.6GB，End是1011GB。

在SD卡上安装

可以单机安装，也可以在有电脑的环境下安装。这里介绍使用电脑安装的方法。

准备

• 电脑
• AYANEO Pocket S2
• 数据线，最好是3.0的
• SD卡（不少于16G），读卡器

资料下载

• 下载并解压Android BootLoader
• 刷写工具balenaEtcher
• 下载SD卡镜像的所有分卷并解压，所有SD卡镜像均为SD开头

balenaEtcher占用空间较大，在镜像刷写完成后可以卸载掉，或者下载Portable版本，可以直接使用过后删除。

引导程序刷写

以下操作，如果没有严格按照教程操作，会导致设备直接变砖或数据丢失。

命令中标注path/to/xxx的部分，可以通过将文件从文件管理器拖入终端窗口来自动填充。
如果没有办法拖进去，可以右键文件，选择复制文件地址。
如果没有复制文件地址，

• 用数据线将手机插到电脑的USB接口上。
• 在电脑上打开一个终端，输入以下命令，敲回车之后，掌机会重启到fastbootd模式。

adb reboot fastboot

• 输入下面命令并回车，刷入abl文件

  fastboot flash abl path/to/abl_pineapple_testsigned.elf

• 输入下面命令并回车重启回到安卓模式

  fastboot reboot

系统刷写

此操作需要在电脑端完成，且需要读卡器。

此操作会抹除SD卡上的所有数据

1. 打开balenaEtcher，选择冲文件烧录

2. 选择刚才下载的SD卡IMG镜像

3. 选择SD卡读卡器设备

4. 点击现在烧录即可写入SD卡，等待完成

启动

将SD卡插入设备中，在安卓长按电源键，点击重启按钮后按住音量-，等待掌机进入bootloader模式后松开，使用音量键选择Boot to ESP（蓝色）进入Linux。安卓和Linux的切换参考#双系统切换章节。

懒人包9008一键安装

我也是懒人，所以我懒得做。

双系统切换

重启当前系统，并按住音量-，等待系统重启进入Fastboot模式。

Fastboot模式下会显示一些设备信息，例如串号，软件代号之类的，同时也会显示Linux安装状态和默认启动系统，如上图所示。

ESP PARTITION - found  => 代表已经找到Linux引导分区

PRIMARY BOOT OS - android => 代表默认启动进入安卓

短按音量键可以切换选项，按电源键确认选项

Fastboot模式中集成了默认系统切换，临时启动Linux，临时启动Recovery模式等功能，下面是常用选项的介绍：

• START模式
  按电源键确认后进入PRIMARY BOOT OS对应的默认系统，如果Linux启动失败则自动进入安卓。

• Boot to ESP模式
  按电源键确认后尝试临时启动Linux，如果启动失败会返回Fastboot菜单或黑屏/重启。
  

• Toggle Primary Boot OS模式
  按电源键确认后会切换默认启动的系统，并且自动重启设备重新进入Fastoot菜单。
  如果当前是Android，则切换到Linux。
  如果当前是Linux，则切换到Android。
  切换默认启动模式后，使用音量键选择Start模式进入默认系统，下次重启后无需再次进入Fastboot选择系统，引导加载程序会自动进入默认系统。
  

如果你的默认系统是Linux，但是Linux被玩崩溃开不了机了，请长按电源键18s，并在开机Logo亮起之前按下音量-，进入Fastboot模式切换回安卓模式。