Firebase Configuration

Description and configuration for Google Firebase Database used for the medical dispenser.

Structure and Data

This database stores a simple JSON object, and can update fields within the JSON object.

The data is structured as follows:

{
  "patients" : [
    "3981820312" : {
      "alert" : false,
      "dosage" : 4,
      "dosesPerDay" : 3,
      "name" : Jeffrey Leung",
      "nextDispense" : 1474216825.1630926,
      "remainingDosage" : 5,
      "totalDosage" : 12
    }
  ]
}

The arbitrary number represents the patient number which uniquely identifies each patient.

Integration

The Dashboard contacts the Firebase server to store the newest scheduling and dosage data.

The Dispenser retrieves a push notification from the Firebase server and retrieves scheduling and dosage data when it has been updated.

Setup

Navigate to the Google Firebase console. Create a new account if you don't have one already.

Click Create New Project, fill in the form, and click Create project.

Once you have your project set up, select Database.

Click on the 3-dot button on the right, choose Import JSON, and import the file base_import.json.

Data

Information is stored at https://{firebaseProjectName}.firebaseio.com. For our project, we use https://lumohacks-med-disp.firebaseio.com.

Patients' data is located at the /patients/{patientId} URL mapping.

To retrieve or update data from the Firebase server, use the REST APIs in the following sections. Text, not JSON, is sent and received.

Retrieval

Alert Status

Request:

GET /patients/{patientId}/alert.json

Response:

200 OK
true

Dosage

Request:

GET /patients/{patientId}/dosage.json

Response:

200 OK
4

Updating

Alert Status

Request:

PUT /patients/{patientId}/alert.json
true

Response:

200 OK
true

Dosage

Request:

GET /patients/{patientId}/dosage.json

Response:

200 OK
4