JP1 Remotes

I'm using the webtv keyboard device upgrade to augment my ability
to enter show titles in ReplayTV.

I can use the ReplayTV on screen keyboard for #s and alphabet, so I'm
mainly interested in the symbols from the WebTV keyboard device.

From my experience the particular symbols I care about for show titles
are:

1) . (period) OBC 52 18
2) , (comma) OBC ?
3) ' (single quote) OBC 56 58
4) - (dash) OBC 50 DA
5) : (colon) OBC ?

I couldn't find 2 & 5 in the WebTV device/protocol upgrade. Any pointers
on where to get the OBCs I should be using? I don't have a WebTV
keyboard to learn from. I guess I can always try trial and error, but
figure it is quicker to ask.

It may be useful to cover how keyboards work. Each key has two commands down and up. There is probably a held command and an all clear that are the same for all keys, but I don't think they are important for what you want. There is only one "a" key. "A" is shift-"a" to do a shift anything; the command sequence is shift-down, a-down, a-up, and shift-up for a total of 4 keystrokes. ctrl-alt-delete would be ctrl-down, alt-down, del-down, del up, alt-up and ctrl-up. Since the device being controlled generally executes when del-down is sent, the rest of the commands are moot.

Comma Down= 52 3A and Up=F2 3A

Colon = shift-semi-colon

You will need to create a macro since these commands only execute a down or up. If you need up keys you will need to change the values from the remarks column. As is true anytime in KM Master use copy, paste-special-values.

Please add the comma to the device upgrade and feel free to document what works. I decoded it but sometimes once things work, I don't get any feedback. I don't have the hardware and I did it from decoding a ccf file. John Fine gets a lot of the credit when he realized these were really ASCII commands and they are inverted.

A zero is 775 uS on a One is 775 uS off. A start bit is always a Zero, then 8-bits, a parity bit, a parity check bit, and finally a stop bit that is always a One. There can be big gaps between these commands since they depend on human response time. Every keyboard seems to have some variation on this theme.

Then I converted all that into commands that Protocol builder could do so unless you lay out the binary and change byte barriers, it will be hard to reconcile to the commands that you learn. I do believe that DecodeIR.dll will decode some of these but it will decode them in their true values, not necessarily what you will enter in KM Master.

If you get to where that is needed I will send you my Excel spreadsheet that converted all this, but it is very poorly documented.

Just what you what you wanted, a simple answer

You probably already know this, but just in case, all punctuation is ignored by the Replay, so "law & order" would yield the same results as "law order".

If you already know that, I'm guessing that you just want the punctuation to make the Replay Guide listings look better. That being the case, if you're using a learning remote and are not using an extender, you might want to just learn the few WebTV buttons that you need.

> Each key has two commands down and up.
That explains alot. I was wondering why I couldn't enter the same letter
twice. Now I realize f(down) f(down) doesn't make much sense for a
keyboard. It seems for the ReplayTV virtual keyboard, a 2nd (different)
key down implicitly results in prev key up ie

g(down) h(down) g(down) h(down)

looks like it is interpreted as

g(down) [g(up)] h(down) [h(up)] g(down) [g(up)] h(down)

this behavior coupled with my circumstances (where I never need to enter
the same symbol twice in a row) is beneficial in that I can skip the
step of creating macros for each symbol for down/up (thus saving memory
and time, at the expense of probably deviating from expected sequences)

The part that confused me about Web_TV_Keyboard-KM.txt
was it seemed two symbols were missing from the Functions, ',' (comma)
and ';' (semi-colon). It turns out they were in the KM file all along, but
KM converts those characters to '_' when you save the file, so by the
time I loaded the KM file there were 3 '_', one was a duplicate line and
the other two corresponded to ',' and ';' I'm not sure what the etiquette of updating files authored by someone
else is, so I'll just put the suggestions in this post.

> You probably already know this, but just in case, all punctuation is
> ignored by the Replay, so "law & order" would yield the same results
> as "law order".
Doh! Now you tell me At least you gave me an out so I can make my
Replay Theme names all pretty.

For the record, I'm using learning remote 15-2117, but I'm using
extender2, and I don't have a WebTV keyboard to learn from.

I spent some time (it seems more educational than useful) mapping out
the WebTV keyboard to ReplayTV mappings. In the process, I found there
seems to be two ways to enter any particular key (at least that's my
experience for entry into ReplayTV text entry area). For example OBC
(I don't know if OBC is proper terminology) for letter 'a' is 52 E2. 52 E0
can also be used for 'a'.

Basically the last digit for all the OBCs in the KM file are 0, 2, 8, A.
0 and 2 are interchangeable as are 8 and A. I couldn't detect any
pattern of why 0 was used instead of 2, same for 8 and A, so I figure
they can be used interchangeably.

In case anyone is curious here are the mappings from the WebTV
keyboard to ReplayTV functions (don't know if this was already
published somewhere):

Now I feel pretty silly.

First, KM already had all the mappings I needed, I just didn't realize it.

Second, Replay ignores punctuation in theme searches.

Third, someone on AVS had already done a nice writeup on the
WebTV to Replay mappings and the caveats.

http://www.avsforum.com/avs-vb/showthre ... ost2813922

sfhub,

As far as modifying my file: have at it! Make it useful and add your comments and the link in a readme and zip it. Tell me and I'll delete my old one. I am quite happy to get some real feedback that it really works. BTW, most keyboards really do seem to work with only the key down commands as you experienced. I thought you might need compound keys so you got the full explanation.

BTW, you are definitely someone who got up to speed on a lot of things really quickly -- so I hope you stick around once you get everything working perfectly.

Jon -
I cleaned up the KM file and got rid of symbols Excel didn't like (was
converting to underscores) and got rid of the duplicate entry. I also
included sample 15-2117 mapping for ReplayTV users. There's a readme
which details most of my experiences. I've included it below. The new
WebTV keyboard file is located at:

http://groups.yahoo.com/group/jp1/files ... yboard.zip

-- readme.txt --

WebTV Keyboard is a device/protocol created by Jon Armstrong
with assistance from John Fine to allow your remote to send
the IR signals which a WebTV keyboard would normally generate.
It was partially based on a pronto ccf file.

In the process of adapting his work for text/symbol entry into
ReplayTV, I've taken his original work and slightly cleaned up
the KM file and added arrow key support.

I have tested every key which has a ReplayTV mapping but cannot
comment on the other unmapped keys as I do not have a device
which understands the full WebTV keyboard set.

There are 2 files:
Web_TV_Keyboard-KM.txt
Web_TV_Keyboard_for_Replay-KM.txt

The first is a cleaned up version of Jon's original work.
The second is a sample ReplayTV mapping for a 15-2117 remote.

To use, simply load the appropriate file into KM, cut/paste
the device *and* protocol into IR, define a device to use
cbl/1985, upload to your remote, and start experimenting.

Optionally, you can adjust the remote control model and
button mappings in KM.

CAVEATS:
1) ReplayTV ignores symbols in searches, so if you wanted to
create a Theme for:

CSI "CSI Crime" would find "CSI: Crime Scene Investigation"
MI5 "MI5" would find "MI-5"

Thus it is not necessary to enter symbols into the title of
a show (thus you might not want to go through the trouble of
using this device/protocol for ReplayTV other than for aesthetics)

2) To enter the shifted version of any key, use the CAPS key
(mapped to Enter in the 15-2117 sample KM file) This functions
as a shift-lock, so you need to press it again when you are
finished entering the shifted version of keys.

3) Some keys do not appear to display the proper character in
ReplayTV, in particular:

~ tilde (shift-grave) displays ` grave
) right-paren (shift-zero) displays 0 zero
" double-quote (shift-quote) displays , comma
' quote (quote) displays , comma

4) ReplayTV has it's own idea about how to capitalize letters.
The WebTV keyboard doesn't overide the builtin algorithm.

-
- sfhub (PM me at http://www.avsforum.com/)
-

----

If you are interested in the details, read on...

At this point it may be useful to discuss some keyboard basics
with a blurb from Jon Armstrong:

It may be useful to cover how keyboards work. Each key has two
commands down and up. There is probably a held command and an
all clear that are the same for all keys, but I don't think
they are important for what you want. There is only one "a" key.
"A" is shift-"a" to do a shift anything; the command sequence
is shift-down, a-down, a-up, and shift-up for a total of 4
keystrokes. ctrl-alt-delete would be ctrl-down, alt-down,
del-down, del up, alt-up and ctrl-up. Since the device being
controlled generally executes when del-down is sent, the rest
of the commands are moot.

On the "Functions" page of KM you'll notice the OBCs defined
are all for "key-down". The matching "key-up" OBCs are listed
in the Description/Notes column. To properly emulate a WebTV
keyboard you'll need to define a macro for each key with the
"key-down" followed by the "key-up"

However in my testing with *ReplayTV* I've found that in many
cases you really only need to use the OBC for "key-down" as
long as you don't press the same key twice.

For example when I try to enter "gg" what is being sent to
ReplayTV is g(down) g(down), which doesn't make much sense
as there should have been an g(up) sandwiched in between and
at the end of the sequence, if this had been a real keyboard.

There seems to be a feature of the ReplayTV keyboard processing
(possibly others) which will interpret two different "key-down"
presses as if there was a "key-up" in between.

For example:
g(down) h(down) g(down) h(down)

is interpreted as:
g(down) [g(up)] h(down) [h(up)] g(down) [g(up)] h(down)

You can take advantage of this fact to enter repeating characters.
In the above example of entering "gg", we could have entered the
following to accomplish what we wanted (using only key-down OBCs)
g(down) arrow-up(down) g(down)

Regarding the OBCs, in my ReplayTV testing I have found there are
two ways to define any particular key. The last nibble (4 bits)
of any particular OBC will either be 0, 2, 8, A. In particular
0 and 2 are paired as are 8 and A. They can be used interchangeably.

For example:
'a' OBC 52 E0 or OBC 52 E2
'h' OBC 56 78 or OBC 56 7A

Finally, I'm providing the mappings from the WebTV key to the ReplayTV
equivalent function. This would be useful in defining your own button
maps.

This is a nice write up (and not just because you mentioned me ). It is great to have this sort of feedback for others who are trying to progam macros with keyboard commands. I deleted the original version.