Cài đặt thiết bị XGSMHub (Raspberry Pi) cho người mới

Từ lúc mở hộp tới lúc gửi được tin nhắn đầu tiên. Thiết bị mua từ VOOC TECH đã cài sẵn phần mềm và đã kích hoạt bản quyền, bạn chỉ cần lắp, nối mạng và liên kết tài khoản. Không cần biết lập trình, không cần màn hình hay bàn phím cho Pi, mọi thứ làm trên điện thoại hoặc trình duyệt.

Mục lục

1Tổng quan: làm những gì, mất bao lâu

Thiết bị XGSMHub là một máy tính nhỏ Raspberry Pi điều khiển các modem 4G gắn SIM. Pi chạy liên tục 24/7, bạn điều khiển hoàn toàn qua trình duyệt: trên điện thoại, máy tính, ở cùng nhà hay ở xa (qua Gateway).

  1. Lắp đặt: gắn SIM vào modem, nối hub modem với Pi, cấp nguồn.
  2. Nối mạng: khuyến khích cắm dây mạng (ổn định nhất, không cần cài gì), hoặc dùng điện thoại chọn WiFi cho Pi qua WiFi thiết lập của máy.
  3. Liên kết Gateway: để mở bảng điều khiển từ bất cứ đâu tại gateway.xvooc.id.vn.
  4. Tạo tài khoản cho nhân viên (tuỳ chọn) và bắt đầu dùng.

Lần đầu làm thường mất khoảng 15–30 phút, phần lớn là thời gian chờ máy khởi động và modem nhận SIM.

Pi
Máy tính Raspberry Pi bên trong thiết bị, chạy phần mềm XGSMHub.
WiFi thiết lập
WiFi tạm do chính Pi phát, tên XGSM-Setup-xxxx (xxxx là 4 ký tự riêng của từng máy), không có mật khẩu. Dùng để mở trang thiết lập khi Pi chưa có mạng hoặc khi cần đổi WiFi.
Trang thiết lập
Trang web của Pi để nối mạng, liên kết Gateway, tạo tài khoản. Mở tại http://10.42.0.1:8000/ khi điện thoại đang nối WiFi thiết lập.
Gateway
Máy chủ gateway.xvooc.id.vn giúp mở bảng điều khiển của thiết bị từ xa, không cần cùng mạng.
Bảng điều khiển
Giao diện chính để gửi SMS, gọi điện, xem lịch sử, quản lý SIM.

2Chuẩn bị

Thứ cần cóGhi chú
Thiết bị XGSMHub (Pi)Đã cài sẵn phần mềm và kích hoạt bản quyền. Pi khởi động từ thẻ nhớ hoặc ổ USB gắn sẵn, đừng tháo ra.
Nguồn cho PiDùng đúng cục nguồn đi kèm. Theo khuyến nghị của Raspberry Pi: Pi 3 dùng nguồn 5V từ 2,5A (cổng micro USB), Pi 4 dùng 5V 3A (cổng USB-C). Nguồn yếu là nguyên nhân hàng đầu gây treo máy, rớt modem.
Hub / board modem và SIMBoard nhiều cổng có nguồn riêng, không lấy điện từ Pi. Gắn SIM đúng chiều trước khi cấp nguồn.
Mạng InternetKhuyến khích dùng cáp mạng (LAN) cắm vào router. Chỉ dùng WiFi (tên + mật khẩu) khi không kéo dây được. Pi 3B chỉ bắt được WiFi 2,4 GHz; Pi 3B+ và Pi 4 bắt được cả 2,4 GHz và 5 GHz (theo thông số Raspberry Pi). Nếu router phát 2 tên riêng, chọn tên có "2.4G".
Điện thoại có WiFiĐể nối WiFi thiết lập và mở trang thiết lập (Android hay iPhone đều được).
Tài khoản GatewayTên đăng nhập và mật khẩu cổng quản lý gateway.xvooc.id.vn do VOOC TECH cấp. Chưa có thì liên hệ trước (xem Liên hệ).
MẹoGhi sẵn ra giấy: tên WiFi, mật khẩu WiFi, tài khoản Gateway. Lúc đổi mạng điện thoại sẽ rớt WiFi vài lần, có sẵn thông tin thì làm rất nhanh.

3Lắp đặt phần cứng

  1. Đặt máy ở nơi thoáng, khô ráo, gần router (nếu dùng WiFi) và có sóng di động tốt cho các SIM. Tránh đặt sát nhau nhiều anten.
  2. Gắn SIM vào các khe modem khi board chưa cấp điện.
  3. Nối board modem với Pi bằng cáp USB đi kèm.
  4. (Nếu dùng mạng dây) cắm cáp LAN từ router vào cổng mạng của Pi.
  5. Cấp nguồn cho board modem trước, sau đó mới cấp nguồn cho Pi.
  6. Chờ Pi khởi động khoảng 1–3 phút. Đèn đỏ trên Pi sáng đứng là có điện; đèn xanh nháy là Pi đang đọc dữ liệu (đang khởi động).
Không rút điện đột ngột khi không cầnRút nguồn Pi lúc đang chạy có thể làm hỏng dữ liệu trên thẻ nhớ/ổ USB. Muốn tắt hẳn, nên khởi động lại hoặc tắt từ bảng điều khiển trước rồi mới rút điện.

4Nối mạng: dây hoặc WiFi

Khuyến cáo: nên dùng MẠNG DÂY thay vì WiFi
  • Ổn định hơn: thiết bị chạy 24/7, gửi tin và gọi liên tục. WiFi dễ chập chờn do sóng yếu, nhiễu, router quá tải, làm rớt kết nối tới Gateway.
  • Không cần thiết lập: cắm dây là Pi tự nhận IP và có mạng ngay, không phải nối WiFi thiết lập, không bị rớt điện thoại khi đổi mạng.
  • Đổi chỗ, đổi router dễ: cắm dây vào router mới là xong, không phải nhập lại tên và mật khẩu WiFi.
  • Nếu vẫn cài thêm WiFi, Pi chỉ dùng WiFi làm đường dự phòng khi dây có vấn đề.

Pi dùng được mạng dây, WiFi, hoặc cả hai. Cả hai cách đều tự nhận địa chỉ IP từ router, bạn không cần cài đặt gì thêm.

CáchKhi nào dùngPi làm gì
Chỉ mạng dây (khuyến khích)Đặt máy gần router hoặc kéo dây được. Ổn định nhất.Cắm dây là tự nhận IP và có mạng.
Chỉ WiFiKhông kéo dây được.Chọn WiFi qua trang thiết lập (mục 5).
Cả dây và WiFiMuốn có đường dự phòng.Ưu tiên đi dây. Rút dây thì tự chuyển sang WiFi, cắm lại thì tự quay về dây.
Dây có cắm nhưng mất InternetVới các máy cài bằng bộ cài từ bản 2.40 trở đi, Pi tự kiểm tra Internet trên từng đường: dây vẫn cắm nhưng router mất mạng thì sau khoảng 20 giây Pi tự đi qua WiFi (nếu đã cài WiFi), có lại Internet thì quay về dây.

Làm sao để vào được trang thiết lập

  • Pi chưa có mạng (chưa cắm dây, chưa cài WiFi): Pi luôn phát WiFi thiết lập XGSM-Setup-xxxx.
  • Pi đã có mạng: WiFi thiết lập chỉ phát khoảng 2 phút sau khi bật nguồn. Nếu có điện thoại đang nối vào hoặc đang mở trang thiết lập thì Pi giữ WiFi này tiếp. Lỡ thời gian thì rút nguồn Pi, cắm lại và nối ngay.
  • Pi mất mạng khoảng 1 phút (router tắt, đổi mật khẩu WiFi, mang máy đi chỗ khác): WiFi thiết lập tự phát lại để bạn cài mạng mới.

5Trang thiết lập (4 bước)

Mở trang thiết lập trên điện thoại

  1. Trên điện thoại vào Cài đặt → WiFi, chọn mạng XGSM-Setup-xxxx (không có mật khẩu). Nếu có nhiều thiết bị, mỗi máy có 4 ký tự cuối khác nhau.
  2. Điện thoại có thể báo "WiFi không có Internet", chọn giữ kết nối / vẫn dùng mạng này. Đây là bình thường vì WiFi thiết lập chỉ để nói chuyện với Pi.
  3. Mở trình duyệt (Chrome, Safari), gõ đúng địa chỉ http://10.42.0.1:8000/. Trang thiết lập hiện ra với các bước.
Tắt dữ liệu di động nếu trang không mởMột số điện thoại thấy WiFi không có Internet sẽ tự đi bằng 4G, làm địa chỉ 10.42.0.1 không mở được. Tạm tắt dữ liệu di động (4G) rồi mở lại trang.

Bước 1: Kết nối mạng

  • Tab Trạng thái hiện tại cho biết Pi đang có mạng chưa: mạng dây (đã nối / chưa cắm dây) và WiFi (tên mạng, IP), đường nào đang dùng, đường nào dự phòng.
  • Nếu đã cắm dây và thấy "Mạng dây: đã nối", có thể bỏ qua phần WiFi, bấm Tiếp tục.
  • Muốn dùng WiFi: chọn tab Đổi WiFi, chọn tên WiFi trong danh sách (hoặc gõ tay tên WiFi nếu không thấy), nhập mật khẩu, bấm Kết nối WiFi.
Bước Kết nối mạng: thiết bị đã nối dây mạng (đang dùng), WiFi làm dự phòng
Tab Trạng thái hiện tại: mạng dây đang dùng, WiFi dự phòng.
Tab Đổi WiFi: danh sách WiFi, ô mật khẩu
Tab Đổi WiFi: chọn mạng, nhập mật khẩu.
Quan trọng: điện thoại sẽ bị RỚT khỏi WiFi thiết lập trong lúc Pi đang nối WiFi

Khi bấm Kết nối WiFi, nếu WiFi mới phát ở kênh khác, Pi phải tắt WiFi thiết lập vài giây rồi phát lại. Điện thoại sẽ mất kết nối, trang có thể báo lỗi hoặc đứng. Đây là bình thường, không phải hỏng.

  1. Đợi khoảng 10–20 giây.
  2. Vào Cài đặt WiFi của điện thoại, nối lại XGSM-Setup-xxxx (nhiều máy không tự nối lại).
  3. Mở lại http://10.42.0.1:8000/. Trang sẽ hiện "Đã kết nối <tên WiFi>" kèm địa chỉ IP mới của Pi.

Đừng bấm Kết nối WiFi nhiều lần liên tiếp trong lúc chờ. Xem giải thích ở mục 6.

Đang đổi WiFi: WiFi thiết lập sẽ tắt vài giây
Đang đổi: WiFi thiết lập tắt vài giây, điện thoại rớt.
Đã kết nối WiFi mới, kèm địa chỉ IP
Nối lại XGSM-Setup, mở lại trang: Đã kết nối + IP mới.
  • Nếu trang báo "Mật khẩu WiFi không đúng.": kiểm tra lại mật khẩu (phân biệt chữ hoa/thường) rồi thử lại. Pi vẫn giữ mạng cũ, WiFi thiết lập bật lại ngay.
  • Nếu báo "Không tìm thấy mạng WiFi này": WiFi ở quá xa, đang tắt, hoặc là mạng 5 GHz mà Pi 3B không bắt được.
  • Có thể đổi tên WiFi thiết lập cho dễ nhận (vd Pi-Kho-1) ở ô tên rồi bấm Lưu tên WiFi. Điện thoại sẽ rớt và phải nối lại theo tên mới.

Bước 2: Kích hoạt bản quyền

Thiết bị mua từ VOOC TECH đã được kích hoạt sẵn. Ở bước này chỉ cần bấm Giữ license hiện tại, bỏ qua bước này.

Bước Bản quyền: đang dùng license hợp lệ, nút giữ license hiện tại
Đã kích hoạt sẵn: bấm Giữ license hiện tại, bỏ qua bước này.
Nếu trang báo "License không hợp lệ — thiết bị đang tạm khoá"Bấm Sao chép ở ô Mã máy, gửi mã đó cho VOOC TECH qua Zalo. Khi nhận được license key, dán vào ô Dán license key rồi bấm Kích hoạt; thiết bị tự khởi động lại vào chế độ đầy đủ trong khoảng 30 giây.

Bước 3: Liên kết Gateway (để dùng từ xa)

  1. Nhập Tài khoản cổng quản lý và Mật khẩu (tài khoản gateway.xvooc.id.vn của bạn).
  2. Bấm Gửi yêu cầu liên kết. Pi cần có Internet ở bước này.
  3. Thiết bị mua từ VOOC TECH thường được duyệt tự động trong vài giây. Nếu trang báo "Đang chờ quản trị viên duyệt thiết bị…" quá vài phút, liên hệ VOOC TECH.

Không cần dùng từ xa thì bấm Bỏ qua bước này, thiết lập sau; lúc nào cần thì nối lại WiFi thiết lập và làm bước này.

Bước Liên kết Gateway: tài khoản cổng quản lý, mật khẩu
Nhập tài khoản Gateway, bấm Gửi yêu cầu liên kết.
Bước Tài khoản thiết bị: danh sách tài khoản, thêm tài khoản
Thêm tài khoản Quản trị / Người dùng cho nhân viên.

Bước 4: Tài khoản đăng nhập thiết bị (tuỳ chọn)

  • Tạo tài khoản để nhân viên đăng nhập bảng điều khiển của thiết bị qua Gateway: nhập tên (vd nhanvien1), mật khẩu, chọn vai trò, bấm Thêm tài khoản.
  • Quản trị: dùng mọi chức năng. Người dùng: không thấy phần Cài đặt, API/Token, Đổi IMEI.
  • Xong bấm Hoàn tất.

Kết thúc

Bấm Tắt WiFi thiết lập để Pi ngừng phát WiFi tạm. Nếu quên, Pi tự tắt sau khoảng 2 phút không ai dùng (khi Pi đã có mạng).

Hoàn tất: nút Tắt WiFi thiết lập
Xong: bấm Tắt WiFi thiết lập.

6Vì sao điện thoại bị rớt khi đổi WiFi

Card WiFi của Raspberry Pi vừa nối vào WiFi nhà bạn, vừa phát WiFi thiết lập, nhưng cả hai bắt buộc dùng chung một kênh sóng. Khi bạn chọn một WiFi mới ở kênh khác, Pi phải:

  1. Tắt WiFi thiết lập: điện thoại của bạn bị ngắt.
  2. Nối WiFi mới, mất khoảng 3–10 giây.
  3. Phát lại WiFi thiết lập ở kênh của WiFi mới.

Nếu WiFi mới cùng kênh với WiFi cũ thì WiFi thiết lập không tắt và điện thoại không bị rớt.

Sau khi đổi WiFi, máy tính / điện thoại phải ở CÙNG mạng với PiVí dụ Pi đã chuyển sang WiFi "Tầng 2", thì muốn mở http://<IP-của-Pi>:8000/ trong mạng nội bộ, máy của bạn cũng phải nối "Tầng 2". Hai router khác nhau thường là hai mạng riêng, đứng ở router này không thấy Pi ở router kia. Dùng Gateway thì mở được từ bất cứ mạng nào.

7Mở bảng điều khiển và kiểm tra modem

Từ bất cứ đâu (qua Gateway)

  1. Mở https://gateway.xvooc.id.vn/, đăng nhập tài khoản cổng.
  2. Chọn thiết bị trong danh sách để mở bảng điều khiển.

Trong cùng mạng (không qua Gateway)

Mở http://<IP-của-Pi>:8000/. IP của Pi xem ở trang thiết lập (bước Kết nối mạng) hoặc trong trang quản lý router (danh sách thiết bị đang kết nối).

Kiểm tra modem và SIM

Bảng Slot: mỗi dòng một SIM với nhà mạng, số điện thoại, sóng
Bảng Slot trên bảng điều khiển: mỗi dòng là một modem/SIM.
  • Bảng Slot liệt kê từng modem: cổng, trạng thái, nhà mạng, số điện thoại, cường độ sóng.
  • Sau khi bật nguồn, modem cần thời gian để nhận SIM và đăng ký mạng. Chờ vài phút rồi xem lại.
  • Slot báo không có SIM: tắt nguồn board, kiểm tra SIM gắn đúng chiều, cấp nguồn lại.
  • Thử gửi 1 tin nhắn tới số của bạn để chắc chắn mọi thứ chạy. Cách dùng từng chức năng xem Hướng dẫn sử dụng.

8Đổi WiFi, chuyển chỗ đặt máy

  1. Nếu Pi vẫn đang có mạng: rút nguồn Pi, cắm lại. WiFi thiết lập phát khoảng 2 phút sau khi bật. Nếu Pi đã mất mạng (đổi chỗ, đổi mật khẩu router): chờ khoảng 1 phút, WiFi thiết lập tự phát.
  2. Nối điện thoại vào XGSM-Setup-xxxx, mở http://10.42.0.1:8000/.
  3. Tab Đổi WiFi → chọn WiFi → nhập mật khẩu → Kết nối WiFi.
  4. Điện thoại sẽ rớt vài giây (xem mục 6). Nối lại XGSM-Setup-xxxx, mở lại trang để xem "Đã kết nối … IP …".
  5. Bấm Tắt WiFi thiết lập khi xong.

Pi nhớ các WiFi đã nối. Đổi lại một WiFi đã từng dùng (kể cả khi router đã đổi mật khẩu) cũng làm y như trên, nhập mật khẩu mới.

Cách nhanh nhất khi chuyển chỗNếu chỗ mới có cổng mạng, cắm dây LAN cho Pi: Pi tự nhận IP và có mạng ngay, không cần làm bước nào.

9Cập nhật phần mềm

  • Pi tự cập nhật: kiểm tra bản mới khoảng 6 giờ một lần, và 5 phút sau mỗi lần khởi động. Cài xong tự khởi động lại dịch vụ, giữ nguyên dữ liệu.
  • Muốn lên bản mới ngay: trên bảng điều khiển bấm Cập nhật phần mềm ở thanh trên cùng (hoặc tab Cài đặt → Kiểm tra cập nhật).
  • Phiên bản đang chạy hiện ở thanh trên cùng của bảng điều khiển.

10Xử lý sự cố

Điện thoại không thấy WiFi XGSM-Setup-xxxx

Pi đang có mạng thì WiFi thiết lập chỉ phát khoảng 2 phút sau khi bật. Rút nguồn Pi, cắm lại, chờ 1–2 phút rồi tìm lại. Nếu vẫn không thấy: Pi có thể chưa khởi động xong (đèn xanh còn nháy nhiều) hoặc nguồn yếu. Thử cục nguồn khác đúng chuẩn.

Bấm "Kết nối WiFi" xong thì điện thoại mất kết nối, trang báo lỗi

Bình thường. Pi phải tắt WiFi thiết lập vài giây để nối WiFi mới ở kênh khác. Chờ 10–20 giây, nối lại XGSM-Setup-xxxx, mở lại http://10.42.0.1:8000/ để xem kết quả. Xem mục 6.

Đã nối WiFi mới nhưng không mở được bảng điều khiển bằng IP

Máy tính / điện thoại của bạn phải nối cùng mạng với Pi. Hai router khác nhau (vd tầng 1 và tầng 2) thường là hai mạng riêng. Hoặc mở qua Gateway gateway.xvooc.id.vn, không cần cùng mạng.

Trang thiết lập báo "Mật khẩu WiFi không đúng."

Kiểm tra lại mật khẩu, chú ý chữ hoa/thường và dấu cách. Pi giữ nguyên mạng cũ, thử lại được ngay.

Địa chỉ 10.42.0.1 không mở được dù đã nối XGSM-Setup

Tạm tắt dữ liệu di động (4G) trên điện thoại, chọn "giữ kết nối" khi điện thoại báo WiFi không có Internet, gõ đúng http://10.42.0.1:8000/ (có :8000).

Modem rớt liên tục, Pi tự khởi động lại, slot lúc có lúc mất

Thường do nguồn. Dùng đúng nguồn đi kèm cho Pi và nguồn riêng đủ mạnh cho board modem. Trên bảng điều khiển, khung thông tin Raspberry Pi có báo thiếu điện nếu nguồn Pi bị sụt áp.

Khung Thông tin Raspberry Pi: CPU, nhiệt độ, RAM, bộ nhớ, nguồn điện
Khung thông tin Raspberry Pi: xem nhiệt độ, bộ nhớ và cảnh báo thiếu điện.
Bảng điều khiển báo license không hợp lệ

Gửi Mã máy (trên trang thiết lập hoặc bảng điều khiển) cho VOOC TECH để được cấp lại key. Không tự cài lại hệ điều hành khi chưa liên hệ.

Không thấy thiết bị trên Gateway / thiết bị báo offline

Kiểm tra Pi có Internet (trang thiết lập, bước Kết nối mạng). Nếu đã đổi tài khoản Gateway, làm lại bước Liên kết Gateway trên trang thiết lập.

Muốn cài lại phần mềm hoặc hệ điều hành cho Pi

Không tự cài lại: thiết bị đã được cài sẵn và gắn bản quyền theo máy. Liên hệ VOOC TECH (mục Liên hệ hỗ trợ), chúng tôi hỗ trợ cài đặt từ xa.

11Bảng lệnh hay dùng (qua SSH)

ViệcLệnh
Xem nhật ký trực tiếpsudo journalctl -u gsm4ghub -f (thoát: Ctrl+C)
Khởi động lại phần mềmsudo systemctl restart gsm4ghub
Xem phần mềm có đang chạysystemctl status gsm4ghub
Xem mạng đang dùngnmcli device status và ip route
Kiểm tra nguồn điệnvcgencmd get_throttled, ra throttled=0x0 là tốt
Khởi động lại Pisudo reboot
Tắt Pi an toànsudo poweroff, chờ đèn xanh ngừng nháy rồi mới rút điện

12Liên hệ hỗ trợ

Khi cần hỗ trợ, gửi kèm: ảnh màn hình trang thiết lập hoặc bảng điều khiển, phiên bản phần mềm, và mô tả bạn đã làm gì (giờ phút càng tốt).

↑