summaryrefslogtreecommitdiff
path: root/keyboard/hhkb_rn42/MEMO.txt
blob: 28c5a09d38106e755a2709f39792d266cc677060 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
Roving RN-42
============
07/16   After fix of voltage dividor on GPIO6, had a trouble that it could not send a char to BT module, though could receive.
        Found R8 had wrong 1K resistor and changed to 10K, after that it can send to the module again. Not sure how it had sent with the wrong 1K before.
07/18   On Linux, had an USB related trouble; keyobard or console didn't work for some reason. Changing PID cured this problem. Very annoying, took very long time before resolved it.



TODO
----
- LUFA sendchar should be buffered and serial_uart.c buffur size is too large(256).
- Factroy reset doesn't work; need to test again. 10K pull-up is too high?
- Lipo voltage ADC sensing
- Lipo charger configuration: fast charge time:  USB charger spec?
- Low voltage alarm: LED indcates voltage of Lipo
- CTS/RTS lines are needed? just connect in loop back if no flow control is needed.
- CTS is needed for waking up from deep sleep?
- Serial API callback  when data are available/received(and when send buffer is available)
- Serial API instance  several serial ports can be used
- DCDC converter: squeaky inducter with onsemi NCP1402
- Lipo charger MCP73831: needs capacitor 4.7uF *2
- Keymap layer bug: during space is pressed(mousekey) press Fn(HHKB) then release space before Fn, in result HHKB layer is locked(toggled) unintentionally.

DONE:
- USB connection check - 07.01
- BT on/off check: whether RX line is pulled up? - checking RTS 07.01
- USB/BT switching  BT is on -> BT, BT is off -> USB - 07.01
- Under voltage lock out UVLO for protection of Lipo - Lipo has discharge protection at 3.100V    07.01
- Power saving: HHKB scan, BT radio control - 9h with 850mAh, this is enough   07.01
- Power selector doesn't work; Q4 MOSFET leaks from Lipo to USB power line. -- use Schottky instead 07/04


Lipo
----
Sparkfun Polymer Lithium Ion Battery 850mAh:
https://www.sparkfun.com/products/341
Lipo Cell spec:
https://www.sparkfun.com/datasheets/Batteries/063048%20Li-polymer.pdf
Protection spec:
http://dlnmh9ip6v2uc.cloudfront.net/datasheets/Prototyping/BatteryProtection.pdf
                            min     typical max
over-charge                 4.255   4.280   4.305
over-charge discover?       4.030   4.080   4.130        
over-discharge              2.827   2.900   2.973
over-discharge discover     3.022   3.100   3.178

ADC voltage monitor:    voltage divider 10K+10K(0.5)
    ADC=V*0.5/2.56*1024
    V       ADC
    ------------------
    4.20    0x347(839)
    3.10    0x26b(619)
    



Configuration
-------------
Ver 6.15 04/26/2013
(c) Roving Networks
***Settings***
BTA=0006664B3AE3
BTName=tmkBT-3AE3
Baudrt(SW4)=115K
Mode  =DTR
Authen=2
Bonded=0
Rem=000000000000
***ADVANCED Settings***
SrvName= keyboard/mouse
SrvClass=0000
DevClass=0000
InqWindw=0100
PagWindw=0100
CfgTimer=255
StatuStr=NULL
HidFlags=3c
DTRtimer=8
KeySwapr=0
***OTHER Settings***
Profile= HID
CfgChar= $
SniffEna=8010
LowPower=0
TX Power=0
IOPorts= 0
IOValues=0
Sleeptmr=0
DebugMod=0
RoleSwch=0



Serial connection
-----------------
Serial line:    115200bps, 8bit, 1-stopbit, non-parity, no flow control
SSP:            115200bps, 8bit, 1-stopbit, non-parity, no flow control(via Bluetooth)

To enter command mode disconnect the module from host and type '$$$'.(you will see 'CMD')
To exit type '---'(you will see 'END') and '+' to get local echo.



Setting command mode
--------------------
S-,tmkBT            // Device name
SS,keyboard/mouse   // service name
SM,4                // Auto Connect DTR mode
SW,8010             // Sniff enable 0x10*0.625ms=10ms; 50ms is laggish and not much power save
S~,6                // HID profile
SH,003C             // HID register
SY,0004             // Transmit power




Other options:
SC,0000         // COD: 000005C0    (see HID spec/Bluegiga doc)
SD,05C0         //     bit 12-8         7           6           5-0
                //         00101        1           1           0
                //         peripheral   pointing    keybaord    joystick, gamepad, ...
SM,6                // Pairing mode: auto connect
SM,4                // Master mode: Connection can be controled with GPIO6




HID profile
-----------
S~,6    HID profile
S~,0    SPP profile
R,1     reboot


Apple iOS
---------
Cannot supported without apple iAP authentication chip.


HID flag register
-----------------
SH,0200
GH

10 0000 0000(0200)  default
00 0011 1000(0038)  Combo
|| |  | |\_\____ number of paired devices to which the module can reconnect
|| |  | \_______ send out reports over UART (0xFF <len> <data>)
|| \__\_________ descriptor type
|\______________ toggle virtual keyboard on iOS when first connected
\_______________ Force HID mode if GPIO11 is high on power-up

    Descriptor type:
    0000:   keybaord
    0001:   Game Pad
    0010:   Mouse
    0011:   Combo
    0100:   Joystick
    1xxx:   reserved

Out report - Indicator
----------------------
0xFE 0x02 0x01 <LED_state>


LED Status
----------
Configuring                     10 times per sec
Startup/configuration timer     2 times per sec
Discoverable/Inquiring/Idle     once per sec
Connected                       solid on


Pairing
-------
First, host initiates pairing process and once it is done, auto connect will work thereafter.
SM,3        Master mode
SM,4        Auto Connect DTR Mode uses GPIO6 to make and break connection(Mode =DTR)
                confirm: auto connect works and control connection with GPIO6
SM,5        Auto Connect ANY Mode (Mode =ANY)
                each time GPIO is set, make inquiry and connect to the first found device
SM,6        automatically reconnect(Mode =Pair)
                confirm: auto connect works well but difficult to enter command mode.


Fast data mode
--------------
The module enters fast data mode after 'remote configuration timer' window is passed from power on.
In this mode the module does not accept '$$$' to enter command mode.

Power Management
----------------
Inquiry and Page window     Idle or Active  (3.1.1)
    Downside: delay in discovery or connection time
    SI,         // set inquiry scan window(discovery) on/off duty?
    SJ,         // set page scan window(connection)
    This reduces averaege power >20mA to 5mA(3mA in Sniff mode)

Sniff mode                  Transmit
    Sniff mode is disabled by default and radio is active continuously when connected.(25-30mA)
    In Sniff mode the radio wakes up intermittently and sleeps in very low power mode.(2mA)
    SW,<val>    // set interval timer(*0.625ms) 0000-7FFF

Deep sleep                  Idle            (3.1.2)
    In this mode the module shuts down completly and only draws about 300uA. To enable this set the most signifant bit(0x8000) of Sniff interaval timer.
    SW,8320     // deep sleep enable(interval=0x320*0.625=500ms)
    In normal sleep the firmware is still running in idle mode, and wakes up about 20 times per second to check ports, update LEDs, etc. During deep sleep, the firmware actually stops runnig some tasks and the LEDs only update about once per second.
    To wake from deep sleep there are three ways: (in worst case wake up takes 5ms)
        *send a charactor to the UART(first charactor will be lost)
        *toggle CTS low to high and wait 5ms
        *wake automatically every slot time(<val>*0.625ms)
    Once the radio is awake it stay active for exactly 1 second of inactivity and then sleeps again.
    Downside: latency and data loss

Disable Output driver       Idle or Active  (3.1.3)
    S%,1000     // set all GPIO pins(0-11) to inputs.

Lower Transmit Power        Idle or Active  (3.1.4)
    SY,<hex>    // transmit power setting(takes effect after a power cycle and reboot)
    Downside: reducing effective range


Optimizig for Latency
---------------------
By default the firmware is optimized for throughput.
SQ,16           // set latency bit
SQ,0            // unset latency bit


Configuration timer settings
----------------------------
Remote configuration is used for the module to be configured with various commands over Bluetooth(SPP profile only?).

The module has remote configuration timer to allow remote configuration over Bluetooth after power up in Slave mode. In Master modes the remote configuration timer is set to 0(no remote configuration). (In Trigger Master mode the timer is used as an idle timer to break the connection after time expires with no charactors receive.)
    ST,0        // no remote, no local when connected
    ST,<1-252>  // local and remote with timeout in seconds from power up
    ST,253      // local only       without timeout
    ST,254      // remote only      without timeout
    ST,255      // local and remote without timeout


Android
-------
3.7.1.5 Note: To connect with Android phone the modules must wake up 11ms every 2.5seconds.


Commands
--------
SC,
SM,<val>
SD,         
SP,<string>             Pin code(alpahnumeric)
SQ,<mask>               Special configuration(GPIO, discovery mode, low latency, reboot, UART)
SR,<hex>                Store remote address
SR,Z                    Erase all address
SS,<string>             Set service name(1-20)**
ST,<val>                Remote configuration timer(Master:0, Slave:0-255, Triger:as idle timer)
SU,<val>                UART baud rate
SW,<val>                low-power sniff mode** deep sleep and wake up every 625us * <val>
SX,<0|1>                bonding enable  only acceps device that matches the stored address
SY,<hex>                power setting** 
SZ,<val>                non-standard raw baud rate  <val>=baud*0.004096
S~,<val>                Profile     0:SPP, 5:APL, 6:HID
S-,<string>             Device name     -15 alphanumeric charactors
S?,<0|1>                role switch enable
S$,<char>               command mode char
$|,<hex>                low-power connect mode  deep sleep/active(discoverable and connectable) cycle
D                       display basic setting
E                       display extended setting
GB                      display the device's Bluetooth address
GF                      display Bluetooth address of connected device
GK                      show connection status
GR                      show remote address for reconnecting
G&                      show GPIO pin
G<char>                 show stored setting
+                       toggle local echo on/off
&                       show GPIO 3,4,6,7(DIP switch)
C                       connect to stored remote address
C,<address>             connect last address
CFI                     connect and go into fast data mode
CFR                     connect and go into fast data mode
CT,<address>,<val>      connect to the address and disconnect after val?
F,1                     fast data mod:
H                       display help
I,<time>,<cod>          inquiry scan with <cod>
IN
IQ                      scan
IS                      inquiry scan with 001F00
J                       hide pin code
K,                      kill    disconnects current connection
L                       link quality
M                       show modem signlal status
O                       display other settings
P,<car>                 pass through?
Q                       quiet mode  make the module not discoverable
Q,0                     discoverable and connectable
Q,1                     not discoverable and not connectable
Q,2                     not discoverable and connectable
Q,?                     display current quiet mode
R,1                     reboot
T,<0|1>                 pass received data while in command mode
U,<baud>,<parity>       change UART setting tentatively
V                       display firmware version
W                       wake from quiet mode    enable discovery and connection
Z                       deep sleep mode(<2mA)



help
----
*** SET COMMANDS ***
SA,<3,0>   - Authentication
SC,<hex>   - Service Class
SD,<hex>   - Device Class
SE,<1-16>  - UUID
SF,1       - Factory Defaults
SH,<hex>   - HID flags
SI,<hex>   - Inquiry Scan Window
SJ,<hex>   - Page Scan Window
SL,<E,O,N> - Parity
SM,<0-5>   - Mode (0=slav,1=mstr,2=trig,3=auto,4=DTR,5=Any)
SN,<name>  - Name
SO,<text>  - conn/discon Status
SP,<text>  - Pin Code
SR,<adr>   - Remote Address
SS,<text>  - Service Name
ST,<num>   - Config Timer
SU,<rate>  - Baudrate
SW,<hex>   - Sniff Rate
SX,<1,0>   - Bonding
SY,<hex>   - TX power
SZ,<num>   - Raw Baudrate
S~,<0-6>   - Profile (0=SPP,1=DCE,2=DTE,3=MDM,4=D&S,6=HID
S?,<0-1>   - role switch
S$,<char>  - CMD mode char
S@,<hex>   - io port dir
S&,<hex>   - io port val
S%,<hex>   - io boot dir
S^,<hex>   - io boot val
S*,<hex>   - pio(8-11) set
S|,<hex>   - low power timers
S+,<num>   - DTR timer
S=,<hex>   - Key mapper
S:,<num>   - sleep timer
*** DISPLAY      ***
D     - Basic Settings
E     - Extended Settings
G<X>  - Stored setting
GB    - BT Address
GF    - BT Address of Last Connection
GK    - Connect Status
G&    - I/O Ports
V     - Firmare version
*** OTHER        ***
C,<adr>    - Connect
F,1        - Fast Mode
I,<time>,<cod> - Device Scan Inquiry
J          - Hide Pin Code
K,         - Kill (disconnect)
L,         - toggle local echo
P,<text>   - Pass Thru
Q          - Quiet (no discovery)
R,1        - Reboot
T,<0,1>    - send data in CMD mode
U,<rate>,<E,O,N> - Temp Uart Change
Z          - low power sleep
&          - Read switches