| Index: docs/accessibility/patts.md
|
| diff --git a/docs/accessibility/patts.md b/docs/accessibility/patts.md
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..5a7fce52891beaf0ce8ee90149aa5873d16f6eeb
|
| --- /dev/null
|
| +++ b/docs/accessibility/patts.md
|
| @@ -0,0 +1,77 @@
|
| +# The Chrome OS PATTS speech synthesis engine
|
| +
|
| +Chrome OS comes with a speech synthesis engine developed internally at Google
|
| +called PATTS. It's based on the same engine that ships with all Android devices.
|
| +
|
| +## Building from source
|
| +
|
| +This is for Googlers only.
|
| +
|
| +Visit [http://go/chrome-tts-blaze](http://go/chrome-tts-blaze)
|
| +for instructions on how to build the engine from source and get the
|
| +latest voice files.
|
| +
|
| +When debugging, start Chrome from the command-line and set the
|
| +NACL_PLUGIN_DEBUG environment variable to 1 to print log messages to stdout.
|
| +
|
| +## Updating
|
| +
|
| +First, follow the public
|
| +[Chromium OS Developer Guide](http://www.chromium.org/chromium-os/developer-guide) to check out the source.
|
| +At a minimum you'll need to create a chroot.
|
| +You do not need to build everything from source.
|
| +You do need to start the devserver.
|
| +
|
| +Next, flash your device to a very recent test build. Internally at Google
|
| +you can do this with the following command when the dev server is running,
|
| +where CHROMEBOOK_IP_ADDRESS is the IP address of your Chromebook already
|
| +in developer mode, and $BOARD is your Chromebook's board name.
|
| +
|
| +```cros flash ssh://CHROMEBOOK_IP_ADDRESS xbuddy://remote/$BOARD/latest-dev/test```
|
| +
|
| +Before you can make changes to PATTS, the first thing you need to run
|
| +(from the chroot) is call cros_workon with two relevant ebuilds:
|
| +
|
| +```
|
| +cros_workon --board=$BOARD start chromeos-assets
|
| +cros_workon --board=$BOARD start common-assets
|
| +```
|
| +
|
| +Next, make sure you're in the platform/assets directory and run
|
| +```repo start``` and create a branch.
|
| +
|
| +```
|
| +cd platform/assets
|
| +repo start <branch_name> .
|
| +```
|
| +
|
| +
|
| +The PATTS data files can be found in this directory:
|
| +
|
| +```platform/assets/speech_synthesis/patts```
|
| +
|
| +When updating the files, the native client files (nexe) need to be zipped.
|
| +
|
| +Replace all of the files you need to update, commit them using git,
|
| +then from the chroot, run:
|
| +
|
| +```
|
| +emerge-$BOARD common-assets
|
| +cros deploy CHROMEBOOK_IP_ADDRESS common-assets
|
| +```
|
| +
|
| +Note that you need to call cros_workon on both chromeos-assets and
|
| +common-assets. You will be changing files in chromeos-assets, but
|
| +to flash it onto your device, you need to emerge and deploy
|
| +common-assets.
|
| +
|
| +After that, reboot your Chromebook and verify that speech works.
|
| +
|
| +To upload the change, use repo upload, something like this:
|
| +
|
| +```
|
| +git commit -a
|
| + BUG=chromium:12345
|
| + TEST=Write what you tested here
|
| +repo upload .
|
| +```
|
|
|