Mae’r miniSMU MS01 yn cael ei reoli drwy ryngwyneb gorchmynion sy’n dilyn confensiynau SCPI (Standard Commands for Programmable Instruments). Mae’r adran hon yn esbonio strwythur y gorchmynion ac yn rhoi trosolwg o’r gorchmynion sydd ar gael.

Trosolwg o gystrawen y gorchmynion

Caiff gorchmynion eu hanfon at y ddyfais drwy ryngwyneb y feddalwedd. Mae strwythur cyffredinol y gorchmynion yn dilyn y patrwm hwn: COMMAND[:SUBCOMMAND] [PARAMETER]

Ar gyfer ymholiadau sy’n gofyn i’r ddyfais am wybodaeth, ychwanegwch farc cwestiwn at y gorchymyn: COMMAND[:SUBCOMMAND]?

Elfennau strwythur y gorchmynion

Cyfeirnod y gorchmynion cyffredin

Mae’r tabl canlynol yn rhoi cyfeirnod ar gyfer y gorchmynion sy’n cael eu defnyddio amlaf:

Gorchmynion system

Mae gorchmynion system yn rheoli gosodiadau a statws y ddyfais gyfan:

Gorchmynion ffynhonnell ac allbwn

Mae’r gorchmynion hyn yn rheoli gosodiadau allbwn pob sianel. Rhowch rif y sianel (1 neu 2) yn lle x:

Gorchmynion mesur

Mae’r gorchmynion hyn yn gwneud mesuriadau. Rhowch rif y sianel (1 neu 2) yn lle x:

Gorchmynion ffrydio data

Ar gyfer caffael data’n barhaus:

Caiff data ei anfon mewn sypiau, mewn fformat CSV â’r strwythur canlynol:

1,1751313180797,3.713e-02,-7.441e-10,0

Meysydd y fformat data

Gwahanyddion a therfynwyr gorchmynion

• Fel arfer, mae gorchmynion yn gorffen gyda nod llinell newydd \n
• Fel arfer, mae ymatebion i orchmynion yn gorffen gyda nod llinell newydd

Nodiadau am redeg gorchmynion

• Caiff gorchmynion eu rhedeg yn eu trefn, fel y cânt eu derbyn
• Gall rhai gorchmynion gymryd amser i’w cwblhau (e.e. chwilio am rwydweithiau Wi-Fi)
• Fel arfer, mae gorchmynion gosod yn ymateb gydag OK i gydnabod eu bod wedi’u derbyn
• Bydd gorchmynion holi bob amser yn dychwelyd ymateb

Negeseuon gwall

Os bydd gwall gyda gorchymyn, efallai y bydd y ddyfais yn dychwelyd neges gwall:

• Gwallau cystrawen (enghraifft SOUR:VOLT): Invalid SOUR:VOLT command
• Gorchymyn anhysbys: Invalid input format

Rhyngwyneb y feddalwedd

Er y gallwch ddefnyddio’r gorchmynion hyn yn uniongyrchol mewn sefyllfaoedd rhaglennu uwch, mae meddalwedd miniSMU yn rhoi rhyngwyneb graffigol sy’n anfon y gorchmynion hyn yn y cefndir. Mae rhyngwyneb y feddalwedd yn cynnwys:

• Meysydd mewnbwn ar gyfer gosod gwerthoedd foltedd a cherrynt
• Botymau ar gyfer galluogi/analluogi’r allbynnau
• Arddangosiadau ar gyfer darlleniadau mesur
• Paneli ffurfweddu ar gyfer gosodiadau amddiffyn
• Delweddu data ar gyfer mesuriadau sy’n cael eu ffrydio

Mae deall strwythur y gorchmynion yn arbennig o werthfawr wrth:

• Greu dilyniannau prawf awtomataidd
• Ddatblygu rhyngwynebau meddalwedd pwrpasol
• Ddatrys problemau gydag ymddygiad y ddyfais
• Wneud gweithrediadau uwch nad ydynt wedi’u cynnwys yn rhyngwyneb sylfaenol y feddalwedd

Bydd yr adrannau nesaf yn ymdrin â gweithrediadau mwy penodol sy’n defnyddio’r gorchmynion hyn, gan gynnwys adnabod y ddyfais, ffurfweddu’r allbynnau, a gwneud mesuriadau.