LUOGU 1.0.1

LUOGU 1.0.1: a fix to 1.0. On the 唱腔 page, a note played on the keys as a 京胡 (or 京二胡, 月琴), shown as
"京胡 3", was drawn over the 过门's 简谱 whenever the page was stopped. It is now at the top right of the title strip,
above the 板式's name, where nothing else is. Everything else is as in
1.0.

Install: download luogu-1.0.1.fwsc below, connect the FM-1 by USB, and run
python3 base/tools/fm1_install.py luogu-1.0.1.fwsc in a clone of this repository
(git clone --recursive https://github.com/Reytian/fm1-luogu; the installer needs mido with python-rtmidi).
M-VAVE's own firmware can be put back the same way. Installing is at your own risk.

File	What
luogu-1.0.1.fwsc	The firmware (identity FM-1_53010001; sha256 4e7d9262e55b57fab36b0660770952528b9333f62971fcc7e9c5bd3aedb81199)

Licences: LUOGU is MPL-2.0. The 唱段 are the Jingju Music Scores Collection's scores (Rafael Caro Repetto and
Xavier Serra, 2017), under CC BY-NC-ND 4.0: this firmware may be shared, but not sold or used commercially. The
彩蛋's two sung words are from a recording of 郭德纲 and 于谦's 相声 《黄鹤楼》 (德云社); they belong to their owners and
are not under LUOGU's licence. Details: CREDITS.md.

---

LUOGU 1.0.1：修正一处显示问题。 在唱腔页用键盘拉京胡（或京二胡、月琴）时，弹的音（比如“京胡 3”）原来在停着时会压住
过门的简谱，现在挪到了屏幕右上角、板式名的上方。其他和 1.0 一样。

安装：下载下面的 luogu-1.0.1.fwsc，USB 连上 FM-1，在本仓库的克隆里运行
python3 base/tools/fm1_install.py luogu-1.0.1.fwsc（要先装 mido 和 python-rtmidi）。原厂固件也能用同样的方法刷回去，
风险自负。唱段按 CC BY-NC-ND 4.0 只限非商业使用；彩蛋里的两句唱出自郭德纲、于谦的相声《黄鹤楼》（德云社）录音，
版权归原所有者。

LUOGU 1.0

LUOGU 1.0: Peking opera percussion and accompaniment in your M-VAVE FM-1. It plays the 锣鼓经 (64 patterns, each
with its 起, 中 and 收, the 字谱 lit as it sounds) and the 京胡's 过门 for 18 板式, with the 京二胡 and the 月琴, so you
can learn the percussion by playing along, or sing to a band. 跟练 makes the music wait for your strokes; the keys
are laid out the way each player's hands go.

New since 0.1: five whole 唱段, the 京胡 playing you through each aria with its lyrics lit syllable by syllable
(苏三离了洪洞县, 我本是卧龙岗散淡的人, 一轮明月照窗前, 当日里好风光忽觉转变, 深宫无处不飞花); one job for each knob
(PRESET picks the group, ALGO the item, SELECT nothing); and a hidden 彩蛋.

Install: download luogu-1.0.fwsc below, connect the FM-1 by USB, and run
python3 base/tools/fm1_install.py luogu-1.0.fwsc in a clone of this repository
(git clone --recursive https://github.com/Reytian/fm1-luogu; the installer needs mido with python-rtmidi).
M-VAVE's own firmware can be put back the same way. Installing is at your own risk. How to play: the
README and the
manual (中文).

File	What
luogu-1.0.fwsc	The firmware (identity FM-1_53010000; sha256 dcf9018ec32a3f6c52289574ac7f1dbff5fff72f87c02fd4ebeebfdabfc7963d)

Licences: LUOGU is MPL-2.0. The 唱段 are the Jingju Music Scores Collection's scores (Rafael Caro Repetto and
Xavier Serra, 2017), under CC BY-NC-ND 4.0: this firmware may be shared, but not sold or used commercially. The
彩蛋's two sung words are from a recording of 郭德纲 and 于谦's 相声 《黄鹤楼》 (德云社); they belong to their owners and
are not under LUOGU's licence. Details: CREDITS.md.

Status: LUOGU runs on an FM-1. This package was built from the tagged source in a fresh clone of this repository
and passed every test in fm1-base's host simulator, which runs the firmware's own code; the audio load is estimated
from instruction counts (at most 35 % of a core in its busiest block). Reports are welcome in the issues.

---

LUOGU 1.0：FM-1 上的京剧锣鼓和胡琴。 64 套锣鼓经（起、中、收，字谱随声点亮），18 种板式的京胡过门，京二胡、月琴
伴奏；可以跟着打锣鼓，也可以自拉自唱。跟练模式下音乐等你打对才往下走；键盘按每位乐手真实的左右手排。

比 0.1 新增：五段完整的唱段，京胡托腔一路托着你唱到底，唱词逐字点亮（苏三离了洪洞县、我本是卧龙岗散淡的人、
一轮明月照窗前、当日里好风光忽觉转变、深宫无处不飞花）；三个旋钮各管一件事（PRESET 选组，ALGO 选条目，SELECT 不选）；
还有一个隐藏的彩蛋。

安装：下载下面的 luogu-1.0.fwsc，USB 连上 FM-1，在本仓库的克隆里运行
python3 base/tools/fm1_install.py luogu-1.0.fwsc（要先装 mido 和 python-rtmidi）。原厂固件也能用同样的方法刷回去，
风险自负。

许可：LUOGU 本身是 MPL-2.0。唱段的谱子来自 Jingju Music Scores Collection，按 CC BY-NC-ND 4.0：这个固件可以转给
别人，但不能卖，也不能用于商业用途。彩蛋里的两句唱出自郭德纲、于谦的相声《黄鹤楼》（德云社）录音，版权归原所有者，
不在 LUOGU 的许可之内。详见 CREDITS.md。

LUOGU 0.1

The first release of LUOGU: Peking opera percussion and accompaniment in your M-VAVE FM-1. It plays the 锣鼓经
(64 patterns, each with its 起, 中 and 收, the 字谱 lit as it sounds) and the 京胡's 过门 for 18 板式, with the 京二胡
and the 月琴, so you can learn the percussion by playing along, or sing to a band. 跟练 makes the music wait for your
strokes; the keys are laid out the way each player's hands go.

Install: download luogu-0.1.fwsc below, connect the FM-1 by USB, and run
python3 base/tools/fm1_install.py luogu-0.1.fwsc in a clone of this repository
(git clone --recursive https://github.com/Reytian/fm1-luogu; the installer needs mido with python-rtmidi).
M-VAVE's own firmware can be put back the same way. Installing is at your own risk. How to play: the
README and the
manual (中文).

File	What
luogu-0.1.fwsc	The firmware (identity FM-1_53000100; sha256 836fbddf8ee663abdd9e2a43345bdf1ca01f3fd56fcd67fcf3964d3d9cefd0a8)

Not in this build: the 唱段 (whole arias with their 京胡 托腔). Their scores are the Jingju Music Scores
Collection's (CC BY-NC-ND 4.0) and can't be distributed; tools/tq_data.py makes them from your own copy, for your
own FM-1 (see the manual).

Status: LUOGU runs on an FM-1. This package was built from the tagged source in a clean clone and passed the
tests in fm1-base's host simulator, which runs the firmware's own code; the audio load is estimated from instruction
counts (at most 35 % of a core in its busiest block) and hasn't been measured on the chip. Reports are welcome in the
issues.

---

LUOGU 0.1：FM-1 上的京剧锣鼓和胡琴。 64 套锣鼓经（起、中、收，字谱随声点亮），18 种板式的京胡过门，京二胡、月琴
伴奏；可以跟着打锣鼓，也可以自拉自唱。跟练模式下音乐等你打对才往下走；键盘按每位乐手真实的左右手排。

安装：下载下面的 luogu-0.1.fwsc，USB 连上 FM-1，在本仓库的克隆里运行
python3 base/tools/fm1_install.py luogu-0.1.fwsc（要先装 mido 和 python-rtmidi）。原厂固件也能用同样的方法刷回去，
风险自负。

这一版不含唱段：唱段的谱子来自 Jingju Music Scores Collection（CC BY-NC-ND 4.0），不能随固件分发。使用方法见 README
的中文说明和说明书。