Dev 3.0.0

[andrewjaykeller]

v3.0.0

New Features

• Add wifi shield support.
  • Simply add OpenBCI_Wifi_Master to your DefaultBoard.ino and add wifi.loop() to your loop function. If you want to read from it checkout the DefaultBoard.ino for it's simple interface.
  • Send channel gains to wifi shield at start of stream
  • takes ~4 seconds for the wifi shield to be reachable
• Add ability to turn external serial port Serial1 on through commands.
• Change board types on the fly! No longer do you have to upload new code to the Cyton's Pic32 just to do an analog read. You can now read from analog or digital pins with the press send of a code! '/x' now sets the board mode, where x can be one of the following:
  • BOARD_MODE_DEFAULT is 0
  • BOARD_MODE_DEBUG is 1
  • BOARD_MODE_ANALOG is 2
  • BOARD_MODE_DIGITAL is 3
  • BOARD_MODE_MARKER is 4
  • BOARD_MODE_BLE is 5
• A new board mode called MARKER. In this mode, if a command in the format of '`n' (where n is ASCII '0':'9') is received by the Cyton over any of the serial streams (including wifi) then a marker of int(n) is inserted in the AUX1 channel. Note that this mode is mutually exclusive to the DEFAULT (accelerometer mode) as it uses the AUX1/ACCELX channel.
• A new board mode called BLE. In this mode, the board will switch Serial0 to 9600 and will downsample 2 channels to 125Hz and send them 3 samples in a packet for a total of 18 data bytes. The RFduino would then take this packet and send it over BLE.
• Add loop function for internal timing operations related to power on reset for wifi shield, remove loop to free up pins and such and remove wifi capability.
• Add function to turn time stamps on useTimeStamp(true), time stamps are disabled by default. Note the Wifi shield will use NTP time stamps.
• Add wifi commands:
  • OpenBCI Wifi Attach - {
  • OpenBCI Wifi Remove - }
  • OpenBCI Wifi Status - :
  • OpenBCI Wifi Reset - ;
• Variable sample rate in the format of ~(COMMAND). This works similar to the Channel Settings commands, however, there is no latching character. Changing the sample rate requires sending a v or soft-reset to ensure all systems are correct. Power cycling the OpenBCI board will cause the sample rate to reset back to default of 250Hz. IMPORTANT! The Cyton cannot and will not stream data over 250SPS. Plug in the wifi shield to get speeds over 250SPS streaming. You may still write to an SD card though, the firmware will not send EEG data over the Bluetooth radios. Check out the new commands:
  • 0 = 16000 Hz
  • 1 = 8000 Hz
  • 2 = 4000 Hz
  • 3 = 2000 Hz
  • 4 = 1000 Hz
  • 5 = 500 Hz
  • 6 = 250 Hz
  • ~ = Get current sample rate
  • EXAMPLE
    • First, user sends ~~
    • returns Sample rate is 250Hz$$$
    • Then, user sends ~5
    • returns Sample rate set to 500Hz$$$

Enhancements

• hasDataSerial0 and hasDataSerial1 use new properties SerialInfo to determine if data should be received. Now safe to call every loop.

Breaking Changes

• Removed boolean useAccel in support of new mode paradigm. To use the accel, do nothing, it's enabled by default, to not use the accel simply call useAccel(false) and this library will automatically send the contents of auxData array each packet.
• Removed OPENBCI_EOP_STND_ACCEL, OPENBCI_EOP_STND_RAW_AUX, OPENBCI_EOP_USER_DEFINED, OPENBCI_EOP_ACCEL_TIME_SET, OPENBCI_EOP_ACCEL_TIME_SYNCED, OPENBCI_EOP_RAW_AUX_TIME_SET, and OPENBCI_EOP_RAW_AUX_TIME_SYNCED in place of enum support replacement: PACKET_TYPE_ACCEL, PACKET_TYPE_RAW_AUX, PACKET_TYPE_USER_DEFINED, PACKET_TYPE_ACCEL_TIME_SET, PACKET_TYPE_ACCEL_TIME_SYNC, PACKET_TYPE_RAW_AUX_TIME_SET, and PACKET_TYPE_RAW_AUX_TIME_SYNC.
• Removed sniffMode in place for curBoardMode == OPENBCI_BOARD_MODE_DEBUG
• Removed public waitForNewChannelData()
• Removed public timeSynced and private sendTimeSyncUpPacket
• Setting internal test signal now, when not streaming, returns a success message, with EOT $$$
• Sending multi char messages now times out after a second of not completing the multichar message.

Release Candidate 7

Bug Fixes

• Sending data for register query took too long to send, removed delay when command came from wifi.
• Setting board mode restarted board for no real reason.

New Features

• Marker mode, where you can store markers to the stream. Send a /4 to engage this mode.

Release Candidate 6

Bug Fixes

• Even when command came from wifi, library printed to Serial0, which resulted in overflow of radio buffer which led to a reset.

Release Candidate 5

Bug Fixes

• Calling boardBeginDebug(void) would result in debug not working.
• Closes #69 with once second timeout on multi byte messages.

Release Candidate 4

Enhancements

• Can now send long messages to Wifi shield which will allow for the GUI to understand the the channel settings for each channel on the Cyton. Required changing a ton of Serial0.print to printAll and Serial0.println to printlnAll.
• Send response when stopping and starting streaming to wifi shield if present, will not send to Serial ever.

Release Candidate 3

Fix the library.properties file again...

Release Candidate 2

Had to fix the library.properties file

Release Candidate 1

Breaking Changes

• Stop sending wifi connection status on connect

Beta5

New Features

• Send gains after connecting to Wifi shield

Breaking Changes

• Don't send streaming data over bluetooth when wifi is present and attached

Beta4

The overall goal was to clean the wifi code out of the library so it would not be needed when you are building a bare board.

Bug Fixes

• Fixed the BoardWithAnalogSensor.ino, BoardWithDigitalRead.ino and BoardWithCustomData.ino examples.
• Board did not send serial data with allowed sample rates over bluetooth.

Breaking Changes

• Removed all wifi code and put into new library that must be included! The new library is a called OpenBCI_Wifi_Master_Library. It is simply included when wifi is wanted.
• Removed .loop() function from library.

Files

• Add BoardWithWifi.ino example that shows a bare board with just wifi. No SD or ACCEL for example.

Beta3

Bug Fixes

• Fixes erroneous print out on seeking wifi overall Serial0.

Beta2

Breaking Changes

• Setting internal test signal now, when not streaming, returns a success message, with EOT $$$

Beta1

• Initial Release