Fibocom Linux apps

This is a Fibocom linux apps set project for wwan devices.
Flash service: firmware update, switch, recovery.
Ma service: fccunlock(It is not open source).
Config service: OEM configuration function.
Helper service: provider dbus API for Flash/Ma/Config service.

License

The fibo_flash fibo_config fibo_helper binaries are both GPLv2+.

Notice

• Service must be used with fw_package. Before installing service, ensure that fw_package has been installed. Obtain the fw package from the corresponding OEM .
  
• fw_switch using fastboot so you can install fastboot with command sudo apt-get install fastboot
  
• MA service default not enable if you want to used you should copy /opt/fibocom/fibo_ma_service/fcc-unlock.d to /usr/lib/x86_64-linux-gnu/ModemManager/ command :
  1. cp -raf /opt/fibocom/fibo_ma_service/fcc-unlock.d /usr/lib/x86_64-linux-gnu/ModemManager/
  2. rm -rf /opt/fibocom/fibo_ma_service/fcc-unlock.d
  3. chown -R root:root /usr/lib/x86_64-linux-gnu/ModemManager/fcc-unlock.d
  4. chmod 755 -R /usr/lib/x86_64-linux-gnu/ModemManager/fcc-unlock.d
• This application runs only on ubuntu22.04,other ubuntu versions and other OS have unverified.

Building on Ubuntu

1. Install

• sudo apt install cmake
  
• sudo apt install build-essential
  
• sudo apt install -y pkg-config
  
• sudo apt install libglib2.0-dev
  
• sudo apt install libxml2-dev
  
• sudo apt install libudev-dev
  
• sudo apt install libmbim-glib-dev
  
• sudo apt install libdbus-1-dev
  
• sudo apt install libmm-glib-dev
  

2. Build

1. cmake -S . -B build
   if you want to install custom path you can send cmd:
   cmake -S . -B build --install-prefix <custm path>
   
2. cmake --build build
   
3. sudo cmake --install build
   if you install custom path in home path you can send cmd:
   cmake --install
   

3. If using systemd, use

• load config file
  sudo systemctl daemon-reload
• enable service
  sudo systemctl enable fibo_xxx.service
  examples: sudo systemctl enable fibo_helper.service
       sudo systemctl enable fibo_helper_mbim.service
       sudo systemctl enable fibo_flash.service
       sudo systemctl enable fibo_config.service
  notices: this step must be done,then systemd can find and start the service
  
• start service
  sudo systemctl start fibo_xxx.service
  
• Get status
  sudo systemctl status fibo_xxx.service
  
• Stop service
  sudo systemctl stop fibo_xxx.service
  

release history

• version:1.0.0
  first version, add flash firmware,recovery service.
  

• version:1.0.2
  

  1. modify project build script
     
  2. optimize helper and flash service source code
     

• version:1.0.3
  modify project build script
  

• version:1.0.4
  fw switch:
  

  1. FWSwitch can not be triggered after hotplug switch verizon to CUCC sim card. (mccmnc 6 bit switch to 5 bit)
     

  recovery:
  

  1. The oem is damaged. After the module is powered on, recovery is triggered to burn the oem.
     
  2. Stop the timer when the fastboot port appears.
     

  Ma Service:
  

  1. If an exception is returned, modify the judgment string
     
  2. Add the SKU ID
     

  helper:
  

  1. Support MBIM message indication and revert previous MM indication support.
     
  2. Re-add timeout recovery mechanism if helperm is no response.
     
  3. When the helper returns a command to the caller, the code logic is incorrect.
     

• version:1.0.5
  config_service:
  

  1. support sim card slot switch slot 1.
     

  helper:
  

  1. The SIM card status and MCCMNC on the network side can be queried using mbim messages.
     
  2. recovery You can select the version number to flash.
     

  fw switch:
  

  1. Support low-battery upgrade in AC mode.
     
  2. If the obtained SubSysid is empty, no upgrade is performed.
     

• version:1.0.6
  Fix spelling errors in source code
  

  helper:
  

  1. The optimization progress bar is displayed
     
  2. Optimize recovery download logic
     
  3. modify helperm abnormal stuck status
     

  fw switch:
  

  1. Can't do FW switch after recovery when port state is abnormal on first boot.
     
  2. Support monitoring of new package installation.
     

• version:1.0.7
  

  1. modify source code compiling warning
     
  2. modify all service log format
     

• version:1.0.8
  

  1. optimized config code
     
  2. modify log level
     
  3. flash service print log without fw_package
     

• version:1.0.11
  

  1. Modify FWFlashServie flash logic.