Go to file
Stefan Eichenberger 948be408d0 meta-nmrouter: remove recipes not part of bsp
Remove all recipes that are not part of the bsp, move them in a separate
layer.
2017-07-14 10:40:20 +02:00
conf meta-nmrouter: remove recipes not part of bsp 2017-07-14 10:40:20 +02:00
recipes-connectivity meta-nmrouter: remove recipes not part of bsp 2017-07-14 10:40:20 +02:00
recipes-core bd.json: add new tags 2017-02-28 18:12:36 +01:00
recipes-kernel meta-nmrouter: remove recipes not part of bsp 2017-07-14 10:40:20 +02:00
README README: update and do some corrections 2016-12-02 14:06:31 +01:00

README

This layer depends on:

URI: git://git.yoctoproject.org/poky
branch: jethro
revision: HEAD

URI: git://git.openembedded.org/meta-openembedded
branch: jethro
revision: HEAD
layers: meta-python, meta-oe, meta-networking

For images that contain NodeJS extensions:
URI: https://github.com/imyller/meta-nodejs.git
branch : jethro
revision: HEAD

URI: https://github.com/imyller/meta-nodejs-contrib.git
branch: jethro
revision: HEAD


To get an image that is compatible with the NetModule router, build an nmrouter-image. Set the MACHINE in conf/local.conf to 
MACHINE = "armada-385-nbhw17-nb2800" or
MACHINE = "am335x-nbhw16" # AKA NB800
and add the following layers to conf/bblayers.conf:
BBLAYERS ?= " \
  <poky dir>/meta \
  <poky dir>/meta-yocto \
  <poky dir>/meta-nmrouter \
  <poky dir>/meta-telephony \
  <poky dir>/meta-nodejs \
  <poky dir>/meta-nodejs-contrib \
  <poky dir>/meta-openembedded/meta-python \
  <poky dir>/meta-openembedded/meta-oe \
  <poky dir>/meta-openembedded/meta-networking \
  "

NB2800:
    While the NetModule router is running under the original software you have to do the following steps:
        - Find out what boot partition is currently used:
        cat /proc/cmdline
        - The partition layout is mmcblk0p1 => bootpart0, mmcblk0p2 => bootpart1, mmcblk0p3=> overlay/data partition
        - Untar the output of the nmrouter-image build to the partition that is not in use (if the above cmd returns mmcblk0p1 then to mmcblk0p2)
        mount /dev/mmcblk0p2 /mnt
        rm -rf /mnt/*
        tar -xjf ./<image>.tar.bz2 -C /mnt
        - reboot the netmodule router
        - in u-boot you have to manually overwrite the bootcmd. Use the correct boot partition (bootpart0 => 0:1, bootpart1 => 0:2)
        setenv bootcmd 'ext4load mmc 0:2 $kernel_addr /boot/zImage && ext4load mmc 0:2 $fdt_addr /boot/armada-385-nbhw17-nb2800.dtb && setenv bootargs root=/dev/mmcblk0p2 rw rootfstype=ext4 console=ttyS0,115200 rootwait && bootz $kernel_addr - $fdt_addr'
        saveenv # save the environment in eeprom (ignore message during bootup)
        - boot to Linux:
        boot

    Do not overwrite the original partition, u-boot will search a valid FPGA there. If you want to overwrite the other partition, make sure you copy the /logic folder from the original partition to the new one!

    To learn how to build an image and to find the build dependencies visit:
    http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html

    Memory Map of the FPGA (to switch SIMs, reset modems):
    Address     Width   Name/Comment
    0x0020      16      LED
    LED Control Register
        Slice    Name        Type    Reset    Description
        0        LED0 green  RW      1        Enable LED 0 (green)
        1        LED0 red    RW      1        Enable LED 0 (red)
        2        LED1 green  RW      0        Enable LED 1 (green)
        3        LED1 red    RW      0        Enable LED 1 (red)
        4        LED2 green  RW      0        Enable LED 2 (green)
        5        LED2 red    RW      0        Enable LED 2 (red)
        6        LED3 green  RW      0        Enable LED 3 (green)
        7        LED3 red    RW      0        Enable LED 3 (red)
        8        LED4 green  RW      0        Enable LED 4 (green)
        9        LED4 red    RW      0        Enable LED 4 (red)
        10       LED5 green  RW      0        Enable LED 5 (green)
        11       LED5 red    RW      0        Enable LED 5 (red)
        12       LED6 green  RW      0        Enable LED 6 (green)
        13       LED6 red    RW      0        Enable LED 6 (red)
        14       LED7 green  RW      0        Enable LED 7 (green)
        15       LED7 red    RW      0        Enable LED 7 (red)

    SIM Card Control
    Address     Width   Name/Comment
    0x0040      16      SIM Ctrl
    SIM Slot Control Register
        Slice   Name        Type        Reset   Description    
        2..0    SIM1_SEL    RW          0       000:  disconnect  
                                                001: Connect Bus 1  
                                                010: Connect Bus 2  
                                                011: Connect Bus 3  
                                                100: Connect Bus 4  
                                                Note:  If no SIM Card is inserted, the power is disable of the corresponding slot.
        3        N/A        R           0       Reserved    
        6..4    SIM2_SEL    RW          0       000:  disconnect  
                                                001: Connect Bus 1  
                                                010: Connect Bus 2  
                                                011: Connect Bus 3  
                                                100: Connect Bus 4  
                                                Note:  If no SIM Card is inserted, the power is disabled of the corresponding slot.
        7        N/A        R           0       Reserved    
        10..8    SIM3_SEL   RW          0       000:  disconnect  
                                                001: Connect Bus 1  
                                                010: Connect Bus 2  
                                                011: Connect Bus 3  
                                                100: Connect Bus 4  
                                                Note:  If no SIM Card is inserted, the power is disable of the corresponding slot.
        11        N/A       R           0       Reserved    
        14..12    SIM4_SE   RW          0       000:  disconnect  
                                                001: Connect Bus 1  
                                                010: Connect Bus 2  
                                                011: Connect Bus 3  
                                                100: Connect Bus 4  
                                                Note:  If no SIM Card is inserted, the power is disabled of the corresponding slot.
        15        N/A       R           0       Reserved    


    PCIe Mini Slot Control:
    Address     Width    Name/Comment
    0x0030      16       PCIe Reset
    PCIe Slot Reset
        Slice    Name           Type    Reset   Description
        0        PCIe1 RST~     RW      0       PCIe Slot 1 Reset
                                                0: reset asserted
        1        PCIe2 RST~     RW      0       PCIe Slot 2 Reset
                                                0: reset asserted
        2        PCIe3 RST~     RW      0       PCIe Slot 3 Reset
                                                0: reset asserted
        3        PCIe4 RST~     RW      0       PCIe Slot 4 Reset
                                                0: reset asserted
        4..15    n/a            R       0        

    The FPGA Base address is at 0xfd000000, to enable for example LED0:red write 0x2 to 0xfd000020:
    devmem2 0xfd000020 hw 0x02

NB800:
    - To update the software you can do a sw-update.sh -l <rootfs.tar.gz>
    - To read and write to the board descriptor use bd read/read-all/write
    - To connect configure the modem and network interface use mmcli and nmcli (ModemManager and NetworkManager)

For questions, send an email to <stefan.eichenberger@netmodule.com>