Catfish - Revision history

Beroset: Change text to reflect the fact that rubyfish is now supported.

2026-02-15T13:43:44Z

Change text to reflect the fact that rubyfish is now supported.

← Older revision		Revision as of 13:43, 15 February 2026
Line 35:		Line 35:
	Catfish (Mobvoi Ticwatch Pro), catfish-ext (Ticwatch Pro 2020) and Catshark (Ticwatch Pro 4G/LTE) are a series of feature-complete round watches with a secondary display for timekeeping. The port is mostly complete, but work is still needed to get the LCD fully supported and to expose all its functions.		Catfish (Mobvoi Ticwatch Pro), catfish-ext (Ticwatch Pro 2020) and Catshark (Ticwatch Pro 4G/LTE) are a series of feature-complete round watches with a secondary display for timekeeping. The port is mostly complete, but work is still needed to get the LCD fully supported and to expose all its functions.
	----		----
	~~Warning:~~ Ticwatch Pro 3 series ~~are not supported at the moment. If you would like to help with a porting effort for these, please contact us on the matrix chat~~.		See [[rubyfish]] for the Ticwatch Pro 3 series.

	= Description =		= Description =

Beroset: add ReleaseDate

2026-02-03T15:59:03Z

add ReleaseDate

← Older revision		Revision as of 15:59, 3 February 2026
Line 3:		Line 3:
	\|OtherNames=catfish_ext,catshark		\|OtherNames=catfish_ext,catshark
	\|Model=TicWatch Pro 2018/20		\|Model=TicWatch Pro 2018/20
			\|ReleaseDate=2018-07-01
	\|Picture=catfish.png		\|Picture=catfish.png
	\|Status=supported		\|Status=supported

AFly.js: /* LCD and nanohub */

2026-01-25T15:48:59Z

LCD and nanohub

← Older revision		Revision as of 15:48, 25 January 2026
Line 45:		Line 45:
	= LCD and nanohub =		= LCD and nanohub =
	The FSTN LCD on catfish has a number of interesting segments - These seem to be as follows:<br>		The FSTN LCD on catfish has a number of interesting segments - These seem to be as follows:<br>
	- 4 7-segment digits and a colon used to indicated time in minutes and hours<br>		- 4 large 7-segment digits and a colon used to indicated time in minutes and hours<br>
			- 2 little 7-segment digits in front of the 4 large digits<br>
	- 5 9-segment digits used to indicate the month and day of month<br>		- 5 9-segment digits used to indicate the month and day of month<br>
			- in front of them an "CAL", behind them an "AM" and "PM" indicator<br>
			- 5 9-segment digits below the last 2 large digits followed by an "KM" an likely an "%". The two last digits are separatet by a dot.<br>
	- 5 rectangular segments (the leftmost shaped like a battery) used to indicate the charge level<br>		- 5 rectangular segments (the leftmost shaped like a battery) used to indicate the charge level<br>
	- ~~pm indicator<br>~~		- 5 9-segment digits for step counting + a shoe symbol in front of them. The numbers follow an "KM/H" and "/KM". After 3 digits is a dot and after the last 2 two dots, like ' and ".<br>
	- ~~some segments~~ for step counting ~~(number unknown)~~ + a shoe symbol<br>		- 3 9-segment digits for heartrate + a heart symbol<br>
	- ~~some segments~~ for heartrate ~~(likely 3)~~ + a heart symbol<br>		- a running person symbol at the bottom<br>
			- an arrow like an GPS symbol at the bottom<br>
			- a Moon with two "z"<br>
			- 4 9-segment digits at the top and a colon<br>
			Note: That is based on a catfish_ext (WF12106). Whether all models are equal has not been verified.

	The LCD is controlled by a dedicated microcontroller called nanohub, which can continue running when the system is completely shut down. Apart from the LCD it is also hooked up to nearly every sensor on the watch, which allows it to keep track of steps and heartrate independently.		The LCD is controlled by a dedicated microcontroller called nanohub, which can continue running when the system is completely shut down. Apart from the LCD it is also hooked up to nearly every sensor on the watch, which allows it to keep track of steps and heartrate independently.

Beroset at 20:42, 15 January 2026

2026-01-15T20:42:01Z

← Older revision		Revision as of 20:42, 15 January 2026
Line 20:		Line 20:
	\|StatusSpeaker=good		\|StatusSpeaker=good
	\|StatusCompass=good		\|StatusCompass=good
	\|StatusSteps=~~bad~~		\|StatusSteps=good
	\|StatusHeartRate=good		\|StatusHeartRate=good
	\|StatusUSB=good		\|StatusUSB=good

Dodoradio: re-rate watches to match website

2025-02-19T13:33:51Z

re-rate watches to match website

← Older revision		Revision as of 13:33, 19 February 2025
Line 5:		Line 5:
	\|Picture=catfish.png		\|Picture=catfish.png
	\|Status=supported		\|Status=supported
	\|Stars=4		\|Stars=5
	\|Chipset=msm8909w		\|Chipset=msm8909w
	\|KernelVersion=3.18		\|KernelVersion=3.18

Mosen: /* Repair */ add overtighten warning to battery info

2025-01-22T13:28:31Z

Repair: add overtighten warning to battery info

← Older revision		Revision as of 13:28, 22 January 2025
Line 77:		Line 77:

	The battery part no. for this device is SP452929SF, which fits other TicWatch models as well.		The battery part no. for this device is SP452929SF, which fits other TicWatch models as well.

			When replacing the battery, ensure that the three Phillips screws fastening the white motherboard cage to the display assembly are not overtightened. Over-tightening can create undue pressure, which may result in ghost touches caused by the metal bezel interfering with the digitizer functionality.

	= Miscellaneous hardware docs =		= Miscellaneous hardware docs =

Giuliano-macedo: Period

2024-09-01T19:16:56Z

Period

← Older revision		Revision as of 19:16, 1 September 2024
Line 76:		Line 76:
	All catfish are held together from the back with 4 torx t4 screws and are sealed with a rubber O-ring (no glue to negotiate, water resistance is not compromised after opening). Parts do not seem to be generally available.		All catfish are held together from the back with 4 torx t4 screws and are sealed with a rubber O-ring (no glue to negotiate, water resistance is not compromised after opening). Parts do not seem to be generally available.

	The battery part no. for this device is SP452929SF, which fits other TicWatch models as well		The battery part no. for this device is SP452929SF, which fits other TicWatch models as well.

	= Miscellaneous hardware docs =		= Miscellaneous hardware docs =

Dodoradio: correct grammar on lates edit

2024-08-31T19:19:18Z

correct grammar on lates edit

← Older revision		Revision as of 19:19, 31 August 2024
Line 76:		Line 76:
	All catfish are held together from the back with 4 torx t4 screws and are sealed with a rubber O-ring (no glue to negotiate, water resistance is not compromised after opening). Parts do not seem to be generally available.		All catfish are held together from the back with 4 torx t4 screws and are sealed with a rubber O-ring (no glue to negotiate, water resistance is not compromised after opening). Parts do not seem to be generally available.

	The battery part no. for this device is SP452929SF, ~~it does~~ fits other TicWatch models		The battery part no. for this device is SP452929SF, which fits other TicWatch models as well

	= Miscellaneous hardware docs =		= Miscellaneous hardware docs =

Giuliano-macedo: Battery number information based on this chat: https://matrix.to/#/!IhWLkfcitdpMucYIJB:matrix.org/$3x6E1B15y4wk6DOTze4-jVQkYaYexNmoCT9ni_JAtnM?via=matrix.org&via=fairydust.space&via=kde.org

2024-08-30T23:43:35Z

Battery number information based on this chat: https://matrix.to/#/!IhWLkfcitdpMucYIJB:matrix.org/$3x6E1B15y4wk6DOTze4-jVQkYaYexNmoCT9ni_JAtnM?via=matrix.org&via=fairydust.space&via=kde.org

← Older revision		Revision as of 23:43, 30 August 2024
Line 75:		Line 75:
	= Repair =		= Repair =
	All catfish are held together from the back with 4 torx t4 screws and are sealed with a rubber O-ring (no glue to negotiate, water resistance is not compromised after opening). Parts do not seem to be generally available.		All catfish are held together from the back with 4 torx t4 screws and are sealed with a rubber O-ring (no glue to negotiate, water resistance is not compromised after opening). Parts do not seem to be generally available.

			The battery part no. for this device is SP452929SF, it does fits other TicWatch models

	= Miscellaneous hardware docs =		= Miscellaneous hardware docs =

Ncaat at 22:48, 3 February 2024

2024-02-03T22:48:28Z

← Older revision		Revision as of 22:48, 3 February 2024
Line 44:		Line 44:

	= LCD and nanohub =		= LCD and nanohub =
	The FSTN LCD on catfish has a number of interesting segments - These seem to be as follows:		The FSTN LCD on catfish has a number of interesting segments - These seem to be as follows:<br>
	- 4 7-segment digits and a colon used to indicated time in minutes and hours		- 4 7-segment digits and a colon used to indicated time in minutes and hours<br>
	- 5 9-segment digits used to indicate the month and day of month		- 5 9-segment digits used to indicate the month and day of month<br>
	- 5 rectangular segments (the leftmost shaped like a battery) used to indicate the charge level		- 5 rectangular segments (the leftmost shaped like a battery) used to indicate the charge level<br>
	- pm indicator		- pm indicator<br>
	- some segments for step counting (number unknown) + a shoe symbol		- some segments for step counting (number unknown) + a shoe symbol<br>
	- some segments for heartrate (likely 3) + a heart symbol		- some segments for heartrate (likely 3) + a heart symbol<br>

	The LCD is controlled by a dedicated microcontroller called nanohub, which can continue running when the system is completely shut down. Apart from the LCD it is also hooked up to nearly every sensor on the watch, which allows it to keep track of steps and heartrate independently.		The LCD is controlled by a dedicated microcontroller called nanohub, which can continue running when the system is completely shut down. Apart from the LCD it is also hooked up to nearly every sensor on the watch, which allows it to keep track of steps and heartrate independently.

	The system communicates with the nanohub through a binary blob that sends data to a really ugly interface in sysfs. On narwhal this is done entirely through sysfs commands (which is a far better implementation). Nanohub gets pretty nuts, looking at the data in firmware files suggests that it may even be running a neural network to analyse the data coming in from the sensors, and it seems to expose this for the purposes of sleep and exercise tracking while the watch is off.		The system communicates with the nanohub through a binary blob that sends data to a really ugly interface in sysfs. On narwhal this is done entirely through sysfs commands (which is a far better implementation). Nanohub gets pretty nuts, looking at the data in firmware files suggests that it may even be running a neural network to analyse the data coming in from the sensors, and it seems to expose this for the purposes of sleep and exercise tracking while the watch is off.

			The <code>lcd-tools</code> command can be used to interact with nanohub.

	== sysfs interface ==		== sysfs interface ==
	'''DO NOT TOUCH THE SYSFS INTERFACE OF CATFISH UNLESS YOU KNOW WHAT YOU ARE DOING. TALK TO SOMEONE KNOWLEDGEABLE FIRST. CATFISH HAVE HAD NANOHUB BRICKED IN THE PAST, LEAVING THE LCD AND SENSORS UNRESPONSIVE. BELOW IS SOME INFORMATION, BUT THIS IS NOT ADEQUATE TO START MESSING WITH SYSFS. YOU HAVE BEEN WARNED.'''		'''DO NOT TOUCH THE SYSFS INTERFACE OF CATFISH UNLESS YOU KNOW WHAT YOU ARE DOING. TALK TO SOMEONE KNOWLEDGEABLE FIRST. CATFISH HAVE HAD NANOHUB BRICKED IN THE PAST, LEAVING THE LCD AND SENSORS UNRESPONSIVE. BELOW IS SOME INFORMATION, BUT THIS IS NOT ADEQUATE TO START MESSING WITH SYSFS. YOU HAVE BEEN WARNED.'''

	<code>/sys/class/nanohub/nanohub ~~provides~~</code> a number of interfaces for communicating. The issue is that it is not known what happens on the other side of this equation, we have firmware files for nanohub but analysing the logic on there is not a project anyone has embarked on.		<code>/sys/class/nanohub/nanohub</code> provides a number of interfaces for communicating. The issue is that it is not known what happens on the other side of this equation, we have firmware files for nanohub but analysing the logic on there is not a project anyone has embarked on.
	<pre>		<pre>
	root@catfish:/home/ceres# ls /sys/class/nanohub/nanohub/		root@catfish:/home/ceres# ls /sys/class/nanohub/nanohub/