more minor tweaks

gfwilliams · gfwilliams · commit 38549ab6208e · 2025-03-14T10:20:11.000Z
diff --git a/libs/banglejs/jswrap_bangle.c b/libs/banglejs/jswrap_bangle.c
@@ -4931,9 +4931,10 @@ void jswrap_banglejs_touchWr(JsVarInt reg, JsVarInt data) {
     ]
 }
 Reads a register from the touch controller. See https://github.com/espruino/Espruino/issues/2146#issuecomment-2554296721 for a list
-of registers.
+of registers. When the touchscreen is off (eg the Bangle is locked) then reading from any register will return `255` (`0xFF`) -
+so ensure the Bangle is unlocked with `Bangle.setLocked(false)` before trying to read or write.
 
-For example `print(Bangle.touchRd(0xa7).toString(16))` returns the `ChipID` register, which is 0xB4 (CST816S) on older Bangles or 0xB6 (CST816D) on newer ones.
+For example `print(Bangle.touchRd(0xa7).toString(16))` returns the `ChipID` register, which is `0xB4` (CST816S) on older Bangles or `0xB6` (CST816D) on newer ones.
 
 **Note:** On Espruino 2v06 and before this function only returns a number (`cnt` is ignored).
 */

Original file line number	Diff line number	Diff line change
`@@ -4931,9 +4931,10 @@ void jswrap_banglejs_touchWr(JsVarInt reg, JsVarInt data) {`
`4931`	`4931`	`]`
`4932`	`4932`	`}`
`4933`	`4933`	`Reads a register from the touch controller. See https://github.com/espruino/Espruino/issues/2146#issuecomment-2554296721 for a list`
`4934`		`-of registers.`
	`4934`	+of registers. When the touchscreen is off (eg the Bangle is locked) then reading from any register will return `255` (`0xFF`) -
	`4935`	+so ensure the Bangle is unlocked with `Bangle.setLocked(false)` before trying to read or write.
`4935`	`4936`
`4936`		-For example `print(Bangle.touchRd(0xa7).toString(16))` returns the `ChipID` register, which is 0xB4 (CST816S) on older Bangles or 0xB6 (CST816D) on newer ones.
	`4937`	+For example `print(Bangle.touchRd(0xa7).toString(16))` returns the `ChipID` register, which is `0xB4` (CST816S) on older Bangles or `0xB6` (CST816D) on newer ones.
`4937`	`4938`
`4938`	`4939`	Note: On Espruino 2v06 and before this function only returns a number (`cnt` is ignored).
`4939`	`4940`	`*/`