Using the dashboard, you are able to select a subset of batteries and launch an OTA update with a single click.

To set your password, simply type your email address in the login screen (once your account has been created), and click the “Forgot password” link. An email will be sent with a password reset link (check your spam folder).

Using the app (or webapp with modern browsers) you can connect to your battery using Bluetooth.

This allows you to view the current battery state (cell voltages, global voltage, state of charge, temperatures, etc).

Simply click on the “Bluetooth” icon at the top, and allow Bluetooth permissions. A “scanning” screen will be shown with detected devices.

By clicking on one of the devices, you can connect to it and see its information.

• It’s unique ID in the tab title (”G997”),

• a manually set (and editable) “id tag” which allows you to give a more meaningful name (”POBO1-72-6” in this case),

• a “location tag” which allows you to provide optional location data on the battery (for instance if it’s on a bike, or in a warehouse). This location tag can be automatically set by our backend if you provide us with location data,

• a status, which can be one of “operating”, “alert”, “in_maintenance”, “out_of_order” or “discarded”,

• a firmware, which can be updated (by clicking on the edit button)

• its client id, allowing only the corresponding client to access its data,

• and an optional description, which can be convenient to set in some situations when observing or repairing the battery, in addition to notes (in the “Notes” tab)

shell
curl -H "Authorization: Bearer <YOUR_TOKEN>" \
     "https://api.gouach.com/v1/clients/batteries/report"

json
{
	"success": true,
	"data": {
		"count": number_of_items,
		"pages": total_number_of_pages,
		"startAfterId": id_of_next_battery,
		"pageItems": [...list of items in the current page]
	}
}

typescript
{
        id: "G137",
        id_tag: "Some id tag",
        status: "operating",
        created_at: /*battery creation timestamp*/,
        last_known_location: {...},
        last_communication_at: /*last communication timestamp*/,
        last_state_timestamp: /* last known state timestamp */,
        last_state: {
              battery_current: ...,
              battery_voltage: ...,
              battery_output_voltage: ...,
              cell_balancing_times: [..., ],
              cell_voltages: [..., ],
              errors: [..., ],
              fsm_state: ...,
              state_of_charge: ...,
              min_temp_cells: ...,
              max_temp_cells: ...,
              min_temp_bms: ...,
              max_temp_bms: ...,
              temperatures: {
                cells_back: ...,
                cells_front: ...,
                bms_ic: ...,
                bms_mosfet: ...,
                bms_shunt: ...,
              },
            },
        bms_id: "...",
      };
    });

typescript
export interface ClientAlert {
  version: number;
  battery_id: string;
  created_at: number;
  source: string;
  triggers: AlertTrigger[];
  description: string; // description message
  metadata: {
    gouach_battery_model: string;
    id_tag: string; // empty when unknown
    state_of_charge: number; // -1 when unknown
    fsm_state: string; // empty when unknown
    latest_state_update_timestamp: number;
    last_known_location: BatteryLastKnownLocation;
  };
}

• there is a significant charge current and the cell temperatures are strictly less than 0°C

• there is a significant charge current and the cell temperatures are strictly above 43°C

• at any time, if the cell temperatures are strictly above 60°C

• at any time, if cells or BMS temperatures are strictly below -20°C

• at any time, if there is a difference of temperature between cells strictly above 10°C

• at any time, if the BMS temperature is strictly above 75°C

• INIT: initialization

• IDLE: idle state

• DISCHARGE: battery used, in discharge

• CHARGE: battery is in charge

• ERROR: a major error state

• SHUTDOWN: battery is shutting down

• SCD: short-circuit

• OCD: over-current in discharge

• OCC: over-current in charge

• UV: cell under-voltage

• OV: cell over-voltage

• IUT: internal under-temperature

• IOT: internal over-temperature

• COTC: cells over-temperature in charge

• CUTC: cells under-temperature in charge

• COTD: cells over-temperature in discharge

• CUTD: cells under-temperature in discharge

• FOT: fet over-temperature

• BQ_PF: BQ permanent failure

• ENVIF: environment initialization failure

• ICIF: battery IC initialization failure

• SCDL: short-circuit in discharge latched

• SUV: safety under-voltage

• CUDEP: copper deposit