Defnyddio offer AI i ysgrifennu sgriptiau miniSMU a µSMU

Os ydych yn ymchwilydd ffotofoltaeg, yn wyddonydd batrïau, yn beiriannydd deunyddiau neu’n fyfyriwr sy’n gwybod yn union pa fesuriadau sydd eu hangen arnoch, ond nad ydych yn gyfforddus yn ysgrifennu Python o’r dechrau, gall cynorthwywyr codio AI helpu. Mae offer fel Claude, ChatGPT a Gemini yn gadael i chi ddisgrifio eich arbrawf mewn iaith bob dydd a chael cod sy’n gweithio yn ôl. Does dim angen profiad rhaglennu.

Ond mae un anhawster: er bod yr offer hyn wedi’u hyfforddi ar symiau enfawr o god, efallai na fyddant yn gwybod manylion llyfrgelloedd Python y miniSMU neu’r µSMU. Mae’r canllaw hwn yn datrys hynny gyda thempledi cyd-destun parod i’w defnyddio, sy’n dysgu i’ch offeryn AI bopeth y mae angen iddo ei wybod.

Beth yw templed cyd-destun?

Dogfen gyfeirio yw templed cyd-destun, sy’n disgrifio API llyfrgell, patrymau cyffredin, a maglau pwysig. Pan fyddwch yn rhoi un i gynorthwyydd AI, mae fel rhoi taflen gymorth i gydweithiwr cyn gofyn am ei help - bydd y canlyniadau’n llawer gwell.

Rydym yn cynnal templedi cyd-destun ar gyfer ein dwy lyfrgell Python. Gallwch eu defnyddio drwy:

• Eu gludo ar ddechrau sgwrs ag unrhyw gynorthwyydd AI
• Eu cadw fel ffeil yn ffolder eich prosiect (CLAUDE.md ar gyfer Claude Code, AGENTS.md ar gyfer Copilot/Codex), fel bod yr AI yn darllen y ffeil yn awtomatig
• Eu hychwanegu at anogwr y system (system prompt) neu at eich cyfarwyddiadau personol

Cael y templedi

miniSMU

Mae’r templed ar gyfer y miniSMU MS01 yn ymdrin â gweithredu dwy sianel, cysylltedd USB a Wi-Fi, sgubiadau I-V ar y caledwedd, rheoli’r amrediad cerrynt, mesur Kelvin 4 gwifren, a ffrydio data.

Cael y templed: Gweld ar GitHub - cliciwch ‘Raw’ ac yna copïwch y cyfan

µSMU

Mae’r templed ar gyfer y µSMU yn ymdrin â chysylltiad cyfresol USB, rheoli’r allbwn, mesur foltedd/cerrynt, cyfyngu cerrynt, a sgubiadau I-V yn y feddalwedd.

Cael y templed: Gweld ar GitHub - cliciwch ‘Raw’ ac yna copïwch y cyfan

Dechrau arni

1. Copïwch y templed o’r ddolen uchod (cliciwch ‘Raw’, dewiswch y cyfan, a’i gopïo)
2. Gludwch ef ar ddechrau eich sgwrs ag unrhyw offeryn AI
3. Disgrifiwch eich mesuriad mewn iaith bob dydd
4. Gwellwch fesul cam - gofynnwch i’r AI addasu’r cod, ychwanegu nodweddion neu drwsio problemau

Dechreuwch yn syml. Gofynnwch am sgript sylfaenol sy’n cysylltu ac yn gwneud un mesuriad. Pan fydd hynny’n gweithio, gofynnwch i’r AI ychwanegu sgubiad, yna allforio CSV, yna plot. Mae adeiladu fesul cam yn fwy dibynadwy na gofyn am bopeth ar unwaith, a byddwch yn deall y cod yn well wrth iddo dyfu.

Dyma rai pethau sy’n helpu’r AI i roi canlyniadau gwell i chi:

• Soniwch am eich system weithredu a’ch porth COM (e.e. ‘Rwy’n defnyddio Windows, ac mae’r ddyfais ar COM3’)
• Nodwch yr amrediadau cerrynt rydych yn eu disgwyl ar gyfer y ddyfais sy’n cael ei phrofi
• Dywedwch pa fformat allbwn rydych ei eisiau (CSV, plot matplotlib, wedi’i argraffu i’r consol)
• Gofynnwch am nodweddion diogelwch: ‘Ychwanegwch derfynau amddiffyn, a gwnewch yn siŵr bod yr allbwn yn cael ei analluogi os bydd gwall’

Enghreifftiau o anogwyr a’r cod a gynhyrchir

I roi syniad i chi o sut mae’r llif gwaith hwn yn edrych yn ymarferol, dyma rai anogwyr (prompts) go iawn a’r math o god y bydd cynorthwyydd AI yn ei gynhyrchu.

Nodweddu I-V celloedd solar

‘Ysgrifennwch sgript Python ar gyfer y miniSMU MS01 sy’n mesur cromlin I-V cell solar o -0.2V i 0.8V gyda 101 o bwyntiau. Cyfrifwch ac argraffwch Voc, Isc, y ffactor llenwi a’r effeithlonrwydd, gan dybio goleuo o 100 mW/cm² ac arwynebedd cell o 1 cm². Cadwch y data mewn ffeil CSV.’

Profi LED gyda thoriad diogelwch

‘Crëwch sgript ar gyfer y miniSMU sy’n sgubo’r foltedd o 0 i 3.5V ar LED. Stopiwch ar unwaith os yw’r cerrynt yn mynd yn uwch na 15mA, er mwyn diogelu’r LED. Plotiwch y gromlin I-V ar y diwedd.’

Cylch gwefru/dadwefru batri Li-ion

‘Ysgrifennwch sgript sy’n gwneud cylch gwefru a dadwefru llawn ar fatri Li-ion ar 100mA. Dylai gynnwys gwefru CC i 4.2V, dal CV nes bod y cerrynt yn gostwng i 10mA, saib o 5 munud, dadwefru CC i 3.0V, a saib arall. Cofnodwch yr holl ddata gyda stampiau amser mewn ffeil CSV.’

Profi swp o samplau

‘Mae angen i mi brofi sawl sampl. Ysgrifennwch sgript sy’n rhedeg mewn dolen: mae’n gofyn am ID y sampl, yn rhedeg sgubiad I-V o -1V i 1V, yn cadw’r data fel “sample_[ID].csv”, ac yn gofyn a ydw i eisiau parhau.’

Monitro gwrthiant dros amser

‘Ysgrifennwch sgript sy’n monitro gwrthiant drwy roi cerrynt o 1mA a mesur y foltedd. Gwnewch ddarlleniad bob eiliad am 5 munud, a dangoswch blot sy’n diweddaru’n fyw.’

Pan fydd pethau’n mynd o chwith

Os bydd yr AI yn rhoi cod i chi nad yw’n rhedeg, peidiwch â phoeni! Mae hyn yn rhan arferol o’r broses (er bod hyn yn digwydd yn llai aml erbyn hyn). Copïwch y neges gwall, gludwch hi yn ôl yn y sgwrs, a gofynnwch i’r AI drwsio’r cod. Fel arfer, bydd yn gweld y broblem ar unwaith.

Dyma rai problemau cyffredin, a sut i’w datrys yn gyflym:

‘Module not found’ - Gosodwch y llyfrgell yn gyntaf:

pip install minismu-py  # For miniSMU
pip install usmu-py      # For µSMU

Methu dod o hyd i’r ddyfais - Gofynnwch i’r AI: ‘Ychwanegwch god i restru’r pyrth cyfresol sydd ar gael, er mwyn i mi ddod o hyd i’m dyfais’

Darlleniadau annisgwyl - Gofynnwch: ‘Ychwanegwch derfynau amddiffyn priodol, ac esboniwch beth mae pob gosodiad yn ei wneud’

Mae’n werth nodi bod y llyfrgelloedd Python yn defnyddio’n union yr un gorchmynion caledwedd ag ap bwrdd gwaith miniSMU - mae cywirdeb y mesur yn union yr un fath, sut bynnag rydych yn rheoli’r ddyfais. Dim ond eich helpu i ysgrifennu’r cod y mae’r AI; nid yw’n effeithio ar y mesuriadau trydanol eu hunain.

Darllen pellach

• Cysylltiadau Kelvin wrth brofi I-V celloedd solar - Defnyddio mesuriadau 4 gwifren i nodweddu’n gywir
• Sut i ddiweddaru cadarnwedd eich miniSMU - Cael y nodweddion diweddaraf, gan gynnwys sgubiadau ar y caledwedd a mesur Kelvin
• Llyfrgell Python miniSMU - Y cod ffynhonnell llawn a’r ddogfennaeth
• Llyfrgell Python µSMU - Y cod ffynhonnell llawn a’r ddogfennaeth

Oes rhywbeth ar goll o’r templedi, neu oes gennych batrwm cod defnyddiol i’w rannu? Y ffeiliau CLAUDE.md ac AGENTS.md ym mhob ystorfa yw’r ffynhonnell awdurdodol - mae croeso i chi gyflwyno ceisiadau tynnu (pull requests).