单OpenApi账号调用接口的每分钟请求数最大限制：50
本功能默认不开启，需与责任商务沟通开通
请务必使用设备商身份获取Token，仅设备商Token有权限使用本接口
当前阶段仅支持子设备（如逆变器）的DeviceID维度下发指令，暂不支持设备的SN维度，不支持采集器维度
DeviceID请通过设备列表接口获取

支持的指令

附录

CRC32算法

/*******************************************************************************
*Function Name: Get_Inverter_Version_CRC32
*Description:
*Input: start：
*Output:
*Returns: 
*******************************************************************************/
cyg_uint32 Get_Inverter_Version_CRC32(cyg_uint32 start_address, cyg_uint32 file_len)
{
    //U8 loop = 0;
    cyg_uint16 index = 0;
    cyg_uint32 temp = 0;
    cyg_uint32 loop_i = 0;
    cyg_uint32 loop_j = 0;
    cyg_uint32 h_CRC = 0;
    cyg_uint32 flash_startAddr = 0;
    yz_up_mid_buf = hfmem_malloc(1024);
    if( yz_up_mid_buf == NULL )
    {
        return 0;
    }
    memset(yz_up_mid_buf, 0, 1024);
    flash_startAddr = start_address;
    for(loop_i = 0, h_CRC = 0xFFFFFFFF, loop_j = 0; loop_i < file_len; loop_i++, loop_j++)
    {
        if(loop_j == 1024)
        {
            loop_j = 0;
            memset((char*)yz_up_mid_buf, 0, 1024);
            yz_flash_read(flash_startAddr, (unsigned char *)yz_up_mid_buf, 1024);
            for(index = 0; index < 256; index++)
            {
                temp = yz_up_mid_buf[index * 4];
                temp = (temp << 8) & 0xff00;
                temp += yz_up_mid_buf[index * 4 + 1];
                temp = (temp << 8) & 0xffff00;
                temp += yz_up_mid_buf[index * 4 + 2];
                temp = (temp << 8) & 0xffffff00;
                temp += yz_up_mid_buf[index * 4 + 3];
                h_CRC = CRC32(h_CRC, (cyg_uint32 *)&temp, 1);
            }
            flash_startAddr += 1024;
        }
    }
    if(loop_j)
    {
        memset(yz_up_mid_buf, 0, 1024);
        yz_flash_read(flash_startAddr, (unsigned char *)yz_up_mid_buf, loop_j);
        for(index = 0; index < (loop_j / 4); index++)
        {
            temp = yz_up_mid_buf[index * 4];
            temp = (temp << 8) & 0xff00;
            temp += yz_up_mid_buf[index * 4 + 1];
            temp = (temp << 8) & 0xffff00;
            temp += yz_up_mid_buf[index * 4 + 2];
            temp = (temp << 8) & 0xffffff00;
            temp += yz_up_mid_buf[index * 4 + 3];
            h_CRC = CRC32(h_CRC, (cyg_uint32 *)&temp, 1);
        }
        loop_i = loop_j % 4;
        if(loop_i != 0)
        {
            if(loop_i == 1)
            {
                temp = yz_up_mid_buf[index * 4];
            }
            else if(loop_i == 2)
            {
                temp = yz_up_mid_buf[index * 4];
                temp = (temp << 8) & 0xff00;
                temp += yz_up_mid_buf[index * 4 + 1];
            }
            else if(loop_i == 3)
            {
                temp = yz_up_mid_buf[index * 4];
                temp = (temp << 8) & 0xff00;
                temp += yz_up_mid_buf[index * 4 + 1];
                temp = (temp << 8) & 0xffff00;
                temp += yz_up_mid_buf[index * 4 + 2];
            }
            h_CRC = CRC32(h_CRC, (cyg_uint32 *)&temp, 1);
        }
    }
    hfmem_free(yz_up_mid_buf);
    return h_CRC;
}
/*******************************************************************************
*Function Name: CRC32
*Description:
*Input:
*Output:
*Returns:
*******************************************************************************/
cyg_uint32 CRC32(cyg_uint32 uCurCRC, cyg_uint32 * pcData, cyg_uint32 dwSize)
{
    cyg_uint32 bits;
    cyg_uint32 xbit;
    cyg_uint32 data;
    cyg_uint32 uCRC = 0;
    uCRC = uCurCRC;
    while (dwSize--)
    {
        xbit = ((cyg_uint32)1 << 31);
        data = *pcData++;
        for (bits = 0; bits < 32; bits++)
        {
            if (uCRC & 0x80000000)
            {
                uCRC <<= 1;
                uCRC ^= 0x04c11db7;
            }
            else
                uCRC <<= 1;
            if (data & xbit)
                uCRC ^= 0x04c11db7;
            xbit >>= 1;
        }
    }
    return uCRC;
}

CURL示例

## 3.10 采集器指令
curl -X "POST" "https://api.solarmanpv.com/device/v1.0/upgrade?language=zh" \
     -H 'Authorization: bearer eyJhbGxxxxxxxxxxxxxxxxxxxLm10000uxxxxxxxxxxxLm100uxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxuxxxxxxxxxxxLm100uxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxxxxxxLm100uxxxxxxxLm100uSChpu1eLPQ' \
     -H 'Content-Type: application/json' \
     -d $'{
  "deviceId": "1234567890",
  "content": "AT+INVUPURL=http://fw.net.com/f/abc.bin",
  "timeoutSeconds": "600",
  "callBackUrl": "http://call.back.com:3000/solarman/api/callback/Success"
}'

JAVA示例

import java.io.IOException;
import org.apache.http.client.fluent.*;
import org.apache.http.entity.ContentType;
public class SendRequest
{
  public static void main(String[] args) {
    sendRequest();
  }
  private static void sendRequest() {
    // 3.10 采集器指令 (POST )
    try {
      // Create request
      Content content = Request.Post("https://api.solarmanpv.com/device/v1.0/upgrade?language=zh")
      // Add headers
      .addHeader("Authorization", "bearer eyJhbGxxxxxxxxxxxxxxxxxxxLm10000uxxxxxxxxxxxLm100uxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxuxxxxxxxxxxxLm100uxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxLm100uxxxxxxxxxxxxxxxxLm100uxxxxxxxLm100uSChpu1eLPQ")
      .addHeader("Content-Type", "application/json")
      // Add body
      .bodyString("{\"deviceId\": \"1234567890\",\"content\": \"AT+INVUPURL=http://fw.net.com/f/abc.bin\",\"timeoutSeconds\": \"600\",\"callBackUrl\": \"http://call.back.com:3000/solarman/api/callback/Success\"}", ContentType.APPLICATION_JSON)
      // Fetch request and return content
      .execute().returnContent();
      // Print content
      System.out.println(content);
    }
    catch (IOException e) { System.out.println(e); }
  }
}