Caution
KARBIT SETIA 🤪
KKKKKKKKKKKKKKKKKKKKK0dc;;;;;;,'..........,;........................... 'OKKKKKk'dKKKKKKKK000000
KK0K00KKKKKKKKKKKKKKKl,,,,,,'..........';cll;........................... .c0KK0cl0KKK00000OOOOOO
KK0KK0KKKKKKKKKKKKKKKl,,,,,..........;cll:;ll:........................... .l0dlK0OdOOOOO0000000
KKKKKKKKKKKKKKKKKKKKKl',,'.........clllc,,',llc,........................... .c:xookO00KKKKKKKKK
KKKKKKKKKKKKKKKKKKKKKd',,'.........llll';:ccllll:........................... .;cd0KKKKKKKKKKKK
KKKKKKKKKKKKKKKKKKKK0d',''.........lll:';;,';::lll:........................... ;;;:'lKKKKKKKKKKKK
KKKKKKKKKKKK0kxdoc:;,'.''..........cll:;';l:,:clll:............................ ..:co;,OKKKKKKKKKKK
KKKKKKK0dl:;,,,,,,,,,,.............;l;.;c::...;lll'............................. .'c;:c..o0KKKKKKKKK
KKKKKKKd.''',,,,,''................'lll,,:.',:lllc.............................. ..,':;, oKKKKKKKKK
K0KKKKKKx;'''''.....................:lll''cllllll' ...............',,.';;;,......' ... '00OKK0K000
KKKKKKKKK0x:........................,cll;cllllll:. ............ .;;;;:;:c:;;...... .oxxO0000000
K00KKKKKKKKK0d;........................,;:clllll, ........... .',llccclc,...'. .xOOOOOOOOOOO
0O0000KKKKKKKKK0xc. .........................''. ...... ,,,l:,',:lo;,,,... .ck000000000O
00000KKK00KKKKKKKd............................................. ';;cc;,:ccc,,,c;'. .cO00000000
K00KKK00OkO0KKKKd....... .................................... ....',;c:.,,,;::;'. ;k000000
KKKKKKKK0O0KKKKk;....... ....,clcc.... .......................... .....''',,':ll:;' ;k0000
KKKKKKKKKKKK0K0l,..','......:odxxd... ............................. .. ......,,;,. :000
KKKKK0KK00KKKKdl';:,,,,....coooolc.............:odol;..... .... . ',.. .,. . ...,:ok000
K00KKKKKK0K000l:,xc;:;,...':;,;:od,.. ......,.'dcccll:.... ...... ...,'.. ';. . ,... lxxkOOO000000
00K0KKKKK0000Oc,oO;,,,,. ... ..'.'......o.'xxxdolc;.... ..... ......'.''','''.....kOOOkkkkkkkkk
000000KKK0000Oc,xOo;,',' :;dd'..,..'c;;;,;;xc'll:,.. .. .... ..........,.........'00OOOOOOOOOOO
00000000KK00OOlcO0:.,'',. .oxKo.;odc.:d,,,''dko''..... . .... ............ ..'....'',,o0000000000000
00000000K00OO0kcx0,.''.',. 'xO0kc::co,dOl,,.c000Oc.'dx::xdo:'...,:;;,,,;;:..,;'...,,,;k000OOO0000000
0000000000000000k0;,'...',..okdkOOO00Odk0Ol;'l0000d,:c:;;k0dodc.,,,,..,,,...:;,..',,,:0OOOOOOOO00000
0000000O0000000Od:,,'....,. ;xxxxxkOOOOkkO00OkO000K0xddx0K0OOkd;,,;,..,,...',,'..,,,,lOOOOOOOOOOOOOO
OOOOlx0k0000koc,,,''''......'kkkkkOOO0OOO0000000Okkkkkkkkkkkkxo,,,'. .,'...,,,,..,,,'dOOOOOOOOOOOOOO
0000x;col:;,,,,;,...'...'....kOOOOO000000000000OOkkkkxxxxxxxxo;,,....''....,,,,'.,::,xOOOOOOOOOOOOOO
0000kl,;'''''.,,....,..',....,O000000000000000000OOOOkkkxxxdl;'............',,,,',oo;dOOOOOOOOOOOOOO
0Okdl:,.....:dl;;,,',...'.... .l0000000000000000000OOOOOOxd:'.......,'''....',,,,',,'lkkkOOOOOOOOkkk
'.......,cdkOl::cllc;'....... .cO00000OO000000000000Okd:'. ....',',,,... ..,,,,',,,okxxxkkkxxxxxx
...,:oxO0OOOO:clcllll:'...... .;x00000000000000Oxo:,........,,,,,,' ..',,,''.'lxkkxxkkkkkk
xO00000OOOOO;;ll:clllc:...... ,d0000000Okxdl;'.........,,,,'.. .....'',,....:oxkkkkkkO
0000OOOOOOd' ;ccc;cccc:;'..''. ,odol;;;,'...........',,'. .....''''.'','....;okkOOO
0OOOOOOOx:.. ;:::;,::::::,...,...... ..................',,'.. ....',,;;:;;,,'..':c'....,cox
OOOOOOkl,... ;::::,';:;::;....,,....... ...'....... .',,,'........ ...,;;;::::::;,''..,odxl;..'..
OOOOOx;'... .:::::;,.''::;....,,'..........'.... .',,,,'............. .,;;:::::::::;,'. .:xkkkkoc;'
kOOOo,'.;c. '::::::;'.'::;....,'.......... .......,,,,''..............,:;:::::::::::;;,. .:xOOOOOOk
OOOl,',do. .;::::::;.'.::;...'.......... ......'',,,'..............':::cc::::::::::;;, .. .:xOOOOOO
OOc,;okl. .:::::::,..':cc:cloc.l,.....'.,,.......,,,..............;::cccccdd:::::::,,. ....':oOOOOO
Oo,ckko'. .':::clxkkOOOkxdl:;...;Oxlllc::;:''.....','............,c::c:;,:cll:::::::,....... .;cOkkk
k,o0Ox,. ..,coO000Oo:,';::'....cllk0d;'',.:l;,.. ...............;:::c;',:c::::::::::,..........':xxx
lc0KKOx'...c0000kk0Oc.,:;,,;;;lO0OlokOdl',,';;,.............. .;;,:;'';:::::::::::::'......'..;.'cxx
;cKKxdc...x000k00kkO0o;:::::::cdxo:dolk0koc;,,'....... ......,;:';,.,;::::::::::::::. .....,..o.'lx
':Od,'...;00000kkO0kkkcc::::::::::;cccxkOOOo;::,...........';:''.',;::::::::::::::::.. ....',.lc.,x
;.x;,'...x000kkO0kxkoldOo;:::::::::xO00OOO0Od;::;'.......,;:::..,;:::::::::::::::::;... ...,';k,.l
o..',''.,O000kdlll;..;oc;:::::::;:olxkkO00000d;:::;''.';::::;',::::;::::::::ccc::::,.... ..',,xo.:
ko',',..okOOOdod; .,:;::::::;;;:xkkOO00000d::::::::::::,,;:::;,,::::::::ccc::;;..... ..,,xd.:
kko,...,xkkkkxxx, ...;::::::;;:;:dO000000000x::::::::::,';;;;,';::::::::::::::;,...... .,;xd.l
kkk:. cxxkxxxxo. ....';:::,:;;;;:coO0000000o;:;;;;;;,...,'.';;;:::::::;;;;;,,,...... .,lx:'x
xxxc cddddddl. .. ...,;;;,....;;,:xOOOOkkx:','''''......,,,,,,,,,,,,'',,,,,'...... .,dd.ld
Repositori ini merupakan sistem IoT buat monitoring lokasi dan tegangan aki alsintan. Secara garis besar, arsitektur sistem dibagi dalam bentuk folder esp, frontend, dan backend yang disesuaikan dengan lapisan umum IoT.
espuntuk menampung sensing/perception dan network layer (basically hardware/network level), dengan file prima donnamain.cppbackenduntuk menampung network/service layer (basically penghubung antara hardware dengan jaringan), dengan file MC (siapa?)frontenduntuk menampung application layer (basically lapisan yang user friendly untuk menampilkan data agar enak untuk dilihat)
Repo ini juga didukung oleh dokumentasi dan catatan yang disimpan di dalam folder docs dan logs respectively. Format dokumentasi menggunakan MarkDown GitHub sama dengan README ini.
docsadalah kumpulan dokumentasi proyeklogsadalah catatan selama proyek dikembangkan
Skill umum yang harus dimiliki oleh pengembang proyek adalah:
- niat lulus (tepat waktu)
- prompting jarvis
- Dokumentasi
- Kekuatan anime
- Navigasi teks
- Ctrl + Arrow
- Home
- End
- Ctrl + Home
- Ctrl + End
- Blocking teks
- Shift + Arrow
- Ctrl + Shift + Arrow
- Shift + Home
- Shift + End
- Ctrl + L
- Ctrl + Shift + Home
- Ctrl + Shift + End
- Manipulasi teks
- Alt + Arrow
- Tab
- Shift + Tab
- Gercep
- Super + D, Alt + F4, Enter
- Alt + Tab
- Alt + Shift + Tab
- Ctrl + Alt + T
- Navigasi workspace
- Super + Arrow
- Super + Alt + Arrow
- Ngetik 10 jari (opsional)
Skill khusus yang harus dimiliki oleh pengembang esp adalah:
- C++ (OOP dan macro header)
- FreeRTOS
- Shell scripting
- loncat-loncat library
Sudah tanggung jawab Anda sebagai pengembang profesional untuk mendokumentasikan perangkat lunak untuk digunakan oleh orang lain dengan benar. Mengelola kompleksitas perangkat lunak adalah bagian yang sangat penting dalam menjaga proyek tetap efisien, dan itu sulit dilakukan jika tidak ada yang tahu cara menggunakan perangkat lunak Anda, atau metode apa yang aman untuk dilakukan 1.
Mr. Frodo
I can’t do this, Sam.
Sam
I know. It’s all wrong. By rights we shouldn’t even be here. But we are. It’s like in the great stories, Mr. Frodo. The ones that really mattered. Full of darkness and danger, they were. And sometimes you didn’t want to know the end. Because how could the end be happy? How could the world go back to the way it was when so much bad had happened? But in the end, it’s only a passing thing, this shadow. Even darkness must pass. A new day will come. And when the sun shines it will shine out the clearer. Those were the stories that stayed with you. That meant something, even if you were too small to understand why. But I think, Mr. Frodo, I do understand. I know now. Folk in those stories had lots of chances of turning back, only they didn’t. They kept going. Because they were holding on to something.
Mr. Frodo
What are we holding onto, Sam?
Sam
Biar cepet lulus dul
- Visual Studio Code: IDE untuk mengembangkan proyek, dengan menggunakan ekstensi:
- PlatformIO: All about Sensing Layer
- EasyEDA: Desain PCB/Skematik
- Fusion: Desain casing
- GenAI (Gemini Pro/Claude): Apa boleh buat 😛
- Laptop/Komputer (Opsional)
Kontrol versi menggunakan Git dan GitHub (siapa sangka)
Feel free untuk menggunakan proyek ini. Clone menggunakan command
git clone https://github.com/lbmu/web_mektan_v2.git
Di-fork juga boleh
# command buat forking (git fork gitu?)
Kasih nomor versi sesuai dengan perkembangan proyek. Beri penomoran sesuai perubahan yang MAJOR.MINOR.PATCH.
Gunakan Semantic Versioning. Contoh:
| Changes | Dari | Ke | Contoh Perubahan | Deskripsi |
|---|---|---|---|---|
| MAJOR | 0.6.6 | 1.0.0 | Arsitektur Superloop ke RTOS | Perubahan yang besar sehingga kode tidak backwards compatible |
| MINOR | 1.0.0 | 1.1.0 | OTA Debugging | Penambahan fitur/sub-sistem yang backwards compatible |
| PATCH | 1.1.0 | 1.1.2 | nambahin ASCII Hu Tao di docs | Perubahan yang sangat kecil, hanya developer yang commit yang mengetahui perbedaannya |
untuk sekarang, upload kode ke repo remote bisa menggunakan script yang sudah dibuat. Script yang digunakan adalah git_sync.bat untuk 🪟 atau git_sync.sh untuk 🐚.
Note
Untuk Windows, jalankan git_sync.bat dengan privilege admin (mereun)
Untuk Shell, gunakan command di bawah ini dalam terminal
# Biar mode execution
chmod +x git_sync.sh
# eksekusi kode nya
sh git_sync.shJika skrip nya bermasalah, cari tahu sendiri biar sekalian belajar 😝
Library digunakan untuk mendukung perkembangan proyek.
Konfigurasi library bisa dilakukan di dalam file platformio.ini bagian lib_deps. Explore library yang didukung oleh PlatformIO di PIO Home (Yang logo alien), dan detail library nya di sini.
Untuk File Library level hardware dapat ditemukan di dalam environment konfigurasi PlatformIO. Defaultnya adalah .pio/libdeps/nama_board pada proyek PlatformIO.
- Sensor daya: Adafruit INA219
- Sensor GPS: TinyGPSPlus
- OTA Monitoring: ESPTelnet
- Basic Security: ESP_SSLClient
- AT/MQTT Handle:
Backend:
- Apa aja dul
Frontend:
- Apa aja dul
Untuk mendokumentasikan proyek, gunakan website dokumentasi GitHub sebagai kitab formatting.
Tip
Kalo mau pake emoji, boleh klik si batu 🗿
Semua dokumentasi/panduan sistem tersedia di folder docs. Dokumentasi dipisah sesuai masing-masing layer sistem.
Error atau problem berada di bagian Issues (siapa sangka).
Coming soon... (nunggu dokumentasi layer aplikasi)
;;;;;;;;;;;;;' ';;;;;. .;;;;;,..,;;;;;;;;;;; .,;;;;;;;;;;; .;;;; .,;;. ';;;;;;;,. .,cc:cc, ';;;;;;;;;;;
Wd,..MMM0.'cXO xMMMc 'MMMN KMMM...,cKM XMMM...,lKM cMMMX. W. 0MMM:.,lWNx. 'kWX' ,XWx. xMMM;..';xM.
x MMMO .k lMMM, .MMMK 0MMM . K 0MMW . O WXMMWc N. xMMM, ;MMWl :WMW. 'MMW; oMMM' o.
MMMO lMMM, .MMMK 0MMM d . 0MMW d . W.dMMMk. N. xMMM, XMMM, .MMMO NMMW. oMMM' l
MMMO lMMMc....,MMMK 0MMM.'x0 0MMM.'xO W. 'XMMN, N. xMMM, xMMMk oMMMx 0MMM: oMMM,.,0o
MMMO lMMMxccccoMMMK 0MMMoxN0 0MMMlxNO W. .kMMMo N. xMMM, dMMMO dMMMx 0MMMl oMMMxd0Mo
MMMO lMMM, .MMMK 0MMM .k 0MMW .x W. cWMMKW. xMMM, kMMMo cMMMk XMMM, oMMM' :o
MMMO lMMM, .MMMK 0MMM ' l. 0MMW ' c. W. .KMMM. xMMM, NMMN. XMMX MMM0 oMMM' ,
MMMO lMMM, .MMMK 0MMM .oK 0MMM oW W. dMM. xMMM, oMMk. .OMM: oMMk. oMMM'
'lNNNX,. 'ONNNx' .lNNNX;..;XNNNkllokXNo .;XNNNxllokXNd .;No' 'X. .,KNNNkllxkl. ,xKx::cxKd' ,0NNNd'
. ...
.cXXX0cok0kc. 'cXXXOcllxKXx oK 'dXXXxloxko' .cXXXX, .XXXXd..,0XXXocloOXX.
MMM0 dMMW; MMMO .xO .MM: ,MMMl cMMK' NXMMX O0MMM, kMMM. ;W.
MMM0 ,MMMK MMMO , l 0MMN ,MMMl OMMW. X.WMMd llxMMM, xMMM. ; :.
MMM0 lMMMl MMMO ll c0MMMx ,MMMl ;MMM0 X oMMM, '0 xMMM, xMMM. .0
MMMX:lkMXx' MMMXoXMl .X kMMM, ,MMMl .MMMM X KMMX 0. xMMM, xMMMdkMN
MMM0.XMMX. MMMO .kl O' .NMMK ,MMMl 'MMMN X .WMMxdc xMMM, xMMM. ;K
MMM0 .NMMK MMMO c ; ;X:::kMMMc ,MMMl cMMMl X oMMM0 xMMM, xMMM. l ..
MMM0 .XMMK. MMMO cK .X.....OMMW. ,MMMl XMMx X XMN. xMMM, xMMM. .K.
'MMMX .NMMX. 'MMMX'.',c0Ml kd ;MMMO lMMMk.':0Nk, .W. .W, OMMMc 0MMMo..':dW0
.;;;;;,. .;;;;.';;;;;;;;;;;;. ,;;. .,;;;;, ';;;;;;;,. .;;;. . .,;;;;;..,;;;;;;;;;;;.
;ooooo, coool:. 'o' .:odo:. ;oddl' loool;. .oooool ,cl;
xMl,,,. KM,':WX cMl OMo.,kx .XN:''oMx WW,,:0W: ,MO,,,' ,. dW,,NO
xM0kkk KMc:oW0 cMl 'kXKko, xMl KM. WW WW ,MXkkk; '0l ,NOkWc
xM;... KMc:;' cMl :: .'KM'cMk .WN WW ;MO ,Mk... . NX..0W.
dN0OOO: 0N :Nc :K0kOKd ;OKOOKx. XNOO00l 'NXOOOk ,Wo lKkkXd
.;''. ',',. .; ., .,,,.
.00. .x .l dM;.oX; ,o 'X0 dddo
OM, o'cO. xk,Ol.x''c.WK, lo,k. 0d,0l :l;d dM; WW ,o'x.cc.l lO..x:lk,'0o:K, :'M0 :NKk:
KM, oclMl KN xM:XKo' WO ;M; W0 Mx KX.Md'k' dM; WM.Mk.k;dXx: dM.dM'cW.,Mo.Mx kc:MX'ooo, ..cNc
'NO '.NocMl KN kN''.xX WO..Wc Mx Mx KX.W0... dM; :Nc XX...:.:W.dM..O;;. ,Mo.Mx :::MX.....,; o'
;:'' c:.c; KN'c..,',. 'c. .;', :, ;: .:c' ,:,', :c, ,,'' ,:.,XOkOd.:'.:, :, .c:'.
dx ;c..',