get_alarm
ChatGPTRead live ThingsBoard lifecycle state for one alarm in one Plant, from the same source as the GUI alarm page. Times are epoch milliseconds. A read does not acknowledge or clear the alarm. Use for: alarm details and lifecycle times. Not for: work orders - this connector cannot read them. Next: query_device_telemetry for the device curve at the alarm time. Read-only.
get_plant_chart
ChatGPTRead a Plant chart for one Plant-local day, live and today data, at 1 to 60 minutes. Use for: a one-day power, yield, or performance chart. Not for: stored numbers across days - use query_plant_5min. Next: query_device_telemetry. Read-only.
get_plant_daily_performance
ChatGPTRead stored daily yield, PR, availability, and irradiation for one Plant, up to 366 days; can lag. A plain-date end (YYYY-MM-DD) includes that whole day. With offset timestamps, start is inclusive and end is exclusive. Use for: low PR and daily performance. Not for: other stored daily values - use query_plant_daily. Next: get_string_daily_analytics. Read-only.
get_plant_dashboard
ChatGPTRead live and today status for one Plant and its devices. Use for: production KPIs, offline devices, and disconnected strings. Not for: past daily performance - use get_plant_daily_performance. Next: list_devices. Read-only.
get_plant_overview
ChatGPTRead current identity and timezone for one accessible Plant. Use for: Plant scope and local dates. Not for: live status - use get_plant_dashboard. Next: get_plant_daily_performance. Read-only.
get_portfolio_dashboard
ChatGPTRead live and today screens across accessible Plants, with 7-day yield and bounded alarm status. Pass plantIds to narrow it. Use for: Plants with problems today. Not for: one Plant over past days - use get_plant_daily_performance. Next: get_plant_dashboard. Read-only.
get_profile
ChatGPTReturn the email address for the SolarSENS account selected for this connection. Use to confirm which account is connected. Does not select or switch accounts. Read-only.
get_string_daily_analytics
ChatGPTRead stored daily string analytics for one Plant, latest processed day or one past Plant-local date; can lag. Call a string weak only with the peer value it was compared with; state that value. Use for: weak strings and peer ranks. Not for: current and voltage curves - use query_string_5min. Next: query_string_5min. Read-only.
list_accessible_plants
ChatGPTRead the current Plant catalog for the signed-in account, all accessible Plants. Use only returned Plant IDs; never guess account scope from letters, digits, keywords, or IDs. Use for: account scope. Not for: a named Plant - use search_plants. Next: get_portfolio_dashboard. Read-only.
list_alarms
ChatGPTRead live ThingsBoard alarm state for one Plant, the same list as the GUI alarm page. Ten events per page; page 0 is the first page. Start inclusive and end exclusive on creation time, with UTC offsets. Use for: active alarms and alarm history. Not for: work orders - this connector cannot read them. Next: get_alarm for one alarm, then query_device_telemetry for the device curve at the alarm time. Read-only.
list_devices
ChatGPTRead the current device catalog for one Plant, all devices or one type. Use for: IDs, parents, types, and unclear names with nameQuery. nameQuery matches name or label; letter case and separators are ignored. If no device matches, call again without nameQuery to find similar names or labels. If no device or more than one device matches, stop. Show name, label, and type, and ask which device. Do not read data for all matches. Not for: offline status - use get_plant_dashboard. Next: query_device_telemetry. Read-only.
query_device_telemetry
ChatGPTRead telemetry for one device and one Plant-local day, today or a past day, at 1 to 60 minutes. Metric keys are device telemetry names, for example Active Power. An empty series can mean a wrong key, not missing data. Get the device ID from list_devices. Use for: device values at a time of day. Not for: string values across days - use query_string_5min. Next: get_plant_dashboard. Read-only.
query_inverter_daily
ChatGPTRead stored inverter daily values as reported; can lag. Up to 366 days, 1,000 rows. inverterIds optional. A plain-date end (YYYY-MM-DD) includes that whole day. With offset timestamps, start is inclusive and end is exclusive. Use for: yield, availability, and losses across inverters. Not for: a live device curve today - use query_device_telemetry. Next: query_string_5min. Read-only.
query_plant_5min
ChatGPTRead stored five-minute Plant values; can lag. Up to 31 days, but 1,000 rows allow about 3 days for one metric or 1 day for 3 metrics. start inclusive, end exclusive, with offsets. Use for: numbers across days. Not for: a one-day chart - use get_plant_chart. Next: query_inverter_daily. Read-only.
query_plant_daily
ChatGPTRead stored daily Plant values, up to 366 days and 1,000 rows; can lag. start inclusive, end exclusive, with offsets. Use for: curtailment, soiling, revenue, and monthly values. Not for: yield, PR, availability, irradiation - use get_plant_daily_performance. Next: query_inverter_daily. Read-only.
query_string_5min
ChatGPTRead stored string Idc and Udc at 5 to 60 minutes; can lag. Up to 7 days, 1,000 rows; inverterIds optional. Data is kept for about the last 72 days only. For an older date, do not call; tell the user stored five-minute string data is not kept for that date. A plain-date end (YYYY-MM-DD) includes that whole day. With offset timestamps, start is inclusive and end is exclusive. Use for: current and voltage across days. Not for: a live curve today - use query_device_telemetry. Next: get_plant_dashboard. Read-only.
search_plants
ChatGPTRead the current Plant catalog by name or code, accessible matches only. Call once with the user's name or code. If one result name equals the user's Plant name (any letter case), use it without asking. If the user gives only the end of a code, such as P043 (a full code is NORTH-P043), search the digits, such as 043; if several codes match, show all and ask. Use for: a named Plant. Not for: all Plants - use list_accessible_plants. Next: get_plant_overview. Read-only.