src/README.building

   1 == How to build OsmocomBB? ==
   2
   3 === Prerequisites ===
   4
   5 We assume you are building on a GNU/Linux host system such as Debian
   6 GNU/Linux.  Successful builds have also been reported using MacOS X
   7 and the Cygwin environment for MS Windows, but we do not officially support
   8 this.
   9
  10  # Get a GNU toolchain (gcc/binutils) for ARM (e.g. from http://gnuarm.com/)
  11  # Set your path to include the arm-elf-* executables of your toolchain
  12  # call 'make' in this (the src) subdirectory
  13
  14 === Details ===
  15
  16 The master Makefile will build:
  17
  18  * libosmocore for the host (x86 or whatever you use)
  19  * libosmocore for the target (ARM)
  20  * osmocon and layer23 executables for the host (linking libosmocore)
  21  * the actual target firmware images (in src/target/firmware/board/*/*.bin)
  22
  23 == Transmitting ==
  24
  25 For safety reasons, all code that can enable the transmitter on the phone is
  26 disabled in the default builds.  Plese check the src/target/firmware/Makefile
  27 for the "#CFLAGS += -DCONFIG_TX_ENABLE" line.
  28
  29 Please notice that GSM operates in licensed spectrum and in most jurisdictions
  30 you will need a license from a regulatory authority to transmit.