2025年12月27日 星期六

[水井USR創新教材]Python一下用Google AI Studio瞭解水井村

 Gemini API教學文件:https://ai.google.dev/gemini-api/docs?hl=zh-tw

一、申請API金鑰

網址:https://ai.google.dev/gemini-api/docs/api-key?hl=zh-tw

二、開啟"設定",建立環境變數


開啟系統內容,選擇"環境變數..."



建立GOOGLE_API_KEY或GEMINI_API_KEY


三、開啟cmd,安裝套件

pip install -q -U google-genai


四、開啟Python IDLE,新增檔案,把下列程式貼上,記得要修改API KEY。
程式:

1
2
3
4
5
6
7
8
9
from google import genai

# The client gets the API key from the environment variable `Google_API_KEY`.
client = genai.Client()

response = client.models.generate_content(
    model="gemini-2.5-flash", contents="您對雲林水井村瞭解多少呢?"
)
print(response.text)

執行結果:
我對雲林水井村(位於雲林縣麥寮鄉)的了解如下:

水井村是雲林縣麥寮鄉的一個村落,其名稱本身就帶有濃厚的歷史與地理意涵。

1.  **名稱由來 (Etymology):**
    *   「水井」顧名思義,傳聞在過去,村內有多口水井,提供了居民生活用水及灌溉所需,是當地居民賴以維生的重要水源,因此得名「水井村」。這也反映了早期台灣農村對水資源的重視。

2.  **地理位置 (Geography):**
    *   水井村位於雲林縣的西部沿海一帶,屬於麥寮鄉,地理位置接近台灣海峽。
    *   麥寮鄉近年來因為台塑六輕工業區的設立而廣為人知,水井村多少也會受到周邊工業區發展的影響。

3.  **經濟活動 (Economy):**
    *   **農業:** 作為傳統農村,水井村主要的經濟活動仍以農業為主。雲林縣是台灣重要的農業縣,水井村的農產品可能包括花生、蒜頭、地瓜、玉米等。
    *   **漁業/養殖漁業:** 由於地近沿海,部分居民也可能從事養殖漁業或相關產業。
    *   **勞務:** 隨著六輕工業區的發展,也為周邊村落帶來了一些就業機會,部分村民可能在工業區或相關產業工作。

4.  **人文與文化 (Culture & Demographics):**
    *   **傳統農村風貌:** 雖然受到現代化的衝擊,水井村仍保有部分傳統農村的純樸風貌和生活步調。
    *   **人口結構:** 許多台灣的農村都面臨人口老化的問題,青壯年人口可能因工作機會或教育而外移至都市。水井村可能也有類似的趨勢。
    *   **信仰中心:** 台灣的村落通常都有自己的信仰中心——廟宇,供奉當地居民所信仰的神明,例如王爺、媽祖等,是村民凝聚情感和舉辦節慶的重要場所。

5.  **發展與挑戰 (Development & Challenges):**
    *   **環境議題:** 靠近大型工業區,村落可能需面對與環境保護相關的議題,例如空氣品質、水質等。
    *   **轉型與發展:** 如何在保有傳統農村特色的同時,又能適應現代社會的變遷,吸引年輕人回流,是水井村及許多台灣農村共同面臨的課題。

總體而言,水井村是一個充滿歷史與鄉土氣息的農村,見證了雲林沿海地區的發展與變遷,同時也在現代化的浪潮中尋找自己的定位。

2025年12月19日 星期五

Forward Education:以目標為導向的 STEAM 教育

網站: https://forwardedu.com/
以下文章是透過Notebooklm整理出來的:

此資源來自「Forward Education - Purpose-driven STEAM Education」網站,著重於推動以目標為導向的 STEAM 教育,目標是培養學生成為富有創造力的問題解決者。該網站提供全面的教育解決方案,包括程式設計與機器人套件(如氣候行動套件和智慧水培套件)、創客空間工具(例如 3D 列印機和雷射切割機),以及人工智慧的實作學習。內容亦涵蓋針對不同學習環境的課程,包括課堂、擴展學習和職業技術教育(CTE)實驗室,並提供教育者專業發展課程和豐富的教學資源,例如學習平台上的課程庫和教程。網站設計考量到全球受眾,提供多國貨幣和地區選項,顯示其產品和服務具有廣泛的國際影響力。


氣候行動教學連結:

2025年12月12日 星期五

[OTTO Biped]奧托雙足機器人會跳舞

前一篇:OTTO 忍者機器人
奧托雙足:Otto DIY build your own robot

操作介面:



HTML腳本:



  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
<!DOCTYPE html>
<html lang="zh-TW">
<head>
<meta charset="UTF-8">
<title>Otto Web BLE Controller</title>
<style>
body { font-family: Arial, sans-serif; text-align:center; background:#f9f9f9; }
button{
    width:140px; height:60px; margin:10px; font-size:16px;
    border:none; border-radius:10px; background:#4CAF50; color:white;
}
button.red{ background:#d9534f; }
button.blue{ background:#0275d8;}
.container{ margin-top:30px; }
</style>
</head>
<body>

<h2>OTTO BLE 遙控器</h2>
<button id="connectBle">連線 / Connect</button>
<button id="disconnectBle" disabled>中斷連線 / Disconnect</button>
<p id="status">尚未連線</p>

<div class="container">
    <button onclick="sendMove('forward')">⬆ 前進 / Forward (forward)</button><br>
    <button onclick="sendMove('left')">⬅ 左轉 / Left (left)</button>
    <button onclick="sendMove('stop')" class="red">⏹ 停止 / Stop (stop)</button>
    <button onclick="sendMove('right')">➡ 右轉 / Right (right)</button><br>
    <button onclick="sendMove('backward')">⬇ 後退 / Backward (backward)</button>
</div>

<h3>表情與動作 / Emotions & Gestures</h3>
<!-- 第一列 -->
<button onclick="sendGesture('happy')">開心 / Happy (happy)</button>
<button onclick="sendGesture('superhappy')">超開心 / Super Happy (superhappy)</button>
<button onclick="sendGesture('sad')">難過 / Sad (sad)</button>
<button onclick="sendGesture('sleeping')">睡覺 / Sleeping (sleeping)</button><br>
<!-- 第二列 -->
<button onclick="sendGesture('confused')">困惑 / Confused (confused)</button>
<button onclick="sendGesture('fretful')">煩躁 / Fretful (fretful)</button>
<button onclick="sendGesture('love')">愛心 / Love (love)</button>
<button onclick="sendGesture('angry')">生氣 / Angry (angry)</button><br>
<!-- 第三列 -->
<button onclick="sendGesture('magic')">魔法 / Magic (magic)</button>
<button onclick="sendGesture('wave')">揮手 / Wave (wave)</button>
<button onclick="sendGesture('victory')">勝利 / Victory (victory)</button>
<button onclick="sendGesture('fail')">失敗 / Fail (fail)</button><br>
<!-- 第四列 -->
<button onclick="sendGesture('fart')">放屁 / Fart (fart)</button>
<br/>
<img src="2_01.png">
<script>
let device, server, uartService, tx;

// 速度索引 0~5,先固定 2,如果要加 slider 再改這裡
let speedIndex = 2;

const connectBtn    = document.getElementById("connectBle");
const disconnectBtn = document.getElementById("disconnectBle");
const statusEl      = document.getElementById("status");

connectBtn.onclick = async () => {
    try{
        device = await navigator.bluetooth.requestDevice({
            filters:[
                { namePrefix: "Otto" },
                { services: ["0000ffe0-0000-1000-8000-00805f9b34fb"] }
            ]
        });

        device.addEventListener("gattserverdisconnected", onDisconnected);

        server = await device.gatt.connect();
        uartService = await server.getPrimaryService("0000ffe0-0000-1000-8000-00805f9b34fb");
        tx = await uartService.getCharacteristic("0000ffe1-0000-1000-8000-00805f9b34fb");

        statusEl.innerHTML = "已連線: " + device.name;
        connectBtn.disabled = true;
        disconnectBtn.disabled = false;
    }catch(e){
        alert("連線失敗: " + e);
    }
};

disconnectBtn.onclick = () => {
    disconnect();
};

function disconnect(){
    if (device && device.gatt && device.gatt.connected){
        device.gatt.disconnect();
    } else {
        onDisconnected();
    }
}

function onDisconnected(){
    tx = null;
    uartService = null;
    server = null;
    statusEl.innerHTML = "尚未連線";
    connectBtn.disabled = false;
    disconnectBtn.disabled = true;
    console.log("藍牙已斷線");
}

function sendRaw(str){
    if(!tx) { 
        alert("請先連線 BLE"); 
        return; 
    }
    const data = new TextEncoder().encode(str);
    tx.writeValue(data);
    console.log(">>> Sent:", JSON.stringify(str));
}

// 移動 / 模式:指令 + 速度數字 + 換行
function sendMove(cmd){
    const line = cmd + String(speedIndex) + "\n";
    sendRaw(line);
}

// 表情:指令 + "0" + 換行,讓 Arduino 那邊 n 會被設成 0(合法索引)
function sendGesture(cmd){
    const line = cmd + "0\n";
    sendRaw(line);
}
</script>

</body>
</html>

Arduino程式:

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
/*  
*                        
*    ______________      ____                                _____    _  _     _
*   |   __     __  |    / __ \ _________ _________   ____   |  __ \  | | \\   //  
*   |  |__|   |__| |   | |  | |___   ___ ___   ___  / __ \  | |  | | | |  \\ //  
*   |_    _________|   | |  | |   | |       | |    | |  | | | |  | | | |   | |
*   | \__/         |   | |__| |   | |       | |    | |__| | | |__| | | |   | |
*   |              |    \____/    |_|       |_|     \____/  |_____/  |_|   |_|
*   |_    _________|
*     \__/            
*
*    This Sketch was created to control Otto Starter with the Offical Web Bluetooth Controller for Otto DIY Robots.
*    For any question about this script you can contact us at education@ottodiy.com
*    By: Iván R. Artiles
*/

#include <Otto.h>
#include <EEPROM.h>

#define LEFTLEG 2
#define RIGHTLEG 3
#define LEFTFOOT 4
#define RIGHTFOOT 5
#define TRIG 8
#define ECHO 9
#define BLE_TX 11
#define BLE_RX 12
#define BUZZER 13


#if defined(ARDUINO_ARCH_ESP32)
  #include "BluetoothSerial.h"
  String device_name = "Otto BT Esp32 A21";
  BluetoothSerial bluetooth;
#else
  #include <SoftwareSerial.h>
  String device_name = "NFU-OSSR-A21";
  SoftwareSerial bluetooth(BLE_TX, BLE_RX);
#endif

int move_speed[] = {3000, 2000, 1000, 750, 500, 250};
int n = 2;
int ultrasound_threeshold = 15;
String command = "";

int v;
int ch;
int i;
int positions[] = {90, 90, 90, 90};
int8_t trims[4] = {0,0,0,0};
unsigned long sync_time = 0;

bool calibration = false;

int isavailable = 1;
  
Otto Ottobot;

long ultrasound_distance() {
   long duration, distance;
   digitalWrite(TRIG,LOW);
   delayMicroseconds(2);
   digitalWrite(TRIG, HIGH);
   delayMicroseconds(10);
   digitalWrite(TRIG, LOW);
   duration = pulseIn(ECHO, HIGH);
   distance = duration/58;
   return distance;
}

void setup() {
  Serial.begin(9600);
  Ottobot.init(LEFTLEG, RIGHTLEG, LEFTFOOT, RIGHTFOOT, true, BUZZER);
  pinMode(TRIG, OUTPUT); 
  pinMode(ECHO, INPUT);

#if defined(ARDUINO_ARCH_ESP32)
  Serial.print("ESP32");
  bluetooth.begin(device_name);
  //bluetooth.deleteAllBondedDevices(); // Uncomment this to delete paired devices; Must be called after begin
#else
  Serial.print("No ESP32");
  Serial.print(device_name);
  bluetooth.begin(9600);
  bluetooth.print("AT+NAME" + device_name+ "\r\n");
#endif
  
  Ottobot.home();
  v = 0;
}

void loop() {
  checkBluetooth();//if something is coming at us
    if (Serial.available() > 0) {
    command = Serial.readStringUntil('\n');
    command.trim(); // 去掉換行與空白
    Serial.print("Received: ");
    Serial.println(command);
  }
  if (command == "forward") {
    Forward();
  }
  else if (command == "backward") {
    Backward();
  }
  else if (command == "right") {
    Right();
  }
  else if (command == "left") {
    Left();
  }
  else if (command == "avoidance") {
    Avoidance();
  }
  else if (command == "force") {
    UseForce();
  }
}
void checkBluetooth() {
  char charBuffer[20]; // 最多讀 19 字元 + 結尾 0
  
  if (bluetooth.available() > 0) {
    isavailable = 1;

    int numberOfBytesReceived = bluetooth.readBytesUntil('\n', charBuffer, 19);
    if (numberOfBytesReceived <= 0) return;

    charBuffer[numberOfBytesReceived] = '\0'; // C 字串結尾
    Serial.print("Received by BLE: ");
    Serial.println(charBuffer);

    // 最後一個字元當作速度 index(0~9),避免不是數字時出錯可稍微檢查
    char last = charBuffer[numberOfBytesReceived - 1];
    if (last >= '0' && last <= '9') {
      n = last - '0';
      if (n < 0) n = 0;
      if (n > 5) n = 5;  // 限制在 0~5
    }

    // 前面幾個字元當作指令名稱
    if (strstr(charBuffer, "forward") == &charBuffer[0]) {
      command = "forward";
    }   
    else if (strstr(charBuffer, "backward") == &charBuffer[0]) {
      command = "backward";
    }
    else if (strstr(charBuffer, "right") == &charBuffer[0]) {
      command = "right";
    }
    else if (strstr(charBuffer, "left") == &charBuffer[0]) {
      command = "left";
    }
    else if (strstr(charBuffer, "stop") == &charBuffer[0]) {
      command = "stop";
      Stop();
    }
    else if (strstr(charBuffer, "ultrasound") == &charBuffer[0]) {
      Stop();
      bluetooth.print(ultrasound_distance());
    }
    else if (strstr(charBuffer, "avoidance") == &charBuffer[0]) {
      command = "avoidance";
    }
    else if (strstr(charBuffer, "force") == &charBuffer[0]) {
      command = "force";
    }

    // ===== 表情 / 手勢指令區 =====
    else if (strstr(charBuffer, "happy") == &charBuffer[0]) {
      command = "";
      Ottobot.playGesture(OttoHappy);
    }
    else if (strstr(charBuffer, "superhappy") == &charBuffer[0]) {
      command = "";
      Ottobot.playGesture(OttoSuperHappy);
    }
    else if (strstr(charBuffer, "sad") == &charBuffer[0]) {
      command = "";
      Ottobot.playGesture(OttoSad);
    }
    else if (strstr(charBuffer, "sleeping") == &charBuffer[0]) {
      command = "";
      Ottobot.playGesture(OttoSleeping);
    }
    else if (strstr(charBuffer, "confused") == &charBuffer[0]) {
      command = "";
      Ottobot.playGesture(OttoConfused);
    }
    else if (strstr(charBuffer, "fretful") == &charBuffer[0]) {
      command = "";
      Ottobot.playGesture(OttoFretful);
    }
    else if (strstr(charBuffer, "love") == &charBuffer[0]) {
      command = "";
      Ottobot.playGesture(OttoLove);
    }
    else if (strstr(charBuffer, "angry") == &charBuffer[0]) {
      command = "";
      Ottobot.playGesture(OttoAngry);
    }
    else if (strstr(charBuffer, "magic") == &charBuffer[0]) {
      command = "";
      Ottobot.playGesture(OttoMagic);
    }
    else if (strstr(charBuffer, "wave") == &charBuffer[0]) {
      command = "";
      Ottobot.playGesture(OttoWave);
    }
    else if (strstr(charBuffer, "victory") == &charBuffer[0]) {
      command = "";
      Ottobot.playGesture(OttoVictory);
    }
    else if (strstr(charBuffer, "fail") == &charBuffer[0]) {
      command = "";
      Ottobot.playGesture(OttoFail);
    }
    else if (strstr(charBuffer, "fart") == &charBuffer[0]) {
      command = "";
      Ottobot.playGesture(OttoFart);
    }

    // 校正與測試
    else if (strstr(charBuffer, "C") == &charBuffer[0]) {
      if (calibration == false) {
        Ottobot._moveServos(10, positions);
        calibration = true;
        delay(50);
      } 
      command = "calibration";
      Calibration(String(charBuffer));
    }
    else if (strstr(charBuffer, "walk_test") == &charBuffer[0]) {
      command = "";
      Ottobot.walk(3, 1000, FORWARD);
    }
    else if (strstr(charBuffer, "save_calibration") == &charBuffer[0]) {
      command = "";
      readChar('s');
    }
  }
  else {
    if (isavailable == 1) {
      Serial.println("No Bluetooth is available.");
      isavailable = 0;
    }
  }
}

void Forward() {
  Ottobot.walk(1, move_speed[n], FORWARD);
}

void Backward() {
  Ottobot.walk(1, move_speed[n], BACKWARD);
}

void Right() {
  Ottobot.walk(1, move_speed[n], RIGHT);
}

void Left() {
  Ottobot.walk(1, move_speed[n], LEFT);
}

void Stop() {
  Ottobot.home();
}

void Avoidance() {
  if (ultrasound_distance() <= ultrasound_threeshold) {
    Ottobot.playGesture(OttoConfused);
    for (int count=0 ; count<2 ; count++) {
      Ottobot.walk(1,move_speed[n],-1); // BACKWARD
    }
    for (int count=0 ; count<4 ; count++) {
      Ottobot.turn(1,move_speed[n],1); // LEFT
    }
  }
  Ottobot.walk(1,move_speed[n],1); // FORWARD
}

void UseForce() {
  if (ultrasound_distance() <= ultrasound_threeshold) {
      Ottobot.walk(1,move_speed[n],-1); // BACKWARD
    }
    if ((ultrasound_distance() > 10) && ( ultrasound_distance() < 15)) {
      Ottobot.home();
    }
    if ((ultrasound_distance() > 15) && ( ultrasound_distance() < 30)) {
      Ottobot.walk(1,move_speed[n],1); // FORWARD
    }
    if (ultrasound_distance() > 30) {
      Ottobot.home();
    }  
}

void Settings(String ts_ultrasound) {
  ultrasound_threeshold = ts_ultrasound.toInt();
}

void Calibration(String c) {
  if (sync_time < millis()) {
      sync_time = millis() + 50;
      for (int k = 1; k < c.length(); k++) {
        readChar((c[k]));
      }
  } 
}

void readChar(char ch) {
  switch (ch) {
  case '0'...'9':
    v = (v * 10 + ch) - 48;
    break;
   case 'a':
    trims[0] = v-90;
    setTrims();
    v = 0;
    break;
   case 'b':
    trims[1] = v-90;
    setTrims();
    v = 0;
    break;
   case 'c':
    trims[2] = v-90;
    setTrims();
    v = 0;
    break;
   case 'd':
    trims[3] = v-90;
    setTrims();
    v = 0;
    break;
   case 's':
    for (i=0 ; i<=3 ; i=i+1) {
      EEPROM.write(i,trims[i]);
    }
    delay(500);
    Ottobot.sing(S_superHappy);
    Ottobot.crusaito(1, 1000, 25, -1);
    Ottobot.crusaito(1, 1000, 25, 1);
    Ottobot.sing(S_happy_short);
    break;
  }
}

void setTrims() {
  Ottobot.setTrims(trims[0],trims[1],trims[2],trims[3]);
  Ottobot._moveServos(10, positions); 
}