跳到主要内容
版本:Next

3.1.14:云平台部署

创芯工坊(ICWorkshop)是面向芯片程序交付的在线平台。PowerWriter® 客户端内置了"快速发布"入口,可以把当前工程、编程模式、芯片别名、附件和订单描述一次性发布到创芯工坊,由指定的接收账户完成远程烧录或离线烧录。与早期在浏览器后台逐项填写表单的方式相比,客户端发布会自动带入当前工程、芯片型号和烧录器信息,减少重复填写和手工选错芯片的可能。

本章节按实际客户端界面,从账号准备、工程准备、发布页各功能项到发布结果逐项说明。界面文案以当前版本为准,后续版本可能微调。

适用对象
  • 已经或准备成为创芯工坊开发者,需要把自己的量产工程交付给生产方、客户或自己的其他设备。
  • 使用 PowerWriter 客户端完成烧录参数配置,希望直接以当前工程发布订单的用户。

图 1:PowerWriter 主界面右侧的快速发布入口

1 整体流程​

客户端发布订单分为四步:

  1. 账号准备:注册创芯工坊账号,并开通开发者(工作室)身份。
  2. 工程准备:在 PowerWriter 中连接烧录器、选择芯片、加载固件并设置好烧录参数,保存为 .pkg 工程。
  3. 打开快速发布:点击主界面右侧的悬浮胶囊,展开抽屉后点击"开始发布"。
  4. 填写并发布:在发布页确认订单名称、价格、接收账户、编程模式等信息,点击"发布"。

发布成功后,接收账户可以在创芯工坊的订单中看到本次发布的工程,并按订单允许的方式烧录芯片。

2 账号准备​

2.1 注册创芯工坊账号​

打开 创芯工坊注册页,页面右侧提供"手机注册"和"邮箱注册"两种方式,流程一致:

图 2:创芯工坊注册页

  • 手机注册:选择国家/地区代码,填写手机号,获取并填写短信验证码,勾选服务条款后点击"立即注册"。
  • 邮箱注册:切换到"邮箱注册"页签,填写邮箱并获取邮箱验证码完成注册。

注册完成后使用同一账号登录创芯工坊网站:

图 3:创芯工坊网页登录页

网页端支持账号密码、微信和验证码三种登录方式。客户端登录使用账号密码或短信验证码,见 2.3 登录客户端。

2.2 开通开发者身份​

只有开通开发者身份的账号才能发布程序。按创芯工坊帮助中心的说明,需要完成"工作室设置"和"收款账号绑定"两步:

图 4:成为开发者(帮助中心)

操作路径为:登录后点击"我是开发者" → "工作室管理" → "工作室设置",填写工作室名称、介绍、地址等信息;再完成收款账号绑定。完整的图文步骤请参考帮助中心原文:

如果只做赠送样品、不涉及收款,也建议先完成开发者身份,否则发布入口可能不可用。

2.3 登录 PowerWriter 客户端​

在主界面点击右侧悬浮胶囊并选择"开始发布"后,如果尚未登录,客户端会弹出"登录创芯工坊"窗口。窗口有三种状态:

已保存账号——上次登录成功且会话仍有效时,直接显示账号名和"快速发布"按钮:

图 5:已保存账号的登录窗口

点击"快速发布"即可进入发布页;点击"切换账号"可以更换其他账号。

账号密码登录——切换账号后默认显示:

图 6:账号密码登录

  • 账号输入框支持用户名、邮箱或手机号。
  • 密码输入框右侧的眼睛图标可以切换明文显示。
  • 点击"登录"完成登录;"注册账号"和"忘记密码?"会打开创芯工坊对应网页。

验证码登录——切换到"验证码登录"页签:

图 7:短信验证码登录

填写手机号后点击"发送验证码",收到短信后填写验证码并点击"登录"。发送验证码期间按钮会进入倒计时状态,避免重复发送。

登录成功后,客户端会记住本次会话。下次打开时若会话未过期,会直接进入"已保存账号"状态。

3 准备待发布的工程​

发布的是"当前工程",而不是单独选择的一个固件文件。发布前请在主界面完成以下准备:

  1. 连接烧录器:在"烧录器设置"中选择并连接设备型号(例如 PW200)。
  2. 选择芯片:在"芯片设置"中选择目标芯片,确认 Flash 大小、擦除方式、接口电平、编程速度等参数。
  3. 加载固件:通过"打开"加载固件文件,或通过"加载工程"打开已有 .pkg。
  4. 配置烧录功能:按需设置序列号、选项字节、校验、读回等选项。
  5. 保存工程:点击"保存",把当前配置保存为 .pkg 工程文件,并设置工程密码。

图 8:主界面工程与芯片状态

关于 .pkg 工程的组成和保存方法,见 如何生成 PKG 文件。

发布对工程的要求
  • 发布使用当前工程中的固件、芯片型号和烧录参数。发布页不再单独填写固件和烧录参数。
  • 服务端烧录参数中的固件密码要求为 8~16 位可见 ASCII 字符。当前工程密码不符合要求时,客户端会提示保存为合规密码,或使用当前配置生成临时工程发布。
  • 当前工程尚未保存为 .pkg 时,发布流程会提示"保存工程"或"使用临时工程"。临时工程使用随机密码,发布结束后自动删除,不会修改原工程。
  • 工程按某个烧录器型号保存时,发布前请确认当前连接的烧录器与工程一致,避免服务端参数与本地配置不符。

4 打开快速发布​

4.1 悬浮胶囊​

主界面右侧垂直居中位置有一个半嵌在外框上的胶囊形入口,鼠标移入会提示"快速发布到云平台":

图 9:主界面右侧的快速发布胶囊

胶囊位于客户区外边缘,属于主窗口的附属弹窗,不会占用主界面布局;主窗口最小化时胶囊自动隐藏。

4.2 展开抽屉​

点击胶囊,向右展开"快速发布到云平台"抽屉:

图 10:展开后的快速发布抽屉

抽屉中显示:

  • 账户:当前登录的创芯工坊账号。
  • 云端:发布目标环境(创芯工坊)。
  • 说明:发布前会检查工程、网络和账户状态。
  • 开始发布:进入发布流程。

点击"开始发布"后,客户端依次检查工程、网络和登录状态:

  • 未登录:弹出登录窗口。
  • 工程未保存或密码不合规:提示保存工程或使用临时工程。
  • 网络不可达:提示检查网络后重试。

检查通过后打开"PowerWriter 快速发布"窗口。

4.3 发布期间的限制​

发布流程进行中:

  • 主窗口会被禁用,避免在发布过程中修改工程或芯片配置。
  • 快速发布抽屉同步收起并禁用。
  • 发布页不能最小化;点击关闭按钮会提示"发布进行中,暂时不能关闭窗口"。
  • 主窗口在发布流程结束前不能关闭。

5 发布页总览​

发布页顶部是当前环境信息条,下方依次为"基础设置""编程模式""更多设置"和底部的"发布"按钮:

图 11:发布页总览(脱机编程模式)

顶部信息条从左到右显示:

项目说明
芯片当前工程的芯片系列与型号,例如 STM32 / STM32F0 / STM32F071xB
烧录器当前连接的烧录器型号,例如 PW200
工程当前工程名称,用于生成默认订单名称
账号当前登录的创芯工坊账号

发布页的所有内容都在一个可滚动页面内。展开"更多设置"或切换编程模式后,窗口高度会随内容增加。

6 基础设置​

6.1 订单名称​

订单名称是接收方在订单列表中看到的标题。默认值由"工程名-芯片型号"组成,例如工程名为 123、芯片为 STM32F071xB 时,默认名称为 123-STM32F071xB。

填写规则:

  • 长度 2~60 个字符。
  • 不能包含非法字符(输入框会拦截并在下方显示红色提示)。
  • 默认名称超过 60 个字符时,会退化为仅使用工程名;工程名仍超长时使用"PowerWriter 生产项目"。

建议在名称中体现项目、客户或批次,便于接收方区分多个订单。

6.2 订单单价与免费赠送​

订单单价表示接收方每烧录一次需要支付的金额,单位为"元 / 次":

  • 取值范围 0.0001~10000,最多 4 位小数。
  • 输入 nan、科学计数法、多余空格或结尾小数点会被拒绝。
  • 勾选"免费赠送"后,单价输入框被禁用,订单按赠送处理。

勾选"免费赠送"时:

  • 不需要填写单价。
  • "允许转售"选项会隐藏并自动取消勾选。
  • 订单数量表示赠送给接收方的可烧录次数。

6.3 订单数量​

订单数量是本次订单允许烧录的总次数:

  • 取值范围 1~1000000。
  • 付费订单表示接收方最多可购买/烧录的次数。
  • 赠送订单表示直接赠送到接收方账户的可烧录次数。
与工程内限制次数的关系

如果 .pkg 工程在保存时设置了限制烧写次数,该限制只在离线烧录时生效;发布到平台后,订单的可烧录次数以发布页填写的"订单数量"为准。

6.4 允许转售​

勾选"允许用户将订单转售(赠)给其他账号"后,接收方可以把订单转售或转赠给其他账号。免费赠送的订单不显示该选项。

转售的完整规则(价格拆分、上级订单、下架联动等)由创芯工坊平台定义,详见 程序转售规则:

图 12:程序转售规则(帮助中心)

6.5 订单接收账户​

"订单接收账户"决定谁能看到并烧录本次发布的工程。点击"选择账户"打开联系人对话框:

图 13:选择联系人对话框

对话框说明:

  • 搜索框:按用户名、账号、邮箱或备注过滤联系人,输入即筛选。
  • 刷新:重新从服务端拉取通讯录。
  • 列表:显示用户名、账号、备注三列,勾选即选中,可多选。
  • 确定:把选中的联系人加入订单接收账户。
  • 找不到账号?点我更新通讯录:打开创芯工坊通讯录页面,添加联系人后回到对话框点击"刷新"。

已选账户以胶囊形式显示在"订单接收账户"下方,点击胶囊右侧的 × 可以移除。

同时将订单推送给自己:默认勾选。勾选后,除已选联系人外,当前登录账号也会收到该订单,胶囊中显示为"自己(账号名)"。如果接收账户中已经包含自己,可以取消勾选,避免重复。

刷新联系人:不打开对话框,直接重新拉取通讯录。

找不到账号?点我更新通讯录:跳转 https://www.icworkshop.com/user/contactslisttxl,在网页中添加或维护联系人。

接收账户规则
  • 订单至少需要一个接收账户,否则发布时提示"请选择至少一个接收账户"。
  • 联系人来自创芯工坊账号的通讯录,不能手工输入任意账号。
  • 通讯录在网页端更新后,客户端需要点击"刷新联系人"或重新打开对话框才会生效。

7 编程模式​

"编程模式"决定接收方烧录时如何取得固件、是否需要在线授权。点击下拉框展开四种模式:

图 14:编程模式下拉框

模式适用场景是否联网是否签名
在线编程接收方每次烧录都从平台下载固件是否
在线编程 + 固件签名(创芯工坊)使用创芯工坊内置授权算法是是
在线编程 + 固件签名(自定义)使用自建授权服务器是是
脱机编程接收方把订单下载到烧录器后离线烧录否(烧录时)否

7.1 在线编程​

选择"在线编程"后,页面只保留模式选择本身:

图 15:在线编程模式

该模式相当于 PowerWriter 的全自动在线编程:接收方连接芯片后,每次烧录都从平台重新下载固件,一次烧一颗芯片。适用于生产方始终联网、需要按次计费的场景。

7.2 在线编程 + 固件签名(创芯工坊)​

该模式使用创芯工坊内置的非对称签名算法,对芯片进行在线授权。选择后会出现"签名算法"下拉框:

图 16:创芯工坊签名模式(未选择算法)

使用步骤:

  1. 在"签名算法"下拉框中选择要使用的算法。列表由服务端返回,显示算法名称和当前账号的剩余签名次数。
  2. 如果列表为空或需要更新,点击左侧"重新获取"。
  3. 选择后,下拉框显示算法名称:

图 17:已选择签名算法

关于算法与次数:

  • 算法列表来自创芯工坊的授权服务,每个算法显示当前账号的剩余次数。
  • 剩余次数不足时,发布校验会提示"所选签名算法剩余次数不足"。
  • 没有可用算法时,提示"没有可用的签名算法"。
  • 列表加载失败时显示"签名算法获取失败",可点击"重新获取"重试。

如果需要新增算法或购买次数,点击右侧"找不到算法,点我访问服务器",跳转创芯工坊算法服务页(需登录):

https://www.icworkshop.com/user/goodsShop

签名模式的前提

使用创芯工坊签名前,需要先在创芯工坊授权中心添加项目并配置算法。算法原理和授权流程与 ICWKEY 一致,具体请参考创芯工坊帮助中心与 ICWKEY 开发手册。

7.3 在线编程 + 固件签名(自定义)​

该模式使用用户自建的授权服务器。选择后会出现"授权服务器"和"授权密钥"两个输入框:

图 18:自定义签名模式

填写规则:

  • 授权服务器:必须是合法的 http(s) 地址,例如 https://auth.example.com/api。未填写时提示"请填写授权服务器",格式错误时提示"授权服务器必须是合法的 http(s) 地址"。
  • 授权密钥:只能包含可打印 ASCII 字符。输入框右侧的锁形图标可以切换明文显示。未填写时提示"请填写授权密钥"。

右下角的"签名服务开发文档"会打开创芯工坊的自建授权服务器帮助页:

图 19:自建烧录授权服务器(帮助中心)

该页面提供授权服务器的安装要求和部署命令,适合需要自行管理授权数据的用户。接口格式、签名协议和二次开发说明请以帮助中心原文为准。

7.4 脱机编程​

脱机编程模式不使用在线授权。接收方把订单下载到烧录器后,烧录器可以脱离电脑和网络完成烧录:

图 20:脱机编程模式

该模式适合生产现场网络不稳定、需要批量离线烧录的场景。可烧录次数以订单数量为准。

脱机编程的设备限制

PWLINK 和 PWLINK2 不支持脱机编程。使用这两款烧录器时,发布页不会提供"脱机编程"选项,默认使用"在线编程"。如果需要离线烧录,请使用支持脱机的型号(例如 PW200)。

7.5 模式选择建议​

  • 只交付固件、不限制烧录方式:脱机编程。
  • 按次计费、希望每次都能吊销:在线编程。
  • 需要芯片级授权、防止固件被复制:在线编程 + 固件签名(创芯工坊或自定义)。
  • 客户有自建授权体系:在线编程 + 固件签名(自定义)。

8 更多设置​

点击"更多设置"展开,包含芯片别名、附件和订单描述;展开后按钮变为"收起更多设置":

图 21:更多设置

8.1 芯片别名​

芯片别名用于向接收方隐藏芯片的真实品牌、系列和型号。别名模式有三种:

图 22:别名模式下拉框

模式说明
不设置不修改服务端别名,接收方看到芯片的真实型号
随机生成由客户端随机生成一组品牌、系列和型号作为别名
自定义手工填写品牌、系列和型号

选择"自定义"后出现三个输入框:

图 23:自定义芯片别名

  • 品牌 / 系列 / 型号:三项都必须填写,否则提示"自定义别名需要填写品牌、系列和型号"。
  • 别名按"账户 + 芯片"在服务端保存,不是只对当前订单生效。
  • 当前芯片已经设置过别名时,选择"不设置"会提示"当前芯片已设置别名,删除后可重新设置",确认删除后会移除服务端别名。
  • 查询别名期间会显示"正在查询芯片别名…",查询失败时提示"查询芯片别名失败"。

8.2 附件​

附件用于随订单交付生产资料、说明手册、测试报告等文件。点击"添加附件"打开系统文件选择器:

  • 最多 3 个附件,超过时提示"最多只能添加 3 个附件"。
  • 单个附件不超过 5 MB,超过时提示"附件不能超过 5 MB"。
  • 不支持空文件(0 字节),提示"附件不能是空文件"。
  • 只接受以下扩展名:zip、rar、pdf、xlsx、docx、jpg、jpeg、png、gif。
  • 正在被其他程序写入或独占占用的文件不能添加,请先关闭占用程序再选择。
  • 文件无法读取时提示添加失败。

附件会随订单同步给接收方账户,接收方可以在订单详情中下载。

8.3 订单描述​

订单描述是富文本编辑器,用于填写订单说明、生产注意事项、版本变更等。工具栏按钮说明:

按钮功能按钮功能
B粗体I斜体
U下划线S删除线
H₁一级标题H₂二级标题
<>行内代码双引号引用块
圆点列表无序列表数字列表有序列表
定义列表定义列表增加缩进缩进
减少缩进反缩进清除格式清除样式
链接插入链接图片插入图片
表格插入表格撤销 / 重做历史操作

插入链接和图片时:

  • 链接只支持 http(s) 外链,输入其他协议会提示"请输入有效的 http(s) 地址"。
  • 插入表格时行数和列数范围为 1~20,超出范围会提示重新输入。

描述内容以 HTML 形式随订单提交,接收方在订单详情中按富文本显示。

9 发布订单​

9.1 发布前校验​

点击底部"发布"按钮后,客户端按以下顺序校验:

检查项失败提示
订单名称请填写订单名称 / 订单名称需要 2~60 个字符 / 订单名称包含非法字符
单价(非赠送)请填写单次烧录单价 / 单价范围为 0.0001~10000,最多 4 位小数
订单数量请填写订单允许烧录的总次数(1~1000000)
接收账户请选择至少一个接收账户 / 联系人尚未加载完成
签名算法(创芯工坊签名)请选择签名算法 / 所选签名算法剩余次数不足 / 没有可用的签名算法
授权服务器(自定义签名)请填写授权服务器 / 授权服务器必须是合法的 http(s) 地址
授权密钥(自定义签名)请填写授权密钥 / 授权密钥只能包含可打印 ASCII 字符
芯片别名(自定义)自定义别名需要填写品牌、系列和型号
附件最多只能添加 3 个附件 / 附件不能超过 5 MB / 附件不能是空文件

校验不通过时,焦点会定位到对应字段,并在字段下方显示红色提示;修正后提示自动消失。

9.2 发布过程​

校验通过后,按钮进入"正在发布…"状态,页面按阶段显示进度:

  1. 准备发布参数。
  2. 反查芯片和烧录器。
  3. 校验烧录参数。
  4. 上传工程文件。
  5. 上传附件。
  6. 提交发布订单。
  7. 发布完成。

各阶段由客户端与创芯工坊服务端交互完成。上传时间取决于工程大小和网络状况,附件较多时"上传附件"阶段会相应延长。

9.3 发布结果​

  • 成功:显示"发布成功"和订单 ID(订单 ID:xxxx)。接收账户可以在创芯工坊的订单列表中看到该订单。
  • 失败:显示"发布失败"和错误信息。常见原因包括网络中断、登录会话过期、签名算法次数不足、工程或附件上传失败。修正后可重新点击"发布"。

发布过程中不要关闭窗口或退出客户端。发布失败不会扣减签名次数(以服务端返回为准)。

10 发布之后​

本节说明接收方(买家/生产方)如何查看订单并完成烧录。发布方与接收方可能是同一个账号(勾选"同时将订单推送给自己"),也可能是不同账号。以下操作在创芯工坊客户端中完成,界面来自 V1.9.0.7,实际版本可能略有差异。

10.1 安装并登录创芯工坊客户端​

接收方需要在电脑上安装创芯工坊客户端(与 PowerWriter 客户端是两个不同的软件):

图 24:创芯工坊客户端安装界面

安装完成后启动客户端,使用接收订单的创芯工坊账号登录:

图 25:创芯工坊客户端登录界面

  • 支持手机号、邮箱或账号登录。
  • 勾选"保存密码"可在下次启动时自动填充。
  • 点击"验证码登录"可以改用短信验证码登录。
  • 登录前需要勾选并同意创芯工坊服务条款。

10.2 查看订单​

登录后,客户端顶部提供多个页签:

图 26:创芯工坊客户端订单页签

页签用途
账户信息查看当前账号资料与余额
所有订单全部订单,含已完成和未完成
可烧录订单当前可下载、可烧录的订单
已完成订单已烧录完成的订单
处理中订单正在处理的订单
创芯云盘开发者共享的程序文件

订单列表包含订单号、购买次数、剩余次数、创建时间、烧录时间、卖家和项目名称等信息。接收方按项目名称或订单名称确认要烧录的订单,重点看"剩余次数"——它表示当前还可以烧录的次数。

列表上方的搜索框可以按关键字查找内容,PREV/NEXT 用于分页。

10.3 下载固件并配置烧录参数​

  1. 在"可烧录订单"页签中选中目标订单。
  2. 点击底部的"下载固件(F9)"按钮。
  3. 客户端弹出本次烧录的配置窗口:

图 27:订单编程配置窗口

配置项说明
选择烧写设备选择连接烧录器的串口,例如 COM44
设备信息显示烧录器类型、序列号、硬件版本、bootloader 版本
编程模式在线或离线模式,由订单的编程模式决定
烧录次数本次要烧录的芯片数量;离线烧录可自行设置,但不能超过订单剩余次数;在线烧录默认为 1 次
设置序列号起始序列号,用于多颗芯片连续烧录
十进制显示序列号按十进制显示
不再显示此对话框勾选后下次下载固件不再弹出本窗口
更新适配数据勾选后尝试从服务器更新芯片适配数据,在线编程失败时可尝试打开
自动检查并更新设备固件勾选后自动检查烧录器固件版本
剩余次数当前订单还可烧录的次数
  1. 确认配置无误后点击"确定",客户端开始下载固件并进入烧录流程。

10.4 烧录结果与日志​

烧录过程中,日志栏会显示固件下载、设备连接、擦除、写入、校验和授权结果:

图 28:订单烧录日志

  • 成功时显示"离线烧录完成""烧录订单成功",并提示当前订单号、程序文件和烧录次数。
  • 失败时日志会给出具体阶段和错误信息,例如设备未连接、固件校验失败、授权失败。
  • 多颗芯片连续烧录时,可以按设置的烧录次数重复执行;每烧录一颗,订单剩余次数相应减少。
  • 在线编程订单每次烧录都会重新获取授权,脱机编程订单在下载后可以脱离电脑烧录。
发布方与接收方是同一账号时

发布时勾选"同时将订单推送给自己",接收方登录后在"可烧录订单"中就能看到自己发布的订单,可以直接按本节步骤完成下载和烧录,用于自测发布参数是否正确。

版本差异

本节截图来自创芯工坊客户端 V1.9.0.7,用于说明订单查看与烧录配置的整体流程。创芯工坊客户端可能随版本调整界面布局和按钮名称,实际以当前客户端为准;平台规则与更多买家功能请参考创芯工坊帮助中心。

11 常见问题​

Q:发布页提示"请选择签名算法",但下拉列表是空的?

A:先点击"重新获取"。仍为空时,说明当前账号没有可用算法或算法次数已用完,点击"找不到算法,点我访问服务器"到算法服务页开通或购买,然后回到发布页重新获取。

Q:接收账户列表里找不到某个账号?

A:联系人来自创芯工坊通讯录,不能在客户端手工输入。点击"找不到账号?点我更新通讯录"到网页添加联系人,再回到客户端点击"刷新联系人"。

Q:点击"发布"没有反应或提示网络错误?

A:确认网络可以访问创芯工坊,登录会话没有过期。可以关闭发布页后重新从胶囊进入,客户端会重新检查账户和网络状态。

Q:为什么"脱机编程"选项不见了?

A:当前烧录器是 PWLINK 或 PWLINK2,这两款不支持脱机编程。更换支持脱机的烧录器(例如 PW200)后重新打开发布页。

Q:工程密码有什么要求?

A:服务端固件密码要求 8~16 位可见 ASCII 字符。工程密码不符合要求时,按提示重新保存工程,或选择使用临时工程发布。

Q:发布成功后还能修改订单吗?

A:发布页只负责创建订单。订单的上下架、修改库存和描述等操作在创芯工坊后台完成,具体规则以平台为准。转售相关规则见 程序转售规则。

Q:附件添加失败,提示文件被占用?

A:附件不能是正在被其他程序写入或独占打开的文件。关闭 Excel、压缩软件、图片查看器等可能占用该文件的程序后重试。

Q:发布过程中关闭窗口会怎样?

A:发布进行中客户端会阻止关闭窗口并提示"发布进行中,暂时不能关闭窗口"。请等待发布完成或失败后再关闭。

说明

本章节介绍 PowerWriter 客户端内的发布流程。创芯工坊平台的功能、算法服务、订单与转售规则可能随平台升级调整,涉及账号权限、计费和平台规则的内容,请以创芯工坊帮助中心和实际页面为准。