Bluetooth API

Bluetooth®

The foc.us gamer is a licensed Bluetooth® Smart device.

In response to popular demand we are publishing our bluetooth API. If you want to write your own application to control your foc.us the information required to do so is on this page.
If you have a question please post it on stackoverflow and then email the link to support@foc.us and we will respond there.

The information provided on this page is the property of foc.us. It may only be used to create client software for use with foc.us products.
Usage of this information does not constitute or infer any rights to ownership or guaranteed access or continuation of usage.

UUID Permissions Size Name Value Unit Description
0xfff1 Read 1 byte Battery level 0…100 1% Battery level
0xfff2 Read 1 byte Actual current 0…200 0.01mA The current level on the electrodes in real time
0xfff3 Read/Write 1 byte Mode See description

Value Perm Name Description
0 W Off Power off device
1 R/W Paired The device is connected via Bluetooth
2 R/W ACTIVE_CONT Active conitunuous mode
3 R/W ACTIVE_PULSE Active pulse mode
4 R/W ACTIVE_SINUS Active sinus mode
5 R/W ACTIVE_NOISE Active noise mode
6 R/W ACTIVE_FAKE Active fake mode
7 R ERROR_ZERO The current is equal to zero
8 R ERROR_OVF Target current can’t be reached
0xfff4 Read/Write 1 byte Electrodes mode See description Least nibble – left electrode
Most nibble – right electrode
This value can only be written in “paired” mode
Value of nibble:

Value Perm Name Description
0 R/W Off Electrode is switched off
1 R/W Negative Electrode is negative when active
2 R/W Positive Electrode is positive when active
0xfff6 Read/Write 2 bytes Time in active mode 0…65535 1s Duration of the active mode
0xfff7 Read/Write 2 bytes FW version
FW update control		 FW version can be read in FW_IDLE mode. Range 0…65535

FW update control:

Value Perm Name Description
0 W FW_IDLE No FW update process
1 R/W FW_START Start of FW update process
2 R FW_DATA FW data transmission
3 R/W FW_END_DATA End of FW data transmission
4 R FW_CRC_OK Calculated CRC value is true
5 R FW_CRC_ERROR Calculated CRC value is false
6 R/W FW_BURN Start of flash update process
0xfff8 Write Item 20 bytes FW data buffer Buffer for data during firmware update process
0xfff9 Read/Write 4 bytes Pin code 0…999999 Pin code for pairing

Table 2

UUID Perm. Size Continuous Mode Pulse Mode Sinus Mode Noise Mode Fake Mode
0xfff5 R/W 1 byte Max current
20…200 * 0,01mA		 Max current
20…200 * 0,01mA		 Max current
20…200 * 0,01mA		 Max current
20…200 * 0,01mA		 Max current
20…200 * 0,01mA
0xfffa R/W 1 byte N/A Current offset
0…200 * 0.01mA		 Current offset
0…200 * 0.01mA		 Current offset
0…200 * 0.01mA		 N/A
0xfffb R/W 1 byte Current rise/fall time
1…255*1s		 Current rise/fall time
1…255*1s		 Current rise/fall time
1…255*1s		 Current rise/fall time
1…255*1s		 Current rise/fall time
1…255*1s
0xfffc R/W 2 byte N/A Pulse width
10…65335 * 1ms		 Sinus wave period
2…65535 * 50ms		 Min timestep
10…65535 * 1ms		 N/A
0xfffd R/W 2 byte N/A Pulse period
10…65535 * 1ms		 N/A Max timestep
10…65535 * 1ms		 N/A

FW update process description

  1. 1. Write FW_START value.
  2. 2. Send firmware file. Sending is made in blocks of 20 bytes, where least 2 bytes : data block number, and most 18 bytes : firmware data.
    Note. The size of any firmware file is a multiple of 18 bytes.
  3. 3. Write FW_END_DATA value.
  4. 4. Wait, while check sum is calculated. When it complete, device will set FW_CRC_OK or FW_CRC_ERROR state.
  5. 5. If state is FW_CRC_OK, write FW_BURN value for firmware rewriting. If state is FW_CRC_ERROR (firmware file was corrupted during transmission) go to step 1.

The Bluetooth® word mark and logos are registered trademarks owned by Bluetooth SIG, Inc. and any use of such marks by foc.us is under license. Other trademarks and trade names are those of their respective owners.