API reference - Ricoh Theta

Bluetooth API Reference

Ricoh Theta A1, X and Z1 support camera control via Bluetooth Low Energy communication. This communication protocol is fully compliant with the Bluetooth 4.2 Core Specifications that includes the Generic Atttibute Profile (GATT) and incorporates Ricoh Theta Extensions.

1. Advertising

Ricoh Theta is discoverable for an indefinite period of time.

• Complete local name: For Theta A1, the serial number of Theta. For Thate X and Z1, numeric portion of the serial number of Theta.
  • If a serial number of Theta A1 is AA01234567, its complete local name is AA0123456.
  • If a serial number of Theta X is YR01234567, its complete local name is 0123456
• 128-bit service UUID: f74d1ba5-bc52-4f10-99c0-85e785ebe43f
• Flag: General Discoverable Mode

2. Provided services

Ricoh Theta provides following services:

• Camera control command v2
• WLAN control command v2
• Bluetooth Control Command : Theta A1 only

All characteristics return response upto 512 bytes as UTF-8 encoded JSON.

2.1 Camera control command v2 service

The serice UUID is b6ac7a7e-8c01-4a52-b188-68d53df53ea2.

The following characteristics are exposed in the Camera control command v2 service.

Characteristic Name	Enabled properties	Characteristic UUID	Value format	Note
Get Info	read	a0452e2d-c7d8-4314-8cd6-7b8bbab4d523	UTF-8 string (JSON)
Get State	read	083d92b0-21e0-4fb2-9503-7d8b2c2bb1d1	UTF-8 string (JSON)
Get State2	read	8881ce4e-96fc-4c6c-8103-5dda0ad138fb	UTF-8 string (JSON)
Notify State	notify	d32ce140-b0c2-4c07-af15-2301b5057b8c	UTF-8 string (JSON)
Get Options	read, write, notify	7cffaae3-8467-4d0c-a9dd-7f70b4f52863	UTF-8 string (JSON)
Set Options	write	f0bcd2f9-5862-4653-b50d-80dc51e8cb82	UTF-8 string (JSON)	Theta A1 and X only
Request Shutter Command	write	6e2deebe-88b0-42a5-829d-1b2c6abce750	UTF-8 string (JSON)	Theta A1 and X only

2.2 WLAN Control Command v2 service

The serice UUID is 3c6feeb6-f335-4f93-a4bb-495f926db409.

The following characteristics are exposed in the WLAN control command v2 service.

Characteristic Name	Enabled properties	Characteristic UUID	Value format
Notify Scanned SSID	notify	60eedccc-426a-49cf-9ae1-f602284703d7	UTF-8 string (JSON)
Set Access Point	write	4980acba-e2a5-460b-998b-9ad4c49fbe39	UTF-8 string (JSON)
Set Network Type	write	4b181146-ef3b-4619-8c82-1ba4a743acfe	UTF-8 string (JSON)
Notify WLAN State	notify	a90381fc-2dda-4eed-b24b-60f3e6651134	UTF-8 string (JSON)
Read WLAN State	read	01dff9ff-00fa-44dd-aa6a-71d5e537abcf	UTF-8 string (JSON)
Read WLAN Password State	read	e522112a-5689-4901-0803-0520637dc895	uint8

2.3 Bluetooth Control Command

The serice UUID is 0F291746-0C80-4726-87A7-3C501FD3B4B6.
Theta A1 only.

The following characteristics are exposed in the Bluetooth control command service.

Characteristic Name	Enabled properties	Characteristic UUID	Value format
Scan Bluetooth Peripheral Device	write	03f423b3-a71f-4d70-a4bc-437c3137afcd	UTF-8 string (JSON)
Notification Scanned Bluetooth Peripheral Device	notify	7b058429-df5c-4454-88a2-c81086131c30	UTF-8 string (JSON)
Connect Bluetooth Peripheral Device	write	1fa3e524-bad5-4f75-808b-94487a4b9024	UTF-8 string (JSON)
Delete Bluetooth Peripheral Device	write	61a37c82-d635-43b9-a973-5857efe64094	UTF-8 string (JSON)

Appendix A. Recent firmware change history

These API descriptions target the latest version of Theta firmware. Older versions may not have any options or parameters. Refer firmware change history.