package goosci

Get desktop application:
View/edit binary Protocol Buffers messages

Analog pin number refers to the numeric value in A0, A1, A2... use this to request values from an analog pin on the Device.

Used in: Pin

• required int32 pin = 1

AnalogValue contains a stream of single-dimensional integer values collected from an analog pin on the Device.

Used in: Data

• required uint32 value = 1

Used in: SensorSpec, Trial.AppearanceEntry

• optional string locale = 1

  An experiment may be recorded in one locale and displayed in another locale. We will not attempt to store all possible translations of a sensor’s name just in case it is displayed in a different locale. However, we may wish at some point to have a UI element change if we know we’re showing a foreign language. The format is a BCP 47 language tag, like "en-US"

• optional string name = 2

  Display name

• optional string units = 3

  Displayed string representing the units of the value

• optional IconPath icon_path = 4

  Asset path to the small icon (for tab display)

• optional string short_description = 5

  Short description that is shown on meter-mode card

• optional int32 pointsAfterDecimal = 6

  Allows a sensor to specify that it should be rounded in a particular way

• optional IconPath large_icon_path = 7

  Asset path to the large icon (for display in snapshots)

• optional string address = 1

• optional string sensor_type = 2

  Must be a string representation of a number. Valid values can be found at SensorTypeProvider#SensorKind.

• optional string customPin = 3

  _If_ the sensor is of type SensorTypeProvider.TYPE_CUSTOM, what pin does it read from?

• optional bool customFrequency = 4

  _If_ the sensor is of type SensorTypeProvider.TYPE_CUSTOM, does it use a frequency filter?

• optional BleSensorConfig.ScaleTransform customScaleTransform = 5

  _If_ the sensor is of type SensorTypeProvider.TYPE_CUSTOM, how is it scaled? A missing value means no scaling. If customFrequency is true, then this scaling is applied _after_ the frequency filter.

Defines a linear transform that maps the range [sourceBottom, sourceTop] in the incoming data to [destBottom, destTop] in the outgoing, filtered data.

Used in: BleSensorConfig

• optional double sourceBottom = 1

• optional double sourceTop = 2

• optional double destBottom = 3

• optional double destTop = 4

A user-added caption. This can be applied to trials and labels.

Used in: Label, Trial

• optional string text = 1

• optional int64 lastEditedTimestamp = 2

A single change to the experiment. Adding, editing, or deleting labels, titles, or trials will all result in a new change being added here. Used for resoving conflicts between client and server.

Used in: Experiment

• optional string changeId = 1

  A UUID to identify the change.

• optional ChangedElement changedData = 2

  A reference to the label or trial that was changed.

• optional Change.ChangeType type = 3

  The type of change.

Used in: Change

• UNKNOWN = 0

  Default. Do not use.

• ADD = 1

  Used to signify a change that results in a new UUID being generated. Generally adding a trial or label.

• DELETE = 2

  Used to signify a change that removes an item with a UUID from the Experiment proto.

• MODIFY = 3

  Used to signify a change that alters the content of an item with an existing UUID.

• MERGE = 4

  Used to signify changes that take place during a mergeFrom, such as Editing the title of an experiment to contain two titles. May be unused.

An indication of what element was changed by this change.

Used in: Change

• optional ChangedElement.ElementType type = 1

  The type of element changed.

• optional string id = 2

  The ExperimentID, LabelID or TrialID UUID of the edited element, or in the case of caption, the ID of the parent.

Used in: ChangedElement

• UNKNOWN = 0

  Default. Do not use.

• NOTE = 1

  A note or label.

• TRIAL = 2

  A trial. Not a note or label within a trial, just the trial itself.

• EXPERIMENT = 3

  The whole experiment. Used to indicate the Title.

• CAPTION = 4

  A caption. Id should refer to the parent element.

Used in: SensorData

• required Pin pin = 1

• oneof value

  • AnalogValue analog_value = 10

  • DigitalValue digital_value = 11

  • FloatValue float_value = 12

    virtual type

  • IntValue int_value = 13

    virtual type

  • StringValue string_value = 14

    virtual type

Data type of a scalar

• ANALOG = 1

• DIGITAL = 2

• FLOAT = 3

• INT = 4

• STRING = 5

Proto containing information about a device that hosts sensors. This may be (a) the host device itself (phone or tablet) with internal sensors (b) an Arduino running the Science Journal firmware (c) an external piece of hardware (like Vernier sensor) discovered by a third-party app implementing the scalar API. Devices that host sensors that have been connected to are remembered as "My Devices", which puts them in a special section of the Manage Sensors page to be easily found again later. Added in V2.

Used in: UserMetadata

• optional GadgetInfo info = 1

  Provider, address, hostid, etc.

• optional string name = 2

  Display name

Digital pin number refers to the numeric value in D2, D3... use this to request values from a digital pin on the Device.

Used in: Pin

• required int32 pin = 1

DigitalValue contains a stream of single-dimensional boolean values collected from an digital pin on the Device. We use bool to represent DigitalValues, although packed bytes would be a more efficient encoding.

Used in: Data

• required bool value = 1

(message has no fields)

Used in: SensorData

• required string error = 1

  Text description of error.

Experiment protobuf definition. Added in V2.

• optional int64 creationTimeMs = 1

  The timestamp that this experiment was created.

• optional string title = 2

  The user-entered title of this experiment.

• optional string description = 3

  The user-entered description of this experiment. This is deprecated in version 1.1, when old descriptions were turned into text notes.

• repeated SensorLayout sensorLayouts = 4

  SensorLayouts associated with this experiment. (That is, the sensors that are currently shown in cards)

• repeated Trial trials = 5

  Trials in this experiment.

• repeated Label labels = 6

  Labels in this experiment.

• repeated ExperimentSensor experimentSensors = 7

  Sensors included in or excluded from this experiment. (should use availableSensors instead; this field was never populated.)

• repeated SensorTrigger sensorTriggers = 8

  Sensor triggers associated with sensors in this experiment.

• optional int32 version = 9

  Deprecated, use fileVersion below

• optional int32 minorVersion = 10

  Deprecated, use fileVersion below

• repeated Experiment.SensorEntry availableSensors = 11

  Which sensors are currently shown as available in the sensor cards to be observed. If a host device is not able to observe sensors in availableSensors, perhaps because it loaded an experiment created from a different device, those sensors will be disabled in sensor cards.

• optional FileVersion fileVersion = 12

  Identifies the intended format version of this file, and the app that wrote it. See version.proto for details.

• optional int32 totalTrials = 13

  The total number of trials ever made in this experiment. This is used to create unique names for untitled trials, i.e. "Recording 1", "Recording 2", etc, so that no two recordings in one experiment ever use the same name. This differs from GoosciUserMetadata.ExperimentOverview.trialCount because it is monotonically increasing, whereas trialCount will decrease when trials are deleted.

• optional string imagePath = 14

  The path to an image to be used as the Experiment image in the experiment list. Should be relative to the experiment directory.

• repeated Change changes = 15

  The list of changes that have been made to the experiment over time.

Version 1.1: Added

Used in: Experiment

• optional string sensorId = 1

  The sensor ID associated with this within this experiment. This has no global uniqueness or parseable meaning outside this experiment

• optional SensorSpec spec = 2

  The spec of the sensor with this id.

The overall collection of Experiments known to the user. Next Tag: 3 LINT: LEGACY_NAMES

• repeated SyncExperiment syncExperiment = 1

• optional string folderId = 2

  The folder ID of the "Science Journal" folder.

Data about an experiment that is specific to a device. Some data, like title and imagePath, is duplicated here in order to make the Experiment List load faster: this way we don't need to parse every available experiment.

Used in: UserMetadata

• optional string experimentId = 1

  Our local lookup Id for this experiment.

• optional string title = 2

  The user-entered title of this experiment.

• optional string imagePath = 3

  The path to an image used for this experiment, if applicable.

• optional int64 lastUsedTimeMs = 4

  The time when this experiment was last used.

• optional int32 trialCount = 5

  The number of trials in this experiment.

• optional bool isArchived = 6

  Whether this experiment is archived.

• optional int32 colorIndex = 7

  Index into the Experiment Colors array. This allows the experiment to have a consistent color overlay if its imagePath is not yet set. See values/experiment_colors.xml.

Sensors included or excluded in an experiment. TODO: Work with saff to figure out if other information needs to be included, such as a name the user gives their device that represents the type of sensors.

Used in: Experiment

• optional string sensorId = 1

  The sensor ID

• optional bool included = 2

  Whether this sensor is included.

The sync status of a single experiment.

Used in: LocalSyncStatus

• optional string experimentId = 1

  The Experiment ID.

• optional bool dirty = 2

  Whether or not the experiment has any local changes.

• optional int64 lastSyncedVersion = 3

  The last synced version from Drive/

• optional bool serverArchived = 4

  The status we last saw on drive for whether or not the experiment is archived.

• optional bool downloaded = 5

  Whether or not the experiment is locally downloaded.

Represents the version of a file that is written and may someday be shared with another version of the app. Added in V2.

Used in: Experiment, UserMetadata

• optional int32 version = 1

  The version code of this proto. Devices may use this to understand what version of data they are working with, and to perform upgrades. A combination of the major and minor versions is used to understand what is available in this proto. Major version numbers represent large, non-backwards-compatable changes. See ExperimentCache#upgradeExperimentVersionIfNeeded for more on versions. Version 1.1: Initial version

• optional int32 minorVersion = 2

  The minor verion code for this proto. Devices may use this to understand what version of data they are working with, and to perform upgrades. A combination of the major and minor versions is used to understand what is available in this proto. Minor version numbers represent small, non-breaking changes. A device running an older version of Science Journal should be able to parse a proto with a newer minorVersion so long as the version is the same. However, that device should only *read* and not *write* older version protos because data would be lost in the write. This value should be odd in pre-release builds of Science Journal, and even for release versions, for further safety. See ExperimentCache#upgradeExperimentVersionIfNeeded for more on versions. Version 1.1: Initial version

• optional GadgetInfo.Platform platform = 3

  Which platform last wrote this file (Android or iOS)

• optional int32 platformVersion = 4

  This is a monotonically-increasing, platform-specific number. Ideally, it should not be needed to understand the semantics of files written by released builds of the app. However, in the event a bug is introduced that effects written files, this may help to identify the affected files.

FloatValue contains a stream of single-dimensional floating point values synthesized by the Firmware from data collected on the Device.

Used in: Data

• required float value = 1

Information about a device (which contains sensors) or sensor (which can give a data stream) that has been seen on this platform. Please see usage in context in sensor_spec.proto and device_spec.proto Added in V2

Used in: DeviceSpec, SensorSpec

• optional GadgetInfo.Platform platform = 1

  Platform on which this gadget was instantiated.

• optional string providerId = 2

  Identifies a SensorDiscoverer implementation. The result should be a key in the map returned by WhistlePunkApplication#getExternalSensorDiscoverers.

• optional string address = 3

  Opaque to Science Journal, but meaningful to each SensorDiscoverer. It should have a one-to-one relationship with connectable gadgets. That is, if two GadgetInfo have the same address, that means they refer to the same gadget, possibly with two different configurations. We assume that it’s not possible to observe two gadgets with the same address at the same time.

• optional string hostId = 4

  A meaningless GUID that identifies the host device that hosted this gadget last. This allows us to distinguish between gadgets that were seen on the user’s current host devices, and sensors that were seen on some other device.

• optional string hostDescription = 5

  A human-readable string that can be displayed to explain which host device hosted this gadget.

Used in: FileVersion, GadgetInfo

• ANDROID = 0

• IOS = 1

the path to an image that is used to represent a sensor

Used in: BasicSensorAppearance

• optional IconPath.PathType type = 1

• optional string path_string = 2

  The format and interpretation of this string depends on PathType

Used in: IconPath

• BUILTIN = 0

  The path string is the sensor id used by the Android implementation for the built-in sensor. Internal code should look up the appropriate icon and display it.

• LEGACY_ANDROID_BLE = 1

  Legacy type from Android. The path string is the string representation of an integer representing SensorTypeProvider#SensorKind TODO: replace with better system

• PROTO = 2

  Used to signify sensors whose appearances are loaded from the appearance proto. path_string will be empty for these sensors. TODO: populate path_string and load image from there.

• MKRSCI_ANDROID_BLE = 3

  Arduino MkrSci path type. The path string is sensor_id:handler_id.

• optional string provider_id = 1

  id of the provider that found this device (see SensorProvider#getProviderId)

• optional string device_address = 2

  provider-specific "address" identifying the device

IntValue contains a stream of single-dimensional integer values synthesized by the Firmware from data collected on the Device.

Used in: Data

• required int32 value = 1

How many times, and how frequently the Device should return values for this request. If count is greater than 1, then the Device should return values every frequency milliseconds until the count is exceeded.

Used in: SensorDataRequest

• required int32 count = 1

• optional int32 frequency = 2

Label protobuf definition Added in V2.

Used in: Experiment, Trial

• optional string labelId = 1

  The ID is unique within an experiment, but cannot be assumed to be unique across experiments, as users may "copy" entire experiments from Drive. This ID should probably be a unique GUID.

• optional int64 timestampMs = 2

  The time in ms since the epoch which represents this label in time. This may be the time at which the label was created, but some labels have editable timestamps.

• optional int64 creationTimeMs = 3

  The time that the label was created. This is not editable.

• optional Caption caption = 4

  An optional user-added caption. Not all labels will make use of this field. Currently text labels will not use this, but picture, trigger, and snapshot will.

• optional Label.ValueType type = 5

  The type this label represents. This can be used to reference the type of proto_data.

• optional bytes protoData = 6

  A proto can be written to this field to represent the label's data. See ValueType above for which proto will be used in protoData for each ValueType.

Used in: Label

• TEXT = 1

  A text label.

• PICTURE = 2

  This ValueType is associated with protoData field of text_label_value.proto.

  A label that has a picture and may also have a text

• SENSOR_TRIGGER = 3

  caption. This ValueType is associated with protoData of picture_label_value.proto.

  A label created from a sensor trigger.

• SNAPSHOT = 4

  This ValueType is associated with protoData field of sensor_trigger_label_value.proto.

  A label with value snapshot(s) for one or more sensors.

• SKETCH = 5

  This ValueType is associated with protoData of snapshot_label_value.proto.

  A label with a sketch. This ValueType is associated with

The contents of a label, able to represent many different types of data. This is deprecated in V2.

• map<string, string> data = 1

  Data can be used to store a diverse set of label values. Each label type should have its own set of keys into this map to store required information. For example, a text label might have a key for the text field, and the value would be the text itself. A captioned picture label might have a key/value pair for the caption, and another key/value pair for the URI of the picture. This storage flexibility enables future types of labels to store many different formats of information without the programmer knowing ahead of time which label types might exist. Other files, like images, can be referenced using this map and should be named by a unique GUID and placed in the assets directory within the experiment.

• optional LabelValue.ValueType type = 2

  The type this LabelValue represents.

TODO: document how data and proto_data are written and read for each type

Used in: LabelValue

• TEXT = 1

  A text label.

• PICTURE = 2

  A label that has a picture and may also have a text caption.

• SENSOR_TRIGGER = 3

  A label created from a sensor trigger.

• APPLICATION = 4

  A label created automatically by Science Journal.

The sync status of every locally known experiment.

• repeated ExperimentStatus experimentStatus = 1

• optional int64 lastSyncedLibraryVersion = 2

  The last version of the ExperimentLibrary that we have synced.

• optional string address = 1

• optional string sensor = 2

• optional string handler = 3

A value that can be stored in the proto_data field of label.proto, to store data about a picture. Added in V2.

• optional string filePath = 1

  The path to the picture file. This is relative to the experiments folder, for example: if the filePath is "assets/picture.jpg", and the experiment is stored in folder "experiment_17", this means the picture can be loaded from "experiment_17/assets/picture.jpg"

Pin of a specific type.

Used in: Data, SensorDataRequest

• oneof pin

  • AnalogPin analog_pin = 10

  • DigitalPin digital_pin = 11

  • VirtualPin virtual_pin = 12

A time range

Used in: Trial

• optional int64 startMs = 1

  The start of a range.

• optional int64 endMs = 2

  The end of a range.

• repeated ScalarSensorDataDump sensors = 1

Used in: ScalarSensorData

• optional string tag = 1

• repeated ScalarSensorDataRow rows = 2

• optional string trialId = 3

Used in: ScalarSensorDataDump

• optional int64 timestampMillis = 1

• optional double value = 2

• required uint32 timestamp_key = 1

• oneof result

  • Error error = 10

  • Data data = 11

Phone to Device request to initiate sensor data collection and reporting from multiple pins over an interval. The timestamp is used to synchronize the (inaccurate) clock on the device to the (accurate) clock on the phone.

• required uint32 timestamp_key = 1

• required Interval interval = 2

• repeated Pin pin = 3

Used in: Experiment, Trial

• optional string sensorId = 1

  id, to be looked up in either the Experiment.availableSensors or Trial.sensorAppearances field depending on the context.

• optional SensorLayout.CardView cardView = 2

• optional bool audioEnabled = 3

• optional bool showStatsOverlay = 4

• optional int32 color = 5

  Color, as a packed int as described in android.graphics.Color Default is 0 (transparent). We will interpret this as unset in code and replace with a more appropriate default.

• map<string, string> extras = 6

  Extra options for this card, which can be used by individual selected sensors. Keys in this map should begin with some fully-qualified package name that the adding code belongs to. For example, keys added by code written at google will begin with "com.google." This map will be made available as-is to SensorChoice implementations, which will interpret them as desired.

• optional double minimumYAxisValue = 7

  The minimum value shown on the Y axis.

• optional double maximumYAxisValue = 8

  The maximum value shown on the Y axis.

• repeated string activeSensorTriggerIds = 9

  The IDs of active SensorTriggers for this layout.

• optional int32 colorIndex = 10

  The index into the sensor card color array. See values/graph_colors.xml.

Used in: SensorLayout

• METER = 1

  For scalar sensors: show an icon and current reading as a

• GRAPH = 2

  large number For all cards: show a description of what's going on with this sensor, with affordance for "more info"

  For scalar sensors: show an evolving line graph of the value

Specification of an observable sensor. Added in V2

Used in: Experiment.SensorEntry, SensorTriggerLabelValue, SnapshotLabelValue.SensorSnapshot

• optional GadgetInfo info = 1

  Provider, address, hostid, etc.

• optional bytes config = 2

  Opaque to Science Journal, but meaningful to each SensorDiscoverer. Each SensorDiscoverer can place whatever proto it wants here that contains all the information it needs, beyond the address, to connect to, configure, and relay data from a particular sensor in a particular configuration.

• optional BasicSensorAppearance rememberedAppearance = 3

  contains all of the data necessary to display a sensor as part of a trial

Represents a single stat, i.e. average = 42 or num_data_points = 17.

Used in: SensorTrialStats

• optional SensorStat.StatType statType = 1

  The stat type

• optional double statValue = 2

  The value of the stat.

Used in: SensorStat

• MINIMUM = 1

  The minimum value.

• MAXIMUM = 2

  The maximum value.

• AVERAGE = 3

  The average value.

• NUM_DATA_POINTS = 4

  The count of data points.

• TOTAL_DURATION = 5

  The total duration over which the stats are calculated.

• ZOOM_PRESENTER_TIER_COUNT = 6

  The number of zoom presenter tiers.

• ZOOM_PRESENTER_ZOOM_LEVEL_BETWEEN_TIERS = 7

  The zoom level between tiers.

Trial stats for a single sensor. Each sensor may have multiple individual stats.

Used in: Trial

• optional string sensorId = 1

  The sensor ID associated with this stat (to be looked up in sensorAppearances)

• optional SensorTrialStats.StatStatus statStatus = 2

• repeated SensorStat sensorStats = 3

Used in: SensorTrialStats

• VALID = 1

  The stats are updated and valid.

• NEEDS_UPDATE = 2

  The stats need an update and are not currently valid.

Represents a sensor trigger. Added in V2.

Used in: Experiment

• optional string sensorId = 1

  The sensor ID associated with this trigger. This is not mutable.

• optional int64 lastUsedMs = 2

  The timestamp of when this trigger was last used. This is updated with any setters to the trigger, but it is the responsibility of the client to update the database.

• optional TriggerInformation triggerInformation = 3

  The Trigger Information describing this trigger.

• optional string triggerId = 4

  The unique ID of this trigger.

A value that can be stored in the proto_data field of label.proto, to store a sensor trigger label's data. Added in V2.

• optional SensorSpec sensor = 1

  The sensor that recorded the trigger.

• optional TriggerInformation triggerInformation = 2

  This represents the sensor trigger which fired to produce this note. This can be used to populate note text or do other work.

A value that can be stored in the proto_data field of label.proto, to store a set of sketched values.

• optional bytes sketch = 1

  The snapshot of a sketch.

A value that can be stored in the proto_data field of label.proto, to store a set of snapshotted values from one or more sensors. Added in V2.

• repeated SnapshotLabelValue.SensorSnapshot snapshots = 1

  All of the snapshots

Used in: SnapshotLabelValue

• optional SensorSpec sensor = 1

  The sensor that recorded the value

• optional int64 timestampMs = 2

  The time in ms since the epoch at which this datapoint was recorded. This may not match the timestamp at which the snapshot button was pressed, because the data point grabbed may be slightly before or after

• optional double value = 3

  The sensor value recorded

StringValue contains a stream of single-dimensional string values synthesized by the Firmware from data collected on the Device.

Used in: Data

• required string value = 1

A single experiment to be synced to Drive. Next Tag: 7

Used in: ExperimentLibrary

• optional string fileId = 1

  The Drive fileId.

• optional string experimentId = 2

  The experimentId from the experiment.

• optional int64 lastOpened = 3

  The timestamp of the last time the experiment was opened.

• optional int64 lastModified = 4

  The timestamp of the last time the experiment was modified.

• optional bool deleted = 5

  Whether the experiment has been deleted.

• optional bool archived = 6

  Whether the experiment has been archived.

The Drive folder that is used to store synced data

• optional string folder_id = 1

  The folder id.

A value that can be stored in the proto_data field of label.proto, to store a set of snapshotted values from one or more sensors. Added in V2.

• optional string text = 1

  The user's text.

Trial protobuf definition Added in V2.

Used in: Experiment

• optional string trialId = 1

  The ID is unique within an experiment, but cannot be assumed to be unique across experiments. This is also used to reference the file containing trial data, which is stored separately, as users may "copy" entire experiments from Drive. This ID should probably be a unique GUID.

• optional int64 creationTimeMs = 2

  The timestamp that this trial was created.

• optional string title = 3

  The user-entered title of this trial.

• optional bool archived = 4

  Whether the experiment is currently archived.

• optional Range recordingRange = 5

  The range of the original recording.

• optional Range cropRange = 6

  The range of the cropped recording, if this trial is cropped.

• optional bool autoZoomEnabled = 7

  Whether auto-zoom is enabled.

• repeated SensorLayout sensorLayouts = 8

  SensorLayouts associated with this trial.

• repeated SensorTrialStats trialStats = 9

  Stats associated with this trial.

• repeated Label labels = 10

  Labels that are part of this trial.

• optional Caption caption = 11

  An optional user-added caption.

• repeated Trial.AppearanceEntry sensorAppearances = 12

  Which sensors are shown, and how to show them.

• optional int32 trialNumberInExperiment = 13

  The order of this trial within the experiment, compared to all the trials ever made in this experiment. This is used to generate a name for the trial if no name is set by the user, i.e. "Recording 1", "Recording 2", etc. No two trials within an experiment should have the same index. Starts at 1 (different from an index, which starts at 0!)

Version 1.2: Added

Used in: Trial

• optional string sensorId = 1

  The sensor ID associated with this within this experiment. This has no global uniqueness or parseable meaning outside this experiment

• optional BasicSensorAppearance rememberedAppearance = 2

  The appearance of the sensor with this id. contains all of the data necessary to display a sensor as part of this trial

TriggerInformation contains metadata users can set and edit on a particular trigger.

Used in: SensorTrigger, SensorTriggerLabelValue

• optional double valueToTrigger = 3

  The value at which this trigger fires.

• optional TriggerInformation.TriggerWhen triggerWhen = 4

• optional TriggerInformation.TriggerActionType triggerActionType = 5

• repeated TriggerInformation.TriggerAlertType triggerAlertTypes = 6

• optional string noteText = 7

  The text for a note, if this is a TRIGGER_ACTION_NOTE.

• optional bool triggerOnlyWhenRecording = 8

  Whether the trigger should activate only when recording (or all the time)

What type of action should be taken when the trigger fires?

Used in: TriggerInformation

• TRIGGER_ACTION_START_RECORDING = 0

• TRIGGER_ACTION_STOP_RECORDING = 1

• TRIGGER_ACTION_NOTE = 2

• TRIGGER_ACTION_ALERT = 3

The type of alert to use when the trigger fires, if this is an TRIGGER_ACTION_ALERT type.

Used in: TriggerInformation

• TRIGGER_ALERT_VISUAL = 1

• TRIGGER_ALERT_AUDIO = 2

• TRIGGER_ALERT_PHYSICAL = 3

What data pattern causes the trigger to fire?

Used in: TriggerInformation

• TRIGGER_WHEN_AT = 0

• TRIGGER_WHEN_RISES_ABOVE = 1

• TRIGGER_WHEN_DROPS_BELOW = 2

• TRIGGER_WHEN_ABOVE = 3

• TRIGGER_WHEN_BELOW = 4

Represents metadata shared across the whole Science Journal app for one user. Added in V2.

• repeated ExperimentOverview experiments = 1

  Experiment state that is per-user, such as whether the experiment is archived.

• optional int32 version = 2

  Deprecated, use fileVersion below

• optional int32 minorVersion = 3

  Deprecated, use fileVersion below

• repeated DeviceSpec myDevices = 4

  "My Devices" are added to when a user connects to an external sensor, and are shown in a special section of the Manage Sensors screen. See device_spec.proto for details.

• optional FileVersion fileVersion = 5

  Identifies the intended format version of this file, and the app that wrote it. See version.proto for details.

(message has no fields)

See https://docs.google.com/document/d/10SgMM-_myVyfZQZ_afLipPv_x4aq4gQG2FTrY3oktXM/edit# for version policy and implementation details. Encode new versions using https://goosci.googlesource.com/android/+/master/proto/version_codec.py

• V_1_0_0 = 2048

• LATEST = 2048

Virtual pin refers to a non-physical pin capability on the Device, such as a Gooball orientation sensor that returns vectors of floats.

Used in: Pin

• required int32 pin = 1